也可以自己不写配置类，直接使用默认的实现类，在Spring的配置文件中共配置：（不推荐）

2.2.4.与swagger-ui集成

方式一：

• Note: Only use this option if you don't need to customize any of the swagger-ui static content, otherwise use option 2.
• Use the web-jar which packages all of the swagger-ui static content.
• Requires that your app is using the servlet 3 specification.
• For non-spring boot applications some extra spring configuration (ResourceHandler's) is required. See: https://github.com/adrianbk/swagger-springmvc-demo/tree/master/swagger-ui

方式二：（推荐）

• Manually copy all of the static content swagger-ui's dist directory (https://github.com/wordnik/swagger-ui/tree/master/dist)
• Provide the necessary view resolvers and resource handlers to serve the static content.
• Consult the spring documentation on serving static resources.

The following is one way to serve static content from /src/main/webapp

2.6.5.Controller配置

使用注解对Controller进行配置：

• @Api 配置方法API
• @ApiOperation API的操作 GET PUT DELETE POST
• @ApiParam API的方法参数描述

示例Controller：

package org.bugkillers.back.user.controller;
import java.util.List;
import org.bugkillers.back.bean.User;
import org.bugkillers.back.result.Result;
import org.bugkillers.back.user.service.UserService;
import org.bugkillers.back.util.ResultUtil;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;
import com.wordnik.swagger.annotations.Api;
import com.wordnik.swagger.annotations.ApiOperation;
import com.wordnik.swagger.annotations.ApiParam;
/*** 用户操作Controller* <p/>* <p>** @author 刘新宇**         <p>* @date 2015年1月30日 上午10:50:34*       <p>* @version 0.0.1*/
@Api(value = "user-api", description = "有关于用户的CURD操作", position = 5)
@Controller
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserService service;/*** 注册用户* @param user*/@ApiOperation(value = "注册", notes = "注册用户", position = 3)@ResponseBody@RequestMapping(value = { "/regist" }, method = RequestMethod.POST)public ResponseEntity<?> regist(@RequestBody User user) {service.save(user);Result<String> result = ResultUtil.buildSuccessResult("注册成功");return new ResponseEntity<Result<String>>(result, HttpStatus.OK);}/*** 根据pk查找用户* @param userPk* @return*/@ApiOperation(value = "根据pk查找用户", notes = "返回用户实体对象", response = User.class, position = 2)@ResponseBody@RequestMapping(value = { "/{userPk}" }, method = RequestMethod.GET)public ResponseEntity<?> findByPk(@ApiParam(value = "填写Pk", allowableValues = "range[1,5]", required = true, defaultValue = "userPk", allowMultiple = true) @PathVariable("userPk") Integer userPk) {Result<User> result = ResultUtil.buildSuccessResult(service.findByPk(userPk));return new ResponseEntity<Result<User>>(result, HttpStatus.OK);}/*** 测试* @param who* @return*/@ApiOperation(value = "Hellow World", notes = "测试功能", position = 1)@ResponseBody@RequestMapping(value = { "/hello/{who}" }, method = RequestMethod.GET)public ResponseEntity<?> hello(@ApiParam(value = "填写名称") @PathVariable("who") String who) {Result<String> result = ResultUtil.buildSuccessResult( "Hello guys" + " " + who + "!");return new ResponseEntity<Result<String>>(result, HttpStatus.OK);}/*** 查询所有* @return*/@ApiOperation(value = "获取所有用户", notes = "返回用户实体对象集合", position = 5)@RequestMapping(value = "/findAll", method = RequestMethod.GET)public @ResponseBody ResponseEntity<?>  findAll() {Result<List<User>> result = ResultUtil.buildSuccessResult( service.findAll());return  new ResponseEntity<Result<List<User>>>(result, HttpStatus.OK);}/*** 根据用户pk更新实体* @param userPk  用户pk* @param user 返回更新后的实体* @return*/@ApiOperation(value = "更新用户", notes = "返回更新的用户实体对象",position = 5)@RequestMapping(value = "/update/{userPk}", method = RequestMethod.PUT)public ResponseEntity<?> updateByPk(@PathVariable("userPk") Integer userPk, @RequestBody User user) {user.setPk_user(userPk);service.update(user);Result<User> result = ResultUtil.buildSuccessResult(user);return new ResponseEntity<Result<User>>(result, HttpStatus.OK);}/*** 根据用户pk删除实体* @param userPk  用户pk* @return*/@ApiOperation(value = "删除用户", notes = "根据pk删除用户",position = 5)@RequestMapping(value = "/delete/{userPk}", method = RequestMethod.GET)public ResponseEntity<?> deleteByPk(@PathVariable("userPk") Integer userPk) {service.delete(userPk);Result<String> result = ResultUtil.buildSuccessResult("删除成功");return new ResponseEntity<Result<String>>(result, HttpStatus.OK);}
}

2.2.6.启动中间件

项目配置了Jetty或者Tomcat等Web容器的话，在对应的Controller配置好的话就可以启动看效果了。

• 远程示例：http://115.29.170.213/api

2.2.7.需求定制

• 分组信息定制
• Url定制
• Http相应定制