懒猴子CG - 跨语言的程序员极速开发平台

# 2.1.6版本说明 1. 完善了README关于swagger的部分 2. 修复生成时不包含swagger时，PageWrap类编译报错问题 3. 完善了.gitignore内容 # 2.1.5版本说明 1. 完善分页排序功能，过滤掉了不正确的排序对象 2. 完善了swagger参数 ##### swagger注意事项 在使用swagger测试分页接口时，应注意model参数值，model参数为查询条件，默认情况下，使用mybatis框架时通过ExampleBuilder已自动过滤掉了空值，但在springjpa框架下没有过滤空值，所以使用springjpa时，请注意删除model中的空值参数。 # 2.1.4版本说明 修复数据库连接地址不正确的BUG # 2.1.3版本说明 1. 在此版本之前，mybatis查询时条件为空串也会当作SQL条件来处理，此版本通过修改ExampleBuilder类过滤了空串条件。如果你的确需要将空串作为SQL条件，你可以使用以下代码来完成： ```java <example builder>.buildExamplePack(<condition model>).getCriteria() .andNameEqualTo(""); ``` 2. 去掉数据库连接的serverTimezone参数，防止程序设定与数据库设定的时区不一致导致时间值不正确。 # 2.0更新内容说明 ### 一、删除MyBatisUtil类，新增ExampleBuilder类，可更方便的扩展查询条件 在1.x版本，选用mybatis作为持久层，mybatis example封装类辅助我们实现CRUD时，框架中提供的 **MyBatisUtil** 类只实现了精准查询，而如果需要实现模糊查询或Range操作需要自行构建Example实例，我们在2.0版本优化了此项内容。为此我们在2.0添加了 **ExampleBuilder** 类，她可以帮助我们更容易的在原有条件下新增新的条件。她提供以下内容： ###### i. 提供构建自身实例的静态方法 ```java public static <E,C> ExampleBuilder<E,C> create(Class<E> exampleClass, Class<C> criteriaClass) { return new ExampleBuilder<>(exampleClass, criteriaClass); } ``` 为了让构建ExampleBuilder实例得到更好的维护，我们通过create静态方法来构建，避免重复new操作。 ###### ii. 提供将实体类转为Example类的实例方法 ```java public ExamplePack<E,C> buildExamplePack(Object model) {} ``` 方法接收一个装载条件的实体类，返回Example的包装类 ###### iii. 提供包装Example和Criteria的内部类 ```java public static class ExamplePack<E, C> { private E example; private C criteria; } ``` 通过 **buildExamplePack** 实例方法可获取该内部类实例，进而可获取Example和Criteria实例进行其它操作。 ### 二、增加分页接口，接口增加@RequestBody注解 为了满足前后端分离的需求，2.0版本接口增加了 **@RequestBody** 注解。在1.x版本中我们没有提供分页接口，在2.0版本中我们补充了此项内容，以合理的方式封装了分页参数对象 **PageWrap** ，通过该类，我们可以很方便的实现分页，单/多个字段排序的需求。 ##### core/model/PageWrap.java ```java @Data @ApiModel("分页对象") public class PageWrap<M> { @ApiModelProperty("条件参数") private M model; @ApiModelProperty("目标页") private int page; @ApiModelProperty("一页多少行") private int capacity; @ApiModelProperty("排序参数") private List<SortData> sorts; @Data @ApiModel("排序对象") public static class SortData { @ApiModelProperty("排序字段") private String property; @ApiModelProperty("排序方向（ASC：升序，DESC：降序）") private String direction; } } ``` 可以看到PageWrap中通过泛型定义了条件参数对象和排序内部类，分别用于用于接受查询条件和排序字段/方向。 ### 三、警告消除 在1.x版本中，分页类PageData、Service实现类等均有警告代码。在2.0中，我们尽可能的消除了这些警告。 ### 四、视图层封装发送移步请求的$.request方法 为了可以统一处理ajax请求，在head.html/head.jsp中，我们封装了$.request方法，如下： ##### head.html/head.jsp ```javascript (function () { $.request = function (param) { param.url = basePath + param.url; param.method = param.method || 'POST'; param.data = param.data == null ? null : JSON.stringify(param.data); param.contentType = param.contentType || 'application/json'; $.ajax(param) }; })() ``` # 从1.x升级到2.0 ##### i. 升级操作 - 添加PageWrap类至项目中 - 将2.0中的 PageData 覆盖当前项目中的 PageData - （如使用的是MyBatis & MyBatis Example）保留1.x中的 MyBatisUtil 类，将2.0中的 ExampleBuilder 类拷贝至项目中，接口实现可保持不变 - （如使用了JSP或Thymeleaf）将2.0中head.html/head.jsp中$.request封装部分拷贝至对应位置，原发送接口方式可保持不变，在新的开发任务中使用$.request来处理异步请求。 ##### ii. 原有接口处理 原有接口可保持不变 ##### iii. 新接口的开发 新接口可以通过接口生成2.0版本进行快速开发。

• 框架
• 接口生成

Java助手

此模版基于SpringBoot框架将项目合理的拆分为多个maven模块，适用于多个web共用service的站点。模版提供内容如下： 1. 提供可选的持久层框架（可选MyBatis、SpringJPA） 2. 根据你选择的持久层框架提供分页、排序功能的封装 3. 提供完善的API文档处理（可选Swagger-UI、Swagger-Bootstrap-UI） 4. 提供丰富的视图层处理方式（可选Thymeleaf、JSP或不使用任何视图层） 5. 提供可选的jUnit单元测试 6. 提供可选的打包方式（JAR或WAR） 7. 提供可选的配置文件类型（YAML或Properties） 8. 提供基于logback的日志配置 9. 提供可靠的全局异常处理 # 基础接口生成 你可以通过【接口生成】下的模版完成基础接口的代码编写。 # 添加新的WEB工程 我们会提供构建WEB工程的模版，预计在10月5日完成。 # 使用JSP的额外配置 如果视图层使用的是JSP，则很有可能碰到无法访问页面的问题。此时你需要配置Working directory，如下图： 1. 打开启动类的配置  2. 设置Working directory为对应的web工程  # 联系我们 如果你在使用此模版时遇到任何问题，可以加入QQ群877957236进行咨询。

• 框架
• 接口生成

Java助手