1. 程式人生 > >[swagger2]註解使用

[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 執行完畢。");
    }

}