在springboot中整合jersey和springfox-swagger2

最新推荐文章于 2022-02-15 11:14:44 发布
最新推荐文章于 2022-02-15 11:14:44 发布
阅读量2.4k 收藏 2
点赞数
分类专栏： swagger jersey

前言

为了实现RESTful Webservice和接口说明，基于springboot平台，使用jersey作为JAX-RS的实现，采用swagger文档在线生成工具。

提要

在实现了springboot集成jersey的swagger文档功能，同时满足SpringMVC 整合swagger提供RESTful文档功能。

  • Springboot  集成swagger 通过springfox-swagger2实现SpringMVC的RESTful文档接口服务；

  • Springboot  集成 Jersey 通过swagger-jersey2-jaxrs 实现Jersey的文档接口服务；

 

环境

Springboot  1.5.1.RELEASE

springfox-swagger 2 2.6.1

swagger  1.5.12

 

详细配置

1、Pom文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
     < properties >
         < project.build.sourceEncoding >UTF-8</ project.build.sourceEncoding >
         < swagger.version >1.5.12</ swagger.version >
         < springfox-swagger2.version >2.6.1</ springfox-swagger2.version >
         < spring.boot.version >1.5.1.RELEASE</ spring.boot.version >
     </ properties >
 
     < repositories >
         < repository >
             < id >spring-releases</ id >
             < url >https://repo.spring.io/libs-release</ url >
         </ repository >
     </ repositories >
 
     < parent >
         < groupId >org.springframework.boot</ groupId >
         < artifactId >spring-boot-starter-parent</ artifactId >
         < version >1.5.1.RELEASE</ version >
     </ parent >
 
     < dependencies >
         < dependency >
             < groupId >org.springframework.boot</ groupId >
             < artifactId >spring-boot-starter-web</ artifactId >
         </ dependency >
         <!-- 支持自动确定版本路径： 写法由：link rel='stylesheet' href='/webjars/bootstrap/3.1.0/css/bootstrap.min.css' 
             变为： link rel='stylesheet' href='/webjars/bootstrap/css/bootstrap.min.css' -->
         < dependency >
             < groupId >org.webjars</ groupId >
             < artifactId >webjars-locator</ artifactId >
             < version >0.32</ version >
             < exclusions >
                 < exclusion >
                     < groupId >org.apache.commons</ groupId >
                     < artifactId >commons-lang3</ artifactId >
                 </ exclusion >
             </ exclusions >
         </ dependency >
 
         <!-- springboot 集成 jersey 、swagger 实现 JAX-RS Restful 開始 -->
         < dependency >
             < groupId >org.springframework.boot</ groupId >
             < artifactId >spring-boot-starter-jersey</ artifactId >
         </ dependency >
         < dependency >
             < groupId >io.swagger</ groupId >
             < artifactId >swagger-jersey2-jaxrs</ artifactId >
             < version >${swagger.version}</ version >
         </ dependency >
         <!-- swagger 静态资源 -->
         < dependency >
             < groupId >org.webjars</ groupId >
             < artifactId >swagger-ui</ artifactId >
             < version >2.2.10</ version >
         </ dependency >
         < dependency >
             < groupId >org.glassfish.hk2</ groupId >
             < artifactId >spring-bridge</ artifactId >
             < version >2.5.0-b34</ version >
         </ dependency >
         <!-- springboot 集成 jersey 、swagger 实现 JAX-RS Restful 結束 -->
 
         <!-- springboot 集成 swagger 实现SpringMVC Restful 開始 -->
         <!-- 解决 springfox-swagger 依赖swagger版本过低问题 -->
         < dependency >
             < groupId >io.swagger</ groupId >
             < artifactId >swagger-annotations</ artifactId >
             < version >${swagger.version}</ version >
         </ dependency >
         < dependency >
             < groupId >io.swagger</ groupId >
             < artifactId >swagger-models</ artifactId >
             < version >${swagger.version}</ version >
         </ dependency >
         < dependency >
             < groupId >io.springfox</ groupId >
             < artifactId >springfox-swagger2</ artifactId >
             < version >${springfox-swagger2.version}</ version >
         </ dependency >
         < dependency >
             < groupId >io.springfox</ groupId >
             < artifactId >springfox-swagger-ui</ artifactId >
             < version >${springfox-swagger2.version}</ version >
         </ dependency >
         <!-- springboot 集成 swagger 实现SpringMVC Restful 結束 -->
 
 
 
         <!-- Test -->
         < dependency >
             < groupId >org.springframework.boot</ groupId >
             < artifactId >spring-boot-starter-test</ artifactId >
             < scope >test</ scope >
         </ dependency >
 
 
     </ dependencies >
     < build >
         < finalName >${project.artifactId}</ finalName >
         < plugins >
             < plugin >
                 < groupId >org.springframework.boot</ groupId >
                 < artifactId >spring-boot-maven-plugin</ artifactId >
                 < version >${spring.boot.version}</ version >
                 < configuration >
                     < mainClass >sample.rs.service.SampleRestApplication</ mainClass >
                 </ configuration >
                 < executions >
                     < execution >
                         < goals >
                             < goal >repackage</ goal >
                         </ goals >
                     </ execution >
                 </ executions >
             </ plugin >
         </ plugins >
     </ build >

