引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
对于新手来说,快速入门 MyBatis 是至关重要的。本文将为你提供一个详细的 MyBatis 快速入门教程,包括基本概念、配置步骤以及一个简单的实战案例。
一、MyBatis 基本概念
1.1 MyBatis 的核心组件
- SqlSession: MyBatis 的核心接口,用于执行 SQL 命令、管理事务以及获取映射器(Mapper)。
- Executor: MyBatis 的执行器,负责执行 SQL 语句,并返回结果。
- Mapper: MyBatis 的映射器接口,用于定义 SQL 语句和参数,以及结果映射。
1.2 MyBatis 的映射文件
MyBatis 使用 XML 文件来定义 SQL 语句和结果映射。这些文件通常放置在 src/main/resources 目录下。
二、MyBatis 快速入门
2.1 环境搭建
- 添加依赖:在你的 Maven 项目中添加 MyBatis 的依赖。
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</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.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>
- 编写 Mapper 接口:在
com.example.mapper包下创建UserMapper.java接口。
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
}
- 编写 Mapper 映射文件:在
src/main/resources/com/example/mapper目录下创建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.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
- 编写实体类:在
com.example包下创建User.java类。
package com.example;
public class User {
private int id;
private String name;
// ... 省略 getter 和 setter 方法 ...
}
2.2 运行 MyBatis
- 创建 MyBatis 应用程序:创建一个 Java 应用程序,并添加必要的依赖。
- 创建 SqlSessionFactory:在应用程序中创建
SqlSessionFactory。
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
- 创建 SqlSession:使用
SqlSessionFactory创建SqlSession。
SqlSession sqlSession = sqlSessionFactory.openSession();
- 执行查询:使用
SqlSession执行查询。
User user = sqlSession.selectOne("com.example.mapper.UserMapper.getUserById", 1);
System.out.println(user.getName());
- 关闭资源:关闭
SqlSession和SqlSessionFactory。
sqlSession.close();
sqlSessionFactory.close();
三、实战案例解析
以下是一个简单的实战案例,演示如何使用 MyBatis 查询用户信息。
- 创建数据库表:
CREATE TABLE users (
id INT PRIMARY KEY,
name VARCHAR(50)
);
- 添加用户数据:
INSERT INTO users (id, name) VALUES (1, '张三');
- 修改
UserMapper.xml文件:
<select id="getUserById" resultType="com.example.User">
SELECT * FROM users WHERE id = #{id}
</select>
- 运行应用程序:应用程序将查询用户信息并打印到控制台。
结语
通过本文的介绍,相信你已经对 MyBatis 有了一个基本的了解。MyBatis 是一个功能强大的持久层框架,可以帮助你简化数据库操作。希望本文能帮助你快速入门 MyBatis,并在实际项目中应用它。
