MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 允许你将 SQL 映射存储在 XML 文件中,或注解在接口上,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。
MyBatis 的核心组件
- SqlSessionFactory:MyBatis 的核心接口,用于创建 SqlSession。
- SqlSession:它包含执行 SQL 命令所需的所有方法。每个线程都应该有它自己的 SqlSession 实例。
- Executor:MyBatis 的核心接口,负责执行查询、更新、删除等操作。
- MappedStatement:MyBatis 将每条 SQL 映射语句封装成一个 MappedStatement 对象。
MyBatis 入门
环境搭建
- 添加依赖:在项目的
pom.xml文件中添加 MyBatis 的依赖。
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
- 配置 MyBatis:创建
mybatis-config.xml文件,配置数据源、事务管理器等。
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/myapp/mapper/UserMapper.xml"/>
</mappers>
</configuration>
- 编写 Mapper 接口和 XML 映射文件:定义一个 Mapper 接口,并在对应的 XML 映射文件中编写 SQL 语句。
public interface UserMapper {
User getUserById(int id);
}
<mapper namespace="com.myapp.mapper.UserMapper">
<select id="getUserById" resultType="com.myapp.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
- 创建 SqlSessionFactory:使用 MyBatis 的
SqlSessionFactoryBuilder创建SqlSessionFactory。
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
- 使用 SqlSession:使用
SqlSessionFactory创建SqlSession,并执行 SQL 语句。
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
}
MyBatis 高级应用
动态 SQL
MyBatis 提供了动态 SQL 功能,可以方便地编写可变 SQL 语句。
<select id="selectUsers" resultType="User">
SELECT * FROM users
<where>
<if test="username != null">
AND username = #{username}
</if>
<if test="address != null">
AND address = #{address}
</if>
</where>
</select>
缓存
MyBatis 提供了两种类型的缓存:一级缓存和二级缓存。
- 一级缓存:在同一个
SqlSession中,查询到的数据会被缓存起来,后续查询相同数据时可以直接从缓存中获取。 - 二级缓存:在同一个
SqlSessionFactory的不同SqlSession之间共享缓存。
批处理
MyBatis 支持批处理,可以同时执行多条 SQL 语句。
try (SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH)) {
UserMapper mapper = session.getMapper(UserMapper.class);
for (int i = 0; i < 1000; i++) {
User user = new User();
user.setUsername("user" + i);
user.setPassword("password");
user.setAddress("address" + i);
mapper.insertUser(user);
}
session.commit();
}
MyBatis 实践
在实际项目中,MyBatis 可以与各种框架和工具结合使用,例如 Spring、MyBatis Generator 等。
与 Spring 结合
将 MyBatis 与 Spring 框架结合,可以方便地使用 Spring 的 AOP、事务管理等特性。
- 添加依赖:在项目的
pom.xml文件中添加 Spring 和 MyBatis 的依赖。
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.3.10</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>2.0.6</version>
</dependency>
- 配置 Spring 和 MyBatis:在 Spring 的配置文件中配置数据源、事务管理器、SqlSessionFactory 等。
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</bean>
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"/>
<property name="configLocation" value="classpath:mybatis-config.xml"/>
</bean>
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource"/>
</bean>
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.myapp.mapper"/>
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>
- 使用 MyBatis:在 Spring 的 Bean 中注入 MyBatis 的 Mapper 接口。
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public User getUserById(int id) {
return userMapper.getUserById(id);
}
}
MyBatis Generator
MyBatis Generator 是一个 MyBatis 的代码生成器,可以自动生成 Mapper 接口、XML 映射文件和实体类。
- 添加依赖:在项目的
pom.xml文件中添加 MyBatis Generator 的依赖。
<dependency>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-core</artifactId>
<version>1.3.7</version>
</dependency>
- 配置 MyBatis Generator:创建
generatorConfig.xml文件,配置数据源、生成目标等。
<generatorConfiguration>
<classPathEntry location="/path/to/mysql-connector-java-5.1.47-bin.jar"/>
<context id="Mysql" targetRuntime="MyBatis3">
<property name="javaFileEncoding" value="UTF-8"/>
<jdbcConnection driverClass="com.mysql.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/mydb"
userId="root"
password=""/>
<javaModelGenerator targetPackage="com.myapp.entity"
targetProject="src/main/java"/>
<sqlMapGenerator targetPackage="com.myapp.mapper"
targetProject="src/main/java"/>
<javaClientGenerator targetPackage="com.myapp.mapper"
targetProject="src/main/java" type="XMLMAPPER"/>
<table schema="mydb" tableName="user"/>
</context>
</generatorConfiguration>
- 运行 MyBatis Generator:使用命令行运行 MyBatis Generator。
mybatis-generator:generate -e -o src/main/java
总结
MyBatis 是一个功能强大、灵活易用的持久层框架。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际项目中,MyBatis 可以与各种框架和工具结合使用,提高开发效率。希望本文能帮助你更好地掌握 MyBatis。
