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 ?) 

• 速拓服装饰品管理系统
• 迅捷PDF虚拟打印机
• 开博食品行业管理软件
• R3D视频恢复软件
• 鑫河IP自动更换器
• 知乎
• 蜗牛睡眠
• 海拔气压计
• 京师国学堂
• 氧心宝
• 萍乡群防云
• 好省宝
• 券老虎商城
• 天津消防物联网
• 西财一卡通
• 商之声门店
• 享智道
• 昆明理工智能实验室
• 四季艺术
• 流量助理
• 嗖嗖跟台企业版
• PAD电子菜单
• 管家宝Pro
• WIFI一机通
• 掌上天翼物联
• 开心消消乐2 v2.1.0 安卓版
• 天天炫斗无怪秒塔特别版(刷图) for Android v1.10 最新安卓版
• 西游大乱斗 for android v1.2 安卓版
• 史莱姆传说官方版(策略游戏) v2.4.205 安卓版
• 奔跑吧兄弟我是车神手游 for android v2.2.0 安卓版
• 神雕侠侣手游烧饼修改器 for android v1.1.3 官方版
• 末日狂奔 for android v.10 安卓版
• 蜘蛛侠跑酷手机版 for android v1.1.1 安卓版
• QQ飞车2014 乐享新任务 Beta18 Build42 官方正式安装版
• 帝国风云魔鬼辅助最新版 0.5 正式版
• 名师教你分类作文(1-2年级注音版)
• 单片机原理项目化教学(高等职业教育机电一体化及电气自动化专业教材)
• 趣味成语接龙
• 测绘法律法规概论(普通高等教育应用型本科创新教材)
• 投弹虫/海底小纵队拼图大探险
• 物联网概论(第2版21世纪高等学校物联网专业规划教材)
• 金属熔焊基础(焊接专业第3版中等职业教育国家规划教材)
• 情景认知简笔画(走进农场)/涂图乐系列
• 生物医学光子学(供生物医学工程等专业用全国高等学校教材)
• 高速铁路运输企业管理(普通高等教育十三五规划教材)/高速铁路系列
• 深宅1927
• 新闺蜜时代
• 傻儿传奇
• 侠探高飞
• 草帽警察
• 神盾局特工 第二季
• 卧底
• 良心
• 红色宝藏
• 离婚律师