MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
本文将带您从零开始,轻松掌握 MyBatis,并通过实战教程与开源框架应用解析,让您深入理解 MyBatis 的核心概念和用法。
1. MyBatis 简介
1.1 什么是 MyBatis?
MyBatis 是一个半ORM(对象关系映射)框架,它允许你将 SQL 语句映射到 Java 对象。与全ORM框架如 Hibernate 相比,MyBatis 提供了更加灵活的 SQL 语句编写方式,同时减少了数据库操作的复杂性。
1.2 MyBatis 的特点
- 灵活的 SQL 映射:使用 XML 或注解的方式配置 SQL 语句。
- 高性能:减少了数据库操作的开销。
- 易于集成:与各种数据库技术兼容。
- 丰富的插件机制:支持缓存、分页等高级功能。
2. MyBatis 核心概念
2.1 SQL 映射文件
MyBatis 的核心是 SQL 映射文件,它包含了 SQL 语句、参数、返回值等信息。下面是一个简单的示例:
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectUserById" resultType="com.example.entity.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
2.2 Mapper 接口
Mapper 接口定义了与数据库表对应的操作方法,MyBatis 会根据接口名生成对应的实现类。
public interface UserMapper {
User selectUserById(int id);
}
2.3 映射关系
MyBatis 将 SQL 映射文件中的 SQL 语句与 Mapper 接口的方法进行映射,实现数据持久层的操作。
3. MyBatis 实战教程
3.1 创建项目
首先,您需要创建一个 Java 项目,并添加 MyBatis 相关的依赖。
<dependencies>
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- 数据库连接池 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.23</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
</dependencies>
3.2 配置数据库连接
在 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/mydb?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3.3 编写 SQL 映射文件
在 src/main/resources 目录下创建 com/example/mapper/UserMapper.xml 文件,配置 SQL 映射信息。
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectUserById" resultType="com.example.entity.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
3.4 编写 Mapper 接口
在 src/main/java 目录下创建 com/example/mapper/UserMapper.java 文件,定义 Mapper 接口。
public interface UserMapper {
User selectUserById(int id);
}
3.5 测试 MyBatis
在 src/test/java 目录下创建测试类 UserMapperTest.java,使用 MyBatis 进行测试。
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import com.example.mapper.UserMapper;
import com.example.entity.User;
public class UserMapperTest {
public static void main(String[] args) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build("mybatis-config.xml");
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.selectUserById(1);
System.out.println(user);
}
}
}
运行测试类,您将看到控制台输出用户信息。
4. MyBatis 与开源框架集成
MyBatis 可以与各种开源框架集成,例如 Spring、Hibernate 等。
4.1 MyBatis 与 Spring 集成
以下是一个简单的 MyBatis 与 Spring 集成的示例:
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<!-- 配置 MyBatis -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="configLocation" value="classpath:mybatis-config.xml"/>
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 配置数据源 -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
<property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mydb?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</bean>
<!-- 扫描 Mapper 接口 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.example.mapper"/>
</bean>
</beans>
通过以上配置,Spring 会自动扫描 com.example.mapper 包下的 Mapper 接口,并将它们注册到 MyBatis 中。
5. 总结
通过本文的学习,您已经从零开始,轻松掌握了 MyBatis 的核心概念、实战教程以及与开源框架的集成方法。希望您能够在实际项目中应用 MyBatis,提高开发效率。
