这里先写下需要的pom.xml配置(我引用的2.4.0,相对稳定)
在集成springfox-swagger2之前,我也尝试着集成了swagger-springmvc,方式差不多,但是swagger-springmvc相对麻烦一点,因为要把它的静态文件copy到自己的项目中。所以还是用新版本的。
至于两者有什么不同,为什么进行版本变更请参见官方说明文档这里先写下需要的pom.xml配置(我引用的2.4.0,相对稳定)
<dependency>
<groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.4.0</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.4.0</version> </dependency> 还需要在spring-mvc.xml中添加映射静态的配置:<mvc:default-servlet-handler />
然后就是swagger2的配置类:
package com.xingguo.logistics.swagger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;import springfox.documentation.builders.RequestHandlerSelectors;import springfox.documentation.service.ApiInfo;import springfox.documentation.service.Contact;import springfox.documentation.spi.DocumentationType;import springfox.documentation.spring.web.plugins.Docket;import springfox.documentation.swagger2.annotations.EnableSwagger2;@Configuration
@EnableSwagger2public class SwaggerConfig {@Bean
public Docket buildDocket(){ return new Docket(DocumentationType.SWAGGER_2) .apiInfo(buildApiInf()) .select() .apis(RequestHandlerSelectors.basePackage("com.xingguo.logistics.controller"))//controller路径 .paths(PathSelectors.any()) .build(); }private ApiInfo buildApiInf(){
return new ApiInfoBuilder() .title("xingguo大标题") .termsOfServiceUrl("http://blog.csdn.net/u014231523网址链接") .description("springmvc swagger2") .contact(new Contact("diaoxingguo", "http://blog.csdn.net/u014231523", "diaoxingguo@163.com")) .build();}
}然后运行项目,输入自己的url。
http://{ip}:{port}/{projectname}/swagger-ui.html#/ 我的url: http://localhost:8989/logistics/swagger-ui.html#/