D在这个Demo中,我们有四个应用级别的服务, Plus Service,Calc Service,Lookup Service还有UAA。
下面分别介绍Demo中的模块
1.Swagger
Swagger 是一个牛逼的文档管理工具, 这里我们是用做设计驱动,做了很多项目,尤其是对外(也许只是给其他开发)提供REST服务的项目。痛点就是Design与实现不同,实现与文档不同,不能方便的测试REST API。 Swagger在一定程度上解决了这个问题。这里我的思路是,API Designer 设计发布Swagger definition file。利用Swagger Codegen 自动生成接口代码(这里主要是java spring,在每一次build的时候,重新生成代码),开发人员实现接口。当designer 修改swagger definition file后,通知开发人员(当然也可以不通知),接口变化,会体现在开发的一次build。
2.User
Springboot项目。实现用户的CURD
3.UAA
SpringBoot项目。依赖User模块,通过OAuth2+JWT实现对User API的访问。
4.JWT Public
由于UAA提供了JWT的token,其他项目可以参照JWT的原理是JWT Plulic的公共方法来对JWT进行验证。
5.Admin Dashboard
SpringBoot项目由于demo大量使用springboot,这个模块是对spingboot admin的引用。。
6.Manage Service
SpringBoot项目。依赖Admin Dashboard,引用Spring Cloud Config,提供Springcloud的配置,管理。
7.Plus Service
Express.js 项目。
REST Service:
GET /plus?a=1&b=3 返回4
8.Calc Service
SpringBoot项目。
REST Service:
GET /calc/plus?a=1&b=3 返回4,此服务通过调用Plus Service完成。
GET /calc/multiply?a=2&b=6 返回6。
9.Lookup Service
SpringBoot项目。
REST Service:
GET /iplookup 返回当前请求的IP地址
GET /from 返回from属性的来源(验证是否可以从manage service 获取配置)
10.Kong
API gateway, 用来对外发布服务。 其他模块要将自己的服务注册到kong, 没有什么自己的代码可以写。对于来自公网的请求,必须先通过API gateway,内部请求,我们这里就不在走api gateway了,也不对服务之间调用进行授权认证。同时为了简单省事,这些发布到公网的URL做了粉饰。让他们看起来更像一个统一的服务。
发布到公网的服务:
GET /api/v1/direct/plus?a=1&b=3 转发给Plus Service
GET /api/v1/plus?a=1&b=3 转发给Calc Service
GET /api/v1/multiply?a=2&b=3 转发给Calc Service
GET /api/v1/iplookup 转发给Lookup Service
GET /api/v1/from 转发给Lookup Service