2、springboot配置文件 application.properties

1
2
  server.servlet-path = /
  spring.jersey.application-path = /api


3、springboot启动class

1
2
3
4
5
6
7
8
9
10
import  org.springframework.boot.SpringApplication;
import  org.springframework.boot.autoconfigure.SpringBootApplication;
 
@SpringBootApplication
public  class  SampleRestApplication {
 
     public  static  void  main(String[] args) {
         SpringApplication.run(SampleRestApplication. class , args);
     }
}

4、Jersey配置类，整合swagger

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
import  javax.annotation.PostConstruct;
 
import  org.glassfish.jersey.server.ResourceConfig;
import  org.glassfish.jersey.server.wadl.internal.WadlResource;
import  org.springframework.beans.factory.annotation.Value;
import  org.springframework.stereotype.Component;
 
import  io.swagger.jaxrs.config.BeanConfig;
import  io.swagger.jaxrs.listing.ApiListingResource;
import  io.swagger.jaxrs.listing.SwaggerSerializers;
import  sample.jersey.demo1.HelloResource;
import  sample.jersey.demo1.JerseyTest;
import  sample.jersey.demo2.Endpoint;
import  sample.jersey.demo2.ReverseEndpoint;
import  sample.jersey.demo3.HelloService;
 
@Component
public  class  JerseyConfig  extends  ResourceConfig {
 
     @Value ( "${spring.jersey.application-path}" )
     private  String apiPath;
 
     public  JerseyConfig() {
         register(Endpoint. class );
         register(ReverseEndpoint. class );
         this .registerEndpoints();
     }
 
     @PostConstruct
     public  void  init() {
         // Register components where DI is needed
         this .configureSwagger();
     }
 
     private  void  registerEndpoints() {
         this .register(HelloResource. class );
         this .register(JerseyTest. class );
         this .register(HelloService. class );
         // Access through /<Jersey's servlet path>/application.wadl
         this .register(WadlResource. class );
     }
 
     private  void  configureSwagger() {
         // Available at localhost:port/swagger.json
         this .register(ApiListingResource. class );
         this .register(SwaggerSerializers. class );
         BeanConfig config =  new  BeanConfig();
         config.setConfigId( "springboot-jersey-swagger-docker-example" );
         config.setTitle( "Spring Boot + Jersey + Swagger + Docker Example" );
         config.setVersion( "v1" );
         config.setContact( "wzh" );
         config.setSchemes( new  String[] {  "http" ,  "https"  });
         config.setBasePath( this .apiPath);
         config.setResourcePackage( "sample.jersey" );
         config.setPrettyPrint( true );
         config.setScan( true );
     }
}

5、Swagger配置类，支持spirngMVC RESTful文档功能

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
import  static  com.google.common.base.Predicates.or;
import  static  springfox.documentation.builders.PathSelectors.regex;
 
import  java.util.Arrays;
 
import  org.springframework.beans.factory.annotation.Value;
import  org.springframework.context.annotation.Bean;
import  org.springframework.context.annotation.Configuration;
 
import  com.google.common.base.Predicate;
 
