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