MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定大于配置的原则,它允许你将 SQL 与对象映射在一起,从而简化了数据库操作。以下是 MyBatis 的几个关键特点:
- 半自动映射:MyBatis 会自动将 SQL 结果映射到 Java 对象上,但同时也允许你手动编写映射。
- 易于使用:MyBatis 提供了丰富的 API,可以轻松地执行 SQL 查询、更新、删除等操作。
- 支持定制:MyBatis 允许你通过插件来扩展其功能,例如分页插件、缓存插件等。
- 插件支持:MyBatis 支持各种插件,如日志插件、缓存插件、分页插件等。
安装 MyBatis
首先,你需要将 MyBatis 添加到你的项目中。以下是在 Maven 项目中添加 MyBatis 的步骤:
<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.26</version>
</dependency>
</dependencies>
配置 MyBatis
接下来,你需要配置 MyBatis 的环境。在 src/main/resources 目录下创建一个名为 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="your_username"/>
<property name="password" value="your_password"/>
</dataSource>
</environment>
</environments>
<!-- 映射文件配置 -->
<mappers>
<mapper resource="com/your/package/YourMapper.xml"/>
</mappers>
</configuration>
创建 Mapper 接口
在 com/your/package 目录下创建一个名为 YourMapper.java 的接口,并定义你需要执行的 SQL 操作:
package com.your.package;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
@Mapper
public interface YourMapper {
@Select("SELECT * FROM your_table")
List<YourEntity> selectAll();
}
创建实体类
在 com/your/package 目录下创建一个名为 YourEntity.java 的实体类,用于映射数据库中的表:
package com.your.package;
public class YourEntity {
private Integer id;
private String name;
// ... 其他字段 ...
// getter 和 setter
}
编写 Mapper XML
在 src/main/resources/com/your/package 目录下创建一个名为 YourMapper.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.your.package.YourMapper">
<select id="selectAll" resultType="com.your.package.YourEntity">
SELECT * FROM your_table
</select>
</mapper>
使用 MyBatis
现在,你可以在你的 Java 代码中调用 YourMapper 接口来执行数据库操作:
package com.your.package;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.util.List;
public class Main {
public static void main(String[] args) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
try (SqlSession session = sqlSessionFactory.openSession()) {
YourMapper mapper = session.getMapper(YourMapper.class);
List<YourEntity> entities = mapper.selectAll();
for (YourEntity entity : entities) {
System.out.println(entity.getName());
}
}
}
}
以上步骤就完成了 MyBatis 的基本配置和数据库操作。MyBatis 提供了丰富的功能,可以帮助你轻松实现复杂的数据库操作。希望这篇攻略能帮助你入门 MyBatis!
