[swagger2]注解使用

@Api(value = "充值订购Controller", tags = {"充值订购接口"})
@ApiOperation(value = "用户选择优酷或者爱奇艺", tags = {"视频选择"}, notes = "Youku或iQIYI")

@RestController
@Api(value = "充值订购Controller", tags = {"充值订购接口"})
public class TopUpOrderController {

    private final Logger logger = LoggerFactory.getLogger(getClass());

    @Autowired
    private TopUpOrderService service;

    @PostMapping(value = "/topUpOrder")
    @ApiOperation(value = "充值满500元订购", notes = "输入金额，好比：500")
    public void order(@ApiParam(name = "money", value = "充值金额", required = true) @RequestBody int money) {
        logger.debug("order 正在运行。");
        service.service(money);
        logger.debug("order 运行完毕。");
    }

    @PostMapping(value = "/chooseVideo")
    @ApiOperation(value = "用户选择优酷或者爱奇艺", notes = "输入json格式，好比：{\"processInstanceId\":\"44546b0b-5066-11e9-af34-000ec6ad4028\",\"video\":\"iQIYI\"}")
    @ApiImplicitParams({@ApiImplicitParam(name = "req", value = "入参：流程id、选择的视频，{\"processInstanceId\":\"\",\"video\":\"Youku\"}", required = true, dataType = "JSONObject")})
    public void chooseVideo(@RequestBody JSONObject req) {
        logger.debug("chooseVideo 正在运行。");
        service.chooseVideo(req.getString("processInstanceId"), req.getString("video"));
        logger.debug("chooseVideo 运行完毕。");
    }

}

• http://www.javashuo.com/article/p-pipgxxru-mg.html