flyingMyBatis 的扩展插件-轻识

flying 是一个可以极大增加 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，会在新增和修改时起到永久性忽略的作用。