MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
以下是对 MyBatis 的入门攻略,包括实战案例和核心原理的深度解析。
1. MyBatis 简介
1.1 MyBatis 的特点
- 简单易用:MyBatis 可以通过简单的 XML 或注解来配置和映射 SQL,减少了代码量。
- 灵活:MyBatis 支持自定义 SQL、存储过程以及高级映射。
- 支持自定义持久层:MyBatis 支持自定义 SQL 映射器,可以灵活地实现复杂的查询和更新操作。
- 支持缓存:MyBatis 支持一级缓存和二级缓存,可以提高查询效率。
1.2 MyBatis 的适用场景
- 复杂查询:当你的 SQL 查询比较复杂时,MyBatis 可以帮助你简化代码。
- 数据访问层:MyBatis 可以作为数据访问层,简化数据库操作。
- 数据迁移:MyBatis 可以帮助你在不同数据库之间迁移数据。
2. MyBatis 快速入门
2.1 环境搭建
- 添加依赖:在项目的
pom.xml文件中添加 MyBatis 的依赖。
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
- 配置 MyBatis:在
resources目录下创建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/test"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
</configuration>
2.2 创建 Mapper 接口和 XML 映射文件
- 创建 Mapper 接口:定义一个接口,声明需要执行的 SQL 映射。
public interface UserMapper {
User getUserById(Integer id);
}
- 创建 XML 映射文件:在
resources目录下创建UserMapper.xml文件,配置 SQL 映射。
<mapper namespace="com.example.mapper.UserMapper">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
2.3 使用 MyBatis
- 创建 SqlSessionFactory:使用 MyBatis 的配置文件创建
SqlSessionFactory。
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("src/main/resources/mybatis-config.xml"));
- 创建 SqlSession:使用
SqlSessionFactory创建SqlSession。
SqlSession sqlSession = sqlSessionFactory.openSession();
- 执行 SQL 映射:使用
SqlSession执行 SQL 映射。
User user = sqlSession.selectOne("com.example.mapper.UserMapper.getUserById", 1);
- 关闭 SqlSession:操作完成后,关闭
SqlSession。
sqlSession.close();
3. MyBatis 核心原理深度解析
3.1 SQL 映射
MyBatis 使用 XML 或注解来配置 SQL 映射。在 XML 映射文件中,可以使用 <select>、<insert>、<update> 和 <delete> 标签来定义 SQL 映射。
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
在上面的例子中,<select> 标签定义了一个名为 getUserById 的 SQL 映射,它返回一个 User 对象。
3.2 映射器
MyBatis 使用接口和 XML 映射文件来定义 SQL 映射器。在上面的例子中,UserMapper 接口定义了一个 getUserById 方法,MyBatis 会根据 XML 映射文件中的配置来生成对应的 SQL 语句。
3.3 缓存
MyBatis 支持一级缓存和二级缓存。一级缓存是本地缓存,只对当前 SqlSession 有效;二级缓存是分布式缓存,对多个 SqlSession 有效。
3.4 动态 SQL
MyBatis 支持动态 SQL,可以使用 <if>、<choose>、<when> 和 <otherwise> 标签来根据条件动态地构建 SQL 语句。
<select id="getUserByCondition" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
在上面的例子中,根据 name 和 age 的值动态地构建 SQL 语句。
4. 实战案例
以下是一个使用 MyBatis 实现用户管理的实战案例。
4.1 用户实体类
public class User {
private Integer id;
private String name;
private Integer age;
// 省略 getter 和 setter 方法
}
4.2 UserMapper 接口
public interface UserMapper {
User getUserById(Integer id);
List<User> getUserByCondition(User user);
void addUser(User user);
void updateUser(User user);
void deleteUser(Integer id);
}
4.3 UserMapper.xml
<mapper namespace="com.example.mapper.UserMapper">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
<select id="getUserByCondition" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
<insert id="addUser">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
<update id="updateUser">
UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>
<delete id="deleteUser">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
4.4 使用 MyBatis 实现用户管理
- 创建
SqlSessionFactory和SqlSession。 - 使用
UserMapper接口执行 SQL 映射。 - 操作完成后,关闭
SqlSession。
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("src/main/resources/mybatis-config.xml"));
SqlSession sqlSession = sqlSessionFactory.openSession();
User user = sqlSession.selectOne("com.example.mapper.UserMapper.getUserById", 1);
System.out.println(user.getName());
sqlSession.close();
以上是对 Java 开源框架 MyBatis 的入门攻略,包括实战案例和核心原理的深度解析。希望这篇文章能帮助你快速入门 MyBatis,并在实际项目中使用它。
