融合 JPA，MyBatis JPA Extra 3.4.4 发布

2026-02-12 16

标准CRUD + 高效SELECT查询

MyBatis JPA Extra

MyBatis JPA Extra对MyBatis扩展JPA功能，融合JPA的标准化和MyBatis灵活性

1.JPA 注解支持：支持 @Entity、@Table、@Column 等注解，简化实体类的定义；

2.标准化CRUD操作，通过JPA 注释和接口，减少传统MyBatis中大量的XML配置和SQL编写工作;

3.高效SELECT分页查询，优化了分页查询的实现方式，提供更高效、更灵活的分页功能;

4.链式Query查询条件构造器；支持Lambda 形式调用，方便编写各类查询条件；

5.findByXxx解析方法名自动生成查询；

6.@Encrypted注解轻松实现字段数据加密和解密;

7.字段数据自动填充功能;

8.数据库支持

数据库	支持
MySQL	✅
PostgreSQL	✅
Oracle	✅
SqlServer	✅
DB2	✅
Mariadb	✅

代码托管

* GitCode * Gitee *GitHub *

1、JPA 注释

1.1、注释

注释	作用	功能描述
@Entity	class	标识一个类为JPA实体
@Table	class	指定实体类对应的数据库表名
@Column	field	定义字段与数据库列的映射关系，支持自定义列名、是否可为空等属性
@Id	field	标识主键字段
@GeneratedValue	field	定义主键生成策略，支持AUTO、SEQUENCE和IDENTITY
@Encrypted	field	标记加密的字段，支持加密算法(如SM4、AES、DES、DESede)
@PartitionKey	field	分库分表，多租户区分
@SoftDelete	field	标记逻辑删除字段。当执行删除操作时，该字段会被更新为标记值（如 y/1）
@ColumnDefault	field	字段设置默认值，避免手动初始化
@Transient	field	标识字段不映射到数据库列

1.2、主键策略

支持3种主键Id策略

策略	支持
AUTO	主键自动填充策略 snowflakeid(雪花ID-默认) ulid uuid(UUID)
SEQUENCE	数据库序列生成，generator值为数据库序列名
IDENTITY	数据库表自增主键

2、基本操作

2.1、CRUD

    //新增数据
    @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("1");
        student.setStdMajor("政治");
        service.update(student);
        //service.merge(student);
    }
    //根据ID查询
    @Test
    void get() throws Exception{
        Students student = service.get("2");
    }
    //根据实体查询
    @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("3");
    }
    //根据ID集合批量删除
    @Test
    void batchDelete() throws Exception{
        List idList = new ArrayList();
        idList.add("4");
        //...
        service.deleteBatch(idList);
    }

2.2、逻辑删除

    //根据IDS批量逻辑删除
    @Test
    void softDelete() throws Exception{
        //逻辑删除
        service.softDelete("5");

        //批量逻辑删除    
        List idList=new ArrayList();
        idList.add("6");
        idList.add("7");
        //...
        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(1,20);
    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查询

@Select({}) 标识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函数，可以完成租户字段，创建人、创建时间、修改人、修改时间等默认字段的填充

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、使用方法

3.1、实体类定义

@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(insertable = false)
    @GeneratedValue
    private LocalDateTime modifyDate;
    @SoftDelete
    @Column(name ="is_deleted")
    private String isDeleted;
    //...
    //getter setter
}

3.2、Mapper定义

@Mapper
public interface StudentsMapper extends IJpaMapper {

    //根据mapper.xml的fetchPageResults语句分页查询
    public List fetchPageResults(Students entity);

    //根据mapper.xml的fetchPageResults1语句自定义分页查询
    public List fetchPageResults1(Students entity);

    //根据mapper.xml的fetchPageResultsVo语句自定返回类型分页查询，返回类型JpaPageResults
    public List fetchPageResultsVo(StudentQueryDto entity);

    //实现JPA findBy功能，无需写SQL
    @Select({})
    public List findByStdNo(String stdNo);

}

3.3、Service接口

public interface StudentsService extends IJpaService{

    //fetchPageResults/fetchPageResults1无需定义接口

    public JpaPageResults fetchPageResultsVo(StudentQueryDto entity) ;

    public List findByStdNo(String stdNo);
}

3.4、Service实现

public class StudentsServiceImpl extends AbstractJpaRepository implements StudentsService{
    
    //fetchPageResults/fetchPageResults1无需定义实现

    //自定义返回类型JpaPageResults
    @SuppressWarnings("unchecked")
    public JpaPageResults fetchPageResultsVo(StudentQueryDto entity) {
        entity.build();
        return (JpaPageResults) this.buildPageResults(entity, getMapper().fetchPageResultsVo(entity));
    }
    
    //mapper findBy调用
    public List findByStdNo(String stdNo) {
        return getMapper().findByStdNo(stdNo);
    }
}

3.5、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>

3.6、SpringBoot配置

#
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost/test?autoReconnect=true&characterEncoding=UTF-8&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=maxkey

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
#定界符，默认 false
#mybatis.table-column-escape=false
#表、字段等定界符
#mybatis.table-column-escape-char=`
#驼峰与下划线转换配置，默认 false
#mybatis.configuration.map-underscore-to-camel-case=true

