MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 本是Apache软件基金会的一个开源项目,但后来归到Apache的子公司MyBatis.org。它允许我们以更接近自然语言的方式操作数据库,简化了数据库操作。
应用实战
1. 环境搭建
首先,需要下载 MyBatis 的 jar 包以及数据库驱动。接下来,创建一个 Maven 项目,并添加以下依赖:
<dependencies>
<!-- MyBatis 依赖 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
然后,配置数据库连接信息,在 src/main/resources 目录下创建 application.properties 文件:
# 数据库配置
db.url=jdbc:mysql://localhost:3306/mydb
db.username=root
db.password=root
db.driver=com.mysql.cj.jdbc.Driver
最后,在 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="${db.driver}"/>
<property name="url" value="${db.url}"/>
<property name="username" value="${db.username}"/>
<property name="password" value="${db.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2. 编写 Mapper 接口和 XML 映射文件
接下来,创建一个 Mapper 接口 UserMapper:
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User getUserById(int id);
}
然后,在 src/main/resources 目录下创建对应的 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">
<select id="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
最后,创建一个测试类 MyBatisTest:
package com.example;
import com.example.entity.User;
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) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}
}
运行 MyBatisTest 类,将输出查询到的用户信息。
进阶技巧
1. 动态 SQL
MyBatis 提供了动态 SQL 功能,可以方便地实现复杂查询。
例如,在 UserMapper.xml 中,可以使用 <if> 标签实现条件查询:
<select id="getUserByCondition" resultType="com.example.entity.User">
SELECT * FROM user
<where>
<if test="name != null and name != ''">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
2. 类型处理器
MyBatis 提供了丰富的类型处理器,可以方便地处理各种类型的数据。
例如,可以使用 IntegerTypeHandler 处理 Integer 类型:
<resultMap id="userMap" type="com.example.entity.User">
<result column="age" property="age" typeHandler="com.example.handler.IntegerTypeHandler"/>
</resultMap>
3. 插件
MyBatis 提供了插件机制,可以扩展其功能。
例如,创建一个自定义插件 MyPlugin:
package com.example.plugin;
import org.apache.ibatis.executor.statement.StatementHandler;
import org.apache.ibatis.plugin.*;
import java.sql.Connection;
import java.util.Properties;
@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})})
public class MyPlugin implements Interceptor {
@Override
public Object intercept(Invocation invocation) throws Throwable {
// 自定义逻辑
return invocation.proceed();
}
@Override
public Object plugin(Object target) {
return Plugin.wrap(target, this);
}
@Override
public void setProperties(Properties properties) {
// 获取插件配置信息
}
}
在 mybatis-config.xml 中配置插件:
<plugins>
<plugin interceptor="com.example.plugin.MyPlugin"/>
</plugins>
总结
MyBatis 是一个功能强大、易于使用的 Java 持久层框架。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际开发中,结合实战和进阶技巧,MyBatis 将为你的项目带来极大的便利。
