MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定大于配置的原则,这意味着大多数情况下你只需要配置很少的 XML 或注解,MyBatis 就能自动完成其余的工作。它支持自定义 SQL、存储过程以及高级映射。
入门教程
1. 环境搭建
首先,你需要配置 Java 开发环境,然后添加 MyBatis 依赖到你的项目中。以下是 Maven 依赖的例子:
<dependencies>
<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. 配置文件
MyBatis 使用 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/your_database"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. Mapper 文件
Mapper 文件定义了 SQL 语句和 MyBatis 如何将 SQL 结果集映射到 Java 对象。以下是一个简单的 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="selectById" resultType="com.example.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
4. 接口定义
接下来,你需要定义一个接口,这个接口中的方法将映射到 Mapper 文件中的 SQL 语句。以下是一个简单的 UserMapper 接口示例:
package com.example.mapper;
public interface UserMapper {
User selectById(int id);
}
5. 使用 MyBatis
最后,你可以使用 MyBatis 的 SqlSessionFactory 来执行 SQL 语句。以下是如何使用 MyBatis 的示例:
package com.example;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
public class Main {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory()) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1);
System.out.println(user);
}
}
}
}
实战案例解析
1. 创建数据库和表
首先,你需要创建一个数据库和一张表。以下是一个简单的 SQL 语句来创建一个名为 users 的表:
CREATE TABLE users (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(50) NOT NULL,
email VARCHAR(100) NOT NULL
);
2. 添加数据
接下来,你可以向 users 表中添加一些数据:
INSERT INTO users (username, email) VALUES ('John Doe', 'john.doe@example.com');
INSERT INTO users (username, email) VALUES ('Jane Doe', 'jane.doe@example.com');
3. 查询数据
使用 MyBatis 查询数据非常简单。以下是如何查询所有用户的示例:
package com.example.mapper;
public interface UserMapper {
List<User> selectAll();
}
<?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="selectAll" resultType="com.example.User">
SELECT * FROM users
</select>
</mapper>
现在,你可以使用 MyBatis 查询所有用户:
package com.example;
import java.util.List;
public class Main {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory()) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
List<User> users = mapper.selectAll();
for (User user : users) {
System.out.println(user);
}
}
}
}
}
通过以上步骤,你已经成功地使用 MyBatis 查询了数据库中的数据。MyBatis 提供了丰富的功能,例如动态 SQL、关联映射和缓存等,可以帮助你更高效地操作数据库。