import  springfox.documentation.builders.ApiInfoBuilder;
import  springfox.documentation.builders.PathSelectors;
import  springfox.documentation.builders.RequestHandlerSelectors;
import  springfox.documentation.service.ApiInfo;
import  springfox.documentation.service.ApiKey;
import  springfox.documentation.service.SecurityScheme;
import  springfox.documentation.spi.DocumentationType;
import  springfox.documentation.spring.web.plugins.Docket;
import  springfox.documentation.swagger2.annotations.EnableSwagger2;
 
/**
  * api doc -- springfox swagger configuration
  */
 
@Configuration
@EnableSwagger2
public  class  SwaggerConfig {
 
     @Value ( "${spring.jersey.application-path}" )
     private  String apiPath;
 
     @Bean
     public  SecurityScheme apiKey() {
         return  new  ApiKey( "access_token" ,  "accessToken" ,  "header" );
     }
 
     @Bean
     public  Docket apiConfig() {
         return  new  Docket(DocumentationType.SWAGGER_2).groupName( "controller" )
                 // 调用apiInfo方法,创建一个ApiInfo实例,里面是展示在文档页面信息内容
                 .apiInfo(apiInfo()).select()
                 // 控制暴露出去的路径下的实例
                 // 如果某个接口不想暴露,可以使用以下注解
                 // @ApiIgnore 这样,该接口就不会暴露在 swagger2 的页面下
                 .apis(RequestHandlerSelectors.basePackage( "sample.jersey.controller" )).paths(PathSelectors.any())
                 .build().useDefaultResponseMessages( false ).securitySchemes(Arrays.asList(apiKey()));
     }
 
     @Bean
     public  Docket restConfig() {
         return  new  Docket(DocumentationType.SWAGGER_2).groupName( "jax-rs" ).apiInfo(restInfo()).forCodeGeneration( true )
                 .pathMapping( "/" ).select().paths(paths()) // 过滤的接口
                 .build().useDefaultResponseMessages( false );
     }
 
     // 请求url匹配，支持and or，可以过滤筛选
     private  Predicate<String> paths() {
         return  or(regex( "/test/.*" ), regex( "/rest/.*" ));  //
     }
 
     private  ApiInfo apiInfo() {
         return  new  ApiInfoBuilder().title( "berheley service controller api " ) // 大标题
                 .description( "spring boot webservice 平台 API" ) // 小标题
                 // .termsOfServiceUrl("http://ww.swagger.com/")
                 // .contact(new Contact("swagger", "www.swagger.com",
                 // "swagger@foxmail.com"))
                 .version( "2.0" ).build();
     }
 
     private  ApiInfo restInfo() {
         return  new  ApiInfoBuilder().title( "berheley service rest api " ) // 大标题
                 .description( "spring boot webservice 平台 API" ) // 小标题
                 .version( "2.0" ).build();
     }
}

6、SprintMVC风格的web 服务示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
package  sample.jersey.controller;
 
import  org.springframework.stereotype.Controller;
import  org.springframework.web.bind.annotation.RequestMapping;
import  org.springframework.web.bind.annotation.RequestMethod;
import  org.springframework.web.bind.annotation.RequestParam;
import  org.springframework.web.bind.annotation.ResponseBody;
 
import  io.swagger.annotations.ApiOperation;
import  io.swagger.annotations.ApiParam;
 
@Controller
@RequestMapping ( "/test" )
public  class  TestController {
 
     @ResponseBody
     @RequestMapping (value =  "/show" , method = RequestMethod.POST)  // 这里指定RequestMethod，如果不指定Swagger会把所有RequestMethod都输出，在实际应用中，具体指定请求类型也使接口更为严谨。
     @ApiOperation (value =  "测试接口" , notes =  "测试接口详细描述" )
     public  String show( @ApiParam (required =  true , name =  "name" , value =  "姓名" )  @RequestParam (name =  "name" ) String stuName) {
         return  "success" ;
     }
}

7、JAX-RS 实现的服务示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
package  sample.jersey.demo3;
 
import  javax.ws.rs.GET;
import  javax.ws.rs.Path;
import  javax.ws.rs.PathParam;
import  javax.ws.rs.Produces;
import  javax.ws.rs.core.MediaType;
 
import  org.springframework.stereotype.Service;
 
@Path ( "/rest" )
@Component
public  class  HelloService {
 
     @GET
     @Path ( "/sayHello/{a}" )
     @Produces (MediaType.TEXT_PLAIN)
     public  String sayHello( @PathParam ( "a" ) String a) {
         return  "Hello "  + a +  ", Welcome to CXF RS Spring Boot World!!!" ;
     }
}

