Add auto-generated sample codes

Author: rickyma

samples/client/echo_api/java/okhttp-gson-user-defined-templates/.openapi-generator/FILES

@@ -5,6 +5,7 @@ api/openapi.yaml
 build.gradle
 build.sbt
 docs/Category.md
+docs/Color.md
 docs/ModelApiResponse.md
 docs/Order.md
 docs/Pet.md
@@ -21,6 +22,7 @@ gradlew
 gradlew.bat
 info.md
 modelCopy/Category.java
+modelCopy/Color.java
 modelCopy/ModelApiResponse.java
 modelCopy/Order.java
 modelCopy/Pet.java
@@ -55,8 +57,10 @@ src/main/java/org/openapitools/client/auth/OAuthOkHttpClient.java
 src/main/java/org/openapitools/client/auth/RetryingOAuth.java
 src/main/java/org/openapitools/client/model/AbstractOpenApiSchema.java
 src/main/java/org/openapitools/client/model/Category.java
+src/main/java/org/openapitools/client/model/Color.java
 src/main/java/org/openapitools/client/model/ModelApiResponse.java
 src/main/java/org/openapitools/client/model/Order.java
 src/main/java/org/openapitools/client/model/Pet.java
 src/main/java/org/openapitools/client/model/Tag.java
 src/main/java/org/openapitools/client/model/User.java
+src/test/java/org/openapitools/client/model/ColorTest.java

samples/client/echo_api/java/okhttp-gson-user-defined-templates/api/openapi.yaml

@@ -130,6 +130,38 @@ paths:
       x-accepts:
       - application/json
       - application/xml
+  /pet/findByColor:
+    get:
+      description: Returns pets filtered by color.
+      operationId: findPetsByColor
+      parameters:
+      - description: Color of the pet to filter by
+        explode: true
+        in: query
+        name: color
+        required: false
+        schema:
+          $ref: '#/components/schemas/Color'
+        style: form
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                items:
+                  $ref: '#/components/schemas/Pet'
+                type: array
+          description: successful operation
+        "400":
+          description: Invalid color value
+      security:
+      - petstore_auth:
+        - read:pets
+      summary: Finds Pets by color
+      tags:
+      - pet
+      x-accepts:
+      - application/json
   /pet/findByTags:
     get:
       deprecated: true
@@ -819,6 +851,18 @@ components:
       type: object
       xml:
         name: Pet
+    Color:
+      description: pet color in the store
+      enum:
+      - black
+      - white
+      - brown
+      - golden
+      - mixed
+      title: Pet Color
+      type: string
+      xml:
+        name: Pet
     ApiResponse:
       description: Describes the result of uploading an image resource
       example:

samples/client/echo_api/java/okhttp-gson-user-defined-templates/docs/Color.md

@@ -0,0 +1,19 @@
+
+
+# Color
+
+## Enum
+
+
+* `BLACK` (value: `"black"`)
+
+* `WHITE` (value: `"white"`)
+
+* `BROWN` (value: `"brown"`)
+
+* `GOLDEN` (value: `"golden"`)
+
+* `MIXED` (value: `"mixed"`)
+
+
+

samples/client/echo_api/java/okhttp-gson-user-defined-templates/docs/PetApiDocumentation.md

