这里会显示出您选择的修订版和当前版本之间的差别。
start [2019/05/04 17:17] jinlong [未来计划] |
start [2020/07/12 12:07] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== EPPDEV-JEE ====== | ||
- | **DPPDEV-JEE**是一个由数据驱动的,基于Springboot的代码生成程序,可以根据数据库库表结构定义生成mybatis基础OR映射类,对应的基础Service和Controller,以及相应的基础类和工具类,生成的代码无任何私有依赖,完全可以独立运行。 | ||
- | |||
- | 本软件是开源软件,采用 **//[[https://github.com/eppdev/eppdev-jee-pom/blob/master/LICENSE|996 License v1.0]] //** 协议,代码仓库位于: | ||
- | |||
- | * **GitHub**: [[https://github.com/eppdev/eppdev-jee-pom|https://github.com/eppdev/eppdev-jee-pom]] | ||
- | * **Gitee**: [[https://gitee.com/eppdev/eppdev-jee-pom|https://gitee.com/eppdev/eppdev-jee-pom]] | ||
- | |||
- | |||
- | ===== 使用说明 ===== | ||
- | |||
- | ==== 环境准备 ==== | ||
- | |||
- | 在安装和使用EPPDEV-JEE之前,需要做必要的环境准备,主要包括: | ||
- | |||
- | * JDK(1.8以上版本) | ||
- | * 数据库(建议MySQL) | ||
- | * Git(可选) | ||
- | * Maven(编译需要)等 | ||
- | |||
- | 详细的环境准备要求参见:[[usage:environment|环境准备]] | ||
- | |||
- | ==== 编译与安装 ==== | ||
- | |||
- | 编译安装主要可以通过一下几个步骤完成: | ||
- | * 下载源代码(git clone) | ||
- | * 编译(maven package) | ||
- | * 修改配置文件中的配置(application.properties) | ||
- | * 启动程序(java -jar)等 | ||
- | |||
- | 详细的编译安装步骤参见: [[usage:install|编译与安装]] | ||
- | |||
- | ==== 代码生成 ==== | ||
- | |||
- | 代码生成主通过web页面进行完成,主要代码生成的配置也均通过web页面完成,需要提前配置的信息包括: | ||
- | |||
- | * 项目相关配置(如项目名、包名等等) | ||
- | * 各表及字段的相关配置(如是否主键、是否业务主键、是否创建相关查询条件等) | ||
- | |||
- | 具体的使用方式参见: [[usage:generate|代码生成]] | ||
- | |||
- | |||
- | |||
- | ===== 开发定制 ===== | ||
- | |||
- | ==== 基本定制 ==== | ||
- | EPPDEV-JEE的开发已基本实现了生成内容配置化管理,生成内容的相关配置主要包括: | ||
- | |||
- | * **整体配置**:eppdev-jee-cg/src/main/resources/eppdev-jee/eppdev.xml | ||
- | * **代码模板**:eppdev-jee-cg/src/main/resources/eppdev-jee/template/\*\*/*.ftl | ||
- | |||
- | |||
- | 基础的代码模板的修改请参见:[[dev:conf|基本定制说明]] | ||
- | |||
- | |||
- | ==== 二次开发 ==== | ||
- | |||
- | 针对仅仅依靠修改模板配置无法完成的功能,则需要修改程序代码,需要深入理解EPPDEV-JEE的设计思路,详见:[[dev:design|EPPDEV-JEE整体设计思路]] | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | ===== 技术栈 ===== | ||
- | |||
- | 主要使用的组件包括: | ||
- | |||
- | * [[https://spring.io/projects/spring-boot|springboot ]]:不用多说 | ||
- | * [[http://blog.mybatis.org |mybatis ]]:OR映射 | ||
- | * [[https://pagehelper.github.io|mybatis-pagehelper]]:Mybatis的物理分页 | ||
- | * [[https://www.thymeleaf.org | thymeleaf]]:WEB管理页面的展示 | ||
- | * [[https://freemarker.apache.org | FreeMarker]]:代码生成模板 | ||
- | |||
- | 各个技术应用使用说明详见:[[tech|技术栈说明]] | ||
- | |||
- | |||
- | ===== 版本计划 ===== | ||
- | |||
- | ==== 未来计划 ==== | ||
- | |||
- | |||
- | |||
- | * //**V0.1.4**//: 小版本优化,计划2019年5月,主要改造点: | ||
- | * 增加基于spring security的rest api权限验证机制 | ||
- | |||
- | |||
- | * //**V0.2**//: 更进一步的定制化功能,计划时间:2019年7月 | ||
- | * 实现各项内容是否生成的自动化定制 | ||
- | |||
- | 更多的软件版本计划参见:[[plan|更新计划]] | ||
- | |||
- | |||
- | ==== 版本历史 ==== | ||
- | |||
- | 近期主要版本升级如下: | ||
- | |||
- | * <del>//**v0.1.3**//</del>: 小版本升级,完成时间20190503 | ||
- | * 自动生成Test相关内容 | ||
- | |||
- | |||
- | |||
- | * <del>//**v0.1.2**//</del>: bugfix,完成时间20190327 | ||
- | * 针对插入或修改前的逻辑主键判断,只查询一条数据,避免因逻辑主键为空导致获取到大量的数据问题 | ||
- | * 增加996ICU LICENSE | ||
- | |||
- | |||
- | * <del>//**v0.1.1**//</del>:小版本优化,计划时间2019年3月,实际完成2019-02-20,主要改造点: | ||
- | * 针对单机版实现本地配置覆盖服务器通用配置 | ||
- | |||
- | * <del>//**v0.1 **//</del>:第一次正式发布,实际完成时间2019-01-17: | ||
- | * 在原有的代码生成器基础上,采用FreeMarker进行了代码的改造 | ||
- | * 将可以个性化定制修改的代码和不能手工修改(重新生成后会覆盖)的代码的分离 | ||
- | * 将查询参数从映射的实体类中分离,实现查询参数的可定制化 | ||
- | |||
- | |||
- | 详细的版本历史参见 [[history|版本历史]] |