[Java][Native] Remove Javadoc warnings. fix #8692 (#12017)

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

@@ -9,6 +9,9 @@
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public {{classname}} putAdditionalProperty(String key, {{{.}}} value) {
@@ -20,7 +23,8 @@
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, {{{.}}}> getAdditionalProperties() {
@@ -29,6 +33,8 @@
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public {{{.}}} getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

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

@@ -91,6 +91,11 @@ public class {{classname}} {
    {{#returnType}}
    * @return {{#asyncNative}}CompletableFuture<{{/asyncNative}}{{returnType}}{{#asyncNative}}>{{/asyncNative}}
    {{/returnType}}
+   {{^returnType}}
+   {{#asyncNative}}
+   * @return CompletableFuture<Void>
+   {{/asyncNative}}
+   {{/returnType}}
    * @throws ApiException if fails to make API call
    {{#isDeprecated}}
    * @deprecated
@@ -145,6 +150,11 @@ public class {{classname}} {
    {{#returnType}}
    * @return {{#asyncNative}}CompletableFuture<{{/asyncNative}}{{returnType}}{{#asyncNative}}>{{/asyncNative}}
    {{/returnType}}
+   {{^returnType}}
+   {{#asyncNative}}
+   * @return CompletableFuture<Void>
+   {{/asyncNative}}
+   {{/returnType}}
    * @throws ApiException if fails to make API call
    {{#isDeprecated}}
    * @deprecated

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

@@ -87,6 +87,7 @@ public class FakeApi {
    * creates an XmlItem
    * this route creates an XmlItem
    * @param xmlItem XmlItem Body (required)
+   * @return CompletableFuture<Void>
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> createXmlItem(XmlItem xmlItem) throws ApiException {
@@ -532,6 +533,7 @@ public class FakeApi {
    * 
    * For this test, the body for this request much reference a schema named &#x60;File&#x60;.
    * @param body  (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testBodyWithFileSchema(FileSchemaTestClass body) throws ApiException {
@@ -615,6 +617,7 @@ public class FakeApi {
    * 
    * @param query  (required)
    * @param body  (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testBodyWithQueryParams(String query, User body) throws ApiException {
@@ -820,6 +823,7 @@ public class FakeApi {
    * @param dateTime None (optional)
    * @param password None (optional)
    * @param paramCallback None (optional)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testEndpointParameters(BigDecimal number, Double _double, String patternWithoutDelimiter, byte[] _byte, Integer integer, Integer int32, Long int64, Float _float, String string, File binary, LocalDate date, OffsetDateTime dateTime, String password, String paramCallback) throws ApiException {
@@ -928,6 +932,7 @@ public class FakeApi {
    * @param enumQueryDouble Query parameter enum test (double) (optional)
    * @param enumFormStringArray Form parameter enum test (string array) (optional
    * @param enumFormString Form parameter enum test (string) (optional, default to -efg)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testEnumParameters(List<String> enumHeaderStringArray, String enumHeaderString, List<String> enumQueryStringArray, String enumQueryString, Integer enumQueryInteger, Double enumQueryDouble, List<String> enumFormStringArray, String enumFormString) throws ApiException {
@@ -1025,6 +1030,7 @@ public class FakeApi {
    * Fake endpoint to test group parameters (optional)
    * Fake endpoint to test group parameters (optional)
    * @param apiRequest {@link APItestGroupParametersRequest}
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testGroupParameters(APItestGroupParametersRequest apiRequest) throws ApiException {
@@ -1063,6 +1069,7 @@ public class FakeApi {
    * @param stringGroup String in group parameters (optional)
    * @param booleanGroup Boolean in group parameters (optional)
    * @param int64Group Integer in group parameters (optional)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testGroupParameters(Integer requiredStringGroup, Boolean requiredBooleanGroup, Long requiredInt64Group, Integer stringGroup, Boolean booleanGroup, Long int64Group) throws ApiException {
@@ -1247,6 +1254,7 @@ public class FakeApi {
    * test inline additionalProperties
    * 
    * @param param request body (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testInlineAdditionalProperties(Map<String, String> param) throws ApiException {
@@ -1330,6 +1338,7 @@ public class FakeApi {
    * 
    * @param param field1 (required)
    * @param param2 field2 (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testJsonFormData(String param, String param2) throws ApiException {
@@ -1415,6 +1424,7 @@ public class FakeApi {
    * @param http  (required)
    * @param url  (required)
    * @param context  (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> testQueryParameterCollectionFormat(List<String> pipe, List<String> ioutil, List<String> http, List<String> url, List<String> context) throws ApiException {

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

@@ -82,6 +82,7 @@ public class PetApi {
    * Add a new pet to the store
    * 
    * @param body Pet object that needs to be added to the store (required)
+   * @return CompletableFuture<Void>
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> addPet(Pet body) throws ApiException {
@@ -165,6 +166,7 @@ public class PetApi {
    * 
    * @param petId Pet id to delete (required)
    * @param apiKey  (optional)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> deletePet(Long petId, String apiKey) throws ApiException {
@@ -539,6 +541,7 @@ public class PetApi {
    * Update an existing pet
    * 
    * @param body Pet object that needs to be added to the store (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> updatePet(Pet body) throws ApiException {
@@ -623,6 +626,7 @@ public class PetApi {
    * @param petId ID of pet that needs to be updated (required)
    * @param name Updated name of the pet (optional)
    * @param status Updated status of the pet (optional)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> updatePetWithForm(Long petId, String name, String status) throws ApiException {

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

@@ -79,6 +79,7 @@ public class StoreApi {
    * Delete purchase order by ID
    * For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors
    * @param orderId ID of the order that needs to be deleted (required)
+   * @return CompletableFuture<Void>
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> deleteOrder(String orderId) throws ApiException {

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

@@ -80,6 +80,7 @@ public class UserApi {
    * Create user
    * This can only be done by the logged in user.
    * @param body Created user object (required)
+   * @return CompletableFuture<Void>
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> createUser(User body) throws ApiException {
@@ -162,6 +163,7 @@ public class UserApi {
    * Creates list of users with given input array
    * 
    * @param body List of user object (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> createUsersWithArrayInput(List<User> body) throws ApiException {
@@ -244,6 +246,7 @@ public class UserApi {
    * Creates list of users with given input array
    * 
    * @param body List of user object (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> createUsersWithListInput(List<User> body) throws ApiException {
@@ -326,6 +329,7 @@ public class UserApi {
    * Delete user
    * This can only be done by the logged in user.
    * @param username The name that needs to be deleted (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> deleteUser(String username) throws ApiException {
@@ -599,6 +603,7 @@ public class UserApi {
   /**
    * Logs out current logged in user session
    * 
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> logoutUser() throws ApiException {
@@ -671,6 +676,7 @@ public class UserApi {
    * This can only be done by the logged in user.
    * @param username name that need to be deleted (required)
    * @param body Updated user object (required)
+   * @return CompletableFuture&lt;Void&gt;
    * @throws ApiException if fails to make API call
    */
   public CompletableFuture<Void> updateUser(String username, User body) throws ApiException {

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

@@ -82,6 +82,9 @@ public class AdditionalPropertiesAnyType extends HashMap<String, Object> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesAnyType putAdditionalProperty(String key, Object value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesAnyType extends HashMap<String, Object> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Object> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesAnyType extends HashMap<String, Object> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Object getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

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

@@ -83,6 +83,9 @@ public class AdditionalPropertiesArray extends HashMap<String, List> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesArray putAdditionalProperty(String key, List value) {
@@ -94,7 +97,8 @@ public class AdditionalPropertiesArray extends HashMap<String, List> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, List> getAdditionalProperties() {
@@ -103,6 +107,8 @@ public class AdditionalPropertiesArray extends HashMap<String, List> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public List getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

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

@@ -82,6 +82,9 @@ public class AdditionalPropertiesBoolean extends HashMap<String, Boolean> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesBoolean putAdditionalProperty(String key, Boolean value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesBoolean extends HashMap<String, Boolean> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Boolean> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesBoolean extends HashMap<String, Boolean> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Boolean getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

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

@@ -82,6 +82,9 @@ public class AdditionalPropertiesInteger extends HashMap<String, Integer> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesInteger putAdditionalProperty(String key, Integer value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesInteger extends HashMap<String, Integer> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Integer> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesInteger extends HashMap<String, Integer> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Integer getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

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

@@ -83,6 +83,9 @@ public class AdditionalPropertiesNumber extends HashMap<String, BigDecimal> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesNumber putAdditionalProperty(String key, BigDecimal value) {
@@ -94,7 +97,8 @@ public class AdditionalPropertiesNumber extends HashMap<String, BigDecimal> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, BigDecimal> getAdditionalProperties() {
@@ -103,6 +107,8 @@ public class AdditionalPropertiesNumber extends HashMap<String, BigDecimal> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public BigDecimal getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

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

@@ -82,6 +82,9 @@ public class AdditionalPropertiesObject extends HashMap<String, Map> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesObject putAdditionalProperty(String key, Map value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesObject extends HashMap<String, Map> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Map> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesObject extends HashMap<String, Map> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Map getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

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

@@ -82,6 +82,9 @@ public class AdditionalPropertiesString extends HashMap<String, String> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesString putAdditionalProperty(String key, String value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesString extends HashMap<String, String> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, String> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesString extends HashMap<String, String> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public String getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/model/AdditionalPropertiesAnyType.java

@@ -82,6 +82,9 @@ public class AdditionalPropertiesAnyType extends HashMap<String, Object> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesAnyType putAdditionalProperty(String key, Object value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesAnyType extends HashMap<String, Object> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Object> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesAnyType extends HashMap<String, Object> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Object getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/model/AdditionalPropertiesArray.java

@@ -83,6 +83,9 @@ public class AdditionalPropertiesArray extends HashMap<String, List> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesArray putAdditionalProperty(String key, List value) {
@@ -94,7 +97,8 @@ public class AdditionalPropertiesArray extends HashMap<String, List> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, List> getAdditionalProperties() {
@@ -103,6 +107,8 @@ public class AdditionalPropertiesArray extends HashMap<String, List> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public List getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/model/AdditionalPropertiesBoolean.java

@@ -82,6 +82,9 @@ public class AdditionalPropertiesBoolean extends HashMap<String, Boolean> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesBoolean putAdditionalProperty(String key, Boolean value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesBoolean extends HashMap<String, Boolean> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Boolean> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesBoolean extends HashMap<String, Boolean> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Boolean getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/model/AdditionalPropertiesInteger.java

@@ -82,6 +82,9 @@ public class AdditionalPropertiesInteger extends HashMap<String, Integer> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesInteger putAdditionalProperty(String key, Integer value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesInteger extends HashMap<String, Integer> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Integer> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesInteger extends HashMap<String, Integer> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Integer getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/model/AdditionalPropertiesNumber.java

@@ -83,6 +83,9 @@ public class AdditionalPropertiesNumber extends HashMap<String, BigDecimal> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesNumber putAdditionalProperty(String key, BigDecimal value) {
@@ -94,7 +97,8 @@ public class AdditionalPropertiesNumber extends HashMap<String, BigDecimal> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, BigDecimal> getAdditionalProperties() {
@@ -103,6 +107,8 @@ public class AdditionalPropertiesNumber extends HashMap<String, BigDecimal> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public BigDecimal getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/model/AdditionalPropertiesObject.java

@@ -82,6 +82,9 @@ public class AdditionalPropertiesObject extends HashMap<String, Map> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesObject putAdditionalProperty(String key, Map value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesObject extends HashMap<String, Map> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, Map> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesObject extends HashMap<String, Map> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public Map getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {

samples/client/petstore/java/native/src/main/java/org/openapitools/client/model/AdditionalPropertiesString.java

@@ -82,6 +82,9 @@ public class AdditionalPropertiesString extends HashMap<String, String> {
   /**
    * Set the additional (undeclared) property with the specified name and value.
    * If the property does not already exist, create it otherwise replace it.
+   * @param key the name of the property
+   * @param value the value value of the property
+   * @return self reference
    */
   @JsonAnySetter
   public AdditionalPropertiesString putAdditionalProperty(String key, String value) {
@@ -93,7 +96,8 @@ public class AdditionalPropertiesString extends HashMap<String, String> {
   }
 
   /**
-   * Return the additional (undeclared) property.
+   * Return the additional (undeclared) properties.
+   * @return the additional (undeclared) properties
    */
   @JsonAnyGetter
   public Map<String, String> getAdditionalProperties() {
@@ -102,6 +106,8 @@ public class AdditionalPropertiesString extends HashMap<String, String> {
 
   /**
    * Return the additional (undeclared) property with the specified name.
+   * @param key the name of the property
+   * @return the additional (undeclared) property with the specified name
    */
   public String getAdditionalProperty(String key) {
     if (this.additionalProperties == null) {