Äú¿ÉÒÔ¾èÖú£¬Ö§³ÖÎÒÃǵĹ«ÒæÊÂÒµ¡£

1Ôª 10Ôª 50Ôª





ÈÏÖ¤Â룺  ÑéÖ¤Âë,¿´²»Çå³þ?Çëµã»÷Ë¢ÐÂÑéÖ¤Âë ±ØÌî



  ÇóÖª ÎÄÕ ÎÄ¿â Lib ÊÓÆµ iPerson ¿Î³Ì ÈÏÖ¤ ×Éѯ ¹¤¾ß ½²×ù Model Center   Code  
»áÔ±   
   
 
     
   
 ¶©ÔÄ
  ¾èÖú
²âÊÔÉñÆ÷SwaggerµÄÓ¦ÓÃ
 
  3390  次浏览      28
 2019-3-22 
 
±à¼­ÍƼö:
±¾ÎÄÀ´×Ôcsdn£¬±¾ÎĽéÉÜÁËÈçºÎʹÓÿª·¢¹¤¾ßIntellijIDEAÀ´´î½¨SwaggerÓ¦ÓõÄÏà¹ØÄÚÈÝ¡£

ÔÚ¿ª·¢ÖÐÎÒÃǾ­³£»áÅöµ½ÕâÖÖÇé¿ö£ººǫ́¿ª·¢ÈËÔ±ÔÚ¿ª·¢Íê½Ó¿ÚÖ®ºó¸øÇ°Ì¨ÈËÔ±µ÷Óã¬Ç°Ì¨ÈËÔ±¶Ô½Ó¿ÚµÄ×÷ÓÃÒÔ¼°½Ó¿ÚÖеIJÎÊýÍùÍù²»¶®£¬ÕâÑùǰ̨²»µÃ²»¶à´Î¸úºǫ́ÈËÔ±¹µÍ¨½»Á÷£¬ºÜÀË·Ñʱ¼ä¡£µ«Ê¹ÓÃSwaggerºó£¬ÕâÖÖÇé¿ö¾Í¼¸ºõ²»´æÔÚÁË£¬ÒòΪºǫ́¿ª·¢ÈËÔ±ÔÚд½Ó¿ÚµÄͬʱ±ã°Ñ½Ó¿Ú¼°²ÎÊýµÄ×¢ÊÍдºÃÁË£¬ÔÚSwaggerÒ³Ãæ¿ÉÒԷdz£Çå³þÃ÷Á˵Ŀ´µ½¸÷¸ö½Ó¿ÚÒÔ¼°¸÷¸ö²ÎÊýµÄÒâ˼¡£

ÎÒÃÇÏÈ¿´¿´Ð§¹ûͼ£¬ÏÂͼÖÐÃ÷È·ÏÔʾÁ˵±Ç°·ÃÎʵĽӿÚÊôÓÚ"order-controller"£¬ÏÔʾÁËÇëÇóurl·¾¶Îª"/orderNew/getOrder"£¬ÏÔʾÁ˸ýӿڵÄ×÷ÓÃΪ"»ñȡijÌõ¶©µ¥ÐÅÏ¢"£¬ÏÔʾÁËÕâ¸ö½Ó¿ÚËùÓõ½µÄÈý¸ö²ÎÊýÒÔ¼°Èý¸ö²ÎÊýµÄÃû³ÆÒÔ¼°ÀàÐÍ¡£ÎÒÃÇ»¹¿ÉÒÔµã»÷ÏÂÃæµÄ"Try it out!"°´Å¥À´½øÐвâÊÔ¡£ÓÐÁËËü£¬ºǫ́ÈËÔ±²»Óý²½â£¬Ç°¶ËÈËÔ±×ÔÈ»ÄÜÃ÷°×¡£

ÏÂÃæ¾Í˵ÏÂÈçºÎʹÓÿª·¢¹¤¾ßIntellijIDEAÀ´´î½¨SwaggerÓ¦Óá£

µÚÒ»²½£º Ê×ÏÈн¨Ò»¸ö¿ÕµÄMaven¹¤³Ì

µÚ¶þ²½£ºÔÚpom.xmlÎļþÖÐÌí¼ÓÈçÏÂÒÀÀµ

<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.4.1.RELEASE</version>
<relativePath />
</parent>

