Shenyu客户端注册API文档

此篇文介绍如何将 API文档 暴露到 Apache ShenYu 网关。

接入前,请正确启动 shenyu-admin

API文档暴露到网关

可以参考shenyu-examples下面任意一个example的代码。

唯一需要做的就是在你的服务中的新增@ApiModule@ApiDoc注解,以下是shenyu-examples-http中的例子:

  1. @RestController
  2. @RequestMapping("/order")
  3. @ShenyuSpringMvcClient("/order")
  4. @ApiModule(value = "order")
  5. public class OrderController {
  6. @GetMapping("/findById")
  7. @ShenyuSpringMvcClient("/findById")
  8. @ApiDoc(desc = "findById")
  9. public OrderDTO findById(@RequestParam("id") final String id) {
  10. return build(id, "hello world findById");
  11. }
  12. private OrderDTO build(final String id, final String name) {
  13. OrderDTO orderDTO = new OrderDTO();
  14. orderDTO.setId(id);
  15. orderDTO.setName(name);
  16. return orderDTO;
  17. }
  18. }