JavaNCSS Metric Results

[ package ] [ object ] [ method ] [ explanation ]

The following document contains the results of a JavaNCSS metric analysis.
JavaNCSS web site.

Packages

[ package ] [ object ] [ method ] [ explanation ]

Packages sorted by NCSS.

Package Classes Methods NCSS Javadocs Javadoc lines Single lines comment Multi lines comment
javancss 11 137 1261 66 440 90 322
javancss.test 3 40 444 9 47 46 52
Classes total Methods total NCSS total Javadocs Javadoc lines Single lines comment Multi lines comment
14 177 1705 75 487 136 374

Objects

[ package ] [ object ] [ method ] [ explanation ]

TOP 30 classes containing the most NCSS.

Object NCSS Methods Classes Javadocs
javancss.Javancss 359 41 1 10
javancss.test.JavancssTest 358 25 0 4
javancss.JavancssAntTask 302 45 0 46
javancss.JavancssFrame 198 9 0 2
javancss.AsciiFormatter 130 12 0 1
javancss.XmlFormatter 108 12 0 1
javancss.test.XmlFormatterTest 38 7 0 4
javancss.Metric 24 6 0 1
javancss.test.AbstractTest 22 8 0 1
javancss.PackageMetric 19 3 0 1
javancss.ObjectMetric 11 2 0 1
javancss.Main 9 1 0 1
javancss.FunctionMetric 7 2 0 1
javancss.Formatter 5 4 0 1

TOP 30 classes containing the most methods.

Object NCSS Methods Classes Javadocs
javancss.JavancssAntTask 302 45 0 46
javancss.Javancss 359 41 1 10
javancss.test.JavancssTest 358 25 0 4
javancss.AsciiFormatter 130 12 0 1
javancss.XmlFormatter 108 12 0 1
javancss.JavancssFrame 198 9 0 2
javancss.test.AbstractTest 22 8 0 1
javancss.test.XmlFormatterTest 38 7 0 4
javancss.Metric 24 6 0 1
javancss.Formatter 5 4 0 1
javancss.PackageMetric 19 3 0 1
javancss.FunctionMetric 7 2 0 1
javancss.ObjectMetric 11 2 0 1
javancss.Main 9 1 0 1

Averages.

NCSS average Program NCSS Classes average Methods average Javadocs average
113.57 1,705.00 0.07 12.64 5.36

Methods

[ package ] [ object ] [ method ] [ explanation ]

TOP 30 Methods containing the most NCSS.

Methods NCSS CCN Javadocs
javancss.test.JavancssTest.testNcss() 143 7 0
javancss.test.JavancssTest.testNcssAndMore() 73 2 0
javancss.Javancss.Javancss(String[]) 65 28 1
javancss.JavancssFrame.showJavancss(Javancss) 61 6 0
javancss.Javancss._measureSource(Reader) 48 16 0
javancss.JavancssAntTask.classThresholdExceeded(ObjectMetric) 38 10 1
javancss.Javancss.parseImports() 36 13 0
javancss.Javancss.findFiles(List,boolean) 36 14 0
javancss.JavancssAntTask.functionThresholdExceeded(FunctionMetric) 30 8 1
javancss.Javancss._measureSource(File) 28 10 0
javancss.JavancssAntTask.packageThresholdExceeded(PackageMetric) 27 8 1
javancss.XmlFormatter.printPackageNcss() 25 2 0
javancss.JavancssFrame.JavancssFrame(Init) 23 2 0
javancss.JavancssFrame.actionPerformed(ActionEvent) 23 16 0
javancss.XmlFormatter.printObjectNcss() 22 2 0
javancss.AsciiFormatter.printPackageNcss() 21 2 0
javancss.AsciiFormatter.printObjectNcss() 21 2 0
javancss.test.JavancssTest.testCCN() 21 1 1
javancss.XmlFormatter.printFunctionNcss() 20 2 0
javancss.AsciiFormatter.printFunctionNcss() 19 2 0
javancss.JavancssFrame.save() 19 4 0
javancss.JavancssAntTask.getCommandLineArguments(List) 18 7 1
javancss.JavancssFrame.run() 17 6 0
javancss.JavancssAntTask.execute() 16 13 1
javancss.JavancssAntTask.generateReport(List) 16 7 1
javancss.test.XmlFormatterTest.testParsing() 16 2 1
javancss.JavancssAntTask.createSourceListFile(List) 14 4 1
javancss.JavancssFrame._setMenuBar() 14 1 0
javancss.test.JavancssTest._doIt() 14 1 0
javancss.AsciiFormatter._formatListHeader(int,String[]) 13 2 0

Averages.

Program NCSS NCSS average CCN average Javadocs average
1,705.00 8.35 2.39 0.34

Explanations

[ package ] [ object ] [ method ] [ explanation ]

Non Commenting Source Statements (NCSS)

Statements for JavaNCSS are not statements as specified in the Java Language Specification but include all kinds of declarations too. Roughly spoken, NCSS is approximately equivalent to counting ';' and '{' characters in Java source files.

Not counted are empty statements, empty blocks or semicolons after closing brackets. Of course, comments don't get counted too. Closing brackets also never get counted, the same applies to blocks in general.

Examples
Package declaration package java.lang;
Import declaration import java.awt.*;
Class declaration
  • public class Foo {
  • public class Foo extends Bla {
Interface declaration public interface Able ; {
Field declaration
  • int a;
  • int a, b, c = 5, d = 6;
Method declaration
  • public void cry();
  • public void gib() throws DeadException {
Constructor declaration public Foo() {
Constructor invocation
  • this();
  • super();
Statement declaration
  • i = 0;
  • if (ok)
  • if (exit) {
  • if (3 == 4);
  • if (4 == 4) { ;
  • } else {
Label declaration fine :

In some cases consecutive semicolons are illegal according to the JLS but JavaNCSS still tolerates them (thought JavaNCSS is still more strict as 'javac'). Nevertheless they are never counted as two statements.

Cyclomatic Complexity Number (CCN)

CCN is also know as McCabe Metric. There exists a much hyped theory behind it based on graph theory, but it all comes down to simply counting 'if', 'for', 'while' statements etc. in a method. Whenever the control flow of a method splits, the "CCN counter" gets incremented by one.

Each method has a minimum value of 1 per default. For each of the following Java keywords/statements this value gets incremented by one:

  • if
  • for
  • while
  • case
  • catch

Also if the control flow of a method returns abortively the CCNvalue will be incremented by one:

  • if
  • for

An ordinary return at the end of method will not be counted.

Note that 'else', 'default', and 'finally' don't increment the CCN value any further. On the other hand, a simple method with a 'switch' statement and a huge block of 'case' statements can have a surprisingly high CCN value (still it has the same value when converting a 'switch' block to an equivalent sequence of 'if' statements).