±à¼ÍƼö: |
±¾ÎÄÀ´×Ô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Ò³ÃæÁË¡£ |