Watch Star Fork

恒宇少年 / mybatis-enhanceJavaMIT

加入码云
与超过 300 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
Enhance是对于原生的MyBatis的增强编写,不影响任何原生的使用,使用后完全替代mybatis-core、mybatis-spring以及mybatis-spring-boot-starter,可以使用SpringBoot配置文件的形式进行配置相关的内容,尽可能强大的方便快速的集成MyBatis。 https://github.com/hengyuboy/mybatis-enhance
Loading...
README.md 9.55 KB

欢迎使用MyBatis Enhance

Maven central

欢迎关注公众号

微信公众号 关注微信公众号,回复加群,获取交流群群号。

使用示例

请访问项目:mybatis-enhance-sample

MyBatis Enhance是什么?

Enhance是对于原生的MyBatis的增强编写,不影响任何原生的使用,使用后完全替代mybatis-coremybatis-spring以及mybatis-spring-boot-starter,可以使用SpringBoot配置文件的形式进行配置相关的内容,尽可能强大的方便快速的集成MyBatis

除此之外还提供了单表基础数据CRUD操作以及部分批量数据的操作,可以不再使用MyBatis提供的自动生成的方式对单个数据表进行数据操作,当然如果你想使用也是可以的。

Enhance还规划了多个数据表之间的动态查询方式,这种方式可以让你体验到你在使用Java代码编写SQL语句,极大方便的关联、聚合、多表查询字段等常用数据动作(1.0.3.RELEASE暂未支持)。

使用环境

目前SpringBoot的发展趋势已经势如破竹,为了更方便的使用,所以Enhance暂时只允许在集成了SpringBoot框架的项目中使用。

  • SpringBoot1.x以上版本
  • JDK 1.6以上版本

安装

安装比较简单,在引用Enhance的项目中你还需要添加你使用的数据库驱动以及数据源Enhance并不会限制这一点,由于Enhance相关的jar已经上传到Maven Center Repository所以我们只需要添加依赖即可,开发工具会自动下载相关的依赖包。

  • 使用Maven构建工具时,复制下面的内容到pom.xml配置文件内
<dependency>
    <groupId>com.gitee.hengboy</groupId>
    <artifactId>spring-boot-starter-mybatis-enhance</artifactId>
    <version>{lastVersion}</version>
</dependency>
  • 如果你是用的Gradle构建工具,那么复制下面的内容到你的build.gradle
compile group: 'com.gitee.hengboy', name: 'spring-boot-starter-mybatis-enhance', version: '{lastVersion}'

注意:需要将lastVersion版本号更换为最新中央仓库的mybatis-enhance版本号即可.

该怎么使用呢?

实体的创建

根据对应数据库内的表来创建实体,Enhance采用的是Spring Data JPA的形式来管理实体类,并且已经预先提供的一些Annotation数据实体(Entity)对应数据库内的数据表(Table),下面是一个简单的实体代码:

/**
 * 用户数据实体
 *
 * @author:于起宇 <br/>
 * ===============================
 * Created with IDEA.
 * Date:2018/5/13
 * Time:8:53
 * 简书:http://www.jianshu.com/u/092df3f77bca
 * ================================
 */
@Data
@Table(name = "test_user_info")
public class UserInfoEntity implements Serializable {
    /**
     * 用户编号
     */
    @Id(generatorType = KeyGeneratorTypeEnum.AUTO)
    @Column(name = "TUI_ID")
    private Integer userId;
    /**
     * 用户名
     */
    @Column(name = "TUI_NAME")
    private String userName;
    /**
     * 年龄
     */
    @Column(name = "tui_age")
    private Integer age;
    /**
     * 地址
     */
    @Column(name = "tui_address")
    private String address;
}

我采用了跟Spring Data JPA相同命名方式的注解,这样也方便大家在使用Enhance时可以快速的转换注解的使用。

Mapper的创建

创建Mapper跟我们使用原生MyBatis创建方式一样,不过使用Enhance后不需要添加@Mapper注解,你创建的Mapper只需要继承EnhanceMapper<T,PK>接口就可以被扫描到,并且同时可以获取内部提供的CRUD方法!!! 如下所示:

/**
 * 用户基本信息数据接口
 *
 * @author:于起宇 <br/>
 * ===============================
 * Created with IDEA.
 * Date:2018/5/13
 * Time:9:00
 * 简书:http://www.jianshu.com/u/092df3f77bca
 * ================================
 */
public interface UserInfoMapper extends EnhanceMapper<UserInfoEntity, Integer> {
}

EnhanceMapper需要两个泛型,第一个是实体类的类型,第二个则是实体类主键的类型,这样方便我们在传参或者返回值时做到统一,否则还需要进行Object类型的转换,那样不仅麻烦还会提高运行成本,详细介绍请阅读 使用文档

