MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
环境准备
在开始使用 MyBatis 之前,你需要准备以下环境:
- Java 开发环境:确保你的计算机上已经安装了 Java Development Kit (JDK),版本至少为 1.8。
- IDE:推荐使用 IntelliJ IDEA 或 Eclipse 作为开发工具。
- Maven:一个项目管理工具,用于依赖管理和构建自动化。
- 数据库:可以选择 MySQL、Oracle 或其他支持 JDBC 的数据库。
步骤 1:创建 Maven 项目
- 打开你的 IDE,创建一个新的 Maven 项目。
- 添加以下依赖到
pom.xml文件中:
<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.23</version>
</dependency>
</dependencies>
步骤 2:配置数据库连接
在项目的 src/main/resources 目录下创建一个名为 database.properties 的文件,用于存储数据库连接信息:
# database.properties
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC
username=root
password=your_password
步骤 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="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/yourpackage/YourMapper.xml"/>
</mappers>
</configuration>
步骤 4:定义 Mapper 接口和 XML 映射文件
在项目的 src/main/java/com/yourpackage 目录下创建一个接口 UserMapper.java:
package com.yourpackage;
public interface UserMapper {
List<User> getAllUsers();
User getUserById(int id);
}
然后在 src/main/resources/com/yourpackage 目录下创建一个名为 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.yourpackage.UserMapper">
<select id="getAllUsers" resultType="User">
SELECT * FROM users
</select>
<select id="getUserById" parameterType="int" resultType="User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
步骤 5:使用 MyBatis
现在你可以在你的 Java 类中通过 MyBatis 的 SqlSessionFactory 和 SqlSession 来执行 SQL 语句:
package com.yourpackage;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisExample {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml"))) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
List<User> users = mapper.getAllUsers();
for (User user : users) {
System.out.println(user);
}
}
}
}
}
通过以上步骤,你就可以使用 MyBatis 实现简单的数据库操作了。接下来,你可以进一步学习 MyBatis 的高级特性和最佳实践。祝你学习愉快!
