MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定大于配置的原则,通过 XML 或注解的方式将接口和 Java 对象映射成 SQL 语句,使得数据库操作变得更加简单。MyBatis 的核心是 SQL 映射文件,它定义了 SQL 语句和接口之间的关系。
为什么选择 MyBatis?
- 易于上手:MyBatis 的配置文件和注解方式使得数据库操作简单易懂。
- 灵活性强:可以通过 XML 或注解方式灵活配置 SQL 语句。
- 支持定制化:可以通过插件机制实现自定义的功能。
- 性能优秀:通过缓存机制提高数据库操作性能。
环境搭建
1. 添加依赖
首先,在项目的 pom.xml 文件中添加 MyBatis 的依赖:
<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.26</version>
</dependency>
2. 配置数据库
在 application.properties 或 application.yml 文件中配置数据库连接信息:
# application.properties
jdbc.url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=root
jdbc.driver=com.mysql.cj.jdbc.Driver
3. 编写 MyBatis 配置文件
在 src/main/resources 目录下创建 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/mybatis_db?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>
编写 Mapper 接口
在 com.example.mapper 包下创建 UserMapper.java 接口,定义数据库操作的方法:
package com.example.mapper;
public interface UserMapper {
User getUserById(int id);
List<User> getUsers();
}
编写 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>
<select id="getUsers" resultType="com.example.entity.User">
SELECT * FROM user
</select>
</mapper>
编写实体类
在 com.example.entity 包下创建 User.java 实体类,定义数据库表对应的字段:
package com.example.entity;
public class User {
private int id;
private String name;
private String email;
// 省略 getter 和 setter 方法
}
使用 MyBatis
在 com.example.mapper 包下创建 UserMapperTest.java 测试类,使用 MyBatis 的 SqlSessionFactory 和 SqlSession 执行数据库操作:
package com.example.mapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class UserMapperTest {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(UserMapper.class.getResourceAsStream("mybatis-config.xml"));
SqlSession sqlSession = sqlSessionFactory.openSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
}
}
}
以上是使用 MyBatis 搭建 Java 开源框架的实践指南。通过以上步骤,你可以轻松地搭建一个基于 MyBatis 的项目,并实现数据库操作。希望这篇文章能帮助你快速掌握 MyBatis 的使用。
