AppsuarArchetypes JAVA

新手上路

依赖安装软件

1. IDEA 社区版 安装(Lombok,SaveAction)插件
2. JAVA1.8
3. Git
4. Gradle 6.6

技术架构简介

1. 核心框架使用SpringBoot + SpringWeb + SpringDataJpa.
2. 使用gradle来构建工程,并使用Lombok减少代码量提高可读性.
3. 工程基于测试驱动,测试模块包含(MockWebMvc,Redis,Kafka,DataJpa,DataJdbc,Feign,Rest)测试用例

克隆基础项目到本地并编译

1. 执行命令 “git clone https://gitee.com/shenliuyang/sand-box.git”
2. 待克隆完成后,执行进入目录命令 " cd appsugar-web-archetypes-kotlin/"
3. 进入该项目后执行编译命令 windows: “gradle build” linux-mac “gradle build”
4. 第一次编译会消耗很多时间,系统需要下载对应编译工具与项目所依赖的jar包.
5. 直至控制台出现BUILD SUCCESSFUL.标志着编译成功.
6. 在IDEA中导入该项目(以gradle方式)

执行单元测试

1. 在IDEA中打开src/main/test/java/org/appsugar/archetypes/repository/jpa/UserRepositoryTest
2. 双击并选中"testFindAll"方法, 右击进行 run UserRepositoryTest…
3. 等候idea进行单元测试完成, 可以在控制台看到如下日志输出"2020:08:230:11:21:54.422 [Test worker] DEBUG o.a.a.r.jpa.UserRepositoryTest – testFindAll result is [User(id=1, name=newyoung, loginName=admin, address=china, [email protected], age=32), User(id=2, name=keson, loginName=admin, address=china, [email protected], age=32)]
   "

添加单元测试数据

1. 找到并打开src/test/resources/db.migration/R_add_user.sql
2. 在文件中换行并插入insert into appsugar_user(id,name,login_name,address,email,age) values(10,‘test’,‘test’,‘test’,‘test’,3);
3. 返回上一步并执行测试方法, 你会发现控制台输出结果"2020:08:230:11:30:08.355 [Test worker] DEBUG o.a.a.r.jpa.UserRepositoryTest – testFindAll result is [User(id=1, name=newyoung, loginName=admin, address=china, [email protected], age=32), User(id=2, name=keson, loginName=admin, address=china, [email protected], age=32), User(id=10, name=test, loginName=test, address=test, email=test, age=3)]
   " 包含我们刚插入的测试数据.

运行与打包

1. 执行gradle bootRun 运行该工程.
2. 执行gradle clean build 进行打包(快速打包执行 gradle build 免去重复编译带来的时间消耗)

NextStep

1. 对SpringDataJpa进行深入了解, 添加Role实体类并对User类进行多对多关联. 添加对应Repository,Controller与相关的测试数据与测试类.
2. 参照org.appsugar.archetypes.controller.UserControllerTest 进行 RoleController的冒烟测试