8、将swagger-ui包中的index.html复制到static目录下，修改资源文件路径

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
<!DOCTYPE html>
< html >
< head >
   < meta  charset = "UTF-8" >
   < meta  http-equiv = "x-ua-compatible"  content = "IE=edge" >
   < title >Swagger UI</ title >
   < link  rel = "icon"  type = "image/png"  href = "webjars/swagger-ui/images/favicon-32x32.png"  sizes = "32x32"  />
   < link  rel = "icon"  type = "image/png"  href = "webjars/swagger-ui/images/favicon-16x16.png"  sizes = "16x16"  />
   < link  href = '/webjars/swagger-ui/css/typography.css'  media = 'screen'  rel = 'stylesheet'  type = 'text/css' />
   < link  href = '/webjars/swagger-ui/css/reset.css'  media = 'screen'  rel = 'stylesheet'  type = 'text/css' />
   < link  href = '/webjars/swagger-ui/css/screen.css'  media = 'screen'  rel = 'stylesheet'  type = 'text/css' />
   < link  href = '/webjars/swagger-ui/css/reset.css'  media = 'print'  rel = 'stylesheet'  type = 'text/css' />
   < link  href = '/webjars/swagger-ui/css/print.css'  media = 'print'  rel = 'stylesheet'  type = 'text/css' />
 
   < script  src = '/webjars/swagger-ui/lib/object-assign-pollyfill.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/jquery-1.8.0.min.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/jquery.slideto.min.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/jquery.wiggle.min.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/jquery.ba-bbq.min.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/handlebars-4.0.5.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/lodash.min.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/backbone-min.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/swagger-ui.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/highlight.9.1.0.pack.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/highlight.9.1.0.pack_extended.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/jsoneditor.min.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/marked.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lib/swagger-oauth.js'  type = 'text/javascript' ></ script >
 
   <!-- Some basic translations -->
   < script  src = '/webjars/swagger-ui/lang/translator.js'  type = 'text/javascript' ></ script >
   < script  src = '/webjars/swagger-ui/lang/zh-cn.js'  type = 'text/javascript' ></ script > 
 
   < script  type = "text/javascript" >
     $(function () {
       var url = window.location.search.match(/url=([^&]+)/);
       if (url && url.length > 1) {
         url = decodeURIComponent(url[1]);
       } else {
           url = "/api/swagger.json";
       }
 
       hljs.configure({
         highlightSizeThreshold: 5000
       });
 
       // Pre load translate...
       if(window.SwaggerTranslator) {
         window.SwaggerTranslator.translate();
       }
       window.swaggerUi = new SwaggerUi({
         url: url,
         dom_id: "swagger-ui-container",
         supportedSubmitMethods: ['get', 'post', 'put', 'delete', 'patch'],
         onComplete: function(swaggerApi, swaggerUi){
           if(typeof initOAuth == "function") {
           /*   initOAuth({
               clientId: "your-client-id",
               clientSecret: "your-client-secret-if-required",
               realm: "your-realms",
               appName: "your-app-name",
               scopeSeparator: " ",
               additionalQueryStringParams: {}
             }); */
           }
 
           if(window.SwaggerTranslator) {
             window.SwaggerTranslator.translate();
           }
         },
         onFailure: function(data) {
           log("Unable to Load SwaggerUI");
         },
         docExpansion: "none",
         jsonEditor: false,
         defaultModelRendering: 'schema',
         showRequestHeaders: false,
         showOperationIds: false
       });
 
       window.swaggerUi.load();
 
       function log() {
         if ('console' in window) {
           console.log.apply(console, arguments);
         }
       }
   });
   </ script >
</ head >
 
< body  class = "swagger-section" >
< div  id = 'header' >
   < div  class = "swagger-ui-wrap" >
     < a  id = "logo"  href = "http://swagger.io" >< img  class = "logo__img"  alt = "swagger"  height = "30"  width = "30"  src = "/webjars/swagger-ui/images/logo_small.png"  />< span  class = "logo__title" >swagger</ span ></ a >
     < form  id = 'api_selector' >
       < div  class = 'input' >< input  placeholder = "http://example.com/api"  id = "input_baseUrl"  name = "baseUrl"  type = "text" /></ div >
       < div  id = 'auth_container' ></ div >
       < div  class = 'input' >< a  id = "explore"  class = "header__btn"  href = "#"  data-sw-translate>Explore</ a ></ div >
     </ form >
   </ div >
