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