MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java 对象)映射成数据库中的记录。
MyBatis 简介
MyBatis 的核心是一套持久层映射语言(XML),它定义了如何将 SQL 语句映射到 Java 代码中。通过这种方式,开发者可以避免编写繁琐的 JDBC 代码,提高开发效率。
MyBatis 的特点
- 轻量级:MyBatis 是一个轻量级的框架,没有使用代理模式,也没有使用反射,因此运行时消耗的资源相对较少。
- 灵活:MyBatis 提供了灵活的配置方式,可以通过 XML 或注解来配置 SQL 语句。
- 易用:MyBatis 的 API 简单易用,易于学习和掌握。
- 支持定制化:MyBatis 支持定制化 SQL、存储过程以及高级映射。
MyBatis 入门
1. 添加依赖
首先,需要在项目中添加 MyBatis 的依赖。以下是一个 Maven 项目的示例:
<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.22</version>
</dependency>
</dependencies>
2. 配置文件
接下来,需要创建一个配置文件 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/mydatabase"/>
<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 接口
创建一个 Mapper 接口,用于定义数据库操作方法。
package com.example.mapper;
public interface UserMapper {
User selectById(Integer id);
}
4. 创建 Mapper XML 文件
创建一个 Mapper 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.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
5. 测试
在 Java 代码中,创建一个 SqlSessionFactory 和 SqlSession,然后调用 Mapper 接口的方法。
package com.example;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class Main {
public static void main(String[] args) {
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
Resources.getResourceAsStream("mybatis-config.xml"));
try (SqlSession session = sqlSessionFactory.openSession()) {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectById(1);
System.out.println(user);
}
}
}
MyBatis 高效应用
1. 使用注解替代 XML
MyBatis 支持使用注解来替代 XML 配置。以下是一个使用注解的示例:
package com.example.mapper;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Param;
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User selectById(@Param("id") Integer id);
}
2. 动态 SQL
MyBatis 提供了动态 SQL 功能,可以方便地构建复杂的 SQL 语句。
<select id="selectUsers" resultType="User">
SELECT * FROM user
<where>
<if test="name != null">
AND name = #{name}
</if>
<if test="age != null">
AND age = #{age}
</if>
</where>
</select>
3. 批量操作
MyBatis 支持批量操作,可以提高数据库操作的效率。
try (SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH)) {
UserMapper mapper = session.getMapper(UserMapper.class);
for (User user : users) {
mapper.insert(user);
}
session.commit();
}
实战案例解析
以下是一个使用 MyBatis 实现用户管理的实战案例。
1. 创建 User 实体类
package com.example.entity;
public class User {
private Integer id;
private String name;
private Integer age;
// 省略 getter 和 setter 方法
}
2. 创建 UserMapper 接口
package com.example.mapper;
public interface UserMapper {
void insert(User user);
User selectById(Integer id);
List<User> selectAll();
void update(User user);
void delete(Integer id);
}
3. 创建 UserMapper XML 文件
<!-- 省略 XML 配置内容 -->
4. 创建 User 服务类
package com.example.service;
import com.example.entity.User;
import com.example.mapper.UserMapper;
public class UserService {
private final UserMapper userMapper;
public UserService(UserMapper userMapper) {
this.userMapper = userMapper;
}
public void addUser(User user) {
userMapper.insert(user);
}
public User getUserById(Integer id) {
return userMapper.selectById(id);
}
public List<User> getAllUsers() {
return userMapper.selectAll();
}
public void updateUser(User user) {
userMapper.update(user);
}
public void deleteUser(Integer id) {
userMapper.delete(id);
}
}
5. 使用 UserService
package com.example;
import com.example.entity.User;
import com.example.service.UserService;
public class Main {
public static void main(String[] args) {
UserService userService = new UserService(userMapper);
User user = new User();
user.setName("张三");
user.setAge(20);
userService.addUser(user);
System.out.println(userService.getUserById(1));
userService.deleteUser(1);
}
}
通过以上步骤,就可以使用 MyBatis 实现用户管理的功能。
总结
MyBatis 是一款优秀的持久层框架,它可以帮助开发者快速开发高效、灵活的数据库应用程序。通过本文的介绍,相信你已经对 MyBatis 有了一定的了解。在实际项目中,你可以根据自己的需求选择合适的配置方式和操作方式,提高开发效率。
