引言
MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 遵循约定优于配置的原则,使得开发者可以更加专注于业务逻辑的实现。它通过 XML 或注解的方式定义 SQL 映射,将 SQL 与 Java 代码分离,降低了代码的耦合度。
入门准备
环境搭建
- Java 环境:确保你的开发环境中安装了 Java 并配置了环境变量。
- IDE:推荐使用 IntelliJ IDEA 或 Eclipse 等集成开发环境。
- Maven:使用 Maven 来管理项目依赖。
创建项目
- 创建 Maven 项目:在 IDE 中创建一个新的 Maven 项目。
- 添加依赖:在
pom.xml文件中添加 MyBatis 和数据库驱动的依赖。
<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>
MyBatis 核心概念
SQL 映射文件
SQL 映射文件是 MyBatis 的核心,它包含了 SQL 语句和 MyBatis 的配置信息。
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectById" resultType="com.example.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
接口和 Mapper
Mapper 接口定义了 MyBatis 的操作,MyBatis 会根据接口的名称和方法的名称来查找对应的 SQL 映射语句。
public interface UserMapper {
User selectById(Integer id);
}
配置文件
MyBatis 的配置文件包含了数据库连接信息、事务管理器、映射文件等。
<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=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
实践操作
创建数据库和表
首先,你需要创建一个数据库和一个用户表。
CREATE DATABASE mydb;
USE mydb;
CREATE TABLE users (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(50),
age INT
);
编写 SQL 映射文件
在 UserMapper.xml 文件中编写 SQL 语句。
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectById" resultType="com.example.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
编写 Mapper 接口
在 UserMapper.java 文件中定义接口。
public interface UserMapper {
User selectById(Integer id);
}
测试
在主程序中,使用 MyBatis 的 SqlSessionFactoryBuilder 来创建 SqlSessionFactory,然后通过 SqlSession 执行查询。
public class Main {
public static void main(String[] args) throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1);
System.out.println(user);
}
}
}
总结
通过本指南,你应该已经对 MyBatis 有了一个基本的了解。MyBatis 提供了一种简单而强大的方式来处理数据库操作,它通过将 SQL 与 Java 代码分离,降低了代码的复杂度。希望这篇文章能帮助你快速入门 MyBatis,并在实践中不断进步。
