MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 本意是“my bats”,是一个“半自动”的持久层框架。它既不像 Hibernate 那样全自动,也不像 JDBC 那样手动操作数据库。MyBatis 的核心处理 SQL 映射和执行,而数据源连接、事务管理等交由其他框架如 Spring 管理。
MyBatis 的优势
- 简化数据库操作:MyBatis 避免了大量的 JDBC 代码,使得数据库操作更加简单。
- 灵活的映射规则:MyBatis 支持复杂的映射规则,能够满足各种复杂的业务需求。
- 易于集成:MyBatis 可以与任何 JDBC 兼容的数据源进行集成。
- 插件扩展:MyBatis 支持插件扩展,如分页插件、缓存插件等。
MyBatis 快速入门
1. 环境搭建
首先,需要在项目中添加 MyBatis 依赖。以下是一个 Maven 依赖的例子:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-dbcp2</artifactId>
<version>2.7.0</version>
</dependency>
</dependencies>
2. 配置 MyBatis
创建一个 mybatis-config.xml 文件,配置数据源、事务管理器和映射器。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<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/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. 编写 Mapper 接口
在 com.example.mapper 包下创建一个 UserMapper.java 接口。
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
}
4. 编写 Mapper 映射文件
在 com/example/mapper 包下创建一个 UserMapper.xml 文件。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.mapper.UserMapper">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
5. 使用 MyBatis
创建一个 MyBatisUtil.java 工具类,用于获取 MyBatis 的 SqlSessionFactory。
package com.example.util;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.InputStream;
public class MyBatisUtil {
public static SqlSessionFactory getSqlSessionFactory() {
String resource = "mybatis-config.xml";
InputStream inputStream = MyBatisUtil.class.getClassLoader().getResourceAsStream(resource);
return new SqlSessionFactoryBuilder().build(inputStream);
}
}
在业务代码中,使用 SqlSessionFactory 创建 SqlSession,然后执行查询。
package com.example.service;
import com.example.mapper.UserMapper;
import com.example.entity.User;
import com.example.util.MyBatisUtil;
public class UserService {
public User getUserById(int id) {
SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
SqlSession sqlSession = sqlSessionFactory.openSession();
try {
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
return userMapper.getUserById(id);
} finally {
sqlSession.close();
}
}
}
通过以上步骤,您已经成功入门 MyBatis。接下来,您可以继续深入学习 MyBatis 的更多高级特性和最佳实践。
