MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的 Java 对象)映射成数据库中的记录。
引言
在学习 MyBatis 之前,我们需要了解一些基础知识,比如 Java 基础、数据库基础以及 JDBC 操作。接下来,我们将一步步带你入门 MyBatis,掌握 SQL 映射与数据库操作技巧。
一、环境搭建
1.1 创建项目
首先,我们需要创建一个 Java 项目。这里以 Maven 项目为例。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>mybatis-example</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
</dependencies>
</project>
1.2 配置数据库
这里以 MySQL 为例,首先需要下载 MySQL 驱动。然后,在项目中创建 src/main/resources 目录,并添加 application.properties 文件,配置数据库信息。
# 数据库配置
db.driver=com.mysql.cj.jdbc.Driver
db.url=jdbc:mysql://localhost:3306/mybatis_db?useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC
db.user=root
db.password=root
二、编写 MyBatis 配置文件
MyBatis 配置文件位于 src/main/resources 目录下,命名为 mybatis-config.xml。该文件包含数据库配置、事务管理以及 SQL 映射语句等信息。
<?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.user}"/>
<property name="password" value="${db.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
三、编写 Mapper 接口
在 com.example.mapper 包下创建 UserMapper.java 接口,定义 SQL 映射语句。
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User getUserById(int id);
}
四、编写 Mapper XML 文件
在 src/main/resources/com/example/mapper 目录下创建 UserMapper.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="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
五、使用 MyBatis 查询数据
在 Java 类中,创建 SqlSessionFactory 和 SqlSession 对象,使用 UserMapper 接口查询数据。
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 Main {
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.getName());
sqlSession.close();
}
}
六、总结
通过以上步骤,我们成功入门了 MyBatis,掌握了 SQL 映射与数据库操作技巧。在实际项目中,MyBatis 可以大大提高开发效率,降低数据库操作复杂度。希望这篇文章能帮助你更好地学习和使用 MyBatis。
