如何在从 SmartBear/Swagger 生成的代码生成 Java REST API 中实现自定义逻辑

时间:2021-01-02 16:51:49

标签: java swagger openapi swagger-codegen openapi-generator

我已经按照 Swagger/OpenAPI 3.0 标准在 .yaml 文件中定义了 API 文档/端点。在这个 .yaml 文件中,我使用了 SwaggerHub/SmartBear 的代码生成工具来为 Client SDK java 项目生成代码。成功生成的项目代码如下结构:

- docs
- gradle
- lib
- src
  - main
    - java
      - io.swagger.client
        - api
          - RouteApi
          - myApi.yaml
        - auth
          - ApiKeyAuth
          - Authentication
          - HttpBasicAuth
          - OAuth
          - OAuthFlow
        - model
          - Input
          - ModelApiResponse
          - Route
        - ApiCallback
        - ApiClient         
        - ApiException
        - ApiResponse
        - Configuration
        - GzipRequestInterceptor
        - JSON
          - DateTypeAdapter
          - LocalDateTypeAdapter
          - OffsetDateTimeTypeAdapter
          - SqlDateTypeAdapter
        - Pair
        - ProgressRequestBody
          - ProgressRequestListener
        - ProgressResponseBody
          - ProegressListener
    - AndroidMainfest.xml
  - test
- target
- pom.xml
- swagger-java-client-iml
- README.md

生成的项目结构相当复杂,我不确定如何以及在何处实现我的自定义 java 逻辑以处理 Api 请求。简单来说就是需要取入多个字符串参数,输出多个字符串参数。

另外,我不确定如何在 IntelliJ IDEA 中运行/发布生成的 API,这是我目前使用的 IDE。

README 文件建议我运行以下 java 代码:

import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.RouteApi;

import java.io.File;
import java.util.*;

public class RouteApiExample {

    public static void main(String[] args) {
        
        RouteApi apiInstance = new RouteApi();
        List<Input> body = Arrays.asList(new Input()); // List<Input> | List of input object
        try {
            apiInstance.createRoutesWithArrayInput(body);
        } catch (ApiException e) {
            System.err.println("Exception when calling RouteApi#createRoutesWithArrayInput");
            e.printStackTrace();
        }
    }
}

但这只是编译而没有结果。

总而言之,如果您有任何关于使用 SmartBear 的代码生成工具在 Java 中从 OpenAPI3.0/swagger 文档生成的 API 中实现自定义逻辑的资源、建议或教程,我将不胜感激。

0 个答案:

没有答案
相关问题