低版的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效果图

接口说明

接口调试

个性化设置

接口离线文档

相关推荐
JosieBook16 分钟前
【Java编程动手学】Java中的数组与集合
java·开发语言·python
N_NAN_N32 分钟前
类图+案例+代码详解:软件设计模式----单例模式
java·单例模式·设计模式
weixin_3993806939 分钟前
k8s一键部署tongweb企业版7049m6(by why+lqw)
java·linux·运维·服务器·云原生·容器·kubernetes
lang201509281 小时前
Reactor ConnectableFlux支持多订阅者
java·网络
R-sz1 小时前
java流式计算 获取全量树形数据,非懒加载树,递归找儿
java·开发语言·windows
Ramos丶1 小时前
【ABAP】 从无到有 新建一个Webdynpro程序
java·前端·javascript
sniper_fandc1 小时前
SpringMVC详解
java·springmvc
TT哇2 小时前
【Java EE初阶】计算机是如何⼯作的
java·redis·java-ee
paopaokaka_luck2 小时前
基于SpringBoot+Vue的电影售票系统(协同过滤算法)
vue.js·spring boot·后端
陌殇殇5 小时前
SpringBoot整合SpringCache缓存
spring boot·redis·缓存