swagger3融入springboot

标签：

放controller上面

@Api(description = "xxx")

放方法上面

@Operation(summary = "xxx")

引入：

我用的是swagger3.X

需要在yml配置文件中加上：

spring:mvc:pathmatch:matching-strategy: ant_path_matcher

然后生成文档

<!--        生成文档--><!-- swagger3 --><dependency><groupId>io.springfox</groupId><artifactId>springfox-boot-starter</artifactId><version>3.0.0</version></dependency><dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId><version>2.0.0</version></dependency>

生成文档路径：

http://localhost:8080/swagger-ui/index.html

如果生成不了文档，加上这个：

package com.hz.appointment.config;import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;/*** @Project: StudentPsychologicalAppointment* @Description：swagger的配置*/
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("/swagger-ui/**").addResourceLocations("classpath:/META-INF/resources/webjars/springfox-swagger-ui/").resourceChain(false);registry.addResourceHandler("/swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");}
}