flying MyBatis 的扩展插件 项目简介
flying 是一个可以极大增加 mybatis 开发速度的插件组,它提供了一种全新的操作数据的方式,希望能对您有所帮助。众所周知,mybatis 虽然易于上手,但放到互联网环境下使用时,不可避免的要面对诸如‘’一级缓存存在脏数据‘’、‘’需要写大量明文 SQL 语句‘’等问题。对于这些问题 mybatis 的开发团队选择了一种谦逊的方式,他们开放 mybatis 接口,允许用户开发插件,按自己的方式来解决这些问题。于是,一切 ORM 领域相关的问题在 mybatis 上通过插件都有了解决方案。flying 主要特点: 以前我们在 mapper.xml 中要写很复杂的 sql 语句,但现在在 mapper.xml 中只需这样:<select id="select" resultMap="result">
flying#{?}:select
</select>
<select id="selectOne" resultMap="result">
flying:selectOne
</select>
<insert id="insert">
flying:insert
</insert>
<update id="update">
flying:update
</update>
<delete id="delete">
flying:delete
</delete> 再在您的实体类上加上这样一些标注:package myPackage;
import javax.persistence.Column;
import javax.persistence.Id;
import javax.persistence.Table;
@Table(name = "account")
public class Account {
@Id
@Column
private Integer id;
@Column
private java.lang.String name;
@Column
private Integer age;
/* 省略 getter 和 setter */
} flying 就完全明白您的数据结构和您想做的事情了。 接下来您增删改查这个实体就会变得非常简单:/* 新增 */
Account newAccount = new Account();
newAccount.setName("ann");
newAccount.setAge(18);
accountService.insert(newAccount);
/* 按主键查询 */
Account account = accountService.select(newAccount.getId());
/* 按姓名查询,这里忽略了年龄 */
Account accountC1 = new Account();
accountC1.setName("ann");
Account account1 = accountService.selectOne(accountC1);
/* account1 和 account 代表相同的业务数据 */
/* 按年龄查询,这里忽略了姓名 */
Account accountC2 = new Account();
accountC2.setAge(18);
Account account2 = accountService.selectOne(accountC2);
/* account2 和 account 代表相同的业务数据 */
/* 按姓名和年龄查询 */
Account accountC3 = new Account();
accountC3.setName("ann");
accountC3.setAge(18);
Account account3 = accountService.selectOne(accountC3);
/* account3 和 account 代表相同的业务数据 */
/* 修改 */
account.setName("bob");
accountService.update(newAccount);
/* 按主键删除 */
accountService.delete(newAccount); 由于 flying 掌握了您全部的数据结构和实体关系,所以操作数据变得非常简单,您再也不需要定义 “getAccountById、getAccountByName、getAccountByAge” 这样重复性强的方法了,由此带来更大的好处是您的 service 层只需要关注事务方面的逻辑即可,它从低级代码中完全解放了出来。以上只是 flying 功能的冰山一角,其它的功能如多表联查、分页、乐观锁、或逻辑查询、复杂外键关系等 flying 都有简单的解决方案,您可以在 https://flyingdoc.gitee.io/ 中进行查看。 flying 特点总结如下:数据操作入参和返回类型都是自定义的实体类,完全 no sql 杜绝各种‘’手滑‘’,项目可随意重构。 支持跨表操作和跨数据源操作。 非侵占工作机制,可以和您已有的 mybatis 方法协同工作。 加入了优化过的缓存插件,可以对多数据源环境下 flying 方法和传统 mybatis 方法同时进行缓存管理。 可以自定义主键生成器,全面支持或逻辑查询。(初雪版新增特性) 可以在 flying 语句中指定查询的数据库和数据源,达到高性能跨库查询。(阳春版新增特性) flying 获取方式: flying 的 maven 坐标为:<groupId>com.github.limeng32</groupId>
<artifactId>mybatis.flying</artifactId>
<version>0.9.9</version> mybatis 版本与 flying 最新版本 清明 的对应关系见下:mybatis 版本 flying-初雪 flying-阳春 flying-清明 3.3.0、3.3.1 0.8.3 不再支持 不再支持 3.4.0、3.4.1、3.4.2、3.4.3、3.4.4、3.4.5、3.4.6 0.9.3 0.9.4 0.9.9 之所以采用分版本发布的方式是因为我们对 mybatis 每个版本的用户都认真负责,力求使您得到 flying 最大的好处。flying 代码示例: 我们还为您提供了一个快速上手的示例:最新版本demo:https://gitee.com/limeng32/flying-demo-use-springboot 更多内容请您参见软件文档 https://flyingdoc.gitee.io/。清明 新增内容:支持复杂的外键关系,如 join 的条件是同时满足多个逻辑判断且不仅限于相等 在默认左联接的基础上支持右联接 修正上一版本在高并发场景下 sql 语句有时会混乱的问题 demo 完全由 spring-boot 方式重构阳春 新增内容:@FieldMapperAnnotation 和 @ConditionMapperAnnotation 增加了 customTypeHandler 属性,其具有最高优先级。初雪 新增内容: 自定义主键生成器,包括 flying 内置和完全自定义两种形式。 全面支持或逻辑查询,可以用在普通查询和跨表查询中。 @QueryMapperAnnotation 现在可以省略,只要您的某个类既继承实体 pojo 又实现 Conditionable 接口 flying 就可以判断出它是相关 pojo 的条件类。 0.9.2 新增内容:兼容 JPA 中的 @Column、@Id、@Table 标签,这些标签可以和 @FieldMapperAnnotation、@TableMapperAnnotation 协同使用,优先级从高到低为:@Id、@FieldMapperAnnotation 和 @TableMapperAnnotation、@Column 和 @Table。 现在 ignoreTag 对 insert、update、updatePersistent 也会起作用。如果 @Column 中设置 insertable = false 和 updateable = false,会在新增和修改时起到永久性忽略的作用。
flying#{?}:select
</select>
<select id="selectOne" resultMap="result">
flying:selectOne
</select>
<insert id="insert">
flying:insert
</insert>
<update id="update">
flying:update
</update>
<delete id="delete">
flying:delete
</delete> 再在您的实体类上加上这样一些标注:package myPackage;
import javax.persistence.Column;
import javax.persistence.Id;
import javax.persistence.Table;
@Table(name = "account")
public class Account {
@Id
@Column
private Integer id;
@Column
private java.lang.String name;
@Column
private Integer age;
/* 省略 getter 和 setter */
} flying 就完全明白您的数据结构和您想做的事情了。 接下来您增删改查这个实体就会变得非常简单:/* 新增 */
Account newAccount = new Account();
newAccount.setName("ann");
newAccount.setAge(18);
accountService.insert(newAccount);
/* 按主键查询 */
Account account = accountService.select(newAccount.getId());
/* 按姓名查询,这里忽略了年龄 */
Account accountC1 = new Account();
accountC1.setName("ann");
Account account1 = accountService.selectOne(accountC1);
/* account1 和 account 代表相同的业务数据 */
/* 按年龄查询,这里忽略了姓名 */
Account accountC2 = new Account();
accountC2.setAge(18);
Account account2 = accountService.selectOne(accountC2);
/* account2 和 account 代表相同的业务数据 */
/* 按姓名和年龄查询 */
Account accountC3 = new Account();
accountC3.setName("ann");
accountC3.setAge(18);
Account account3 = accountService.selectOne(accountC3);
/* account3 和 account 代表相同的业务数据 */
/* 修改 */
account.setName("bob");
accountService.update(newAccount);
/* 按主键删除 */
accountService.delete(newAccount); 由于 flying 掌握了您全部的数据结构和实体关系,所以操作数据变得非常简单,您再也不需要定义 “getAccountById、getAccountByName、getAccountByAge” 这样重复性强的方法了,由此带来更大的好处是您的 service 层只需要关注事务方面的逻辑即可,它从低级代码中完全解放了出来。以上只是 flying 功能的冰山一角,其它的功能如多表联查、分页、乐观锁、或逻辑查询、复杂外键关系等 flying 都有简单的解决方案,您可以在 https://flyingdoc.gitee.io/ 中进行查看。 flying 特点总结如下:数据操作入参和返回类型都是自定义的实体类,完全 no sql 杜绝各种‘’手滑‘’,项目可随意重构。 支持跨表操作和跨数据源操作。 非侵占工作机制,可以和您已有的 mybatis 方法协同工作。 加入了优化过的缓存插件,可以对多数据源环境下 flying 方法和传统 mybatis 方法同时进行缓存管理。 可以自定义主键生成器,全面支持或逻辑查询。(初雪版新增特性) 可以在 flying 语句中指定查询的数据库和数据源,达到高性能跨库查询。(阳春版新增特性) flying 获取方式: flying 的 maven 坐标为:<groupId>com.github.limeng32</groupId>
<artifactId>mybatis.flying</artifactId>
<version>0.9.9</version> mybatis 版本与 flying 最新版本 清明 的对应关系见下:mybatis 版本 flying-初雪 flying-阳春 flying-清明 3.3.0、3.3.1 0.8.3 不再支持 不再支持 3.4.0、3.4.1、3.4.2、3.4.3、3.4.4、3.4.5、3.4.6 0.9.3 0.9.4 0.9.9 之所以采用分版本发布的方式是因为我们对 mybatis 每个版本的用户都认真负责,力求使您得到 flying 最大的好处。flying 代码示例: 我们还为您提供了一个快速上手的示例:最新版本demo:https://gitee.com/limeng32/flying-demo-use-springboot 更多内容请您参见软件文档 https://flyingdoc.gitee.io/。清明 新增内容:支持复杂的外键关系,如 join 的条件是同时满足多个逻辑判断且不仅限于相等 在默认左联接的基础上支持右联接 修正上一版本在高并发场景下 sql 语句有时会混乱的问题 demo 完全由 spring-boot 方式重构阳春 新增内容:@FieldMapperAnnotation 和 @ConditionMapperAnnotation 增加了 customTypeHandler 属性,其具有最高优先级。初雪 新增内容: 自定义主键生成器,包括 flying 内置和完全自定义两种形式。 全面支持或逻辑查询,可以用在普通查询和跨表查询中。 @QueryMapperAnnotation 现在可以省略,只要您的某个类既继承实体 pojo 又实现 Conditionable 接口 flying 就可以判断出它是相关 pojo 的条件类。 0.9.2 新增内容:兼容 JPA 中的 @Column、@Id、@Table 标签,这些标签可以和 @FieldMapperAnnotation、@TableMapperAnnotation 协同使用,优先级从高到低为:@Id、@FieldMapperAnnotation 和 @TableMapperAnnotation、@Column 和 @Table。 现在 ignoreTag 对 insert、update、updatePersistent 也会起作用。如果 @Column 中设置 insertable = false 和 updateable = false,会在新增和修改时起到永久性忽略的作用。