MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 最初由原 Hibernate 作者 Hills傅阳创建,后由开源社区维护。它旨在帮助开发者更高效地进行数据库操作,简化 JDBC 的使用,使开发者能够专注于业务逻辑,而不是繁琐的数据库操作。
MyBatis 核心概念
1. SQL 映射文件
MyBatis 的核心是 SQL 映射文件,它包含了 SQL 语句和映射配置。这些文件通常以 .xml 扩展名结尾。
<!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="selectUser" resultType="com.example.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
2. 接口
MyBatis 使用接口来定义 SQL 语句,接口中的方法名称与 SQL 映射文件中的 id 属性相匹配。
public interface UserMapper {
User selectUser(Integer id);
}
3. 映射器
映射器是 MyBatis 的核心,它负责执行 SQL 语句并将结果转换为 Java 对象。
public class UserMapperImpl implements UserMapper {
private SqlSession sqlSession;
public User selectUser(Integer id) {
return sqlSession.selectOne("com.example.mapper.UserMapper.selectUser", id);
}
}
4. SQL 会话(SqlSession)
SQL 会话是 MyBatis 的核心接口,用于执行 SQL 语句和获取数据库对象。
SqlSession sqlSession = sqlSessionFactory.openSession();
try {
User user = sqlSession.selectOne("com.example.mapper.UserMapper.selectUser", 1);
// ...处理结果
} finally {
sqlSession.close();
}
MyBatis 实战指南
1. 创建项目
首先,创建一个 Java 项目,并添加 MyBatis 相关依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- ...其他依赖 -->
</dependencies>
2. 配置 MyBatis
创建 mybatis-config.xml 配置文件,配置数据源、事务管理器等。
<!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. 编写 SQL 映射文件
在 src/main/resources 目录下创建 UserMapper.xml 文件,定义 SQL 语句和映射配置。
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectUser" resultType="com.example.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
4. 编写接口
在 src/main/java 目录下创建 UserMapper.java 接口,定义 SQL 语句的调用方法。
public interface UserMapper {
User selectUser(Integer id);
}
5. 使用 MyBatis
创建 SqlSessionFactory 实例,并使用它获取 SqlSession。
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
SqlSession sqlSession = sqlSessionFactory.openSession();
try {
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.selectUser(1);
// ...处理结果
} finally {
sqlSession.close();
}
总结
MyBatis 是一个功能强大的 Java 开源持久层框架,可以帮助开发者快速提升项目效率。通过了解其核心概念和实战指南,开发者可以轻松地将 MyBatis 应用于自己的项目中。
