统一网关服务

[一]网关动态路由

[二]网关服务轻量级鉴权

[三]动态文档聚合

在面向 REST 接口的应用中，通常都会使用 Swagger 来生成接口文档，以方便开发时查看和调试。

微服务和单体系统不同。

• 单体系统直接集成 Swagger 就可以查看所有接口信息。
• 微服务系统接口分布在不同的服务中。虽然也可以一个服务一个服务的查看，但是不够方便也不便于管理。

所以 Dante Cloud 提供了动态文档聚合功能。

• 文档聚合：在 Gateway 服务聚合了所有服务的文档，可以统一进行查看
• 动态聚合：业务服务在如果没有启动，一方面很难聚合该服务的文档，另一方免即使可以聚合也无法查看和调试接口。动态聚合就是可以根据服务的启动状态，动态聚合有效的服务文档。

在浏览器中，直接访问 Gateway 服务中的 Swagger 就可以查看聚合的文档信息。默认的地址为：http://localhost:8847/swagger-ui.html。显示效果如下：

动态文档聚合

通过右上角就可以切换查看不同服务的接口文档，下图就是切换到 UAA 文档：

提示

如果服务没有启动，右上角服务列表中将不会显示。

UAA服务

重要

文档聚合功能，建议仅在开发环境或者测试环境开启，正式环境不要开启，以减少安全风险。可以通过修改参数进行开启和关闭，参见：Swagger参数

[四]统一跨域处理