文章 35
评论 3
浏览 83246
SpringDoc 3.0 接入

SpringDoc 3.0 接入

一、简介 1.1 OpenApi 简介 OpenApi是业界真正的 api 文档标准,一个规范,好比java里面一个抽象的概念。它即是一个抽象类,只是提供了一个api文档规范的抽象方法,该方法目前被量大非官方实现了,一个是springfox,另一个是springdoc。 1.2 SpringFox简介 SpringFox是 spring 社区维护的一个项目(非官方),帮助使用者将 swagger2 集成到 Spring 中。常常用于 Spring 中帮助开发者生成文档,并可以轻松的在spring boot中使用。 目前也已支持 OpenAPI3 标准。 此版本实现较springdoc来讲,实现不是很规范和正式,少了很多架构上的灵活性,维护更新也不如springdoc活跃。因此笔者推荐大家使用springdoc,弃用springfox。 1.3 SpringDoc简介 官方文档:https://springdoc.org/ springdoc-openapi Java库有助于使用Spring Boot项目自动生成API文档。springdoc-openapi的工作原理是在运行时检查....

【SpringFox-Swagger3 注解篇】 一、 @ApiModel 介绍使用

【SpringFox-Swagger3 注解篇】 一、 @ApiModel 介绍使用

Swagger3 注解-@ApiModel 一、简介 1.1 描述 用于响应实体类上,用于说明实体作用 1.2 官方描述: Provides additional information about Swagger models. Classes will be introspected automatically as they are used as types in operations, but you may want to manipulate the structure of the models. 1.3 源码定义 @Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Inherited public @interface ApiModel { String value() default ""; String description() default ""; Class<?> parent() default Void.class; String discriminator(....

修仙猿之旅