<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>1.4.1.RELEASE</version>
</dependency>

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.3.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>4.3.3.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<version>1.4.1.RELEASE</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.2.2</version>
<exclusions>
<exclusion>
<artifactId>spring-context</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
<exclusion>
<artifactId>spring-aop</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
<exclusion>
<artifactId>spring-beans</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
<exclusion>
<artifactId>spring-web</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
<exclusion>
<artifactId>spring-webmvc</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
<exclusion>
<artifactId>spring-core</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
<exclusion>
<artifactId>jackson-annotations</artifactId>
<groupId>com.fasterxml.jackson.core</groupId>
</exclusion>
<exclusion>
<artifactId>slf4j-api</artifactId>
<groupId>org.slf4j</groupId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.2.2</version>
</dependency>
</dependencies>

µÚÈý²½£ºÔÚcomĿ¼»òÕ߯ä×ÓĿ¼ÏÂн¨Ò»¸öApplicationÀ࣬ÈçÏÂͼËùʾ¡£×¢ÒâÒ»¶¨ÒªÔÚcom»òÆä×ÓĿ¼Ï£¬·ñÔòÆô¶¯²»ÁË¡£

ApplicationµÄ´úÂëÈçÏÂ

package com;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure
.EnableAutoConfiguration;
import org.springframework.boot.autoconfigure
.SpringBootApplication;
import org.springframework.boot.builder
.SpringApplicationBuilder;
import org.springframework.boot.web.support
.SpringBootServletInitializer;
import springfox.documentation.swagger2
.annotations.EnableSwagger2;

/**
* test-sc
* Created by Grady on 2017/4/18.
*/
@EnableSwagger2
@SpringBootApplication
//@ImportResource("classpath:/META-INF/spring
/spring-dubbo-provider.xml")
@EnableAutoConfiguration//ÆôÓÃ×Ô¶¯ÅäÖÃ
//@ComponentScan("com.filter,com.controller,
com.manager,com.api.impl")
public class Application extends
SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure
(SpringApplicationBuilder application) {
return application.sources(Application.class);
}

public static void main(String[] args) {
SpringApplication.run(Application.class);
}
}

µÚËIJ½£ºÔÚControllerÖÐд½Ó¿Ú

ControllerÀà´úÂëÈçÏÂ

package com.controller;

import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
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.RestController;

/**
* Created by dell16 on 2017/4/18.
*/
@RequestMapping("/orderNew")
@RestController
public class OrderController {

@ApiOperation(value = "»ñȡijÌõ¶©µ¥ÐÅÏ¢")
@RequestMapping(value = "/getOrder", method = RequestMethod.GET)
public String getOrder(@ApiParam(value = "¶©µ¥±àºÅ",required = true) @RequestParam(value = "orderNo") String orderNo,
@ApiParam(value = "µ±Ç°Ò³") @RequestParam(value = "pageNum",required = false) Integer pageNum,
@ApiParam(value = "ÿҳÏÔʾÊýÁ¿") @RequestParam(value = "pageSize",required = false) Integer pageSize) {
return "³É¹¦£¡";
}
}

ÓÐÁËÉÏÃæÕâËIJ½£¬Æô¶¯Õâ¸ö¹¤³Ì£¬¾Í¿ÉÒÔÊäÈëhttp://localhost:8080/swagger-ui.html#!/order-controller/getOrderUsingGETÀ´·ÃÎÊSwaggerÒ³ÃæÁË¡£

   
3390 ´Îä¯ÀÀ       28
Ïà¹ØÎÄÕÂ

΢·þÎñ²âÊÔÖ®µ¥Ôª²âÊÔ
һƪͼÎÄ´øÄãÁ˽â°×ºÐ²âÊÔÓÃÀýÉè¼Æ·½·¨
È«ÃæµÄÖÊÁ¿±£ÕÏÌåϵ֮»Ø¹é²âÊÔ²ßÂÔ
È˹¤ÖÇÄÜ×Ô¶¯»¯²âÊÔ̽Ë÷
Ïà¹ØÎĵµ

×Ô¶¯»¯½Ó¿Ú²âÊÔʵ¼ù֮·
jenkins³ÖÐø¼¯³É²âÊÔ
ÐÔÄܲâÊÔÕï¶Ï·ÖÎöÓëÓÅ»¯
ÐÔÄܲâÊÔʵÀý
Ïà¹Ø¿Î³Ì

³ÖÐø¼¯³É²âÊÔ×î¼Ñʵ¼ù
×Ô¶¯»¯²âÊÔÌåϵ½¨ÉèÓë×î¼Ñʵ¼ù
²âÊԼܹ¹µÄ¹¹½¨ÓëÓ¦ÓÃʵ¼ù
DevOpsʱ´úµÄ²âÊÔ¼¼ÊõÓë×î¼Ñʵ¼ù