@@ -6,6 +6,7 @@ All URIs are relative to *http://petstore.swagger.io/v2*
 |------------- | ------------- | -------------|
 | [**addPet**](PetApi.md#addPet) | **POST** /pet | Add a new pet to the store |
 | [**deletePet**](PetApi.md#deletePet) | **DELETE** /pet/{petId} | Deletes a pet |
+| [**findPetsByColor**](PetApi.md#findPetsByColor) | **GET** /pet/findByColor | Finds Pets by color |
 | [**findPetsByStatus**](PetApi.md#findPetsByStatus) | **GET** /pet/findByStatus | Finds Pets by status |
 | [**findPetsByTags**](PetApi.md#findPetsByTags) | **GET** /pet/findByTags | Finds Pets by tags |
 | [**getPetById**](PetApi.md#getPetById) | **GET** /pet/{petId} | Find pet by ID |
@@ -150,6 +151,74 @@ null (empty response body)
 |-------------|-------------|------------------|
 | **400** | Invalid pet value |  -  |
 
+<a id="findPetsByColor"></a>
+# **findPetsByColor**
+> List&lt;Pet&gt; findPetsByColor(color)
+
+Finds Pets by color
+
+Returns pets filtered by color.
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io/v2");
+    
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Color color = Color.fromValue("black"); // Color | Color of the pet to filter by
+    try {
+      List<Pet> result = apiInstance.findPetsByColor(color);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling PetApi#findPetsByColor");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}
+```
+
+### Parameters
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **color** | [**Color**](.md)| Color of the pet to filter by | [optional] [enum: black, white, brown, golden, mixed] |
+
+### Return type
+
+[**List&lt;Pet&gt;**](Pet.md)
+
+### Authorization
+
+[petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | successful operation |  -  |
+| **400** | Invalid color value |  -  |
+
 <a id="findPetsByStatus"></a>
 # **findPetsByStatus**
 > List&lt;Pet&gt; findPetsByStatus(status)

samples/client/echo_api/java/okhttp-gson-user-defined-templates/info.md

@@ -121,6 +121,7 @@ Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
 *PetApi* | [**addPet**](docs/PetApi.md#addPet) | **POST** /pet | Add a new pet to the store
 *PetApi* | [**deletePet**](docs/PetApi.md#deletePet) | **DELETE** /pet/{petId} | Deletes a pet
+*PetApi* | [**findPetsByColor**](docs/PetApi.md#findPetsByColor) | **GET** /pet/findByColor | Finds Pets by color
 *PetApi* | [**findPetsByStatus**](docs/PetApi.md#findPetsByStatus) | **GET** /pet/findByStatus | Finds Pets by status
 *PetApi* | [**findPetsByTags**](docs/PetApi.md#findPetsByTags) | **GET** /pet/findByTags | Finds Pets by tags
 *PetApi* | [**getPetById**](docs/PetApi.md#getPetById) | **GET** /pet/{petId} | Find pet by ID
@@ -144,6 +145,7 @@ Class | Method | HTTP request | Description
 ## Documentation for Models
 
  - [Category](docs/Category.md)
+ - [Color](docs/Color.md)
  - [ModelApiResponse](docs/ModelApiResponse.md)
  - [Order](docs/Order.md)
  - [Pet](docs/Pet.md)

samples/client/echo_api/java/okhttp-gson-user-defined-templates/modelCopy/Color.java

@@ -0,0 +1,150 @@
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.google.gson.JsonArray;
+import com.google.gson.JsonDeserializationContext;
+import com.google.gson.JsonDeserializer;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParseException;
+import com.google.gson.TypeAdapterFactory;
+import com.google.gson.reflect.TypeToken;
+import com.google.gson.TypeAdapter;
+import com.google.gson.stream.JsonReader;
+import com.google.gson.stream.JsonWriter;
+import java.io.IOException;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import org.openapitools.client.JSON;
+
+/**
+ * Color
+ */
+@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.13.0-SNAPSHOT")
+public class Color {
+  public Color() {
+  }
+
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    return true;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash();
+  }
+
+  @Override
+  public String toString() {
+    StringBuilder sb = new StringBuilder();
+    sb.append("class Color {\n");
+    sb.append("}");
+    return sb.toString();
+  }
+
+  /**
+   * Convert the given object to string with each line indented by 4 spaces
+   * (except the first line).
+   */
+  private String toIndentedString(Object o) {
+    if (o == null) {
+      return "null";
+    }
+    return o.toString().replace("\n", "\n    ");
+  }
+
+
+  public static HashSet<String> openapiFields;
+  public static HashSet<String> openapiRequiredFields;
+
+  static {
+    // a set of all properties/fields (JSON key names)
+    openapiFields = new HashSet<String>();
+
+    // a set of required properties/fields (JSON key names)
+    openapiRequiredFields = new HashSet<String>();
+  }
+
+  /**
+   * Validates the JSON Element and throws an exception if issues found
+   *
+   * @param jsonElement JSON Element
+   * @throws IOException if the JSON Element is invalid with respect to Color
+   */
+  public static void validateJsonElement(JsonElement jsonElement) throws IOException {
+      if (jsonElement == null) {
+        if (!Color.openapiRequiredFields.isEmpty()) { // has required fields but JSON element is null
+          throw new IllegalArgumentException(String.format("The required field(s) %s in Color is not found in the empty JSON string", Color.openapiRequiredFields.toString()));
+        }
+      }
+
+      Set<Map.Entry<String, JsonElement>> entries = jsonElement.getAsJsonObject().entrySet();
+      // check to see if the JSON string contains additional fields
+      for (Map.Entry<String, JsonElement> entry : entries) {
+        if (!Color.openapiFields.contains(entry.getKey())) {
+          throw new IllegalArgumentException(String.format("The field `%s` in the JSON string is not defined in the `Color` properties. JSON: %s", entry.getKey(), jsonElement.toString()));
+        }
+      }
+  }
+
+  public static class CustomTypeAdapterFactory implements TypeAdapterFactory {
+    @SuppressWarnings("unchecked")
+    @Override
+    public <T> TypeAdapter<T> create(Gson gson, TypeToken<T> type) {
+       if (!Color.class.isAssignableFrom(type.getRawType())) {
+         return null; // this class only serializes 'Color' and its subtypes
+       }
+       final TypeAdapter<JsonElement> elementAdapter = gson.getAdapter(JsonElement.class);
+       final TypeAdapter<Color> thisAdapter
+                        = gson.getDelegateAdapter(this, TypeToken.get(Color.class));
+
+       return (TypeAdapter<T>) new TypeAdapter<Color>() {
+           @Override
+           public void write(JsonWriter out, Color value) throws IOException {
+             JsonObject obj = thisAdapter.toJsonTree(value).getAsJsonObject();
+             elementAdapter.write(out, obj);
+           }
+
+           @Override
+           public Color read(JsonReader in) throws IOException {
+             JsonElement jsonElement = elementAdapter.read(in);
+             validateJsonElement(jsonElement);
+             return thisAdapter.fromJsonTree(jsonElement);
+           }
+
+       }.nullSafe();
+    }
+  }
+
+  /**
+   * Create an instance of Color given an JSON string
+   *
+   * @param jsonString JSON string
+   * @return An instance of Color
+   * @throws IOException if the JSON string is invalid with respect to Color
+   */
+  public static Color fromJson(String jsonString) throws IOException {
+    return JSON.getGson().fromJson(jsonString, Color.class);
+  }
+
+  /**
+   * Convert an instance of Color to an JSON string
+   *
+   * @return JSON string
+   */
+  public String toJson() {
+    return JSON.getGson().toJson(this);
+  }
+}