MyBatis核心

1. MyBatis 简介

MyBatis 是一个开源的 Java 持久层框架，用于简化数据库操作。它不是全自动的 ORM（对象关系映射），而是半自动框架，允许开发者直接编写 SQL，提供灵活的映射机制。主要特点：

• SQL 与代码分离：SQL 语句写在 XML 或注解中，避免硬编码。
• 动态 SQL：支持条件判断、循环等动态生成 SQL。
• 轻量级：无侵入性，易于集成到 Spring 等框架。
• 高性能：通过缓存和批处理优化性能。

核心组件：

• SqlSessionFactory：创建 SqlSession 的工厂，基于配置文件构建。
• SqlSession：执行 SQL 操作的核心接口。
• Mapper：定义数据库操作的接口（XML 或注解实现）。

---

2. 增删改查（CRUD）实现

以下基于 MyBatis 的 XML 映射方式实现 CRUD。假设有一个 User 实体类：

public class User {private Long id;private String name;private String email;// 省略 getter/setter
}

1. 创建（Insert）

• Mapper 接口：

  public interface UserMapper {void insertUser(User user);
  }
  

• XML 映射文件（UserMapper.xml）：

  <insert id="insertUser" parameterType="User">INSERT INTO users (name, email) VALUES (#{name}, #{email})
  </insert>
  

• 使用示例：

  SqlSession session = sqlSessionFactory.openSession();
  UserMapper mapper = session.getMapper(UserMapper.class);
  User user = new User(null, "Alice", "[e-mail]");
  mapper.insertUser(user);
  session.commit(); // 提交事务
  session.close();
  

2. 读取（Select）

• Mapper 接口：

  public interface UserMapper {User selectUserById(Long id);List<User> selectAllUsers();
  }
  

• XML 映射文件：

  <select id="selectUserById" resultType="User">SELECT * FROM users WHERE id = #{id}
  </select>
  <select id="selectAllUsers" resultType="User">SELECT * FROM users
  </select>
  

• 使用示例：

  User user = mapper.selectUserById(1L);
  List<User> users = mapper.selectAllUsers();
  

3. 更新（Update）

• Mapper 接口：

  public interface UserMapper {void updateUser(User user);
  }
  

• XML 映射文件：

  <update id="updateUser" parameterType="User">UPDATE users SET name = #{name}, email = #{email}WHERE id = #{id}
  </update>
  

• 使用示例：

  User user = mapper.selectUserById(1L);
  user.setName("Bob");
  mapper.updateUser(user);
  session.commit();
  

4. 删除（Delete）

• Mapper 接口：

  public interface UserMapper {void deleteUser(Long id);
  }
  

• XML 映射文件：

  <delete id="deleteUser" parameterType="Long">DELETE FROM users WHERE id = #{id}
  </delete>
  

• 使用示例：

  mapper.deleteUser(1L);
  session.commit();
  

---

3. 日志配置

MyBatis 使用 SLF4J 作为日志门面，支持 Log4j、Logback 等实现。配置日志可监控 SQL 执行细节，便于调试。

步骤：

1. 添加日志依赖（以 Log4j2 为例，在 Maven 的 pom.xml 中）：

   <dependency><groupId>org.apache.logging.log4j</groupId><artifactId>log4j-core</artifactId><version>2.17.1</version>
   </dependency>
   <dependency><groupId>org.apache.logging.log4j</groupId><artifactId>log4j-slf4j-impl</artifactId><version>2.17.1</version>
   </dependency>
   

2. 创建 Log4j2 配置文件（log4j2.xml）：

   <?xml version="1.0" encoding="UTF-8"?>
   <Configuration><Appenders><Console name="Console" target="SYSTEM_OUT"><PatternLayout pattern="%d{HH:mm:ss} [%t] %-5level %logger{36} - %msg%n"/></Console></Appenders><Loggers><!-- 设置 MyBatis 的日志级别为 DEBUG --><Logger name="org.mybatis" level="DEBUG" additivity="false"><AppenderRef ref="Console"/></Logger><Root level="ERROR"><AppenderRef ref="Console"/></Root></Loggers>
   </Configuration>
   

3. 在 MyBatis 配置文件中启用日志（mybatis-config.xml）：

   <configuration><settings><!-- 设置日志实现为 SLF4J --><setting name="logImpl" value="SLF4J"/></settings>
   </configuration>
   

日志输出示例：
执行 SQL 时，控制台会打印：

14:30:22 [main] DEBUG org.mybatis.example.UserMapper.selectUserById - ==>  Preparing: SELECT * FROM users WHERE id = ? 
14:30:22 [main] DEBUG org.mybatis.example.UserMapper.selectUserById - ==> Parameters: 1(Long)
14:30:22 [main] DEBUG org.mybatis.example.UserMapper.selectUserById - <==      Total: 1

---