1

按照这里的文档 - https://micronaut-projects.github.io/micronaut-openapi/1.3.4/guide/index.html

我将我的配置build.gradle为包含用于 swagger yaml 生成的编译时任务,如下所示 -

tasks.withType(JavaCompile){
    options.encoding = "UTF-8"
    options.compilerArgs.add('-parameters')
    options.fork = true
    options.forkOptions.jvmArgs << '-Dmicronaut.openapi.views.spec=rapidoc.enabled=true,swagger-ui.enabled=true,swagger-ui.theme=flattop'
}

这就是我的application.yaml样子——

micronaut:
  server:
    port: 9090
    cors:
      enabled: true
  router:
    static-resources:
      swagger:
        paths: classpath:META-INF/swagger
        mapping: /swagger/**
      redoc:
        paths: classpath:META-INF/swagger/views/redoc
        mapping: /redoc/**
      rapidoc:
        paths: classpath:META-INF/swagger/views/rapidoc
        mapping: /rapidoc/**
      swagger-ui:
        paths: classpath:META-INF/swagger/views/swagger-ui
        mapping: /swagger-ui/**

就像医生说的那样,我也注释Application.java如下-

package com.api.backend;

import io.micronaut.runtime.Micronaut;
import io.swagger.v3.oas.annotations.OpenAPIDefinition;
import io.swagger.v3.oas.annotations.info.Contact;
import io.swagger.v3.oas.annotations.info.Info;

@OpenAPIDefinition(
    info = @Info(
            title = "API Backend",
            version = "0.0",
            description = "API backend"
    )
)
public class Application {

    public static void main(String[] args) {
        Micronaut.run(Application.class);
    }
}

完成所有这些之后,当我尝试打开http://localhost:9090/swagger/api-backend-0.0.yaml它时,它会打开生成的开放 API 规范 yaml。但是,如果我尝试打开http://localhost:9090/swagger-ui/,我会得到一个404.

谁能帮我找出问题或提出替代方案?

4

3 回答 3

1

您可以添加以下代码并检查吗,因为所有文件都在swagger-ui

  router:
    static-resources:
      default:
        enabled: true
        mapping: /**
        paths: classpath:swagger
      swagger:
        paths: classpath:META-INF/swagger
        mapping: /swagger/**
      swagger-ui:
        paths: classpath:META-INF/swagger/views/swagger-ui
        mapping: /swagger-ui/**
于 2021-05-19T10:25:02.017 回答
0

所有步骤对我来说都是正确的。

您能否在构建项目后检查是否在您的工件中的 META-INF/swagger/views/swagger-ui 下创建了 index.html 文件。

从 maven 的角度来看,我们在运行 mvn compile 后在 target 文件夹下看到这个:target/classes/META_INF/swagger/views/swagger-ui

于 2020-05-11T14:05:59.287 回答
0

配置看起来不错,swagger-ui 应该可以在浏览器中使用http://localhost:8080/swagger-ui

于 2021-05-06T22:28:59.420 回答