[Java][Client] Add Deprecated annotation

modules/swagger-codegen/src/main/java/io/swagger/codegen/CodegenOperation.java

@@ -17,7 +17,7 @@ public class CodegenOperation {
             isListContainer, isMultipart, hasMore = true,
             isResponseBinary = false, isResponseFile = false, hasReference = false,
             isRestfulIndex, isRestfulShow, isRestfulCreate, isRestfulUpdate, isRestfulDestroy,
-            isRestful;
+            isRestful, isDeprecated;
     public String path, operationId, returnType, httpMethod, returnBaseType,
             returnContainer, summary, unescapedNotes, notes, baseName, defaultResponse, discriminator;
     public List<Map<String, String>> consumes, produces, prioritizedContentTypes;
@@ -221,6 +221,8 @@ public boolean equals(Object o) {
             return false;
         if (isResponseFile != that.isResponseFile)
             return false;
+        if (isDeprecated != that.isDeprecated)
+            return false;
         if (path != null ? !path.equals(that.path) : that.path != null)
             return false;
         if (operationId != null ? !operationId.equals(that.operationId) : that.operationId != null)
@@ -305,6 +307,7 @@ public int hashCode() {
         result = 31 * result + (isResponseBinary ? 13:31);
         result = 31 * result + (isResponseFile ? 13:31);
         result = 31 * result + (hasReference ? 13:31);
+        result = 31 * result + (isDeprecated ? 13:31);
         result = 31 * result + (path != null ? path.hashCode() : 0);
         result = 31 * result + (operationId != null ? operationId.hashCode() : 0);
         result = 31 * result + (returnType != null ? returnType.hashCode() : 0);

modules/swagger-codegen/src/main/java/io/swagger/codegen/DefaultCodegen.java

@@ -2024,6 +2024,9 @@ public CodegenOperation fromOperation(String path,
         op.notes = escapeText(operation.getDescription());
         op.hasConsumes = false;
         op.hasProduces = false;
+        if (operation.isDeprecated() != null) {
+            op.isDeprecated = operation.isDeprecated();
+        }
 
         List<String> consumes = new ArrayList<String>();
         if (operation.getConsumes() != null) {

modules/swagger-codegen/src/main/resources/Java/api.mustache

@@ -52,6 +52,9 @@ public class {{classname}} {
    * @return {{returnType}}
    {{/returnType}}
    * @throws ApiException if fails to make API call
+   {{#isDeprecated}}
+   * @Deprecated
+   {{/isDeprecated}}
    */
   public {{#returnType}}{{{returnType}}} {{/returnType}}{{^returnType}}void {{/returnType}}{{operationId}}({{#allParams}}{{{dataType}}} {{paramName}}{{#hasMore}}, {{/hasMore}}{{/allParams}}) throws ApiException {
     Object {{localVariablePrefix}}localVarPostBody = {{#bodyParam}}{{paramName}}{{/bodyParam}}{{^bodyParam}}null{{/bodyParam}};

modules/swagger-codegen/src/main/resources/Java/libraries/jersey2/api.mustache

@@ -49,6 +49,9 @@ public class {{classname}} {
    * @return {{returnType}}
    {{/returnType}}
    * @throws ApiException if fails to make API call
+   {{#isDeprecated}}
+   * @Deprecated
+   {{/isDeprecated}}
    */
   public {{#returnType}}{{{returnType}}} {{/returnType}}{{^returnType}}void {{/returnType}}{{operationId}}({{#allParams}}{{{dataType}}} {{paramName}}{{#hasMore}}, {{/hasMore}}{{/allParams}}) throws ApiException {
     Object {{localVariablePrefix}}localVarPostBody = {{#bodyParam}}{{paramName}}{{/bodyParam}}{{^bodyParam}}null{{/bodyParam}};

modules/swagger-codegen/src/main/resources/Java/libraries/resteasy/api.mustache

@@ -45,6 +45,9 @@ public class {{classname}} {
    * @param {{paramName}} {{description}}{{#required}} (required){{/required}}{{^required}} (optional{{#defaultValue}}, default to {{{.}}}{{/defaultValue}}){{/required}}{{/allParams}}{{#returnType}}
    * @return {{{returnType}}}{{/returnType}}
    * @throws ApiException if fails to make API call
+   {{#isDeprecated}}
+   * @Deprecated
+   {{/isDeprecated}}
    */
   public {{#returnType}}{{{returnType}}} {{/returnType}}{{^returnType}}void {{/returnType}}{{operationId}}({{#allParams}}{{{dataType}}} {{paramName}}{{#hasMore}}, {{/hasMore}}{{/allParams}}) throws ApiException {
     Object {{localVariablePrefix}}localVarPostBody = {{#bodyParam}}{{paramName}}{{/bodyParam}}{{^bodyParam}}null{{/bodyParam}};

modules/swagger-codegen/src/test/java/io/swagger/codegen/CodegenTest.java

@@ -403,4 +403,15 @@ private static Swagger parseAndPrepareSwagger(String path) {
         new InlineModelResolver().flatten(swagger);
         return swagger;
     }
+
+    @Test(description = "isDeprecated is present")
+    public void deprecatedParamTest() {
+        final Swagger model = parseAndPrepareSwagger("src/test/resources/2_0/petstore.json");
+        final DefaultCodegen codegen = new DefaultCodegen();
+        final String path = "/pet/findByTags";
+        final Operation p = model.getPaths().get(path).getGet();
+        final CodegenOperation op = codegen.fromOperation(path, "get", p, model.getDefinitions());
+
+        Assert.assertTrue(op.isDeprecated);
+    }
 }

modules/swagger-codegen/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml

@@ -153,6 +153,7 @@ paths:
         - petstore_auth:
             - 'write:pets'
             - 'read:pets'
+      deprecated: true
   '/pet/{petId}':
     get:
       tags:

modules/swagger-codegen/src/test/resources/2_0/petstore.json

@@ -213,7 +213,8 @@
               "read:pets"
             ]
           }
-        ]
+        ],
+        "deprecated": "true"
       }
     },
     "/pet/{petId}": {

modules/swagger-codegen/src/test/resources/2_0/petstore.yaml

@@ -153,6 +153,7 @@ paths:
         - petstore_auth:
             - 'write:pets'
             - 'read:pets'
+      deprecated: true
   '/pet/{petId}':
     get:
       tags:

samples/client/petstore/java/jersey1/src/main/java/io/swagger/client/api/PetApi.java

@@ -185,6 +185,7 @@ public List<Pet> findPetsByStatus(List<String> status) throws ApiException {
    * @param tags Tags to filter by (required)
    * @return List&lt;Pet&gt;
    * @throws ApiException if fails to make API call
+   * @Deprecated
    */
   public List<Pet> findPetsByTags(List<String> tags) throws ApiException {
     Object localVarPostBody = null;

samples/client/petstore/java/jersey2-java6/src/main/java/io/swagger/client/api/PetApi.java

@@ -168,6 +168,7 @@ public List<Pet> findPetsByStatus(List<String> status) throws ApiException {
    * @param tags Tags to filter by (required)
    * @return List&lt;Pet&gt;
    * @throws ApiException if fails to make API call
+   * @Deprecated
    */
   public List<Pet> findPetsByTags(List<String> tags) throws ApiException {
     Object localVarPostBody = null;

samples/client/petstore/java/jersey2/src/main/java/io/swagger/client/api/PetApi.java

@@ -168,6 +168,7 @@ public List<Pet> findPetsByStatus(List<String> status) throws ApiException {
    * @param tags Tags to filter by (required)
    * @return List&lt;Pet&gt;
    * @throws ApiException if fails to make API call
+   * @Deprecated
    */
   public List<Pet> findPetsByTags(List<String> tags) throws ApiException {
     Object localVarPostBody = null;

samples/client/petstore/java/resteasy/src/main/java/io/swagger/client/api/PetApi.java

@@ -168,6 +168,7 @@ public List<Pet> findPetsByStatus(List<String> status) throws ApiException {
    * @param tags Tags to filter by (required)
    * @return List<Pet>
    * @throws ApiException if fails to make API call
+   * @Deprecated
    */
   public List<Pet> findPetsByTags(List<String> tags) throws ApiException {
     Object localVarPostBody = null;