暂时内置的方法
// 统计数据
Long countAll() throws EnhanceFrameworkException;
// 清空数据
void deleteAll() throws EnhanceFrameworkException;
// 根据主键数组删除指定数据
void deleteArray(Id... ids) throws EnhanceFrameworkException;
// 根据自定义sql删除数据
void deleteBySql(String sql, Map<String, Object> params) throws EnhanceFrameworkException;
// 根据主键集合删除指定数据
void deleteCollection(Collection<Id> collection) throws EnhanceFrameworkException;
// 删除一条数据
void deleteOne(Id id) throws EnhanceFrameworkException;
// 数据保存
void insert(T t) throws EnhanceFrameworkException;
// 保存数组内的所有数据
void insertArray(T... array) throws EnhanceFrameworkException;
// 保存集合内的所有数据
void insertCollection(Collection<T> collection) throws EnhanceFrameworkException;
// 查询全部数据
List<T> selectAll() throws EnhanceFrameworkException;
// 根据主键数组查询指定数据
List<T> selectArray(Id... ids) throws EnhanceFrameworkException;
// 分页查询数据
List<T> selectByPageable(Pageable pageable) throws EnhanceFrameworkException;
// 自定义sql查询数据
List<Map> selectBySql(String sql, Map<String, Object> params) throws EnhanceFrameworkException;
// 根据主键集合查询指定数据
List<T> selectCollection(Collection<Id> ids) throws EnhanceFrameworkException;
// 根据主键查询单条数据
T selectOne(Id id) throws EnhanceFrameworkException;
// 根据主键更新数据实体
void update(T t) throws EnhanceFrameworkException;
// 自定义sql更新数据
void updateBySql(String sql, Map<String, Object> params) throws EnhanceFrameworkException;

以上是1.0.3.RELEASE版本提供的内置方法列表,都是在平时开发中比较常用到对单表数据操作的方法。

方法命名规则的使用

方法命名规则Spring Data JPA中的提供的一种数据操作的方式,主要适用于查询统计删除等数据操作动作,其主要原理是根据方法的名称来自动生成SQL,使用正则表达式来进行方法匹配。

方法规则查询

方法规则查询简单示例如下所示:

public interface UserInfoMapper extends EnhanceMapper<UserInfoEntity, Integer> {
    /**
     * 只根据一个字段查询
     *
     * @param name 查询条件的值
     * @return
     */
    UserInfoEntity findByUserName(@Param("userName") String name);

    /**
     * 可以根据多个查询条件进行查询
     * 中间使用And进行连接
     *
     * @param name 第一个查询条件的值
     * @param age  第二个查询条件的值
     * @return
     */
    UserInfoEntity findByUserNameAndAge(@Param("userName") String name, @Param("age") Integer age);
}
方法规则统计

方法规则统计简单示例如下所示:

public interface UserInfoMapper extends EnhanceMapper<UserInfoEntity, Integer> {
    /**
     * 只根据一个字段统计数据
     *
     * @param name 统计条件的值
     * @return
     */
    Long countByUserName(@Param("userName") String name);
    /**
     * 根据多个条件进行统计数据
     *
     * @param name 第一个统计条件的值
     * @param age  第二个统计条件的值
     * @return
     */
    Long countByUserNameAndAge(@Param("userName") String name, @Param("age") Integer age);
}    
方法规则删除

方法规则删除简单示例如下所示:

public interface UserInfoMapper extends EnhanceMapper<UserInfoEntity, Integer> {
    /**
     * 只根据一个字段删除
     *
     * @param name 查询条件的值
     */
    void removeByUserName(@Param("userName") String name);

    /**
     * 根据多个条件进行删除数据
     * 中间使用And进行连接
     *
     * @param name 第一个删除条件的值
     * @param id   第二个删除条件的值
     */
    void removeByUserNameAndUserId(@Param("userName") String name, @Param("userId") String id);
}   

当然方法命名规则不仅上面那一点的方便,详细介绍请阅读 使用文档

敬请期待Maven自动化代码生成插件

作为目前开发的环境,不管你是产品项目的研发还是外包项目的研发都应该做到快速实现功能,针对MyBatis Enhance框架来说,我单独配套编写了一个代码生成工具,能够把创建实体Mapper等必须需要类的自动化创建以及可以通过freemarker模版来完成自定义的实体类创建,从而实现代码上的真正的快速开发,提高编码效率!!!

敬请期待DSL动态查询

Enhance内部默认支持了单表的数据操作方法,但是我们平时在项目中多表查询是最普遍的,我结合了QueryDSL动态查询框架的优点将部分的基础实现迁移到了Enhance框架内,极大的方便了多表联合查询以及动态返回任意数据实体(Entity)数据映射实体(DTO)等。

项目点评 ( 36 )

你可以在登录后,发表评论

搜索帮助