SONAR-12897 Document in Javadoc use of sonar-plugin-api-impl for testing

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/Plugin.java b/sonar-plugin-api/src/main/java/org/sonar/api/Plugin.java
index abe7ae3117b5a71ccd9a79b9cc3cea3801f1c4c9..ef88227357948a859b5fa5a5e8d175799a61d4d7 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/Plugin.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/Plugin.java
@@ -69,6 +69,7 @@ import static java.util.Objects.requireNonNull;
  * </pre>
  *
  * <p>Example of Test
+ * Add a test dependency to sonar-plugin-api-impl to have access to implementation classes in tests.
  * <pre>
  *{@literal @}Test
  * public void test_plugin_extensions_compatible_with_5_6() {

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/SonarRuntime.java b/sonar-plugin-api/src/main/java/org/sonar/api/SonarRuntime.java
index 2ac1e54bd301be0a26b610fa930627415fe5ad58..c7c717b86f1a811f0b0091ca6318e7ecb070676b 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/SonarRuntime.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/SonarRuntime.java
@@ -133,7 +133,7 @@ import org.sonarsource.api.sonarlint.SonarLintSide;
  * </p>
  *
  * <p>
- * Unit tests of plugin extensions can create instances of {@link SonarRuntime}
+ * Unit tests of plugin extensions can add a test dependency to available in sonar-plugin-api-impl and create instances of {@link SonarRuntime}
  * via {@link org.sonar.api.internal.SonarRuntimeImpl}.
  * </p>
  *

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/FileSystem.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/FileSystem.java
index ee9a2b21f5fcf3461d1306a583b9201d57839c76..bfecca4b0c3ca024c08f64987962dcdc70c2ff23 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/FileSystem.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/FileSystem.java
@@ -41,7 +41,7 @@ import org.sonar.api.scanner.ScannerSide;
  * </pre>
  *
  * <h2>How to use in unit tests</h2>
- * The unit tests needing an instance of FileSystem can use the implementation
+ * The unit tests needing an instance of FileSystem can use the implementation, available in sonar-plugin-api-impl,
  * {@link org.sonar.api.batch.fs.internal.DefaultFileSystem} and the related {@link org.sonar.api.batch.fs.internal.DefaultInputFile},
  * for example :
  * <pre>

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/InputFile.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/InputFile.java
index abd4556a1598cd51446489b44592f6a1029c161e..78e2a3702d99f7b9c44ba546a5aaa590b1dce0ab 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/InputFile.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/fs/InputFile.java
@@ -29,7 +29,7 @@ import org.sonar.api.batch.sensor.SensorDescriptor;
 
 /**
  * This layer over {@link java.io.File} adds information for code analyzers.
- * For unit testing purpose, use TestInputFileBuilder and initialize
+ * For unit testing purpose, use TestInputFileBuilder available in sonar-plugin-api-impl and initialize
  * the needed fields:
  * 
  * <pre>

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/rule/ActiveRules.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/rule/ActiveRules.java
index afcd20f0e63e1f88bdea2011bc5db9425792cf28..ba56e73be87e855ee9602341a49aa20836e40036 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/rule/ActiveRules.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/rule/ActiveRules.java
@@ -31,7 +31,7 @@ import java.util.Collection;
  * The rules that are activated on the current project. Quality profiles are
  * merged, so rules can relate to different repositories and languages.
  * <br>
- * Use {@link org.sonar.api.batch.rule.internal.ActiveRulesBuilder} to instantiate
+ * Use {@link org.sonar.api.batch.rule.internal.ActiveRulesBuilder} available in sonar-plugin-api-impl to instantiate
  * this component in unit tests.
  *
  * @since 4.2

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/Sensor.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/Sensor.java
index be123215511db8dddbc6699a98c70fd5d1bb4849..41905ed65021f9f1eda4268c433a2072e1dd5953 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/Sensor.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/Sensor.java
@@ -32,7 +32,7 @@ import org.sonarsource.api.sonarlint.SonarLintSide;
  * <p>
  * For example the Cobertura Sensor parses Cobertura report and saves the first-level of measures on files.
  * 
- * For testing purpose you can use SensorContextTester
+ * For testing purpose you can use SensorContextTester, available in sonar-plugin-api-impl
  * @since 5.1
  * @since 7.6 use {@link ProjectSensor} instead to make your Sensor run only once per analysis, and no more once per module
  */

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/SensorContext.java b/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/SensorContext.java
index b156d2c5480c92931def31ec940830133dccc894..a387d51ea9087f5aa71bd556068175c597eac9d3 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/SensorContext.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/batch/sensor/SensorContext.java
@@ -47,7 +47,7 @@ import org.sonar.api.utils.Version;
 
 /**
  * See {@link Sensor#execute(SensorContext)}
- * In order to write unit tests you can use SensorContextTester
+ * In order to write unit tests you can use SensorContextTester, available in sonar-plugin-api-impl
  * @since 5.1
  */
 public interface SensorContext {