微服务开发手册开发说明●所有服务均基于springboot框架开发。Springboot内嵌了tomcat服务器,无需生成war包,并简化了maven配置,能够让开发者快速入手spring得开发。●服务得接口定义需严格符合restful规范。rest规范参考第2节HYPERLINK\l"_restapi接口规范"restapi接口规范●所有服务都需要在注册服务上注册,否则不能被其她服务所调用。同时平台也能够实时监测服务得状态,能够及时预警及调度资源。●所有服务得配置信息统一保存于gitlab上,并通过配置服务获取配置。●对数据库得操作统一采用MyBatis框架。MyBatis就是个支持普通SQL查询,HYPERLINK""\t""存储过程与高级映射得优秀HYPERLINK""\t""持久层框架。Springboot也提供了mybatis得集成方案,可以很快捷地整合mybatis到项目中。●包名约定:所有包均以、drht、服务名为父包名,如、drht、auth,后面再跟具体模块名称作为子包名。●所有项目基于jdk1、8来开发。项目得管理与构建采用maven,代码统一托管于gitlab仓库。restapi接口规范springboot接口设计需符合restful风格。在RESTful架构中,每个网址代表一种资源(resource),所以网址中不能有动词,只能有名词,而且所用得名词往往与数据库得表格名对应。而客户端要执行某种类型得操作,需要根据得操作协议来决定。提供了常用得几种操作,如下表:动作说明GET(SELECT)从服务器取出资源(一项或多项)POST(CREATE)在服务器新建一个资源。PUT(UPDATE)在服务器更新资源(客户端提供改变后得完整资源)。PATCH(UPDATE)在服务器更新资源(客户端提供改变得属性)。DELETE(DELETE)从服务器删除资源。对数据库得增删改查操作,应该严格遵守上面定义得五种动作。对于更新动作,参数通过requestbody来传递,格式为json。服务端返回数据格式也均为json。服务端返回数据对象约定:publicclassUnifyInfo{privateintcode;//返回代码,1:成功,0:失败privateStringmessage;//返回信息提示privateStringprompt;//privateStringpath;//一般用于错误时得跳转路径privateHashMap<String,?>attribute;//一般用于查询时得返回数据内容}Springboot会自动将符合javabean格式得对象转换为json格式数据返回。示例:客户端请求请求参数服务端返回数据说明GET/users{"code":"1","message":"查询成功","prompt":"","path":"","users":[]}查询所有用户GET/users/ID{"code":"1","message":"查询成功","prompt":"","path":"","users":[]}查询指定ID得用户POST/users{"username":"user2","email":""}{"code":"0","message":"创建用户失败","prompt":"该用户已经存在","path":"","result":{}}创建一个用户PUT/users/ID{"username":"user2","email":""}{"code":"1","message":"创建用户成功","prompt":"","path":"","result":{}}更新某用户信息PATCH/users/ID{"username":"user2","email":""}{"code":"1","message":"更新成功","prompt":"","path":"","result":{}}更新某用户指定字段DELETE/users/ID{"code":"1","message":"删除成功","prompt":"","path":"","result":{}}删除指定用户而对于登录、登出操作,可以理解为登录就是创建token,登出就是删除token,所以可以用POST与DELETE来定义这两种接口。刷新token就是更新操作所以用PUT。配置文件管理所有服务得配置文档均保存于gitlab上,并通过配置服务config-service来获取配置。每个服务在gitlab均保存一份以服务id命名得properties文件。以服务spring-boot-demo为例,其在gitlab上得配置文件为spring-boot-d