Spring Cloud 研发框架demo

第一步：准备工作

1、下载并集成公司自定义maven

maven包见QQ群文件

2、克隆Git源码到本地eclipse：

xx

3、构建项目

一键初始化parent：run as maven install

注意：构建报错缺少依赖jar

ojdbc14-10.2.0.5.0.jar   到  C:\Users\Administrator\.m2\repository\com\oracle\ojdbc14\10.2.0.5.0

第二步：工程调试

工程调试顺序（eureka->config→ws）

如果eureka和config使用公共服务，可以跳过直接从ws开始调试。但需要获取相关服务连接：

eureka服务地址：http://192.168.199.184:27015

config名称：

1、关于config-server的使用

下图所示该文件是demo-ws的bootstrap.properties

把红框中的serviceId的值由config-server2改为config-server-test。这个是把config-server服务提到公用服务器上去了。

然后这里的spring.application.name按要求是改为自定义（demo-ws-自定义内容），这个config所搜索的文件服务器地址为http://192.168.199.184/liul/demo-config.git，权限我已经分配给大家了。

麻烦大家把自定义的name按照规则在这个链接里面创建对应的properties，创建规则例如：

spring.application.name=demo-ws-ly，

spring.cloud.config.profile=test，

那么则在链接下创建demo-ws-ly-test.properties文件，

内容就点开链接中

复制里面的内容即可。

/refresh 更新配置：

加@RefreshScope注解

1. // 在执行refresh时会刷新bean中变量值
2. @RefreshScope

配置文件添加

1. ws服务直接调用/refresh 就会更新修改后的配置文件  
2. management.security.enabled=false

2、ws工程的api文档配置

修改api文档相关描述配置

添加接口详情注解

实体层参数api注解不要落下！

3、启动项目

找到WsApplication.java文件

右键 Run As → Java Application 直接启动

第三步：相关公共服务

1、分页：

在demo-ws项目中TestController.java中做了个关于分页的方法示例，function如下图示：

方法追踪后（中间省去CommonResult的各类代码填充操作），可追踪到BaseService.java文件中下图示方法

数据库查询如下图所示

2、excel导入：

在demo-ws项目中TestController.java中做了个关于excel导入的方法示例，function如下图示：

 3、excel导出：

在demo-ws项目中TestController.java中做了个关于excel导出的方法示例，function如下图示：

以下两个是为传输条件后导出的表格：

http://XXX:XX/user/excelAllItem?parentId=0

上图为加入查询条件parentId=0（父角色id为0）

http://XXX:XX/user/excelAllItem?parentId=0&orderColum=name

上图为加入查询条件parentId=0&orderColum=name（父角色id为0并且排序列名为name）

4、代码生成器：

下载http://192.168.199.184/liul/eurekaDemo.git上demo-generator-mybatis项目。

在git的配置文件中加入如下图示的代码条件。

config.properties文件中路径均改为自己所对应的项目路径。关于interface层代码生成，先不建议直接生成到interface和ws中。除非所有接口均为所需接口。

下图为generatorConfig.xml所需修改注意事项

修改jdbc.properties为自己库的配置。

hz-base,hz-util,hz-beans三个基础jar包版本全都变更为0.1.0

启动文件为GenMain.java（如果不是要生成新表的话，就把所有路径一个临时路径，将代码进行赋值粘贴。以免覆盖原代码文件）

执行完后刷新生成目录所在的项目。即可看到生成代码

5、返回码

以添加为例，从controller到interface实现类。

私人项目返回码写在自己项目下的HzResultCode中，注明错误描述及注释，如下图示

有些公共返回码则在hz-beans的jar包下的ResultCode如下图示

私人项目返回码区间及urmp管理平台返回码样例定义如下图示

6、日志级别

mybatis访问数据库sql打印

如果需要打印访问数据库语句，在ws中将properties文件添加logging.level.com.hz=debug。