低版的spring boot 1.X接入knife4j

低版的spring boot 1.X接入knife4j

老的项目是用spring boot 1.5.10.RELEASE 不好升级 ,原来接口文档一直用的是老的swagger样式,不是很好看,网上查了下,发现有个knife4j挺好看的,用一下他们的样式,下面是接入详细

Maven中引入Jar包

由于是springfox-swagger的增强UI包,所以基础功能依然依赖Swagger,springfox-swagger的jar包必须引入
io.springfox springfox-swagger2 2.9.2 然后引入SwaggerBootstrapUi的jar包 com.github.xiaoymin swagger-bootstrap-ui ${lastVersion} 编写Swagger2Config配置文件 Swagger2Config配置文件如下:

@Configuration

@EnableSwagger2

public class SwaggerConfiguration {

@Bean

public Docket createRestApi() {

return new Docket(DocumentationType.SWAGGER_2)

.apiInfo(apiInfo())

.select()

.apis(RequestHandlerSelectors.basePackage("com.bycdao.cloud"))

.paths(PathSelectors.any())

.build();

}

private ApiInfo apiInfo() {

return new ApiInfoBuilder()

.title("swagger-bootstrap-ui RESTful APIs")

.description("swagger-bootstrap-ui")

.termsOfServiceUrl("http://localhost:8999/")

.contact("developer@mail.com")

.version("1.0")

.build();

}

}

访问地址

swagger-bootstrap-ui默认访问地址是:http:// h o s t : {host}: host:{port}/doc.html

注意事项

Springfox-swagger默认提供了两个Swagger接口,需要开发者放开权限(如果使用shiro权限控制框架等),如果使用SwaggerBootstrapUi的增强功能,还需放开增强接口地址,所以,放开的权限接口包括3个,分别是:

/swagger-resources:Swagger的分组接口

/v2/api-docs?group=groupName:Swagger的具体分组实例接口,返回该分组下所有接口相关的Swagger信息

/v2/api-docs-ext?group=groupName:该接口是SwaggerBootstrapUi提供的增强接口地址,如不使用UI增强,则可以忽略该接口

Shiro的相关配置实例如下:
/swagger-resources = anon /v2/api-docs = anon /v2/api-docs-ext = anon /doc.html = anon /webjars/** = anon

复制代码
    //others....
</value>    

SpringBoot中访问doc.html报404的解决办法

实现SpringBoot的WebMvcConfigurer接口,添加相关的ResourceHandler,代码如下:

@SpringBootApplication

@ConditionalOnClass(SpringfoxWebMvcConfiguration.class)

public class SwaggerBootstrapUiDemoApplication implements WebMvcConfigurer{

复制代码
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
	registry.addResourceHandler("doc.html").addResourceLocations("classpath:/META-INF/resources/");
	registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
}

}

使用SpringMvc的朋友.在web.xml中配置了DispatcherServlet,则需要追加一个url匹配规则,如下
cmsMvc org.springframework.web.servlet.DispatcherServlet contextConfigLocation classpath:config/spring.xml 1 cmsMvc *.htm cmsMvc /v2/api-docs cmsMvc /swagger-resources cmsMvc /v2/api-docs-ext

UI效果图

接口说明

接口调试

个性化设置

接口离线文档

相关推荐
木棉软糖2 小时前
一个MySQL的数据表最多能够存多少的数据?
java
魔尔助理顾问2 小时前
系统整理Python的循环语句和常用方法
开发语言·后端·python
程序视点3 小时前
Java BigDecimal详解:小数精确计算、使用方法与常见问题解决方案
java·后端
GEM的左耳返3 小时前
Java面试全攻略:Spring生态与微服务架构实战
spring boot·redis·spring cloud·微服务·kafka·java面试
愿你天黑有灯下雨有伞3 小时前
Spring Boot SSE实战:SseEmitter实现多客户端事件广播与心跳保活
java·spring boot·spring
你的人类朋友3 小时前
❤️‍🔥微服务的拆分策略
后端·微服务·架构
Java初学者小白3 小时前
秋招Day20 - 微服务
java
狐小粟同学4 小时前
JavaEE--3.多线程
java·开发语言·java-ee
AI小智4 小时前
后端变全栈,终于可以给大家推出我的LangChain学习小站了!
后端
KNeeg_5 小时前
Spring循环依赖以及三个级别缓存
java·spring·缓存