代码拉取完成，页面将自动刷新
同步操作将从 mybatis-mapper/mapper 强制同步，此操作会覆盖自 Fork 仓库以来所做的任何修改，且无法恢复！！！
确定后同步将在后台操作，完成时将刷新页面，请耐心等待。
基于 mybatis-mapper/provider( gitee | GitHub ) 实现的通用 Mapper。
这是一个不需要任何配置就可以直接使用的通用 Mapper，通过简单的学习就可以直接在项目中使用。
MyBatis Mapper 要求 MyBatis 最低版本为
3.5.1，推荐使用最新版本 
。
和 MyBatis 框架一样，最低需要 Java 8。
如果你使用 Maven，在你的 pom.xml 添加下面的依赖：
<dependencies>
<dependency>
<groupId>io.mybatis</groupId>
<artifactId>mybatis-mapper</artifactId>
<version>1.0.0-RC2</version>
</dependency>
<!-- 使用 Service 层封装时 -->
<dependency>
<groupId>io.mybatis</groupId>
<artifactId>mybatis-service</artifactId>
<version>1.0.0-RC2</version>
</dependency>
<!-- 使用 ActiveRecord 模式时 -->
<dependency>
<groupId>io.mybatis</groupId>
<artifactId>mybatis-activerecord</artifactId>
<version>1.0.0-RC2</version>
</dependency>
</dependencies>
如果使用 Gradle，在 build.gradle 中添加：
dependencies {
compile("io.mybatis:mybatis-mapper:1.0.0-RC2")
// 使用 Service 层封装时
compile("io.mybatis:mybatis-service:1.0.0-RC2")
// 使用 ActiveRecord 模式时
compile("io.mybatis:mybatis-activerecord:1.0.0-RC2")
}
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. extend 模块 的内容， 扩展部分提供了两套扩展注解，下面是一个简单示例：@Extend.Table(value = "sys_user", remark = "系统用户", autoResultMap = true) public class User { @Extend.Column(id = true, remark = "主键", updatable = false, insertable = false) private Long id; @Extend.Column(value = "name", remark = "帐号") private String userName; //省略其他 }
有了 User 实体后，直接创建一个继承了 Mapper 的接口即可：
public interface UserMapper extends Mapper<User, Long> {
}
这个接口只要被 MyBatis 扫描到即可直接使用。
下面是几种常见的扫描配置：
- MyBatis 自带的配置文件方式
mybatis-config.xml：<mappers> <!-- 扫描指定的包 --> <package name="com.example.mapper"/> </mappers>
- 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>
- 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 时会更得心应手，随心所欲。
基于 mybatis-mapper/provider 核心部分实现的基础的增删改查操作，提供了一个核心的 io.mybatis.mapper.Mapper 接口，接口定义如下：
/**
* 基础 Mapper 方法，可以在此基础上继承覆盖已有方法
*
* @param <T> 实体类类型
* @param <I> 主键类型
* @author liuzh
*/
public interface Mapper<T, I extends Serializable>
extends EntityMapper<T, I>, ExampleMapper<T, Example<T>>, CursorMapper<T, Example<T>> {
/**
* 保存实体，默认主键自增，并且名称为 id
* <p>
* 这个方法是个示例，你可以在自己的接口中使用相同的方式覆盖父接口中的配置
*
* @param entity 实体类
* @return 1成功，0失败
*/
@Override
@Lang(Caching.class)
@Options(useGeneratedKeys = true, keyProperty = "id")
@InsertProvider(type = EntityProvider.class, method = "insert")
int insert(T entity);
/**
* 保存实体中不为空的字段，默认主键自增，并且名称为 id
* <p>
* 这个方法是个示例，你可以在自己的接口中使用相同的方式覆盖父接口中的配置
*
* @param entity 实体类
* @return 1成功，0失败
*/
@Override
@Lang(Caching.class)
@Options(useGeneratedKeys = true, keyProperty = "id")
@InsertProvider(type = EntityProvider.class, method = "insertSelective")
int insertSelective(T entity);
/**
* 根据主键更新实体中不为空的字段，强制字段不区分是否 null，都更新
* <p>
* 当前方法来自 {@link io.mybatis.mapper.fn.FnMapper}，该接口中的其他方法用 {@link ExampleMapper} 也能实现
*
* @param entity 实体类
* @param forceUpdateFields 强制更新的字段，不区分字段是否为 null，通过 {@link Fn#of(Fn...)} 创建 {@link Fn.Fns}
* @return 1成功，0失败
*/
@Lang(Caching.class)
@UpdateProvider(type = FnProvider.class, method = "updateByPrimaryKeySelectiveWithForceFields")
int updateByPrimaryKeySelectiveWithForceFields(@Param("entity") T entity, @Param("fns") Fn.Fns<T> forceUpdateFields);
/**
* 根据指定字段集合查询：field in (fieldValueList)
* <p>
* 这个方法是个示例，你也可以使用 Java8 的默认方法实现一些通用方法
*
* @param field 字段
* @param fieldValueList 字段值集合
* @param <F> 字段类型
* @return 实体列表
*/
default <F> List<T> selectByFieldList(Fn<T, F> field, List<F> fieldValueList) {
Example<T> example = new Example<>();
example.createCriteria().andIn((Fn<T, Object>) field, fieldValueList);
return selectByExample(example);
}
/**
* 根据指定字段集合删除：field in (fieldValueList)
* <p>
* 这个方法是个示例，你也可以使用 Java8 的默认方法实现一些通用方法
*
* @param field 字段
* @param fieldValueList 字段值集合
* @param <F> 字段类型
* @return 实体列表
*/
default <F> int deleteByFieldList(Fn<T, F> field, List<F> fieldValueList) {
Example<T> example = new Example<>();
example.createCriteria().andIn((Fn<T, Object>) field, fieldValueList);
return deleteByExample(example);
}
}
这个接口展示了好几个通用方法的特点：
在下面内容中，还能看到一个特点，“5. 那就是一个 provider 实现，通过修改接口方法的返回值和入参，就能变身无数个通用方法”，通用方法的实现极其容易。
点击查看详细介绍。
基于 mybatis-mapper/provider 核心部分扩展更新表和列的信息，可以直接配合 mapper 使用。
这个模块有两个作用：
点击查看详细介绍。
当前模块包含了简单的封装代码，这部分的代码在 service 和 activerecord 中被用到， 如果不使用这两个包的功能，也不需要 common 模块的代码。
点击查看详细介绍。
service 模块对应开发中的 service 层，或者说是 Spring 中的 @Service 标记的类。
这一层基于 mapper 模块中的 Mapper 接口，封装了大量开箱即用的 service 层方法。
点击查看详细介绍。
在软件工程中，主动记录模式（active record pattern）是一种架构模式， 可见于在关系数据库中存储内存中对象的软件中。 它在Martin Fowler的2003年著《企业应用架构的模式》书中命名。 符合这个模式的对象的接口将包括函数比如插入、更新和删除， 加上直接对应于在底层数据库表格中列的或多或少的属性。
主动记录模式是访问在数据库中的数据的一种方式。数据库表或视图被包装入类。 因此，对象实例被链接到这个表格的一个单一行。 在一个对象创建之后，在保存时将一个新行增加到表格中。 加载的任何对象都从数据库得到它的信息。在一个对象被更新的时候， 在表格中对应的行也被更新。包装类为在表格或视图中的每个列都实现访问器方法或属性。
activerecord 模块提供了 4 个接口类、1个工具类、1个配置类和1个Spring Boot自动配置类。
点击查看详细介绍。
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。