0

我有一个要求，我需要在我的微服务中有一个返回文档的 GET 端点，我io.swagger.v3.oas.models.OpenAPI想知道如何编写该对象。原始形式的对象如下所示：

{
"openapi": "3.0.1",
"info": {
"title": "MY API",
"description": "API for accessing stuff and other stuff.",
"termsOfService": "http://website.com",
"contact": {
  "name": "Some chap",
  "url": "https://website.com/s/url",
  "email": "alwaysReplyAll@office.com"
},
"version": "1.0"
},
"paths": {
"/v1/user/{id}/properties": {
  "get": { ...etc etc

我试过这个，但文件刚刚出现空/空白：

@GetMapping("/openapi3")
public @ResponseBody OpenAPI swag() {
     OpenAPI swagDoc = new OpenAPI();
     GenericOpenApiContextBuilder builder = new GenericOpenApiContextBuilder();

    try {
        swagDoc = builder.buildContext(true).read();
    } catch (OpenApiConfigurationException e) {
        // handle error        
}
    return swagDoc;
}

我已经阅读了有关 springfox 的信息，但是他们文档中的示例不是很清楚……我想知道这是否有必要。我在这个构建器上做错了什么？

顺便说一句，使用 Gradle

4

2 回答 2

0

根据评论中的讨论，您可以修改此方法，不需要使用 WebClient。我必须在我的招摇服务中找到文档，并使用此代码。您不会返回 OpenAPI 对象，您只需返回一个字符串，因为您已经拥有原始 json。

getV2SwaggerDoc(新 URL("..."));

private String getV2SwaggerDoc(URL url) throws IOException {
    HttpURLConnection connection = (HttpURLConnection)url.openConnection();

    connection.setRequestMethod(RequestMethod.GET.toString());

    BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream(), "UTF-8"));

    StringBuffer stringBuffer = new StringBuffer();

    String line;

    while ((line = reader.readLine()) != null)
        stringBuffer.append(line);

    reader.close();

    connection.disconnect();

    return stringBuffer.toString();
}
于 2020-03-26T22:10:25.533 回答
0

我能够通过利用 Spring 的 RestTemplate 而不是 java 的低级 HTTP 库来简化接受的答案

private String retrieveSwaggerJson(String url) {
    return new RestTemplate()
            .getForEntity(url, String.class)
            .getBody();
}
于 2020-03-28T20:51:37.720 回答