Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 41 Next »

NameJava Ecosystem
Latest version1.2 ( 13 March 2013 )
Requires Sonar version3.4 or higher ( check version compatibility )
DownloadJavaEcosystem-1.2.zip
LicenseGNU LGPL 3
DevelopersSonarSource
Issue trackerhttp://jira.codehaus.org/browse/SONARJAVA
Sourceshttps://github.com/SonarSource/sonar-java

Live example

Icon

If you want to see a live example of the capabilities of the Java Ecosystem, you can have a look at Sonar on Sonar.

Description / Features

The Java Ecosystem is a set of Sonar plugins used to monitor the quality of Java projects within Sonar.

It is compatible with the Sonar Eclipse plugin to track violations while coding. It is also compatible with the Issues Report plugin to run pre-commit local analysis.

Installation

The Java Ecosystem is a set of plugins:

  • Mandatory plugins:
    • Java [sonar-java-plugin]: to parse Java code source, compute metrics, etc.
    • Squid [sonar-squid-java-plugin]: to compute additional metrics, check code against rules provided by the Sonar engine
       
  • Optional plugins adding features from external tools:
    • Checkstyle [sonar-checkstyle-plugin]: to check code against rules provided by Checkstyle
    • FindBugs [sonar-findbugs-plugin]: to check code against rules provided by FindBugs
    • PMD [sonar-pmd-plugin]: to check code against rules provided by PMD
    • Surefire [sonar-surefire-plugin]: to execute unit tests with Surefire
    • Cobertura [sonar-cobertura-plugin]: to get code coverage with Cobertura 
    • JaCoCo [sonar-jacoco-plugin]: to get code coverage with JaCoCo

Note that by default the Java Ecosystem is provided with Sonar.

You can update it from the Update Center (since Sonar 3.5) or download the latest release from this page header.

Usage

Run a Sonar Analysis

To launch a Sonar analysis of your Java project, it is recommended to use the following analyzers:

Sample projects for each analyzer are available on GitHub that can be browsed or downloaded: /projects/languages/java

Notes:

  • The source directory should be set to the directory containing the top parent package. For example, if your directory structure is 'src/main/java/com/mycompany/...', the source directory must be set to 'src/main/java'.
  • The source directory tree has to match the package declaration. For example, the following class:
MyClass.java

must be located in the following directory: [mySourceDirectory]/com/mycompany/mypackage/MyClass.java. Otherwise you would get such an error while running your analysis:

Log

Tests and Code Coverage

The default code coverage engine for unit tests can be set in Settings > Configuration > General Settings > Java > Code coverage plugin property.

By default the code coverage engine is JaCoCo but CoberturaEmma or Clover can also be used.

To deal with unit tests and code coverage for Java project in Sonar, see Code Coverage by Unit Tests for Java Project tutorial.

To deal with integration tests and code coverage for Java project in Sonar, see Code Coverage by Integration Tests for Java Project tutorial.

Advanced Settings

Documentation on advanced parameters is available on the Analysis Parameters page.

Advanced parameters specific to Java are:

KeyDescriptionDefault value

sonar.skipDesign

Deactivate Java bytecode analysis. The Java bytecode is analyzed by Sonar in order to extract dependencies between packages and files. These dependencies are used for instance to display the DSM (Dependency System Matrix). This bytecode analysis can be deactivated.

false

sonar.java.source

Java version of the source code. This property is not used by the Sonar core but can be used by Java Sonar plugin like the PMD plugin. 

1.5

FAQ

See Java Ecosystem FAQ.

Metrics

See Metrics documentation page.

Android

A sample project with code coverage computed with Emma is available on GitHub that can be browsed or downloaded: /projects/android

Extending Coding Rules using XPath

New coding rules can be added using XPath. See the related documentation.

To navigate the AST, download the SSLR Java Toolkit.

Change Log

Loading

Version 1.3 (unreleased) (43 issues)

Type Key Summary Priority Status
Bug SONARJAVA-165 "Undocumented API" detects private attributes as public Critical Closed
Bug SONARJAVA-29 "Avoid Throwing Raw Exception Types" Rule not able to detect "throw new Exception" in all cases Major Closed
Bug SONARJAVA-135 The rule "Unused private method" generates some false-positives in case of method overloading Major Closed
New Feature SONARJAVA-133 Compute the new metric "complexity in methods" Major Closed
New Feature SONARJAVA-128 Rule S00108: Nested blocks of code should not be left empty Major Closed
New Feature SONARJAVA-127 Rule S00107: Methods should not have too many parameters Major Closed
New Feature SONARJAVA-125 Rule S00112: Generic exceptions Error, RuntimeException, Throwable and Exception should never be thrown Major Closed
New Feature SONARJAVA-122 Rule S00105: Tabulation characters should not be used Major Closed
New Feature SONARJAVA-121 Rule S00104: Files should not have too many lines of code Major Closed
New Feature SONARJAVA-119 Rule S00101: Class names should comply with a naming convention Major Closed
New Feature SONARJAVA-118 Rule S00100: Method names should comply with a naming convention Major Closed
New Feature SONARJAVA-120 Rule S00103: Lines of code should not be too long Major Closed
Improvement SONARJAVA-166 Reorganize the properties of every Java plugin using sub-categories Major Closed
Bug SONARJAVA-164 The Sonar JaCoCo plugin takes into account only the first binary directories if several ones are provided Major Closed
Bug SONARJAVA-161 XPath rule should not lead to NPE, when parse error happens Major Closed
Improvement SONARJAVA-105 The cardinality of JaCoCo properties "includes", "excludes" and "exclclassloader" should be multiple Major Closed
Improvement SONARJAVA-154 Use the new Sonar API to highlight any symbol use or declaration in java source code Major Closed
Improvement SONARJAVA-153 Use the Sonar Syntax Highlighting API to colorize java source code Major Closed
New Feature SONARJAVA-152 Deprecate PMD rule AvoidDollarSigns in favor of S00114 - S00117 Major Closed
New Feature SONARJAVA-151 Rule S00122: Statements should be on separate lines Major Closed
Showing 20 out of 43 issues Refresh

Loading

Version 1.2 (16 issues)

Loading

Version 1.1 (15 issues)

 

  • No labels