</ div >
 
< div  id = "message-bar"  class = "swagger-ui-wrap"  data-sw-translate>&nbsp;</ div >
< div  id = "swagger-ui-container"  class = "swagger-ui-wrap" ></ div >
</ body >
</ html >

9、结果展示

wKioL1iz9u3wW3Y9AABNry7ycVM389.png-wh_50

wKiom1iz9u7AT0K9AAA8FnrDFMk053.png-wh_50

http://localhost:8080/      为Jersey 的文档路径

http://localhost:8080/swagger-ui.html      为SpringMVC的controller文档路径

hxpjava1
关注
专栏目录
springboot jersey中配置swagger2
jared_he2017的博客
11-09 2453
1. pom.xml配置： 出去springboot和jersey陪之外需添加 &lt;dependency&gt;             &lt;groupId&gt;io.swagger&lt;/groupId&gt;             &lt;artifactId&gt;swagger-jersey2-jaxrs&lt;/artifactId&gt;             &l...
SpringBoot（七）：SpringBoot整合Swagger2
热门推荐
Saytime
07-10 7万+
相信各位在公司写API文档数量应该不少，当然如果你还处在自己一个人开发前后台的年代，当我没说，如今为了前后台更好的对接，还是为了以后交接方便，都有要求写API文档。 手写Api文档的几个痛点： 文档需要更新的时候，需要再次发送一份给前端，也就是文档更新交流不及时。接口返回结果不明确不能直接在线测试接口，通常需要使用工具，比如postman接口文档太多，不好管理 Swagg
SpringBoot2.0整合Jersey+Swagger2
LeeD0ng的博客
12-04 2290
一. Swagger • 官网：https://swagger.io • 通过集成Swagger，建立前后端交流沟通的标准化桥梁(尽管有postman)，通过swagger注解，和可视化的Swagger-ui，方便前端同学直接了当的对后端服务进行调用和参数选用 二. SpringBoot2.x条件下，Jersey集成Swagger2 1. 本地环境： 环境名 版本 描述 JD...
springboot整合jersey与swagger2
文盲青年的博客
08-29 1227
build.gradle compile("io.swagger:swagger-jersey2-jaxrs:1.5.12") compile("org.webjars:swagger-ui:2.2.10") compile("org.glassfish.hk2:spring-bridge:2.5.0-b34") JerseyConfig @Configuration @Applic...
Springboot-Jersey-Swagger
05-01
如何配置Spring Boot Jersey和Swagger 问题陈述 如何集成Spring Boot，Jersey，Swagger来构建基于JSON的真实世界的RESTful Web服务 在开始之前 我们必须将Spring Boot Starter Web作为Swagger UI的依赖项才能正常工作。 运行Web服务 curl -X POST“ ” -H“接受：application / json” -H“内容类型：application / json” -d“ {” id“：” 78“，” name“：” huu“}” curl -X GET“ ” -H“接受：application / json”“ [{” id“：” 1“，” name“：”密码“}，{” id“ ：“ 2”，“名称”：“ huu”}] 博客链接
springfox-swagger2-3.0.0-API文档-中文版.zip
05-09
赠送jar包：springfox-swagger2-3.0.0.jar； 赠送原API文档：springfox-swagger2-3.0.0-javadoc.jar； 赠送源代码：springfox-swagger2-3.0.0-sources.jar； 赠送Maven依赖信息文件：springfox-swagger2-3.0.0.pom；...
springfox-swagger2-2.9.2-API文档-中文版.zip
07-13
赠送jar包：springfox-swagger2-2.9.2.jar； 赠送原API文档：springfox-swagger2-2.9.2-javadoc.jar； 赠送源代码：springfox-swagger2-2.9.2-sources.jar； 赠送Maven依赖信息文件：springfox-swagger2-2.9.2.pom；...
springfox-swagger2-2.9.2-API文档-中英对照版.zip
07-13
赠送jar包：springfox-swagger2-2.9.2.jar； 赠送原API文档：springfox-swagger2-2.9.2-javadoc.jar； 赠送源代码：springfox-swagger2-2.9.2-sources.jar； 赠送Maven依赖信息文件：springfox-swagger2-2.9.2.pom；...
springfox-swagger2-2.7.0-API文档-中文版.zip
07-12
赠送jar包：springfox-swagger2-2.7.0.jar； 赠送原API文档：springfox-swagger2-2.7.0-javadoc.jar； 赠送源代码：springfox-swagger2-2.7.0-sources.jar； 赠送Maven依赖信息文件：springfox-swagger2-2.7.0.pom；...
springfox-swagger-common-2.7.0-API文档-中文版.zip
07-12
赠送jar包：springfox-swagger-common-2.7.0.jar； 赠送原API文档：springfox-swagger-common-2.7.0-javadoc.jar； 赠送源代码：springfox-swagger-common-2.7.0-sources.jar； 赠送Maven依赖信息文件：springfox-...
使用SpringBoot整合jersey 实现Restful web service.同时整合springmvc。
02-04
使用SpringBoot整合jersey 实现Restful web service.同时整合springmvc。
SpringBoot整合Swagger
奈&何.
02-15 6543
SpringBoot整合Swagger
SpringBoot使用Jersey+Swagger搭建Rest服务
weixin_34240520的博客
10-16 665
2019独角兽企业重金招聘Python工程师标准>>> ...
基于spring boot使用swagger2为Jersey构建api文档
More than coding
01-27 3341
Jersey 框架是一个比较常用的开源的RESTful框架,。相比spring mvc来说，Jersey实现了JAX-RS 标准，并且在编写rest api时，代码看起来更加直观。当我们写好接口后，通常是自己写一份api文档，但这样做随着时间的推移以及业务复杂性的增加，文档会变得越来越难维护，工作量也越来越大。为了解决这些问题，swagger2出现了，它可以很轻松的集成到spring boo...
【Swagger】可能是目前最好的 Spring Boot 集成 swagger 的方案
KIWI的专栏
09-08 460
【Swagger】可能是目前最好的Spring Boot集成 swagger 的方案   据说程序员最恨的两件事：一件是别人不写文档，另一件是自己写文档。   可见文档真的是程序员生活中相爱相杀的存在。一方面对于使用者来说，一份全面、准确的文档简直就是旅行时的地图，烹饪时的菜谱，通关时的攻略。可以极大的提高对接的效率与尽可能的减少踩坑的概率。然而，一份...
spring-boot集成swagger（接口管理工具）
不变的24号
01-09 2209
spring-boot集成swagger（接口管理工具）
【swagger2】SpringBoot集成springfox-swagger2构建restful API
ooooooooooooooxiaosu的博客
01-20 292
springboot整合swagger2 文章SpringMVC集成springfox-swagger2构建restful API简单写了如何在springmvc中集成swagger2。这边记录下在springboot中如何集成swagger2，其实使用基本相同。 一、引入依赖 使用maven，在pom.xml中引用相关依赖(swagger版本2.4.0，springboot的版本为2.1.5.RELEASE)： <dependency> <groupId>io..
springfox-swagger-ui和swagger-bootstrap-ui和springfox-swagger2三者的区别
最新发布
05-05
springfox-swagger2 是一个使用 Java 注解来生成 Swagger 文档的工具，它可以将 SpringMVC 的 Controller 中的 API 映射生成对应的 API 文档，同时还可以通过 Swagger UI 进行 API 文档的可视化展示。 swagger-bootstrap-ui 是对 Swagger UI 的增强，它对 Swagger UI 进行了美化，增加了更多的功能，比如支持 Markdown 文档，支持离线访问等。 springfox-swagger-ui 是 Swagger UI 的官方实现，它提供了一个可视化的界面，让开发者可以更加方便地查看 API 文档。它与 swagger-bootstrap-ui 的区别在于，swagger-bootstrap-ui 对 Swagger UI 进行了增强，而 springfox-swagger-ui 则是 Swagger UI 的官方实现，没有进行过多的改动。 综上所述，springfox-swagger2 是生成 API 文档的核心工具，swagger-bootstrap-ui 和 springfox-swagger-ui 则是对 API 文档进行可视化展示的工具，其中 swagger-bootstrap-ui 对 Swagger UI 进行了增强，而 springfox-swagger-ui 则是 Swagger UI 的官方实现。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值