SONAR-6954 Add 'since' tag to WS parameters

1 files changed, 16 insertions, 0 deletions

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/server/ws/WebService.java b/sonar-plugin-api/src/main/java/org/sonar/api/server/ws/WebService.java
index 5053284f3bc..045d0db25b5 100644
--- a/sonar-plugin-api/src/main/java/org/sonar/api/server/ws/WebService.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/server/ws/WebService.java
@@ -548,6 +548,7 @@ public interface WebService extends Definable<WebService.Context> {
 
   class NewParam {
     private String key;
+    private String since;
     private String deprecatedSince;
     private String deprecatedKey;
     private String description;
@@ -560,6 +561,11 @@ public interface WebService extends Definable<WebService.Context> {
       this.key = key;
     }
 
+    public NewParam setSince(@Nullable String since) {
+      this.since = since;
+      return this;
+    }
+
     public NewParam setDeprecatedSince(@Nullable String deprecatedSince) {
       this.deprecatedSince = deprecatedSince;
       return this;
@@ -687,6 +693,7 @@ public interface WebService extends Definable<WebService.Context> {
     public static final String SELECTED = "selected";
 
     private final String key;
+    private final String since;
     private final String deprecatedSince;
     private final String deprecatedKey;
     private final String description;
@@ -697,6 +704,7 @@ public interface WebService extends Definable<WebService.Context> {
 
     protected Param(Action action, NewParam newParam) {
       this.key = newParam.key;
+      this.since = newParam.since;
       this.deprecatedSince = newParam.deprecatedSince;
       this.deprecatedKey = newParam.deprecatedKey;
       this.description = newParam.description;
@@ -717,6 +725,14 @@ public interface WebService extends Definable<WebService.Context> {
      * @since 5.3
      */
     @CheckForNull
+    public String since() {
+      return since;
+    }
+
+    /**
+     * @since 5.3
+     */
+    @CheckForNull
     public String deprecatedSince() {
       return deprecatedSince;
     }