Mybatis-Flex 1.0-beta2 发布，一个优雅的 Mybatis 增强框架
Mybatis-Flex 一个优雅的 Mybatis 增强框架。 特征 1、很轻量，整个框架只依赖 Mybatis 再无其他第三方依赖 2、只增强，支持 Entity 的增删改查、及分页查询，但不丢失 Mybatis 原有功能 3、Db + Row，可以无需实体类对数据库进行增删改查 4、支持多种数据库类型，自由通过方言持续扩展 5、支持联合主键，以及不同的主键内容生成策略 6、极其友好的 SQL 联动查询，IDE 自动提示不再担心出错 7、更多小惊喜 开始 Maven 依赖 示例项目 hello world 第一步：编写 Entity 实体类 @Table("tb_account") public class Account { @Id() private Long id; private String userName; private Date birthday; private int sex; //getter setter } 第二步，编写 Mapper 类，并继承 BaseMapper public interface AccountMapper extends BaseMapper<Account> { //只需定义 Mapper 接口即可，可以无任何内容。 } 第三步：开始查询数据 示例 1：查询 1 条数据 class HelloWorld { public static void main(String... args) { HikariDataSource dataSource = new HikariDataSource(); dataSource.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/mybatis-flex"); dataSource.setUsername("username"); dataSource.setPassword("password"); MybatisFlexBootstrap.getInstance() .setDatasource(dataSource) .addMapper(AccountMapper.class) .start(); //示例1：查询 id=100 条数据 Account account = MybatisFlexBootstrap.getInstance() .execute(AccountMapper.class, mapper -> mapper.selectOneById(100) ); } } 示例2：查询列 //示例2：通过 QueryWrapper 构建条件查询数据列表 QueryWrapper query = QueryWrapper.create() .select() .from(ACCOUNT) .where(ACCOUNT.ID.ge(100)) .and(ACCOUNT.USER_NAME.like("张").or(ACCOUNT.USER_NAME.like("李"))); // 执行 SQL： // ELECT * FROM `tb_account` // WHERE `tb_account`.`id` >= 100 // AND (`tb_account`.`user_name` LIKE '%张%' OR `tb_account`.`user_name` LIKE '%李%' ) List<Account> accounts = MybatisFlexBootstrap.getInstance() .execute(AccountMapper.class, mapper -> mapper.selectListByQuery(query) ); 示例3：分页查询 // 示例3：分页查询 // 查询第 5 页，每页 10 条数据，通过 QueryWrapper 构建条件查询 QueryWrapper query = QueryWrapper.create() .select() .from(ACCOUNT) .where(ACCOUNT.ID.ge(100)) .and(ACCOUNT.USER_NAME.like("张").or(ACCOUNT.USER_NAME.like("李"))) .orderBy(ACCOUNT.ID.desc()); // 执行 SQL： // ELECT * FROM `tb_account` // WHERE `id` >= 100 // AND (`user_name` LIKE '%张%' OR `user_name` LIKE '%李%' ) // ORDER BY `id` DESC // LIMIT 40,10 Page<Account> accounts = MybatisFlexBootstrap.getInstance() .execute(AccountMapper.class, mapper -> mapper.paginate(5, 10, query) ); QueryWrapper 示例 select * QueryWrapper query=new QueryWrapper(); query.select().from(ACCOUNT) // SQL: // SELECT * FROM tb_account select columns QueryWrapper query=new QueryWrapper(); query.select(ACCOUNT.ID,ACCOUNT.USER_NAME).from(ACCOUNT) // SQL: // SELECT id, user_name // FROM tb_account QueryWrapper query=new QueryWrapper(); query.select(ACCOUNT.ALL_COLUMNS).from(ACCOUNT) // SQL: // SELECT id, user_name, birthday, sex, is_normal // FROM tb_account select functions QueryWrapper query=new QueryWrapper() .select( ACCOUNT.ID, ACCOUNT.USER_NAME, max(ACCOUNT.BIRTHDAY), avg(ACCOUNT.SEX).as("sex_avg") ).from(ACCOUNT); // SQL: // SELECT id, user_name, // MAX(birthday), // AVG(sex) AS sex_avg // FROM tb_account where QueryWrapper queryWrapper=QueryWrapper.create() .select() .from(ACCOUNT) .where(ACCOUNT.ID.ge(100)) .and(ACCOUNT.USER_NAME.like("michael")); // SQL: // SELECT * FROM tb_account // WHERE id >= ? // AND user_name LIKE ? exists, not exists QueryWrapper queryWrapper=QueryWrapper.create() .select() .from(ACCOUNT) .where(ACCOUNT.ID.ge(100)) .and( exist( selectOne().from(ARTICLE).where(ARTICLE.ID.ge(100)) ) ); // SQL: // SELECT * FROM tb_account // WHERE id >= ? // AND EXIST ( // SELECT 1 FROM tb_article WHERE id >= ? // ) and (...) or (...) QueryWrapper queryWrapper=QueryWrapper.create() .select() .from(ACCOUNT) .where(ACCOUNT.ID.ge(100)) .and(ACCOUNT.SEX.eq(1).or(ACCOUNT.SEX.eq(2))) .or(ACCOUNT.AGE.in(18,19,20).or(ACCOUNT.USER_NAME.like("michael"))); // SQL: // SELECT * FROM tb_account // WHERE id >= ? // AND (sex = ? OR sex = ? ) // OR (age IN (?,?,?) OR user_name LIKE ? ) group by QueryWrapper queryWrapper=QueryWrapper.create() .select() .from(ACCOUNT) .groupBy(ACCOUNT.USER_NAME); // SQL: // SELECT * FROM tb_account // GROUP BY user_name having QueryWrapper queryWrapper=QueryWrapper.create() .select() .from(ACCOUNT) .groupBy(ACCOUNT.USER_NAME) .having(ACCOUNT.AGE.between(18,25)); // SQL: // SELECT * FROM tb_account // GROUP BY user_name // HAVING age BETWEEN ? AND ? join QueryWrapper queryWrapper = QueryWrapper.create() .select() .from(ACCOUNT) .leftJoin(ARTICLE).on(ACCOUNT.ID.eq(ARTICLE.ACCOUNT_ID)) .innerJoin(ARTICLE).on(ACCOUNT.ID.eq(ARTICLE.ACCOUNT_ID)) .where(ACCOUNT.AGE.ge(10)); // SQL: // SELECT * FROM tb_account // LEFT JOIN tb_article ON tb_account.id = tb_article.account_id // INNER JOIN tb_article ON tb_account.id = tb_article.account_id // WHERE tb_account.age >= ? 存在疑问？ 疑问 1：QueryWrapper 是否可以在分布式项目中通过 RPC 传输？ 答：可以。 疑问 2：如何通过实体类 Account.java 生成 QueryWrapper 所需要的 "ACCOUNT" 类 ? 答：Mybatis-Flex 使用了 APT（Annotation Processing Tool）技术，在项目编译的时候，会自动根据 Entity 类定义的字段帮你生成 "ACCOUNT" 类， 通过开发工具构建项目（如下图），或者执行 maven 编译命令:mvn clean package都可以自动生成。这个原理和 lombok 一致。 Db + Row 工具类 Db + Row 工具类，提供了在 Entity 实体类之外的数据库操作能力。使用 Db + Row 时，无需对数据库表进行映射， Row 是一个 HashMap 的子类，相当于一个通用的 Entity。以下为 Db + Row 的一些示例： //使用原生 SQL 插入数据 String sql = "insert into tb_account(id,name) value (?, ?)"; Db.insertBySql(sql,1,"michael"); //使用 Row 插入数据 Row account = new Row(); account.set("id",100); account.set("name","Michael"); Db.insertRow("tb_account",account); //根据主键查询数据 Row row = Db.selectOneById("tb_account","id",1); //Row 可以直接转换为 Entity 实体类，且性能极高 Account account = row.toEntity(Account.class); //查询所有大于 18 岁的用户 String listsql = "select * from tb_account where age > ?" List<Row> rows = Db.selectListBySql(sql,18); //分页查询：每页 10 条数据，查询第 3 页的年龄大于 18 的用户 QueryWrapper query = QueryWrapper.create() .where(ACCOUNT.AGE.ge(18)); Page<Row> rowPage = Db.paginate("tb_account",3,10,query); Db 工具类还提供了更多 增、删、改、查和分页查询等方法。 具体参考：Db.java。 Entity 部分字段更新 相比市面上的其他框架，这部分的功能应该也算是 MyBatis-Flex 的亮点之一。在 BaseMapper 中，Mybatis-Flex 提供了如下的方法： update(T entity, boolean ignoreNulls) 第一个参数是 entity 的对象。 第二个参数是是否忽略 null 值。 有些场景下，我们可能希望只更新 几个 字段，而其中个别字段需要更新为 null。此时需要用到UpdateEntity工具类，以下是示例代码： Account account = UpdateEntity.of(Account.class); account.setId(1); account.setUserName(null); account.setSex(1); accountMapper.update(account,false); 以上的示例中，会把 id 为 1 这条数据中的 user_name 字段更新为 null，sex 字段更新为 1，其他字段不会被更新。也就是说，通过UpdateEntity创建的对象，只会更新调用了 setter 方法的字段，若不调用 setter 方法，不管这个对象里的属性的值是什么，都不会更新到数据库。 其生成的 sql 内容如下： update tb_account set user_name = ? ,sex = ? where id = ? #params: null,1,1 多主键 Mybatis-Flex 多主键就是在 Entity 类里有多个@Id注解标识而已，比如： @Table("tb_account") public class Account { @Id((keyType=KeyType.Auto) private Long id; @Id(keyType=KeyType.Generator, value="uuid") private String otherId; //getter setter } 当我们保存数据的时候，Account 的 id 主键为自增，而 otherId 主键则通过 uuid 生成。 自定义主键生成器 第 1 步：编写一个类，实现IKeyGenerator接口，例如： public class UUIDKeyGenerator implements IKeyGenerator { @Override public Object generate(Object entity, String keyColumn) { return UUID.randomUUID().toString().replace("-", ""); } } 第 2 步：注册 UUIDKeyGenerator KeyGeneratorFactory.register("myUUID",new UUIDKeyGenerator()); 第 3 步：在 Entity 里使用 "myUUID" 生成器： @Table("tb_account") public class Account { @Id(keyType=KeyType.Generator, value="myUUID") private String otherId; //getter setter } 使用数据库 Sequence 生成 @Table("tb_account") public class Account { @Id((keyType=KeyType.Sequence, value="select SEQ_USER_ID.nextval as id from dual") private Long id; } 更多示例 示例 1：Mybatis-Flex 原生（非 Spring） 示例 2：Mybatis-Flex with Spring 示例 3：Mybatis-Flex with Spring boot
