MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
下面,我们将一步步带你快速上手 MyBatis,让你轻松实现数据库操作。
一、环境搭建
1.1 下载与安装
首先,你需要从 MyBatis 官网下载 MyBatis 的最新版本。下载完成后,将其解压到本地目录。
1.2 添加依赖
在项目中,你需要添加 MyBatis 的依赖以及数据库驱动的依赖。以下是一个 Maven 项目的示例:
<dependencies>
<!-- MyBatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- 数据库驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
二、配置文件
2.1 创建配置文件
在项目的 src 目录下创建一个名为 mybatis-config.xml 的配置文件。这个文件用于配置 MyBatis 的环境,包括数据库连接信息、事务管理器、映射器等。
<?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&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!-- 映射器 -->
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
2.2 配置文件解析
<environments>:配置事务管理器和数据源。<environment>:配置事务管理器和数据源的具体信息。<transactionManager>:配置事务管理器类型,这里使用 JDBC。<dataSource>:配置数据源类型,这里使用 POOLED,即连接池。<property>:配置数据源的具体信息,如驱动、URL、用户名、密码等。<mappers>:配置映射器,用于映射 SQL 语句和 Java 对象。
三、编写 Mapper 接口
3.1 创建 Mapper 接口
在项目中创建一个名为 UserMapper.java 的接口,用于定义数据库操作的方法。
package com.example.mapper;
import com.example.entity.User;
import java.util.List;
public interface UserMapper {
List<User> findAll();
User findById(int id);
int save(User user);
int update(User user);
int delete(int id);
}
3.2 Mapper 接口解析
findAll():查询所有用户。findById(int id):根据 ID 查询用户。save(User user):保存用户。update(User user):更新用户。delete(int id):根据 ID 删除用户。
四、编写 Mapper XML
4.1 创建 Mapper XML
在项目中创建一个名为 UserMapper.xml 的 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="findAll" resultType="com.example.entity.User">
SELECT * FROM user
</select>
<select id="findById" parameterType="int" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
<insert id="save" parameterType="com.example.entity.User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
<update id="update" parameterType="com.example.entity.User">
UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>
<delete id="delete" parameterType="int">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
4.2 Mapper XML 解析
<mapper>:配置命名空间,用于区分不同的 Mapper。<select>、<insert>、<update>、<delete>:配置 SQL 语句。id:SQL 语句的唯一标识。resultType:返回结果的类型。parameterType:参数的类型。
五、使用 MyBatis
5.1 创建 SqlSessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
5.2 获取 SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
5.3 使用 Mapper
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> users = userMapper.findAll();
5.4 提交事务
sqlSession.commit();
5.5 关闭 SqlSession
sqlSession.close();
六、总结
通过以上步骤,你已经成功上手了 MyBatis。MyBatis 可以帮助你轻松实现数据库操作,让你告别繁琐的 SQL 代码。希望这篇文章能对你有所帮助!
