第一步:准备工作
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注解
- // 在执行refresh时会刷新bean中变量值
- @RefreshScope
配置文件添加
- ws服务直接调用/refresh 就会更新修改后的配置文件
- 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。