MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定优于配置的原则,这意味着在大多数情况下,你只需要定义 SQL 语句和映射规则,而不需要复杂的配置。它支持自定义 SQL、存储过程以及高级映射,如关联、集合等。
快速上手 MyBatis
环境准备
- Java 开发环境:确保你的开发环境已经安装了 Java,并配置了环境变量。
- Maven 或 Gradle:MyBatis 通常与 Maven 或 Gradle 一起使用,用于管理项目依赖。
- 数据库:选择一个数据库,如 MySQL、Oracle 等,并创建一个简单的表。
步骤 1:创建 Maven 项目
- 打开 Maven 的官方网站下载 Maven 安装包。
- 解压安装包,并配置环境变量。
- 打开命令行,输入
mvn -v验证是否安装成功。
步骤 2:添加 MyBatis 依赖
在项目的 pom.xml 文件中添加以下依赖:
<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>
步骤 3:配置 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/mydb?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
步骤 4:创建实体类和映射文件
- 实体类:创建一个
User类,表示数据库中的用户表。
package com.example.entity;
public class User {
private Integer id;
private String name;
private String email;
// Getters and Setters
}
- 映射文件:创建一个
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="selectById" resultType="com.example.entity.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
步骤 5:编写接口
创建一个 UserMapper 接口,定义方法名与映射文件中的 SQL 语句一致。
package com.example.mapper;
public interface UserMapper {
User selectById(Integer id);
}
步骤 6:使用 MyBatis
在项目的 src/main/java 目录下创建一个 MyBatisDemo 类,使用 MyBatis 执行 SQL 语句。
package com.example;
import com.example.entity.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisDemo {
public static void main(String[] args) {
try (SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build()) {
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1);
System.out.println(user.getName());
}
}
}
}
步骤 7:运行程序
运行 MyBatisDemo 类,程序将输出用户名称。
总结
通过以上步骤,你已经成功入门 MyBatis。在实际项目中,你可以根据需求自定义 SQL 语句和映射规则,实现复杂的业务逻辑。MyBatis 为你提供了强大的功能和灵活性,让你能够轻松地实现数据持久化操作。
