springboot dubbo resteasy 简易集成swagger

之前在springmvc中集成swagger，轻松加愉快，整套springfox进来，ui加api都有了。

现在的新项目，采用了springboot + dubbo + resteasy直出restful api的方式，轻便确实轻便，但是不如springmvc的资料多。不过，也让我在使用中，增加了更多的机会去了解底层。

翻了下swagger的文档，他是已经支持了resteasy了。于是拿来了他的demo看看，确实很方便，直接就能出api。几乎是0代码集成。他是使用servlet方式集成进去的。但是我的springboot，不支持在嵌入式servlet下用spi增加servlet。

所以我最后选用了直接添加service的方式。

 

首先增加一个config bean，创建一个openapicontext。后续可以用这个来得到swagger内容

@Configuration
public class SwaggerConfig {

    @Bean
    public OpenApiContext openApiContext(){
        Set> resources = new LinkedHashSet();

        // 仅抓取有tag注解的路径
        Set beanList = SpringContextUtils.getClassSetOfAnnotation(Tag.class);
        resources.addAll(beanList);

        OpenApiContext openApiContext = null;
        if (!resources.isEmpty()) {
            // init context
            try {
                SwaggerConfiguration oasConfig = new SwaggerConfiguration()
                        .resourceClasses(resources.stream().map(c -> c.getName()).collect(Collectors.toSet()));

                openApiContext = new JaxrsOpenApiContextBuilder()
                        .openApiConfiguration(oasConfig)
                        .buildContext(true);
            } catch (OpenApiConfigurationException e) {
                throw new RuntimeException(e.getMessage(), e);
            }
        }

        return openApiContext;
    }
}

 

然后写一个service，把swagger文档当成json内容返回出去。

 

@Service(interfaceClass = SwaggerDocService.class)
@Path("swaggerdoc")
public class SwaggerDocServiceImpl implements SwaggerDocService {

    @Autowired
    OpenApiContext openApiContext;  // 注入刚才的config bean

    @Path("/all")
    @GET
    public String doc(){

        boolean pretty = false; // json是否美化

        OpenAPI oas = openApiContext.read(); // oas里面包含了所有的文档内容
        try {
            // 格式化oas的内容
            String result = pretty ? Json.pretty(oas) : Json.mapper().writeValueAsString(oas);

            return result;
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
        return "";
    }
}

 

搞定，现在访问 127.0.0.1/swaggerdoc/all，就出来了。

想要来个ui？访问这里 http://petstore.swagger.io，里面贴上上面的地址，完美。