fix buils warning in java native client (#11688)

modules/openapi-generator/src/main/resources/Java/libraries/native/ApiClient.mustache

@@ -150,7 +150,7 @@ public class ApiClient {
   }
 
   /**
-   * Ctor.
+   * Create an instance of ApiClient.
    */
   public ApiClient() {
     this.builder = createDefaultHttpClientBuilder();
@@ -163,7 +163,11 @@ public class ApiClient {
   }
 
   /**
-   * Ctor.
+   * Create an instance of ApiClient.
+   *
+   * @param builder Http client builder.
+   * @param mapper Object mapper.
+   * @param baseUri Base URI
    */
   public ApiClient(HttpClient.Builder builder, ObjectMapper mapper, String baseUri) {
     this.builder = builder;

modules/openapi-generator/src/main/resources/Java/libraries/native/JSON.mustache

@@ -45,6 +45,7 @@ public class JSON {
 
   /**
    * Set the date format for JSON (de)serialization with Date properties.
+   *
    * @param dateFormat Date format
    */
   public void setDateFormat(DateFormat dateFormat) {
@@ -64,6 +65,8 @@ public class JSON {
    *
    * @param node The input data.
    * @param modelClass The class that contains the discriminator mappings.
+   *
+   * @return the target model class.
    */
   public static Class<?> getClassForElement(JsonNode node, Class<?> modelClass) {
     ClassDiscriminatorMapping cdm = modelDiscriminators.get(modelClass);
@@ -123,6 +126,8 @@ public class JSON {
      *
      * @param node The input data.
      * @param visitedClasses The set of classes that have already been visited.
+     *
+     * @return the target model class.
      */
     Class<?> getClassForElement(JsonNode node, Set<Class<?>> visitedClasses) {
       if (visitedClasses.contains(modelClass)) {
@@ -169,6 +174,9 @@ public class JSON {
    *
    * @param modelClass A OpenAPI model class.
    * @param inst The instance object.
+   * @param visitedClasses The set of classes that have already been visited.
+   *
+   * @return true if inst is an instance of modelClass in the OpenAPI model hierarchy.
    */
   public static boolean isInstanceOf(Class<?> modelClass, Object inst, Set<Class<?>> visitedClasses) {
     if (modelClass.isInstance(inst)) {

samples/client/petstore/java/native-async/src/main/java/org/openapitools/client/ApiClient.java

@@ -159,7 +159,7 @@ public class ApiClient {
   }
 
   /**
-   * Ctor.
+   * Create an instance of ApiClient.
    */
   public ApiClient() {
     this.builder = createDefaultHttpClientBuilder();
@@ -172,7 +172,11 @@ public class ApiClient {
   }
 
   /**
-   * Ctor.
+   * Create an instance of ApiClient.
+   *
+   * @param builder Http client builder.
+   * @param mapper Object mapper.
+   * @param baseUri Base URI
    */
   public ApiClient(HttpClient.Builder builder, ObjectMapper mapper, String baseUri) {
     this.builder = builder;

samples/client/petstore/java/native-async/src/main/java/org/openapitools/client/JSON.java

@@ -33,6 +33,7 @@ public class JSON {
 
   /**
    * Set the date format for JSON (de)serialization with Date properties.
+   *
    * @param dateFormat Date format
    */
   public void setDateFormat(DateFormat dateFormat) {
@@ -52,6 +53,8 @@ public class JSON {
    *
    * @param node The input data.
    * @param modelClass The class that contains the discriminator mappings.
+   *
+   * @return the target model class.
    */
   public static Class<?> getClassForElement(JsonNode node, Class<?> modelClass) {
     ClassDiscriminatorMapping cdm = modelDiscriminators.get(modelClass);
@@ -111,6 +114,8 @@ public class JSON {
      *
      * @param node The input data.
      * @param visitedClasses The set of classes that have already been visited.
+     *
+     * @return the target model class.
      */
     Class<?> getClassForElement(JsonNode node, Set<Class<?>> visitedClasses) {
       if (visitedClasses.contains(modelClass)) {
@@ -157,6 +162,9 @@ public class JSON {
    *
    * @param modelClass A OpenAPI model class.
    * @param inst The instance object.
+   * @param visitedClasses The set of classes that have already been visited.
+   *
+   * @return true if inst is an instance of modelClass in the OpenAPI model hierarchy.
    */
   public static boolean isInstanceOf(Class<?> modelClass, Object inst, Set<Class<?>> visitedClasses) {
     if (modelClass.isInstance(inst)) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/ApiClient.java

@@ -159,7 +159,7 @@ public class ApiClient {
   }
 
   /**
-   * Ctor.
+   * Create an instance of ApiClient.
    */
   public ApiClient() {
     this.builder = createDefaultHttpClientBuilder();
@@ -172,7 +172,11 @@ public class ApiClient {
   }
 
   /**
-   * Ctor.
+   * Create an instance of ApiClient.
+   *
+   * @param builder Http client builder.
+   * @param mapper Object mapper.
+   * @param baseUri Base URI
    */
   public ApiClient(HttpClient.Builder builder, ObjectMapper mapper, String baseUri) {
     this.builder = builder;

samples/client/petstore/java/native/src/main/java/org/openapitools/client/JSON.java

@@ -33,6 +33,7 @@ public class JSON {
 
   /**
    * Set the date format for JSON (de)serialization with Date properties.
+   *
    * @param dateFormat Date format
    */
   public void setDateFormat(DateFormat dateFormat) {
@@ -52,6 +53,8 @@ public class JSON {
    *
    * @param node The input data.
    * @param modelClass The class that contains the discriminator mappings.
+   *
+   * @return the target model class.
    */
   public static Class<?> getClassForElement(JsonNode node, Class<?> modelClass) {
     ClassDiscriminatorMapping cdm = modelDiscriminators.get(modelClass);
@@ -111,6 +114,8 @@ public class JSON {
      *
      * @param node The input data.
      * @param visitedClasses The set of classes that have already been visited.
+     *
+     * @return the target model class.
      */
     Class<?> getClassForElement(JsonNode node, Set<Class<?>> visitedClasses) {
       if (visitedClasses.contains(modelClass)) {
@@ -157,6 +162,9 @@ public class JSON {
    *
    * @param modelClass A OpenAPI model class.
    * @param inst The instance object.
+   * @param visitedClasses The set of classes that have already been visited.
+   *
+   * @return true if inst is an instance of modelClass in the OpenAPI model hierarchy.
    */
   public static boolean isInstanceOf(Class<?> modelClass, Object inst, Set<Class<?>> visitedClasses) {
     if (modelClass.isInstance(inst)) {