# ApplicationPower **Repository Path**: carlbase/ApplicationPower ## Basic Information - **Project Name**: ApplicationPower - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 136 - **Created**: 2018-01-12 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ApplicationPower 是一个快速的项目生成脚手架，只需要连接数据库便可快速的创建一个基于maven构建的SpringMvc+Mybatis或者是Spring Boot+Mybatis架构的项目。 创建的标准工程无论是基于SpringMvc的传统项目还是基于Spring Boot的微服务项目都可做到开箱即可正确运行，使用它两分钟就可以快速的创建一个学习的demo或者是一个项目初期的 架构。ApplicationPower在创建过程中会帮您创建许多标准的配置文件和通用代码，屏蔽了人工创建项目初期中的配置繁琐和错误情况，大大减少了初期建项目工程的时间。
ApplicationPower是基于beetl模板来生成源代码的，因此可以灵活的修改模板来生成代码定义自己的开发接口规范。ApplicationPower在一直不断努力地去减少项目开发 中的各种重复工作。
技术交流群：170651381
**重点：** ApplicationPower目前对于Springboot+Mybatis框架的项目创建能力更加，因此推荐选择她来创建springboot。 ## 创建的项目技术 ● 核心框架：Spring Boot 1.5.9 或Spring MVC 4.3.6 ● 数据库连接池：druid-spring-boot-starter 1.1.6或druid 1.1.6 ● 持久层框架：mybatis-spring-boot-starter或MyBatis 3.4.2 ● 分页插件：pagehelper-spring-boot-starter或pagehelper 5.x ● 分布式事务管理：spring-boot-starter-jta-atomikos或atomikos 4.04 ● 日志管理：SLF4J和log4j2 ## 结构说明 1. api-doc是一个未来将使用原生doc注释来生成markdown api文档的项目，目前不可用 2. common-util是开发中常用的一些工具类，目前文档比较详细，也是application-power所依赖的模块，在使用application-power前需要将它安装到你的本地。 3. application-power是整个项目的核心，专门用于生成Spring Boot微服务架构项目和Spring mvc+mybatis架构项目的脚手架， 4. datasource-aspect是spring web应用下多数据源动态切换的通用模块 5. mybatis-template是用于重写SqlSessionTemplate来支持分布式事务环境下的动态数据源切换 ## 版本说明 1. v1.0版本的CommonResult依赖于boco-health-common模块 2. v1.1版本的CommonResult改为依赖独立模块Common-util 3. v1.2版本升级spring到4.3.6，Controller层生成的代码使用@GetMapping和@PostMapping代替@RequestMapping注解。 4. v1.3版本升级mybatis和druid的版本，项目框架摒弃log4j，全面将日志升级到log4j2框架，mysql驱动升级到6.x,支持创建springboot项目。 5. v1.4版本升级实现生成方法可自由控制(ps:参考generator.properties中配置)，基础方法增加一个返回List>的方法。 6. v1.4.1版本升级springboot和其他依赖的版本，修改springboot测试模板错误，springboot项目增加springloaded热部署插件。 7. v1.4.2版本优化生成代码时对数据库的连接次数，restful接口单元测试生成中add和update方法增加自动添加参数和赋予随机值的功能 8. v1.5版本增加springboot项目基于assembly的服务化打包功能，完备的服务脚本使得在window或linux系统启动和运维项目更轻松 9. v1.6版本增加配置来支持springmvc和springboot多数据源动态切换和atomikos分布式事务支持，快随构建一个数据一致性架构的项目. demo:https://gitee.com/sunyurepository/multiple-datasource 10. v1.6.1版本修改生成的springboot项目打成jar包后mybatis别名扫描出错的bug ps: [1.6及以前的版本地址：](https://gitee.com/stana/ApplicationPower) ## 功能 1. 根据连接的数据生成dao,model,service,controller,mapper,controllerTest,serviceTest代码 2. 项目的maven web基础骨架 3. 生成基于spring,spring mvc,mybatis框架结构项目所需的基础配置文件 4. 生成web.xml配置文件 5. 可以修改模板生成自己喜欢风格或者说修改修改来生成自己习惯的方法名 6. 基于SL4J面向接口的标注化日志输出 7. 支持创建多数据源和集成atomikos分布式事务 ## 使用说明 1.使用注意事项 在已经进行后，请勿将ApplicationPower的输出目录指定到当前工程，否则会出现代码覆盖，因此建议项目开发启动后将代码生成到别的地方拷贝到自己工 程下，后续会提供不覆盖配置，但是也有可能忘记修改配置，所以还是要小心。 2.根据自己实际需求，修改generator.properties中的配置 ``` #是否生成注释 generator.comment=true #代码输出目录 generator.outDir=E:\\Test #基包名 generator.basePackage=com.boco.demo #数据库表前缀,例如表t_user则需要去除前缀生成正确的实体 generator.table.prefix=t_ #指定需要用哪张数据表生成代码，不指定则生成全部表的代码 generator.table.name= #生成项目的名称 generator.applicationName=bootstrap-tree #需要生成的代码层 #可生成的代码层dao,model,service,controller,mapper,controllerTest,serviceTest generator.layers=dao,model,service,controller,mapper,controllerTest #需要生成的方法，方法间用英文逗号隔开，写错将无法生成基础方法 #可生成的方法包括add,update,delete,query,page,queryToListMap。 # query方法查询单条数据，page生成分页,queryToListMap是查询结果以List>返回 generator.methods=add,update,delete,query,page,queryToListMap #mybatis自动转驼峰映射，默认开启 generator.mapUnderscoreToCamelCase=true #是否开启mybatis缓存，只能填写true或者false generator.enableCache=true #是否需要生成mybatis mapper配置文件的ResultMap #默认不生成result generator.resultMap=false # @since 1.5 # 打包springboot时是否采用assembly # 如果采用则将生成一系列的相关配置和一系列的部署脚本 generator.package.assembly=false #@since 1.6 # 多数据源多个数据数据源用逗号隔开，不需要多数据源环境则空出来 # 对于多数据源会集成分布式事务 generator.multiple.datasource=one,two # @since 1.6 # jta-atomikos分布式事务支持 generator.jta=true ``` 3.修改数据库配置jdbc.properties ``` jdbc.driver=com.mysql.jdbc.Driver jdbc.username=root jdbc.password=root jdbc.url=jdbc\:mysql\://localhost:3306/cookbook?useUnicode=true&characterEncoding=UTF-8 ``` 4.运行Test下的GenerateCodeTest生成项目 ``` //生成普通SSM框架的maven工程 new CodeWriter().execute(); //生成Springboot+Mybatis的工程 new CodeWriter().executeSpringBoot(); ``` 5.将生成的项目导入编辑器 ## 使用模板介绍 1.model层模板 ``` package ${basePackage}.model; import java.io.Serializable; ${modelImports} /** * * @author ${authorName} * @date ${createTime} * */ public class ${entitySimpleName} implements Serializable{ private static final long serialVersionUID = ${SerialVersionUID}L; ${fields} /** getters and setters */ ${gettersAndSetters} } ``` 2.dao层模板 ``` package ${basePackage}.dao; import java.util.List; import java.util.Map; import ${basePackage}.model.${entitySimpleName}; /** * * @author ${authorName} * @date ${createTime} * * */ public interface ${entitySimpleName}Dao{ /** * 保存数据 * @param entity * @return */ int save(${entitySimpleName} entity); /** * 更新数据 * @param entity * @return */ int update(${entitySimpleName} entity); /** * 删除数据 * @param id * @return */ int delete(int id); /** * 根据id查询数据 * @param id * @return */ ${entitySimpleName} queryById(int id); /** * 查询所有数据 * @return */ List<${entitySimpleName}> queryAll(); /** * query result to list of map * @param params Map查询参数 * @return */ List> queryToListMap(Map params); } ``` 3.service层模板 ``` package ${basePackage}.service; import java.util.List; import java.util.Map; import com.boco.common.model.CommonResult; import ${basePackage}.model.${entitySimpleName}; /** * * @author ${authorName} * @date ${createTime} * */ public interface ${entitySimpleName}Service{ /** * 保存数据 * @param entity * @return */ CommonResult save(${entitySimpleName} entity); /** * 修改数据 * @param entity * @return */ CommonResult update(${entitySimpleName} entity); /** * 删除数据 * @param id * @return */ CommonResult delete(int id); /** * 根据id查询数据 * @param id * @return */ CommonResult queryById(int id); /** * 查询所有数据 * @return */ List<${entitySimpleName}> queryAll(); /** * query result to list of map * @param params Map查询参数 * @return */ List> queryToListMap(Map params); } ``` 4.service实现层模板 ``` package ${basePackage}.service.impl; import java.util.List; import java.util.Map; import javax.annotation.Resource; import org.springframework.stereotype.Service; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import com.github.pagehelper.PageHelper; import com.github.pagehelper.PageInfo; import com.boco.common.model.CommonResult; import ${basePackage}.model.${entitySimpleName}; import ${basePackage}.dao.${entitySimpleName}Dao; import ${basePackage}.service.${entitySimpleName}Service; /** * Created by ApplicationPower. * @author ${authorName} on ${createTime}. */ @Service("${firstLowerName}Service") public class ${entitySimpleName}ServiceImpl implements ${entitySimpleName}Service{ /** * 日志 */ private static Logger logger = LoggerFactory.getLogger(${entitySimpleName}Service.class); @Resource private ${entitySimpleName}Dao ${firstLowerName}Dao; @Override public CommonResult save(${entitySimpleName} entity) { CommonResult result = new CommonResult(); try { ${firstLowerName}Dao.save(entity); result.setSuccess(true); } catch (Exception e) { result.setMessage("添加数据失败"); logger.error("${entitySimpleName}Service添加数据异常：",e); } return result; } @Override public CommonResult update(${entitySimpleName} entity) { CommonResult result = new CommonResult(); try { ${firstLowerName}Dao.update(entity); result.setSuccess(true); } catch (Exception e) { result.setMessage("修改数据失败"); logger.error("${entitySimpleName}Service修改数据异常：",e); } return result; } @Override public CommonResult delete(int id) { CommonResult result = new CommonResult(); try { ${firstLowerName}Dao.delete(id); result.setSuccess(true); } catch (Exception e) { result.setMessage("删除数据失败"); logger.error("${entitySimpleName}Service删除数据异常：",e); } return result; } @Override public CommonResult queryById(int id) { CommonResult result = new CommonResult(); ${entitySimpleName} entity = ${firstLowerName}Dao.queryById(id); if (null != entity) { //成功返回数据 result.setData(entity); result.setSuccess(true); } else { result.setMessage("没有找到匹配数据"); logger.info("${entitySimpleName}Service未查询到数据，编号：{}",id); } return result; } @Override public PageInfo queryPage(int offset, int limit) { PageHelper.offsetPage(offset,limit); List<${entitySimpleName}> list = ${firstLowerName}Dao.queryPage(); return new PageInfo(list); } @Override public List> queryToListMap(Map params){ return ${firstLowerName}Dao.queryToListMap(params); } } ``` 5.controller层模板 ``` package ${basePackage}.controller; import java.util.List; import java.util.Map; import javax.annotation.Resource; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import com.github.pagehelper.PageInfo; import com.boco.common.model.CommonResult; import ${basePackage}.model.${entitySimpleName}; import ${basePackage}.service.${entitySimpleName}Service; /** * Created by ApplicationPower. * @author ${authorName} on ${createTime}. */ @Controller @RequestMapping("${firstLowerName}") public class ${entitySimpleName}Controller { /** * 日志 */ private static Logger logger = LoggerFactory.getLogger(${entitySimpleName}Controller.class); @Resource private ${entitySimpleName}Service ${firstLowerName}Service; @ResponseBody @PostMapping(value = "/add") public CommonResult save(${entitySimpleName} entity) { return ${firstLowerName}Service.save(entity); } @ResponseBody @PostMapping(value = "/update") public CommonResult update(${entitySimpleName} entity) { return ${firstLowerName}Service.update(entity); } @ResponseBody @GetMapping(value = "/delete/{id}") public CommonResult delete(@PathVariable int id) { return ${firstLowerName}Service.delete(id); } @ResponseBody @GetMapping(value = "/query/{id}") public CommonResult queryById(@PathVariable int id) { return ${firstLowerName}Service.queryById(id); } @ResponseBody @GetMapping(value = "/page/{offset}/{limit}") public PageInfo queryPage(@PathVariable int offset,@PathVariable int limit) { return ${firstLowerName}Service.queryPage(offset,limit); } @ResponseBody @GetMapping(value = "/listMap") public List> queryToListMap(@RequestParam Map params) { return ${firstLowerName}Service.queryToListMap(params); } } ```