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,则将它们作为查询条件。










