MyBatis执行SQL用法介绍|极客笔记

MyBatis执行SQL用法介绍

1. 引言

MyBatis 是一个开源的持久化框架，它提供了灵活且强大的 SQL 执行能力。本文将详细介绍 MyBatis 的 SQL 执行用法，包括基本的查询操作、参数处理、动态 SQL、批处理等。

2. 基本查询操作

在 MyBatis 中，我们可以通过一系列的 SQL 映射文件来定义和执行 SQL 语句。下面是一个简单的 SQL 映射文件示例：

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <select id="getUserById" resultType="com.example.model.User">
        SELECT * FROM user WHERE id=#{id}
    </select>
</mapper>

首先，我们需要定义一个映射文件，设置 namespace 属性指定映射文件对应的 Java 接口或类。

其中，<select> 标签用于定义查询语句。id 属性指定方法的名称，resultType 属性指定查询结果的数据类型。在 SQL 语句中，可以使用 #{id} 来引用方法参数。

接下来，我们可以使用 MyBatis 提供的 API 来执行此查询语句：

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import com.example.model.User;

public class Main {
    public static void main(String[] args) throws Exception {
        // 加载 MyBatis 配置文件
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        // 创建 SqlSession
        try (SqlSession session = sqlSessionFactory.openSession()) {
            // 通过映射文件中定义的方法执行 SQL 查询
            User user = session.selectOne("com.example.mapper.UserMapper.getUserById", 1);
            System.out.println(user);
        }
    }
}

在上述示例中，我们首先加载 MyBatis 的配置文件，然后通过 SqlSessionFactoryBuilder 构建一个 SqlSessionFactory 实例。接下来，通过 SqlSessionFactory 打开一个 SqlSession 实例，并使用 selectOne 方法执行查询操作。

3. 参数处理

在实际应用中，我们经常需要将参数传递给 SQL 查询语句。MyBatis 提供了多种方式来处理参数。

3.1 位置参数

位置参数通过占位符 ? 来表示。在 SQL 映射文件中，可以使用 #{param1}、#{param2} 等来引用位置参数。

示例代码如下：

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <select id="getUserByNameAndAge" resultType="com.example.model.User">
        SELECT * FROM user WHERE name=#{param1} AND age=#{param2}
    </select>
</mapper>

import org.apache.ibatis.annotations.Param;
import com.example.model.User;

public interface UserMapper {
    User getUserByNameAndAge(@Param("name") String name, @Param("age") int age);
}

上述示例中，getUserByNameAndAge 方法使用了 @Param 注解来指定方法参数的名称，从而在 SQL 映射文件中引用。

3.2 命名参数

命名参数通过 #{paramName} 形式来表示。在 SQL 映射文件中，可以直接使用 #{paramName} 来引用命名参数。

示例代码如下：

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <select id="getUserByNameAndAge" resultType="com.example.model.User">
        SELECT * FROM user WHERE name=#{name} AND age=#{age}
    </select>
</mapper>

import com.example.model.User;

public interface UserMapper {
    User getUserByNameAndAge(@Param("name") String name, @Param("age") int age);
}

相比位置参数，命名参数更为直观和灵活。在 SQL 映射文件中，我们可以根据具体的需求来引用命名参数。

4. 动态 SQL

动态 SQL 是 MyBatis 中一个非常强大的特性，它可以根据条件来动态生成 SQL 语句。MyBatis 提供了一系列的动态标签，如 <if>、<choose>、<when>、<otherwise> 等。

下面是一个简单的动态 SQL 示例：

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <select id="queryUsers" resultType="com.example.model.User">
        SELECT * FROM user
        <where>
            <if test="name != null">
                AND name=#{name}
            </if>
            <if test="age != null and age > 0">
                AND age=#{age}
            </if>
        </where>
    </select>
</mapper>

在上述示例中，使用了 <where> 标签来包装动态 SQL 语句。<if> 标签用于根据条件判断是否包含相应的 SQL 语句片段。

同时，我们在方法中可以设置相应的参数，以实现动态 SQL 的效果：

import org.apache.ibatis.annotations.Param;
import com.example.model.User;

public interface UserMapper {
    List<User> queryUsers(@Param("name") String name, @Param("age") Integer age);
}

上述示例中，queryUsers 方法接收两个参数 name 和 age，并根据条件动态生成 SQL 查询语句。

5. 批处理

MyBatis 还支持批处理操作，可以在一次数据库连接中执行多个 SQL 语句，提高系统性能。

以下是一个简单的批处理示例：

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
    <insert id="batchInsertUsers">
        INSERT INTO user (name, age) VALUES
        <foreach collection="list" item="item" separator=",">
            (#{item.name}, #{item.age})
        </foreach>
    </insert>
</mapper>

import com.example.model.User;

public interface UserMapper {
    void batchInsertUsers(List<User> users);
}

在上述示例中，通过 <foreach> 标签来进行循环插入操作。collection 属性指定循环的集合，item 属性指定集合中的每个元素，separator 属性指定分隔符。

最后，我们可以调用 batchInsertUsers 方法来执行批处理操作：

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import com.example.model.User;

public class Main {
    public static void main(String[] args) throws Exception {
        // ...
        List<User> users = new ArrayList<>();
        users.add(new User("Alice", 20));
        users.add(new User("Bob", 25));

        try (SqlSession session = sqlSessionFactory.openSession()) {
            session.insert("com.example.mapper.UserMapper.batchInsertUsers", users);
            session.commit();
        }
        // ...
    }
}

在上述示例中，我们首先创建一个 User 对象的集合，并添加若干个元素。然后，通过 SqlSession 的 insert 方法来执行批处理操作。