MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定优于配置( Convention Over Configuration)的原则,这使得 MyBatis 的配置和映射文件相对简单。它支持自定义 SQL、存储过程以及高级映射,如关联、集合等。
入门准备
环境搭建
- Java 开发环境:确保你的系统中安装了 Java 开发工具包(JDK)。
- IDE:推荐使用 IntelliJ IDEA 或 Eclipse。
- Maven:作为构建工具,Maven 可以帮助你管理项目依赖。
创建项目
- Maven 项目:使用 Maven 创建一个简单的 Java Web 项目。
- 添加依赖:在
pom.xml中添加 MyBatis 以及数据库连接池的依赖。
<dependencies>
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- 数据库连接池 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.10</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
配置 MyBatis
- 创建配置文件:在
src/main/resources目录下创建mybatis-config.xml。 - 配置数据库连接:在配置文件中配置数据库连接信息。
<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/your_database"/>
<property name="username" value="root"/>
<property name="password" value="password"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
- 创建映射文件:在
src/main/resources/com/example/mapper目录下创建UserMapper.xml。
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectUser" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
编写 MyBatis 接口
- 创建接口:在
com.example.mapper目录下创建UserMapper.java。
package com.example.mapper;
import com.example.entity.User;
import org.apache.ibatis.annotations.Select;
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User selectUser(Integer id);
}
使用 MyBatis
- 创建 MyBatis 工厂:在项目入口处创建 MyBatis 工厂。
package com.example.util;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisUtil {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(MyBatisUtil.class.getResourceAsStream("/mybatis-config.xml"));
} catch (Exception e) {
e.printStackTrace();
}
}
public static SqlSessionFactory getSqlSessionFactory() {
return sqlSessionFactory;
}
}
- 使用 MyBatis:在业务逻辑层调用 MyBatis 接口。
package com.example.service;
import com.example.entity.User;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
public class UserService {
public User getUserById(Integer id) {
try (SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
return mapper.selectUser(id);
}
}
}
高效实践
映射文件优化
- 使用别名:在映射文件中使用别名可以简化 SQL 语句。
- 动态 SQL:使用
<if>、<choose>、<when>、<otherwise>等标签实现动态 SQL。
高级映射
- 关联映射:使用
<resultMap>标签实现多表关联查询。 - 集合映射:使用
<collection>标签实现一对多、多对多等关系映射。
插件扩展
- 分页插件:使用分页插件实现数据库分页查询。
- 日志插件:使用日志插件记录 SQL 执行过程。
总结
MyBatis 是一个功能强大、易于使用的持久层框架。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际项目中,你可以根据自己的需求进行优化和扩展,让你的数据库操作更加高效、简单。