3.7、依赖引用

例如依赖版本3.4.4配置如下

3.7.1 Maven依赖

<dependency>
    <groupId>org.dromara.mybatis-jpa-extra</groupId>
    <artifactId>mybatis-jpa-extra</artifactId>
    <version>3.4.4</version>
</dependency>
<dependency>
    <groupId>org.dromara.mybatis-jpa-extra</groupId>
    <artifactId>mybatis-jpa-extra-spring</artifactId>
    <version>3.4.4</version>
</dependency>
<dependency>
    <groupId>org.dromara.mybatis-jpa-extra</groupId>
    <artifactId>mybatis-jpa-extra-spring-boot-starter</artifactId>
    <version>3.4.4</version>
</dependency>

3.7.2 Gradle依赖

implementation group: 'org.dromara.mybatis-jpa-extra', name: 'mybatis-jpa-extra', version: '3.4.4'
implementation group: 'org.dromara.mybatis-jpa-extra', name: 'mybatis-jpa-extra-spring', version: '3.4.4'
implementation group: 'org.dromara.mybatis-jpa-extra', name: 'mybatis-jpa-extra-spring-boot-starter', version: '3.4.4'

[提示] 当前版本支持springboot v4+， springboot v3 请参考3.3分支

4、版本更新

1、主键增加ULID的支持

2、provider拆分和优化

3、增加MariadbDialect

4、增加JPA的Page、PageRequest 和Pageable ，相关代码优化

5、增加existsById

6、增加CountProvider

微信关注我们

原文链接：https://www.oschina.net/news/403599

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

MT-AUTH (Let's Auth) v1.30.0 发布，多租户权限系统

更新日志 feature 支持微信，谷歌登录邮箱，手机绑定安全优化 UI界面优化 bugfix MD5校验失败修复并发相关问题修复 Let's Auth 开源、多租户、身份、权限、API 管理系统官方网站 (www.letsauth.cloud) 特色事件驱动架构 (Event driven architecture) 基于角色的权限控制 (Role-Based Access Control) 多租户 (Multi-Tenancy) 单点登录 (Single-Sign on) OAuth 2.0 支持用户管理，多因素认证 (Multi-Factor Authentication) API 管理 (API Management)：路由、鉴权、缓存、跨域 CORS、CSRF 防护、压缩、隐藏系统错误信息、记录与分析、分享、订阅架构图

2026-02-12

14

phoenix v1.2.6.RELEASE-CR5 已经发布，云监控平台此版本更新内容包括： 1.修改：去掉监控配置项 monitoring.comm.comm-framework-type； 2.修改：修改 logback-spring.xml，增加WARN级别日志； 3.修改：各列表页增加查询条件； 4.优化：其它一些细节的调整。详情查看：https://gitee.com/monitoring-platform/phoenix/releases/v1.2.6.RELEASE-CR5

2026-02-12

15

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。

融合 JPA，MyBatis JPA Extra 3.4.4 发布

MyBatis JPA Extra

1、JPA 注释

1.1、注释

1.2、主键策略

2、基本操作

2.1、CRUD

2.2、逻辑删除

2.3、Find查询和Qruey构造器

2.4、单表分页查询

2.5、多表关联分页查询，根据mapper的xml分页查询

2.6、 Lambda查询

2.6、 UpdateWrapper更新

2.8、FindBy查询

2.9、默认数据自动填充

3、使用方法

3.1、实体类定义

3.2、Mapper定义

3.3、Service接口

3.4、Service实现

3.5、mapper配置

3.6、SpringBoot配置

3.7、依赖引用

3.7.1 Maven依赖

3.7.2 Gradle依赖

4、版本更新

MT-AUTH (Let's Auth) v1.30.0 发布，多租户权限系统

phoenix v1.2.6.RELEASE-CR5 已经发布，云监控平台

相关文章

发表评论

资源下载

优质分享App

Mario

腾讯云软件源

Rocky Linux

欢迎您来访！

融合 JPA，MyBatis JPA Extra 3.4.4 发布

MyBatis JPA Extra

1、JPA 注释

1.1、注释

1.2、主键策略

2、基本操作

2.1、CRUD

2.2、逻辑删除

2.3、Find查询和Qruey构造器

2.4、单表分页查询

2.5、多表关联分页查询，根据mapper的xml分页查询

2.6、 Lambda查询

2.6、 UpdateWrapper更新

2.8、FindBy查询

2.9、默认数据自动填充

3、 使用方法

3.1、实体类定义

3.2、Mapper定义

3.3、Service接口

3.4、Service实现

3.5、mapper配置

3.6、SpringBoot配置

3.7、依赖引用

3.7.1 Maven依赖

3.7.2 Gradle依赖

4、版本更新

MT-AUTH (Let's Auth) v1.30.0 发布，多租户权限系统

phoenix v1.2.6.RELEASE-CR5 已经发布，云监控平台

相关文章

发表评论

资源下载

优质分享App

Mario

腾讯云软件源

Rocky Linux

欢迎您来访！

3、使用方法