当前位置:

MyBatis Mapper v2.2.2

收藏
举报
MyBatis Mapper是一个不需要任何配置就可以直接使用的通用 Mapper,通过简单的学习就可以直接在项目中使用。
  • 作者:
    暂无
  • 演示网站:
    暂无
  • 当前版本:
    v2.2.2
  • 日期:
    2024-06-10
  • 相关链接:
    Home Page
  • 所属分类:
    数据库相关 Java
  • 软件评级:
  • 下载人气:
    604
免费下载
求购此源码
源码详情
免费下载
开发环境
联系客服/入群
源码属性
授权 开源
大小 4.86MB
语言 Java
功能介绍

MyBatis Mapper是一个不需要任何配置就可以直接使用的通用 Mapper,通过简单的学习就可以直接在项目中使用。


功能特点:

开箱即用,无需任何配置,继承基类 Mapper 即可获得大量通用方法;

随心所欲,通过复制粘贴的方式可以组建自己的基类 Mapper;

全面贴心,提供 Service 层的封装方便业务使用和理解 Mapper;

简单直观,提供 ActiveRecord 模式,结合 Spring Boot 自动配置直接上手用;

自定义方法,简单几行代码即可实现自定义通用方法;

轻松扩展,通过 Java SPI 轻松扩展。


系统要求

MyBatis Mapper 要求 MyBatis 最低版本为 3.5.1,推荐使用最新版本。

和 MyBatis 框架一样,最低需要 Java 8。


安装

<dependencies>
  <dependency>
    <groupId>io.mybatis</groupId>
    <artifactId>mybatis-mapper</artifactId>
    <version>1.2.2</version>
  </dependency>
  <!-- 使用 Service 层封装时 -->
  <dependency>
    <groupId>io.mybatis</groupId>
    <artifactId>mybatis-service</artifactId>
    <version>1.2.2</version>
  </dependency>
  <!-- 使用 ActiveRecord 模式时 -->
  <dependency>
    <groupId>io.mybatis</groupId>
    <artifactId>mybatis-activerecord</artifactId>
    <version>1.2.2</version>
  </dependency>
</dependencies>
dependencies {
    compile("io.mybatis:mybatis-mapper:1.2.2")
    // 使用 Service 层封装时
    compile("io.mybatis:mybatis-service:1.2.2")
    // 使用 ActiveRecord 模式时
    compile("io.mybatis:mybatis-activerecord:1.2.2")
}


快速设置

MyBatis Mapper 的基本原理是将实体类映射为数据库中的表和字段信息,因此实体类需要通过注解配置基本的元数据,配置好实体后, 只需要创建一个继承基础接口的 Mapper 接口就可以开始使用了。

一、实体类配置

假设有一个表:

create table user
(
    id   INTEGER GENERATED BY DEFAULT AS IDENTITY (START WITH 1) PRIMARY KEY,
    name VARCHAR(32) DEFAULT 'DEFAULT',
    sex  VARCHAR(2)
);

对应的实体类:

import io.mybatis.provider.Entity;

@Entity.Table("user")
public class User {
  @Entity.Column(id = true)
  private Long   id;
  @Entity.Column("name")
  private String username;
  @Entity.Column
  private String sex;

  //省略set和get方法
}

实体类上 必须添加 @Entity.Table 注解指定实体类对应的表名,建议明确指定表名,不提供表名的时候,使用类名作为表名。 所有属于表中列的字段,必须添加 @Entity.Column 注解,不指定列名时,使用字段名(不做任何转换),通过 id=true 可以标记字段为主键。

@Entity 中包含的这两个注解提供了大量的配置属性,想要使用更多的配置,参考下面 3. @Entity 注解 的内容, 下面是一个简单示例:

@Entity.Table(value = "sys_user", remark = "系统用户", autoResultMap = true)
public class User {
 @Entity.Column(id = true, remark = "主键", updatable = false, insertable = false)
 private Long   id;
 @Entity.Column(value = "name", remark = "帐号")
 private String userName;
 //省略其他
}


二、Mapper接口定义

有了 User 实体后,直接创建一个继承了 Mapper 的接口即可:

//io.mybatis.mapper.Mapper
public interface UserMapper extends Mapper<User, Long> {

}

这个接口只要被 MyBatis 扫描到即可直接使用。

下面是几种常见的扫描配置:

1、MyBatis 自带的配置文件方式 mybatis-config.xml:

 <mappers>
   <!-- 扫描指定的包 -->
   <package name="com.example.mapper"/>
 </mappers>

2、Spring 中的 spring.xml 配置:

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
  <property name="basePackage" value="com.example.mapper"/>
  <property name="markerInterface" value="io.mybatis.service.mapper.RoleMarker"/>
  <property name="sqlSessionFactoryBeanName" value="sqlSessionFactoryRole"/>
</bean>

3、Spring Boot 配置,启动类注解方式:

@MapperScan(basePackages = "com.example.mapper")
@SpringBootApplication
public class SpringBootDemoApplication {

  public static void main(String[] args) {
    SpringApplication.run(SpringBootDemoApplication.class, args);
  }

}

Spring Boot 中,还可以直接给接口添加 @org.apache.ibatis.annotations.Mapper 注解,增加注解后可以省略 @MapperScan 配置。


三、使用

定义好接口后,就可以获取 UserMapper 使用,下面是简单示例:

User user=new User();
    user.setUserName("测试");
    userMapper.insert(user);
//保存后自增id回写,不为空
    Assert.assertNotNull(user.getId());
//根据id查询
    user=userMapper.selectByPrimaryKey(user.getId());
//删除
    Assert.assertEquals(1,userMapper.deleteByPrimaryKey(user.getId()));

看到这里,可以发现除了 MyBatis 自身的配置外,MyBatis Mapper 只需要配置实体类注解, 创建对应的 Mapper 接口就可以直接使用,没有任何繁琐的配置。

上面的示例只是简单的使用了 MyBatis Mapper,还有很多开箱即用的功能没有涉及, 建议在上述示例运行成功后,继续查看本项目其他模块的详细文档,熟悉各部分文档后, 在使用 MyBatis Mapper 时会更得心应手,随心所欲。


四、wrapper 用法

在 1.2.0 版本之后,针对 Example 封装了一个 ExampleWrapper,可以通过链式调用方便的使用 Example 方法。

mapper.wrapper()
    .eq(User::getSex,"女")
    .or(c->c.gt(User::getId,40),c->c.lt(User::getId,10))
    .or()
    .startsWith(User::getUserName,"张").list();

对应的 SQL 如下:

SELECT id, name AS userName, sex
FROM user
WHERE (sex = ? AND ((id > ?) OR (id < ?)))
   OR (name LIKE ?)
付费服务
模板/插件
其他
  • IntelliJ IDEA
    版本:v2020.2.2 大小:696 MB 更新时间:2020-09-17
    立即下载
  • Greenfoot
    版本:v3.6.0 大小:236 MB 更新时间:2020-09-14
    立即下载
  • Eclipse集成开发环境
    版本:v2020.06 大小:54.5 MB 更新时间:2020-08-28
    立即下载

联系客服

手机版

扫一扫进入手机版

返回顶部