引言
MyBatis是一个优秀的持久层框架,它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。MyBatis通过简单的XML或注解用于配置和原始映射,将接口和Java的POJOs(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录。本文将从入门到精通的角度,详细介绍MyBatis的使用方法,并通过实际案例进行讲解。
第一章:MyBatis入门
1.1 MyBatis简介
MyBatis的核心是SqlSession,它负责执行命令、管理事务、获取映射等。MyBatis通过XML或注解的方式,将SQL语句与Java代码分离,提高了代码的可读性和可维护性。
1.2 MyBatis环境搭建
- 添加依赖
在项目的pom.xml文件中添加以下依赖:
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
- 配置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=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
- 编写Mapper接口
在项目的src/main/java目录下创建UserMapper接口,定义查询、更新、删除等操作。
package com.example.mapper;
public interface UserMapper {
List<User> selectAll();
int update(User user);
int deleteById(Integer id);
}
- 编写Mapper XML
在项目的src/main/resources目录下创建UserMapper.xml文件,配置SQL语句。
<?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="selectAll" resultType="com.example.entity.User">
SELECT * FROM user
</select>
<update id="update">
UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>
<delete id="deleteById">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
- 测试
在项目中创建测试类,测试MyBatis功能。
package com.example;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisTest {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build()) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper userMapper = session.getMapper(UserMapper.class);
userMapper.selectAll().forEach(System.out::println);
}
}
}
}
第二章:MyBatis进阶
2.1 动态SQL
MyBatis支持动态SQL,可以根据条件动态生成SQL语句。
- if标签
<select id="selectByCondition" 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>
- choose、when、otherwise标签
<select id="selectByCondition" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<choose>
<when test="name != null">
name = #{name}
</when>
<when test="age != null">
age = #{age}
</when>
<otherwise>
1 = 1
</otherwise>
</choose>
</where>
</select>
2.2 类型处理器
MyBatis提供了类型处理器,用于将Java类型转换为数据库类型。
- 自定义类型处理器
package com.example.typehandler;
import org.apache.ibatis.type.BaseTypeHandler;
import org.apache.ibatis.type.JdbcType;
import java.sql.CallableStatement;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
public class MyTypeHandler extends BaseTypeHandler<String> {
@Override
public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {
ps.setString(i, parameter);
}
@Override
public String getNullableResult(ResultSet rs, String columnName) throws SQLException {
return rs.getString(columnName);
}
@Override
public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
return rs.getString(columnIndex);
}
@Override
public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
return cs.getString(columnIndex);
}
}
- 使用自定义类型处理器
<resultMap id="userMap" type="com.example.entity.User">
<result column="name" property="name" typeHandler="com.example.typehandler.MyTypeHandler"/>
</resultMap>
2.3 批处理
MyBatis支持批处理,可以批量插入、更新、删除数据。
- 批量插入
<insert id="batchInsert" parameterType="java.util.List">
INSERT INTO user (name, age) VALUES
<foreach collection="list" item="user" separator=",">
(#{user.name}, #{user.age})
</foreach>
</insert>
- 批量更新
<update id="batchUpdate" parameterType="java.util.List">
<foreach collection="list" item="user" index="index" separator=";">
UPDATE user SET name = #{user.name}, age = #{user.age} WHERE id = #{user.id}
</foreach>
</update>
第三章:MyBatis案例分析
3.1 案例一:用户管理模块
- 实体类
package com.example.entity;
public class User {
private Integer id;
private String name;
private Integer age;
// 省略getter和setter方法
}
- Mapper接口
package com.example.mapper;
public interface UserMapper {
List<User> selectAll();
int insert(User user);
int update(User user);
int deleteById(Integer id);
}
- Mapper XML
<insert id="insert" parameterType="com.example.entity.User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
- 测试
package com.example;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class UserTest {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build()) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper userMapper = session.getMapper(UserMapper.class);
User user = new User();
user.setName("张三");
user.setAge(20);
userMapper.insert(user);
session.commit();
}
}
}
}
3.2 案例二:订单管理模块
- 实体类
package com.example.entity;
public class Order {
private Integer id;
private Integer userId;
private String orderNo;
private Date createTime;
// 省略getter和setter方法
}
- Mapper接口
package com.example.mapper;
public interface OrderMapper {
List<Order> selectAll();
int insert(Order order);
int update(Order order);
int deleteById(Integer id);
}
- Mapper XML
<insert id="insert" parameterType="com.example.entity.Order">
INSERT INTO order (user_id, order_no, create_time) VALUES (#{userId}, #{orderNo}, #{createTime})
</insert>
- 测试
package com.example;
import com.example.mapper.OrderMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class OrderTest {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build()) {
try (SqlSession session = sqlSessionFactory.openSession()) {
OrderMapper orderMapper = session.getMapper(OrderMapper.class);
Order order = new Order();
order.setUserId(1);
order.setOrderNo("20200101001");
order.setCreateTime(new Date());
orderMapper.insert(order);
session.commit();
}
}
}
}
总结
MyBatis是一个功能强大、易于使用的持久层框架。通过本文的介绍,相信你已经对MyBatis有了更深入的了解。在实际项目中,MyBatis可以帮助你提高开发效率,降低代码量,让你更加专注于业务逻辑的实现。希望本文对你有所帮助!
