MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 本是 Apache 组织的一个开源项目,于 2010 年由 Apache 官方归档,并由 Google Code 托管,最后迁移至 GitHub。MyBatis 的设计哲学是“半ORM”(部分对象关系映射),它将 SQL 映射语句与对象分离,使得 SQL 变得更加灵活,同时避免了全ORM带来的性能损耗。
MyBatis 的核心组件
- SqlSession: MyBatis 的核心接口,它包含执行 SQL 命令、管理事务和获取映射器等方法。
- Executor: MyBatis 的核心执行器,负责执行查询、更新等操作。
- StatementHandler: 负责将 MyBatis 的映射语句转换成数据库的 SQL 语句。
- ParameterHandler: 负责处理 SQL 语句中的参数。
- ResultSetHandler: 负责处理查询结果集。
MyBatis 入门实战
1. 环境搭建
首先,我们需要创建一个简单的 Java 项目,并引入 MyBatis 相关依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
2. 配置 MyBatis
接下来,我们需要在项目中的 src/main/resources 目录下创建一个名为 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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. 编写 Mapper 接口和 XML 映射文件
假设我们有一个用户表,我们需要进行增删改查操作。
首先,我们创建一个 User 实体类:
public class User {
private Integer id;
private String name;
private String email;
// getters and setters
}
然后,我们创建一个 UserMapper 接口:
public interface UserMapper {
void insert(User user);
User selectById(Integer id);
void update(User user);
void delete(Integer id);
}
最后,我们编写对应的 XML 映射文件 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">
<insert id="insert" parameterType="User">
INSERT INTO user (name, email) VALUES (#{name}, #{email})
</insert>
<select id="selectById" resultType="User">
SELECT * FROM user WHERE id = #{id}
</select>
<update id="update" parameterType="User">
UPDATE user SET name = #{name}, email = #{email} WHERE id = #{id}
</update>
<delete id="delete" parameterType="int">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
4. 使用 MyBatis
在 Java 代码中,我们使用 SqlSession 来执行 MyBatis 的操作。
public class Main {
public static void main(String[] args) throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
// 执行增删改查操作
}
}
}
总结
通过以上步骤,我们已经成功入门 MyBatis 并完成了一个简单的应用实战。MyBatis 作为一个优秀的持久层框架,能够极大地提高我们的开发效率。在实际项目中,我们还可以使用 MyBatis 的缓存机制、插件机制等高级特性,使其更加灵活和强大。
