aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEvgeny Mandrikov <mandrikov@gmail.com>2011-05-08 00:16:09 +0400
committerEvgeny Mandrikov <mandrikov@gmail.com>2011-05-11 12:43:28 +0400
commit5c2ba8d8e836f1bc75445132f1459dab3eaad7f2 (patch)
tree339dea0802d035957df6dcf753a56f9744ef4464
parenta44fa2a2fafed5a9ef86048a20ad92114d459afd (diff)
downloadsonarqube-5c2ba8d8e836f1bc75445132f1459dab3eaad7f2.tar.gz
sonarqube-5c2ba8d8e836f1bc75445132f1459dab3eaad7f2.zip
Add Javadocs for CoreMetrics
-rw-r--r--sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java25
1 files changed, 25 insertions, 0 deletions
diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java b/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java
index 0d6409f48a8..cd5c6f0bf75 100644
--- a/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java
@@ -208,6 +208,7 @@ public final class CoreMetrics {
* <li>If tool (like Maven Surefire Plugin) has not been activated to run unit tests, then Sensor should not save anything. For example there is no such tool for COBOL.</li>
* <li>If tool has been activated, but there was no unit tests to run, then zero value should be saved for project.</li>
* <li>Non-zero value should be saved for resources representing tests. And Sonar provides default Decorator, which will decorate parent resources.</li>
+ * <li>Should include {@link #TEST_FAILURES} and {@link #TEST_ERRORS}, but should not include {@link #SKIPPED_TESTS}.</li>
* </ul>
*/
public static final Metric TESTS = new Metric(TESTS_KEY, "Unit tests", "Number of unit tests", Metric.ValueType.INT,
@@ -266,6 +267,10 @@ public final class CoreMetrics {
.create();
public static final String LINES_TO_COVER_KEY = "lines_to_cover";
+
+ /**
+ * Use {@link CoverageMeasuresBuilder} to build measure for this metric.
+ */
public static final Metric LINES_TO_COVER = new Metric.Builder(LINES_TO_COVER_KEY, "Lines to cover", Metric.ValueType.INT)
.setDescription("Lines to cover")
.setDirection(Metric.DIRECTION_BETTER)
@@ -285,6 +290,10 @@ public final class CoreMetrics {
.create();
public static final String UNCOVERED_LINES_KEY = "uncovered_lines";
+
+ /**
+ * Use {@link CoverageMeasuresBuilder} to build measure for this metric.
+ */
public static final Metric UNCOVERED_LINES = new Metric.Builder(UNCOVERED_LINES_KEY, "Uncovered lines", Metric.ValueType.INT)
.setDescription("Uncovered lines")
.setDirection(Metric.DIRECTION_WORST)
@@ -319,11 +328,19 @@ public final class CoreMetrics {
.create();
public static final String COVERAGE_LINE_HITS_DATA_KEY = "coverage_line_hits_data";
+
+ /**
+ * Use {@link CoverageMeasuresBuilder} to build measure for this metric.
+ */
public static final Metric COVERAGE_LINE_HITS_DATA = new Metric.Builder(COVERAGE_LINE_HITS_DATA_KEY, "Coverage hits by line", Metric.ValueType.DATA)
.setDomain(DOMAIN_TESTS)
.create();
public static final String CONDITIONS_TO_COVER_KEY = "conditions_to_cover";
+
+ /**
+ * Use {@link CoverageMeasuresBuilder} to build measure for this metric.
+ */
public static final Metric CONDITIONS_TO_COVER = new Metric.Builder(CONDITIONS_TO_COVER_KEY, "Conditions to cover", Metric.ValueType.INT)
.setDescription("Conditions to cover")
.setDomain(DOMAIN_TESTS)
@@ -339,6 +356,10 @@ public final class CoreMetrics {
.create();
public static final String UNCOVERED_CONDITIONS_KEY = "uncovered_conditions";
+
+ /**
+ * Use {@link CoverageMeasuresBuilder} to build measure for this metric.
+ */
public static final Metric UNCOVERED_CONDITIONS = new Metric.Builder(UNCOVERED_CONDITIONS_KEY, "Uncovered conditions", Metric.ValueType.INT)
.setDescription("Uncovered conditions")
.setDirection(Metric.DIRECTION_WORST)
@@ -391,6 +412,8 @@ public final class CoreMetrics {
public static final String CONDITIONS_BY_LINE_KEY = "conditions_by_line";
/**
+ * Use {@link CoverageMeasuresBuilder} to build measure for this metric.
+ *
* @since 2.7
*/
public static final Metric CONDITIONS_BY_LINE = new Metric.Builder(CONDITIONS_BY_LINE_KEY, "Conditions by line", Metric.ValueType.DATA)
@@ -400,6 +423,8 @@ public final class CoreMetrics {
public static final String COVERED_CONDITIONS_BY_LINE_KEY = "covered_conditions_by_line";
/**
+ * Use {@link CoverageMeasuresBuilder} to build measure for this metric.
+ *
* @since 2.7
*/
public static final Metric COVERED_CONDITIONS_BY_LINE = new Metric.Builder(COVERED_CONDITIONS_BY_LINE_KEY, "Covered conditions by line", Metric.ValueType.DATA)