MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
入门指南
1. 环境搭建
1.1 下载与安装
首先,你需要从 MyBatis 官网下载 MyBatis 的最新版本。同时,确保你的项目中已经添加了 MyBatis 的依赖。
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
1.2 配置文件
创建一个名为 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>
2. 创建映射器
在 com/example/mapper 包下创建 UserMapper.xml 文件,用于配置 SQL 映射。
<!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="selectById" resultType="com.example.entity.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
3. 创建接口
在 com/example/mapper 包下创建 UserMapper 接口,用于声明 SQL 映射。
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User selectById(Integer id);
}
4. 使用 MyBatis
在主程序中,通过 SqlSessionFactoryBuilder 创建 SqlSessionFactory,然后通过 SqlSessionFactory 获取 SqlSession,最后使用 SqlSession 执行 SQL。
public class Main {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml"))) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1);
System.out.println(user);
}
}
}
}
实战应用
1. 动态 SQL
MyBatis 提供了动态 SQL 的功能,可以让我们根据条件动态构建 SQL 语句。
<select id="selectByCondition" resultType="com.example.entity.User">
SELECT * FROM users
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
2. 一对多
MyBatis 支持一对多关联查询。
<resultMap id="userMap" type="com.example.entity.User">
<id property="id" column="id"/>
<result property="name" column="name"/>
<result property="age" column="age"/>
<collection property="orders" ofType="com.example.entity.Order">
<id property="id" column="id"/>
<result property="orderNumber" column="order_number"/>
<result property="orderDate" column="order_date"/>
</collection>
</resultMap>
<select id="selectUserWithOrders" resultMap="userMap">
SELECT u.*, o.*
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.id = #{id}
</select>
3. 分页
MyBatis 支持分页查询。
<select id="selectUsersByPage" resultMap="userMap">
SELECT * FROM users LIMIT #{offset}, #{limit}
</select>
总结
MyBatis 是一个功能强大的持久层框架,可以帮助我们简化数据库操作。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际开发中,你可以根据需求灵活运用 MyBatis 的各种功能,提高开发效率。
