MyBatis JPA Extra 3.4.1 发布，优雅 JPA API 功能
MyBatis JPA Extra MyBatis JPA Extra对MyBatis扩展JPA功能 1.Jakarta JPA 3注释简化CUID操作; 2.增强SELECT分页查询; 3.链式Query查询条件构造器；支持Lambda 形式调用，方便编写各类查询条件 4.@Encrypted注解轻松实现字段数据加密和解密; 5.字段数据自动填充功能; 6.数据库支持 数据库 支持 MySQL ✅ PostgreSQL ✅ Oracle ✅ SqlServer ✅ DB2 ✅ 代码托管 | GitCode | Gitee |GitHub | 1、JPA 3注释 1.1、注释 @Entity @Table @Column @ColumnDefault @Id @GeneratedValue @Encrypted @Transient @PartitionKey @SoftDelete 1.2、主键策略 支持3种主键Id策略 序号 策略 支持 1 AUTO 主键自动填充策略 snowflakeid(雪花ID-默认) uuid(UUID) 2 SEQUENCE 数据库序列生成，generator值为数据库序列名 3 IDENTITY 数据库表自增主键 1.3、Java Bean 注释 @Entity @Table(name = "STUDENTS") public class Students extends JpaEntity implements Serializable{ @Id @Column @GeneratedValue private String id; @Column private String stdNo; @Column @Encrypted private String password; @Column private String stdName; @Column @ColumnDefault("'M'") private String stdGender; @Column private int stdAge; @Column private String stdMajor; @Column private String stdClass; @Column private byte[] images; @Column(insertable = false) @GeneratedValue private LocalDateTime modifyDate; @SoftDelete @Column(name ="is_deleted") private int isDeleted; //getter setter } 2、基本操作 2.1、CURD //新增数据 @Test void insert() throws Exception{ Students student = new Students(); student.setStdNo("10024"); student.setStdGender("M"); student.setStdName("司马昭"); student.setStdAge(20); student.setStdMajor("政治"); student.setStdClass("4"); service.insert(student); } //查询数据实体并更新 @Test void update() throws Exception{ Students student = service.get("317d5eda-927c-4871-a916-472a8062df23"); student.setStdMajor("政治"); service.update(student); } //根据实体查询并更新 @Test void merge() throws Exception{ Students student = new Students(); student.setStdMajor("政治"); student.setStdClass("4"); service.merge(student); } //根据ID查询 @Test void get() throws Exception{ Students student = service.get("317d5eda-927c-4871-a916-472a8062df23"); } //根据实体查询 @Test void query() throws Exception{ Students student = new Students(); student.setStdGender("M"); List listStudents = service.query(student); } //查询所有记录 @Test void findAll() throws Exception{ List listStudents = service.findAll(); } //根据ID删除 @Test void delete() throws Exception{ service.delete("921d3377-937a-4578-b1e2-92fb23b5e512"); } //根据ID集合批量删除 @Test void batchDelete() throws Exception{ List idList = new ArrayList(); idList.add("8584804d-b5ac-45d2-9f91-4dd8e7a090a7"); idList.add("ab7422e9-a91a-4840-9e59-9d911257c918"); //... service.deleteBatch(idList); } 2.2、逻辑删除 //根据IDS批量逻辑删除 @Test void softDelete() throws Exception{ List idList=new ArrayList(); idList.add("8584804d-b5ac-45d2-9f91-4dd8e7a090a7"); idList.add("ab7422e9-a91a-4840-9e59-9d911257c918"); //... service.softDelete(idList); } 2.3、Find查询和Qruey构造器 //SpringJDBC的查询方式 where StdNo = '10024' or StdNo = '10004' @Test void find() throws Exception{ List listStudents = service.find(" StdNo = ? or StdNo = ? ", new Object[]{"10024","10004"}, new int[]{Types.VARCHAR,Types.INTEGER} ); } //根据链式条件构造器查询 //WHERE (stdMajor = '政治' and STDAGE > 30 and stdMajor in ( '政治' , '化学' ) or ( stdname = '周瑜' or stdname = '吕蒙' ) ) @Test void queryByCondition() throws Exception{ List listStudents = service.query( new Query().eq("stdMajor", "政治").and().gt("STDAGE", 30).and().in("stdMajor", new Object[]{"政治","化学"}) .or(new Query().eq("stdname", "周瑜").or().eq("stdname", "吕蒙"))); } 2.4、单表分页查询 //根据实体分页查询 @Test void fetch() throws Exception{ JpaPage page = new JpaPage(1); Students student = new Students(); student.setStdGender("M"); JpaPageResults results = service.fetch(page,student); } //根据Query条件分页查询 where stdMajor = '政治' and STDAGE > 30 @Test void fetchByCondition() throws Exception{ JpaPage page = new JpaPage(1,20); Query condition = new Query().eq("stdMajor", "政治").and().gt("STDAGE", 30); JpaPageResults results = service.fetch(page,condition); } 2.5、根据mapper的xml分页查询 //根据Mapper xml配置fetchPageResults分页查询 @Test void fetchPageResults() throws Exception{ Students student=new Students(); student.setStdGender("M"); student.setPageNumber(1); JpaPageResults results = service.fetchPageResults(student); } //根据Mapper xml id分页查询,fetchPageResults1在mapper的xml中配置 @Test void fetchPageResultsByMapperId() throws Exception{ Students student=new Students(); student.setStdGender("M"); student.setPageNumber(1); JpaPageResults results = service.fetchPageResults("fetchPageResults1",student); } 2.6、 Lambda查询 //根据Lambda链式条件构造器查询 //WHERE (stdMajor = '政治' and STDAGE > 30 and stdMajor in ( '政治' , '化学' ) or ( stdname = '周瑜' or stdname = '吕蒙' ) ) service.query( new LambdaQuery().eq(Students::getStdMajor, "政治") .and().gt(Students::getStdAge, Integer.valueOf(30)) .and().in(Students::getStdMajor, new Object[]{"政治","化学"}) .or( new LambdaQuery().eq(Students::getStdName, "周瑜") .or().eq(Students::getStdName, "吕蒙") ) ); //根据Lambda链式条件构造器分页查询 //where stdMajor = '政治' and stdAge > 30 JpaPage page = new JpaPage(); page.setPageSize(20); page.setPageable(true); LambdaQuery lambdaQuery =new LambdaQuery<>(); lambdaQuery.eq(Students::getStdMajor, "政治").and().gt(Students::getStdAge, Integer.valueOf(30)); JpaPageResults results = service.fetch(page,lambdaQuery); ... 2.6、 UpdateWrapper更新 //根据UpdateWrapper更新数据 UpdateWrapper updateWrapper = new UpdateWrapper(); updateWrapper.set("StdMajor", "历史").eq("StdName", "周瑜").or().eq("StdName", "吕蒙"); service.update(updateWrapper); //更新LambdaUpdateWrapper更新数据，带多重LambdaUpdateWrapper List majorList = new ArrayList<>(Arrays.asList("政治","化学")); LambdaUpdateWrapper updateWrapper = new LambdaUpdateWrapper<>(); updateWrapper.set(Students::getStdMajor, "历史") .eq(Students::getStdMajor, "政治") .and().gt(Students::getStdAge, Integer.valueOf(30)) .and().in(Students::getStdMajor, majorList) .or(new LambdaUpdateWrapper().eq(Students::getStdName, "周瑜").or().eq(Students::getStdName, "吕蒙")); service.update(updateWrapper); 2.8、FindBy查询 实现spring data jpa的findBy功能 //Mapper接口定义 //where x.stdNo = ?1 @Select({}) public List findByStdNo(String stdNo); //where x.stdNo = ?1 @Select({}) public List findByStdNoIs(String stdNo); //where x.stdNo = ?1 @Select({}) public List findByStdNoEquals(String stdNo); //where x.stdAge between ?1 and ?2 @Select({}) public List findByStdAgeBetween(int ageStart,int ageEnd); //where x.stdAge < ?1 @Select({}) public List findByStdAgeLessThan(int ageLessThan); //where x.stdAge <= ?1 @Select({}) public List findByStdAgeLessThanEqual(int ageLessThanEqual); //where x.stdAge > ?1 @Select({}) public List findByStdAgeAfter(int ageAfter); //where x.stdAge < ?1 @Select({}) public List findByStdAgeBefore(int ageBefore); //where x.images is null @Select({}) public List findByImagesNull(); //where x.images is null @Select({}) public List findByImagesIsNull(); //where x.images is not null @Select({}) public List findByImagesIsNotNull(); //where x.images is not null @Select({}) public List findByImagesNotNull(); //where x.stdName like ?1 @Select({}) public List findByStdNameLike(String stdName); //where x.stdName not like ?1 @Select({}) public List findByStdNameNotLike(String stdName); //where x.stdName like ?1 (parameter bound with appended %) @Select({}) public List findByStdNameStartingWith(String stdName); //where x.stdName like ?1 (parameter bound with prepended %) @Select({}) public List findByStdNameEndingWith(String stdName); //where x.stdName like ?1 (parameter bound wrapped in %) @Select({}) public List findByStdNameContaining(String stdName); //where x.stdGender = ?1 order by x.stdAge desc @Select({}) public List findByStdGenderOrderByStdAge(String stdGender); //where x.stdGender = ?1 order by x.stdAge desc @Select({}) public List findByStdGenderIsOrderByStdAge(String stdGender); //where x.stdMajors in ?1 @Select({}) public List findByStdMajorIn(String... stdMajors) ; //where x.stdMajors not in ?1 @Select({}) public List findByStdMajorNotIn(List stdMajors); //where x.deleted = true @Select({}) public List findByDeletedTrue(); //where x.deleted = false @Select({}) public List findByDeletedFalse(); //where UPPER(x.stdGender) = UPPER(?1) @Select({}) public List findByStdGenderIgnoreCase(String stdGender); //where x.stdNo <> ?1 @Select({}) public List findByStdNoNot(String stdNo); //where x.lastname = ?1 and x.firstname = ?2 @Select({}) public List findByStdMajorAndStdClass(String stdMajor,String stdClass); 2.9、默认数据自动填充 继承FieldAutoFillHandler，实现insertFill和updateFill函数，可以完成租户字段，创建人、创建时间、修改人、修改时间等默认字段的填充 import org.apache.ibatis.reflection.MetaObject; import org.dromara.mybatis.jpa.handler.FieldAutoFillHandler; public class MxkFieldAutoFillHandler extends FieldAutoFillHandler{ @Override public void insertFill(MetaObject metaObject) { this.setFieldValue(metaObject , "stdNo", "AutoFill_Insert"); } @Override public void updateFill(MetaObject metaObject) { this.setFieldValue(metaObject , "stdNo", "AutoFill_Update"); } } 3、mapper配置 <mapper namespace="org.apache.mybatis.jpa.test.dao.persistence.StudentsMapper" > <sql id="sql_condition"> WHERE 1 = 1 <if test="id != null"> AND ID = '${id}' </if> <if test="stdName != null and stdName != '' "> AND STDNAME like '%${stdName}%' </if> <if test="stdGender != null and stdGender != '' "> AND STDGENDER = #{stdGender} </if> <if test="stdMajor != null"> <![CDATA[AND STDMAJOR = #{stdMajor}]]> </if> </sql> <select id="fetchPageResults" parameterType="Students" resultType="Students"> SELECT id , stdno , stdname ,stdgender , stdage , stdmajor , stdclass FROM STUDENTS <include refid="sql_condition"/> </select> <select id="fetchPageResults1" parameterType="Students" resultType="Students"> SELECT id , stdno , stdname ,stdgender , stdage , stdmajor , stdclass FROM STUDENTS <include refid="sql_condition"/> </select> <select id="queryBy" parameterType="Students" resultType="Students"> SELECT id , stdno , stdname ,stdgender , stdage , stdmajor , stdclass FROM ROLES <include refid="sql_condition"/> </select> 4、SpringBoot配置 # spring.datasource.username=root spring.datasource.password=maxkey spring.datasource.url=jdbc:mysql://localhost/test?autoReconnect=true&characterEncoding=UTF-8&serverTimezone=UTC spring.datasource.driver-class-name=com.mysql.jdbc.Driver spring.datasource.type=com.alibaba.druid.pool.DruidDataSource mybatis.dialect=mysql mybatis.type-aliases-package=org.apache.mybatis.jpa.test.entity mybatis.mapper-locations=classpath*:/org/apache/mybatis/jpa/test/dao/persistence/xml/${mybatis.dialect}/*.xml mybatis.table-column-escape=true #mybatis.table-column-escape-char=` #mybatis.configuration.map-underscore-to-camel-case=true 5、版本更新 1、JpaPage 增加of方法 2、demo mybatis-config.xml优化，增加MybatisConfigInit和代码调整 3、删除冗余的代码 4、dbcp2依赖和支持 5、spring 4支持的优化 6、编译脚本优化 7、新logo优化 8、findBy优化和缓存优化 9、JpaRepositoryImpl优化 10、移除remove @TeMPOraL支持 11、日志输出优化 12、批量插入功能优化 13、新增IJpaCrudMapper ，IJpaRepository增加findById 14、新增deleteById 15、IJpaMapper<T, ID extends Serializable>新方式 16、依赖升级springboot 4.0.1
)
