引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
在这个入门教程中,我们将一起探索如何使用 MyBatis 实现数据库操作。无论你是初学者还是有经验的开发者,这篇文章都将为你提供必要的知识,帮助你轻松上手 MyBatis。
环境准备
在开始之前,确保你已经安装了以下环境:
- JDK 1.8 或更高版本
- Maven 3.0 或更高版本
- MySQL 数据库(或其他支持的数据库)
1. 创建Maven项目
首先,创建一个Maven项目,并在 pom.xml 文件中添加以下依赖:
<dependencies>
<!-- MyBatis 依赖 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
<!-- 单元测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
</dependencies>
2. 配置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/mydb"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!-- 配置映射文件 -->
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
3. 创建实体类和Mapper接口
在 com.example 包下创建实体类 User.java 和 Mapper 接口 UserMapper.java:
// User.java
package com.example;
public class User {
private Integer id;
private String name;
private Integer age;
// getter 和 setter 省略...
}
// UserMapper.java
package com.example;
public interface UserMapper {
List<User> selectAll();
}
4. 编写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.UserMapper">
<select id="selectAll" resultType="com.example.User">
SELECT * FROM users
</select>
</mapper>
5. 使用MyBatis
现在,我们可以使用MyBatis来执行数据库操作了。在主类 App.java 中,添加以下代码:
// App.java
package com.example;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class App {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build()) {
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> users = userMapper.selectAll();
for (User user : users) {
System.out.println(user);
}
}
}
}
}
6. 运行程序
运行 App.java,程序将连接到数据库并输出所有用户信息。
总结
在这个入门教程中,我们学习了如何使用 MyBatis 实现数据库操作。通过配置数据库连接、创建实体类、Mapper 接口和 XML 映射文件,我们可以轻松地实现对数据库的增删改查操作。
MyBatis 是一个功能强大的持久层框架,它简化了数据库操作,提高了开发效率。希望这个入门教程能帮助你更好地了解 MyBatis,并在实际项目中运用它。
