【Java教程】Day22-19 Spring框架：访问数据库——集成MyBatis

在现代应用程序中，数据库访问是不可或缺的一部分，ORM框架（对象关系映射）通过简化数据库操作，帮助开发者将数据库的表和Java对象进行映射，提升开发效率。Hibernate 和 JPA 是两种常见的全自动化 ORM 框架，而 MyBatis 是一种半自动化 ORM 框架，提供了更大的灵活性和控制权。

本教程将介绍如何在Spring框架中集成MyBatis，并详细解释ORM框架背后的工作原理及其实现方式。

---

1. ORM框架简介

ORM（Object-Relational Mapping）是一种让开发者无需直接编写SQL的技术，ORM框架自动把数据库表中的每一行数据映射成Java对象的属性。例如，Hibernate和JPA就是常见的ORM框架，它们通过注解或者XML文件将数据库表与Java类进行映射，从而实现数据库操作。

ORM框架的关键点之一是代理模式，通过代理类来跟踪对象属性的变化，从而实现对数据的更新操作。例如，以下代理类通过设置标记来记录属性的变化：

javapublic class UserProxy extends User {    boolean _isNameChanged;​    public void setName(String name) {        super.setName(name);        _isNameChanged = true;    }}

 

在处理复杂关系时（如一对多或多对一关系），ORM框架通过代理类来延迟加载相关数据。比如，以下是一个延迟加载的示例：

javapublic class UserProxy extends User {    Session _session;    boolean _isNameChanged;​    public void setName(String name) {        super.setName(name);        _isNameChanged = true;    }​    public Address getAddress() {        Query q = _session.createQuery("from Address where userId = :userId");        q.setParameter("userId", this.getId());        List<Address> list = q.list();        return list.isEmpty() ? null : list.get(0);    }}

 

此时，UserProxy 代理类会延迟加载 Address 对象，但在事务提交后，Session 会关闭，导致无法再访问数据库。因此，ORM框架使用了附加状态（Attached/Detached）来标记一个对象是否仍在事务的范围内。

---

2. MyBatis：半自动化的ORM框架

与Hibernate和JPA的全自动化不同，MyBatis是一个半自动化的ORM框架。在MyBatis中，开发者需要手动编写SQL语句，MyBatis负责将数据库的ResultSet自动映射成Java对象。虽然MyBatis没有像Hibernate那样的完全自动化，但它提供了灵活的SQL控制和更高效的性能。

2.1 Spring中集成MyBatis

要在Spring中使用MyBatis，我们首先需要引入MyBatis和MyBatis-Spring的相关依赖：

xml<dependency>    <groupId>org.mybatis</groupId>    <artifactId>mybatis</artifactId>    <version>3.5.11</version></dependency><dependency>    <groupId>org.mybatis</groupId>    <artifactId>mybatis-spring</artifactId>    <version>3.0.0</version></dependency>

 

然后，我们需要配置DataSource、SqlSessionFactory和事务管理器。

java@Configuration@ComponentScan@EnableTransactionManagement@PropertySource("jdbc.properties")public class AppConfig {    @Bean    DataSource createDataSource() {        // 数据源配置        return new DriverManagerDataSource(...);    }        @Bean    SqlSessionFactoryBean createSqlSessionFactoryBean(@Autowired DataSource dataSource) {        SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();        sqlSessionFactoryBean.setDataSource(dataSource);        return sqlSessionFactoryBean;    }        @Bean    PlatformTransactionManager createTxManager(@Autowired DataSource dataSource) {        return new DataSourceTransactionManager(dataSource);    }}

 

2.2 MyBatis的Mapper接口

MyBatis的核心是Mapper接口，它用于定义数据库操作。与Hibernate不同，MyBatis要求Mapper是接口，并且必须为每个操作编写相应的SQL语句。

例如，定义一个UserMapper接口，用于查询用户：

javapublic interface UserMapper {    @Select("SELECT * FROM users WHERE id = #{id}")    User getById(@Param("id") long id);}

 

此时，getById方法会根据传入的id参数查询users表，并将查询结果自动映射成User对象。如果查询参数有多个，可以在SQL中通过@Param注解指定：

java@Select("SELECT * FROM users LIMIT #{offset}, #{maxResults}")List<User> getAll(@Param("offset") int offset, @Param("maxResults") int maxResults);

 

2.3 MyBatis的增删改操作

MyBatis的增、删、改操作也需要手动编写SQL语句。以下是插入、更新和删除操作的示例：

java@Insert("INSERT INTO users (email, password, name, createdAt) VALUES (#{user.email}, #{user.password}, #{user.name}, #{user.createdAt})")void insert(@Param("user") User user);​@Update("UPDATE users SET name = #{user.name}, createdAt = #{user.createdAt} WHERE id = #{user.id}")void update(@Param("user") User user);​@Delete("DELETE FROM users WHERE id = #{id}")void deleteById(@Param("id") long id);

 

对于插入操作，如果需要返回自动生成的主键，可以使用@Options注解来获取自增主键：

java@Options(useGeneratedKeys = true, keyProperty = "id", keyColumn = "id")@Insert("INSERT INTO users (email, password, name, createdAt) VALUES (#{user.email}, #{user.password}, #{user.name}, #{user.createdAt})")void insert(@Param("user") User user);

 

2.4 使用MyBatis的Mapper扫描

为了自动生成Mapper的实现类，我们可以使用@MapperScan注解来扫描指定包下的所有Mapper接口，并自动为它们创建实现类：

java@MapperScan("com.example.mapper")public class AppConfig {    // 配置}

 

在业务逻辑中，我们可以直接注入Mapper接口并调用方法进行数据库操作：

java@Component@Transactionalpublic class UserService {    @Autowired    UserMapper userMapper;​    public User getUserById(long id) {        User user = userMapper.getById(id);        if (user == null) {            throw new RuntimeException("User not found by id.");        }        return user;    }}

 

 

---

3. XML配置方式

虽然我们推荐使用注解来配置MyBatis，但MyBatis也允许通过XML文件进行映射配置。以下是一个动态SQL的示例，它用于根据用户的属性值构建UPDATE语句：

xml<update id="updateUser">  UPDATE users SET  <set>    <if test="user.name != null"> name = #{user.name} </if>    <if test="user.hobby != null"> hobby = #{user.hobby} </if>    <if test="user.summary != null"> summary = #{user.summary} </if>  </set>  WHERE id = #{user.id}</update>

 

XML配置的优势在于能够动态构建SQL，尤其适合复杂的查询和更新操作。缺点是配置和管理较为繁琐，需要开发者额外维护XML文件。

 

---

4. 小结

MyBatis是一款半自动化的ORM框架，开发者需要编写SQL语句，但它提供了灵活的SQL控制，使得我们可以针对特定的数据库进行优化。通过在Spring中集成MyBatis，我们能够方便地管理数据库连接、事务和数据映射，从而提升开发效率。

与全自动化ORM框架相比，MyBatis的最大优势在于SQL的完全控制，开发者可以根据业务需求编写优化的SQL语句。然而，这也意味着在某些场景下需要更多的手动配置。

对于需要灵活SQL控制的应用程序，MyBatis是一个非常适合的选择。

 

---

 

练习： 在Spring框架中集成MyBatis并进行基本的增删改查操作。