github.com/phrase/openapi@v0.0.0-20240514140800-49e8a106740e/openapi-generator/templates/java/api.mustache (about)

     1  {{>licenseInfo}}
     2  package {{package}};
     3  
     4  import com.sun.jersey.api.client.GenericType;
     5  
     6  import {{invokerPackage}}.ApiException;
     7  import {{invokerPackage}}.ApiClient;
     8  import {{invokerPackage}}.Configuration;
     9  import {{modelPackage}}.*;
    10  import {{invokerPackage}}.Pair;
    11  
    12  {{#imports}}import {{import}};
    13  {{/imports}}
    14  
    15  
    16  {{^fullJavaUtil}}
    17  import java.util.ArrayList;
    18  import java.util.HashMap;
    19  import java.util.List;
    20  import java.util.Map;
    21  {{/fullJavaUtil}}
    22  
    23  {{>generatedAnnotation}}
    24  {{#operations}}
    25  public class {{classname}} {
    26    private ApiClient apiClient;
    27  
    28    public {{classname}}() {
    29      this(Configuration.getDefaultApiClient());
    30    }
    31  
    32    public {{classname}}(ApiClient apiClient) {
    33      this.apiClient = apiClient;
    34    }
    35  
    36    public ApiClient getApiClient() {
    37      return apiClient;
    38    }
    39  
    40    public void setApiClient(ApiClient apiClient) {
    41      this.apiClient = apiClient;
    42    }
    43  
    44    {{#operation}}
    45    /**
    46     * {{summary}}
    47     * {{notes}}
    48     {{#allParams}}
    49     * @param {{paramName}} {{description}}{{#required}} (required){{/required}}{{^required}} (optional{{^isContainer}}{{#defaultValue}}, default to {{.}}{{/defaultValue}}){{/isContainer}}{{/required}}
    50     {{/allParams}}
    51     {{#returnType}}
    52     * @return {{returnType}}
    53     {{/returnType}}
    54     * @throws ApiException if fails to make API call
    55     {{#isDeprecated}}
    56     * @deprecated
    57     {{/isDeprecated}}
    58     {{#externalDocs}}
    59     * {{description}}
    60     * @see <a href="{{url}}">{{summary}} Documentation</a>
    61     {{/externalDocs}}
    62     */
    63    {{#isDeprecated}}
    64    @Deprecated
    65    {{/isDeprecated}}
    66    public {{#returnType}}{{{returnType}}} {{/returnType}}{{^returnType}}void {{/returnType}}{{operationId}}({{#allParams}}{{{dataType}}} {{paramName}}{{^-last}}, {{/-last}}{{/allParams}}) throws ApiException {
    67      Object localVarPostBody = {{#bodyParam}}{{paramName}}{{/bodyParam}}{{^bodyParam}}null{{/bodyParam}};
    68      {{#allParams}}{{#required}}
    69      // verify the required parameter '{{paramName}}' is set
    70      if ({{paramName}} == null) {
    71        throw new ApiException(400, "Missing the required parameter '{{paramName}}' when calling {{operationId}}");
    72      }
    73      {{/required}}{{/allParams}}
    74      // create path and map variables
    75      String localVarPath = "{{{path}}}"{{#pathParams}}
    76        .replaceAll("\\{" + "{{baseName}}" + "\\}", apiClient.escapeString({{{paramName}}}.toString())){{/pathParams}};
    77  
    78      // query params
    79      {{javaUtilPrefix}}List<Pair> localVarQueryParams = new {{javaUtilPrefix}}ArrayList<Pair>();
    80      {{javaUtilPrefix}}List<Pair> localVarCollectionQueryParams = new {{javaUtilPrefix}}ArrayList<Pair>();
    81      {{javaUtilPrefix}}Map<String, String> localVarHeaderParams = new {{javaUtilPrefix}}HashMap<String, String>();
    82      {{javaUtilPrefix}}Map<String, String> localVarCookieParams = new {{javaUtilPrefix}}HashMap<String, String>();
    83      {{javaUtilPrefix}}Map<String, Object> localVarFormParams = new {{javaUtilPrefix}}HashMap<String, Object>();
    84  
    85      {{#queryParams}}
    86      {{#collectionFormat}}localVarCollectionQueryParams.addAll(apiClient.parameterToPairs("{{{collectionFormat}}}", {{/collectionFormat}}{{^collectionFormat}}localVarQueryParams.addAll(apiClient.parameterToPair({{/collectionFormat}}"{{baseName}}", {{paramName}}));
    87      {{/queryParams}}
    88  
    89      {{#headerParams}}if ({{paramName}} != null)
    90        localVarHeaderParams.put("{{baseName}}", apiClient.parameterToString({{paramName}}));
    91      {{/headerParams}}
    92  
    93      {{#cookieParams}}if ({{paramName}} != null)
    94        localVarCookieParams.put("{{baseName}}", apiClient.parameterToString({{paramName}}));
    95      {{/cookieParams}}
    96  
    97      {{#formParams}}if ({{paramName}} != null)
    98        localVarFormParams.put("{{baseName}}", {{paramName}});
    99      {{/formParams}}
   100  
   101      final String[] localVarAccepts = {
   102        {{#produces}}"{{{mediaType}}}"{{^-last}}, {{/-last}}{{/produces}}
   103      };
   104      final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);
   105  
   106      final String[] localVarContentTypes = {
   107        {{#consumes}}"{{{mediaType}}}"{{^-last}}, {{/-last}}{{/consumes}}
   108      };
   109      final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
   110  
   111      String[] localVarAuthNames = new String[] { {{#authMethods}}"{{name}}"{{^-last}}, {{/-last}}{{/authMethods}} };
   112  
   113      {{#returnType}}
   114      GenericType<{{{returnType}}}> localVarReturnType = new GenericType<{{{returnType}}}>() {};
   115      return apiClient.invokeAPI(localVarPath, "{{httpMethod}}", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarCookieParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
   116      {{/returnType}}{{^returnType}}
   117      apiClient.invokeAPI(localVarPath, "{{httpMethod}}", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarCookieParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, null);
   118      {{/returnType}}
   119    }
   120    {{/operation}}
   121  }
   122  {{/operations}}