MyBatis 中如何执行 SQL 语句

MyBatis 是一个基于 Java 的持久层框架，它提供了多种方式来执行 SQL 语句，包括直接使用 SqlSession 执行、使用映射器（Mapper）执行、使用 SqlSessionTemplate 执行等。本文将介绍 MyBatis 中常见的 SQL 执行方式及其使用方法。

1. 直接使用 SqlSession 执行 SQL 语句

在 MyBatis 中，可以通过 SqlSession 对象直接执行 SQL 语句。SqlSession 是 MyBatis 的核心类之一，它负责与数据库进行交互和管理事务。SqlSession 提供了多个方法来执行 SQL 语句，比如 selectOne、selectList、insert、update 和 delete 等。下面是一个简单的示例：

public class MyBatisTest {
    public static void main(String[] args) {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        try {
            // 执行查询语句
            User user = sqlSession.selectOne("com.example.mapper.UserMapper.getUserById", 1);
            System.out.println(user);
            // 执行插入语句
            User newUser = new User();
            newUser.setName("Tom");
            newUser.setAge(20);
            int result = sqlSession.insert("com.example.mapper.UserMapper.addUser", newUser);
            System.out.println(result);
            sqlSession.commit();
        } finally {
            sqlSession.close();
        }
    }
}

在上面的示例代码中，首先读取了配置文件 mybatis-config.xml，然后通过 SqlSessionFactoryBuilder 将配置文件解析为 SqlSessionFactory 对象，最后通过 SqlSessionFactory 创建 SqlSession 对象。在 SqlSession 中，可以通过 selectOne、selectList、insert、update 和 delete 等方法执行 SQL 语句。其中，selectOne 方法用于查询单个结果，selectList 方法用于查询多个结果，insert、update 和 delete 方法用于执行更新或删除操作。这些方法的第一个参数为 SQL 语句的 ID，格式为 “namespace.statementId”，其中 namespace 为映射器的命名空间，statementId 为 SQL 语句的 ID。

2. 使用映射器（Mapper）执行 SQL 语句

除了直接使用 SqlSession 执行 SQL 语句外，还可以通过映射器（Mapper）执行 SQL 语句。映射器是 MyBatis 中用于定义 SQL 语句和 Java 对象之间映射关系的接口，它可以通过 XML 或注解的方式进行定义。下面是一个简单的映射器示例：

public interface UserMapper {
    // 查询用户信息
    User getUserById(int id);
    // 添加用户信息
    int addUser(User user);
}

在上面的示例代码中，定义了一个名为 UserMapper 的映射器接口，其中包含了两个方法：getUserById 和 addUser。这两个方法的实现方式与直接使用 SqlSession 执行 SQL 语句的方式类似，只不过将 SQL 语句和参数映射的工作放在了映射器接口中。下面是一个使用映射器执行 SQL 语句的示例：

public class MyBatisTest {
    public static void main(String[] args) {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        try {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 执行查询语句
            User user = userMapper.getUserById(1);
            System.out.println(user);
            // 执行插入语句
            User newUser = new User();
            newUser.setName("Tom");
            newUser.setAge(20);
            int result = userMapper.addUser(newUser);
            System.out.println(result);
            sqlSession.commit();
        } finally {
            sqlSession.close();
        }
    }
}

在上面的示例代码中，首先读取了配置文件 mybatis-config.xml，然后通过 SqlSessionFactoryBuilder 将配置文件解析为SqlSessionFactory 对象，最后通过 SqlSessionFactory 创建 SqlSession 对象。在 SqlSession 中，通过 getMapper 方法获取映射器接口的实例，然后就可以直接调用映射器接口中的方法执行 SQL 语句了。

3. 使用 SqlSessionTemplate 执行 SQL 语句

除了直接使用 SqlSession 和映射器执行 SQL 语句外，还可以使用 SqlSessionTemplate 执行 SQL 语句。SqlSessionTemplate 是 MyBatis-Spring 模块提供的一个类，它封装了 SqlSession 的常用操作，可以方便地在 Spring 框架中使用。下面是一个简单的示例：

public class UserServiceImpl implements UserService {
    private SqlSessionTemplate sqlSessionTemplate;
    public void setSqlSessionTemplate(SqlSessionTemplate sqlSessionTemplate) {
        this.sqlSessionTemplate = sqlSessionTemplate;
    }
    @Override
    public User getUserById(int id) {
        return sqlSessionTemplate.selectOne("com.example.mapper.UserMapper.getUserById", id);
    }
    @Override
    public int addUser(User user) {
        return sqlSessionTemplate.insert("com.example.mapper.UserMapper.addUser", user);
    }
}

在上面的示例代码中，通过注入 SqlSessionTemplate 对象来执行 SQL 语句。SqlSessionTemplate 提供了多个方法来执行 SQL 语句，包括 selectOne、selectList、insert、update 和 delete 等。这些方法的使用方式与直接使用 SqlSession 执行 SQL 语句的方式类似。

4. SQL 语句的参数映射

在执行 SQL 语句时，需要将 SQL 语句中的参数映射到 Java 对象中。MyBatis 提供了多种方式来实现参数映射，包括基本类型参数、JavaBean 参数、Map 参数和注解参数等。下面是一个简单的示例：

public interface UserMapper {
    // 查询用户信息
    User getUserById(int id);
    // 添加用户信息
    int addUser(User user);
    // 查询用户信息，使用 Map 参数
    User getUserByIdMap(Map paramMap);
    // 添加用户信息，使用注解参数
    @Insert("insert into user(name, age) values(#{user.name}, #{user.age})")
    int addUserAnnotation(@Param("user") User user);
}

在上面的示例代码中，getUserById 和 addUser 方法使用了 JavaBean 参数，getUserByIdMap 方法使用了 Map 参数，addUserAnnotation 方法使用了注解参数。在使用 JavaBean 参数和 Map 参数时，需要将 SQL 语句中的参数与 Java 对象的属性进行映射。在使用注解参数时，需要在 SQL 语句中使用 #{paramName} 的方式，其中 paramName 为注解参数的名称。

5. SQL 语句的返回结果映射

在执行 SQL 语句时，需要将 SQL 语句中的返回结果映射到 Java 对象中。MyBatis 提供了多种方式来实现返回结果映射，包括基本类型返回、JavaBean 返回、Map 返回和注解返回等。下面是一个简单的示例：

public interface UserMapper {
    // 查询用户信息，返回 JavaBean
    User getUserById(int id);
    // 查询用户信息，返回 Map
    Map getUserByIdMap(int id);
    // 查询用户信息，使用注解返回
    @Select("select name, age from user where id=#{id}")
    @Results({
            @Result(property = "name", column = "name"),
            @Result(property = "age", column = "age")
    })
    User getUserByIdAnnotation(int id);
}

在上面的示例代码中，getUserById 方法返回了一个 JavaBean，getUserByIdMap 方法返回了一个 Map，getUserByIdAnnotation 方法使用了注解返回。在使用注解返回时，需要在 SQL 语句中使用 @Results 和 @Result 注解将查询结果与 JavaBean 的属性进行映射。

6. 总结

MyBatis 提供了多种方式来执行 SQL 语句，包括直接使用 SqlSession 执行、使用映射器执行、使用 SqlSessionTemplate 执行等。在执行 SQL 语句时，需要将 SQL 语句中的参数和返回结果