正文

Java开源框架MyBatis入门到精通：高效SQL操作与实战案例

/0 浏览量
0724

MyBatis 是一个优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

MyBatis 简介

MyBatis 本身只负责数据持久层的操作，它并不涉及业务逻辑层。它允许我们以编程的方式直接操作 SQL，而不是使用 SQL 映射文件。这使得代码更加简洁，同时也便于维护。

MyBatis 的核心组件

  1. SqlSessionFactoryBuilder: 用于构建 SqlSessionFactory。
  2. SqlSessionFactory: 用于创建 SqlSession。
  3. SqlSession: 用于执行 SQL 语句，获取映射器（Mapper）。
  4. Executor: 执行器，负责执行 SQL 语句。
  5. Mapper: MyBatis 的核心，它将接口和 Java 的 POJOs 映射成数据库中的记录。

MyBatis 入门

环境搭建

  1. 添加依赖

在 Maven 的 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>
  1. 配置 MyBatis

在 src/main/resources 目录下创建 mybatis-config.xml 文件，配置数据源、事务管理器等。

   <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>
  1. 编写 Mapper 接口和 XML 映射文件

在 com/example/mapper 目录下创建 UserMapper.java 接口和 UserMapper.xml 映射文件。

   public interface UserMapper {
       User getUserById(int id);
   }

   <mapper namespace="com.example.mapper.UserMapper">
       <select id="getUserById" resultType="com.example.entity.User">
           SELECT * FROM user WHERE id = #{id}
       </select>
   </mapper>
  1. 运行程序

在主程序中，创建 SqlSessionFactory，然后获取 SqlSession，最后通过 SqlSession 获取 Mapper 的实例。

   public static void main(String[] args) throws IOException {
       SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("src/main/resources/mybatis-config.xml"));
       try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
           UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
           User user = userMapper.getUserById(1);
           System.out.println(user);
       }
   }

MyBatis 高级应用

动态 SQL

MyBatis 提供了动态 SQL 的功能，可以方便地实现复杂的 SQL 语句。

  1. <if> 标签
   <select id="getUserById" resultType="com.example.entity.User">
       SELECT * FROM user
       <where>
           <if test="id != null">
               AND id = #{id}
           </if>
           <if test="name != null">
               AND name = #{name}
           </if>
       </where>
   </select>
  1. <foreach> 标签
   <update id="updateUserRoles" parameterType="map">
       UPDATE user
       SET roles = #{roles}
       WHERE id IN
       <foreach item="id" collection="ids" open="(" separator="," close=")">
           #{id}
       </foreach>
   </update>

缓存

MyBatis 提供了两种缓存机制：一级缓存和二级缓存。

  1. 一级缓存

一级缓存是会话级别的缓存，默认开启。当会话结束时，一级缓存会自动失效。

  1. 二级缓存

二级缓存是全局缓存，需要手动开启。它可以跨会话，并且可以持久化。

扩展

MyBatis 还支持扩展，例如插件、自定义类型处理器等。

实战案例

以下是一个使用 MyBatis 实现用户管理的简单案例。

  1. 实体类
   public class User {
       private int id;
       private String name;
       private String email;
       // ... getter 和 setter
   }
  1. Mapper 接口
   public interface UserMapper {
       User getUserById(int id);
       int addUser(User user);
       int updateUser(User user);
       int deleteUser(int id);
   }
  1. Mapper XML
   <mapper namespace="com.example.mapper.UserMapper">
       <!-- ... -->
   </mapper>
  1. Service 层
   public class UserService {
       private UserMapper userMapper;

       public UserService(UserMapper userMapper) {
           this.userMapper = userMapper;
       }

       public User getUserById(int id) {
           return userMapper.getUserById(id);
       }

       public int addUser(User user) {
           return userMapper.addUser(user);
       }

       public int updateUser(User user) {
           return userMapper.updateUser(user);
       }

       public int deleteUser(int id) {
           return userMapper.deleteUser(id);
       }
   }
  1. Controller 层
   @RestController
   public class UserController {
       private UserService userService;

       public UserController(UserService userService) {
           this.userService = userService;
       }

       @GetMapping("/user/{id}")
       public User getUserById(@PathVariable int id) {
           return userService.getUserById(id);
       }

       @PostMapping("/user")
       public int addUser(@RequestBody User user) {
           return userService.addUser(user);
       }

       @PutMapping("/user")
       public int updateUser(@RequestBody User user) {
           return userService.updateUser(user);
       }

       @DeleteMapping("/user/{id}")
       public int deleteUser(@PathVariable int id) {
           return userService.deleteUser(id);
       }
   }

通过以上步骤，我们可以实现一个简单的用户管理系统。

总结

MyBatis 是一个功能强大的持久层框架，它可以帮助我们高效地操作数据库。通过本文的介绍，相信你已经对 MyBatis 有了一定的了解。在实际项目中，你可以根据自己的需求，灵活运用 MyBatis 的各种功能，提高开发效率。

-- 展开阅读全文 --