MyBatis XML 映射文件

XML 映射文件的基本结构

MyBatis 的 XML 映射文件包含以下几个部分：

• mapper 元素：定义了 XML 映射文件的根元素，其中包含了命名空间和 SQL 语句等信息。
• select、insert、update、delete 元素：分别用于定义查询、插入、更新、删除操作的 SQL 语句。
• resultMap 元素：用于定义结果集的映射关系。
• parameterMap 元素：用于定义参数的映射关系。
• sql 元素：用于定义 SQL 片段，可以在其他 SQL 语句中引用。

以下是一个简单的 XML 映射文件示例：

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

在上述代码中，我们定义了一个 UserMapper 的 XML 映射文件，并在其中定义了一个名为 getUserById 的查询操作。该操作接收一个 int 类型的参数 id，返回一个 com.example.model.User 类型的结果集。

XML 映射文件的语法规则

在 XML 映射文件中，我们需要遵循以下语法规则：

• 所有 XML 元素必须有一个结束标签。
• 属性值必须使用引号括起来。
• XML 元素名称和属性名称都是大小写敏感的。
• XML 注释可以使用 <!-- --> 标记。

以下是一个 XML 映射文件的完整示例：

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
  <select id="getUserById" parameterType="int" resultType="com.example.model.User">
    SELECT * FROM user WHERE id = #{id}
  </select>
  
  <insert id="insertUser" parameterType="com.example.model.User">
    INSERT INTO user (username, password) VALUES (#{username}, #{password})
  </insert>
  
  <update id="updateUser" parameterType="com.example.model.User">
    UPDATE user SET password = #{password} WHERE id = #{id}
  </update>
  
  <delete id="deleteUser" parameterType="int">
    DELETE FROM user WHERE id = #{id}
  </delete>
  
  <resultMap id="userMap" type="com.example.model.User">
    <id property="id" column="id" />
    <result property="username" column="username" />
    <result property="password" column="password" />
  </resultMap>
</mapper>

在上述代码中，我们定义了一个 UserMapper 的 XML 映射文件，并在其中定义了查询、插入、更新、删除操作以及结果映射关系。

XML 映射文件的常见用法

在 XML 映射文件中，我们可以使用以下常见用法：

• 使用 parameterType 属性来指定参数类型。
• 使用 resultType 属性来指定结果类型。
• 使用 #{} 占位符来表示参数。
• 使用 <if>、<where>、<foreach> 等元素来动态生成 SQL 语句。
• 使用 <selectKey> 元素来获取自动生成的主键值。

以下是一个使用 <if> 元素的示例：

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
  <select id="getUserByUsernameAndPassword" parameterType="com.example.model.User" resultType="com.example.model.User">
    SELECT * FROM user WHERE 1 = 1
    <if test="username != null">
      AND username = #{username}
    </if>
    <if test="password != null">
      AND password = #{password}
    </if>
  </select>
</mapper>

在上述代码中，我们定义了一个名为 getUserByUsernameAndPassword 的查询操作，并使用 <if> 元素来动态生成 SQL 语句。如果 username 和 password 不为 null，则将它们作为查询条件。