你真的会写mybatis.xml吗？养成好习惯写养眼好用的xml

我们使用mybatis无非就是进行一些增删改查的操作，但是简单的增删改查想要写好却大有门道。

增

对于实体的新增墙裂建议写一个通用的新增语句，这样在新增的时候就不需要每一次都去写一个新的语句了：

<insert id="insertSelective" parameterType="com.xyh.entity.QuartzJob">
 insert into xyh_quartz_job
 <trim prefix="(" suffix=")" suffixOverrides=",">
 <if test="id != null">
 id,
 </if>
 <if test="jobKey != null">
 job_key,
 </if>
 <if test="jobGroup != null">
 job_group,
 </if>
 <if test="jobStatus != null">
 job_status,
 </if>
 <if test="jobCronExpress != null">
 job_cron_express,
 </if>
 <if test="isDeleted != null">
 is_deleted,
 </if>
 </trim>
 <trim prefix="values (" suffix=")" suffixOverrides=",">
 <if test="id != null">
 #{id,jdbcType=BIGINT},
 </if>
 <if test="jobKey != null">
 #{jobKey,jdbcType=VARCHAR},
 </if>
 <if test="jobGroup != null">
 #{jobGroup,jdbcType=VARCHAR},
 </if>
 <if test="jobStatus != null">
 #{jobStatus,jdbcType=INTEGER},
 </if>
 <if test="jobCronExpress != null">
 #{jobCronExpress,jdbcType=VARCHAR},
 </if>
 <if test="isDeleted != null">
 #{isDeleted,jdbcType=INTEGER},
 </if>
 </trim>
 </insert>

参数解析：

id：唯一标识

parameterType：传入的参数实体

trim：

rim标签有四个属性：prefix，prefixOverrides，suffix，suffixOverrides。

prefix，suffix 表示在trim标签包裹的部分的前面或者后面添加内容（注意：是没有prefixOverrides，suffixOverrides的情况下） 。

如果有prefixOverrides，suffixOverrides 表示覆盖Overrides中的内容。

如果只有prefixOverrides，suffixOverrides 表示删除。

以上示例中suffixOverrides表示删除最后的','。

删

关于删除，一般我们会用到使用主键删除，或者传入参数删除这两种情况。

因此可以新增两条通用的语句：

 <delete id="deleteByPrimaryKey" parameterType="java.lang.Long">
 delete from xyh_quartz_job
 where id = #{id,jdbcType=BIGINT}
 </delete>
 <delete id="deleteByExample" parameterType="com.xyh.entity.QuartzJobCriteria">
 delete from xyh_quartz_job
 <if test="_parameter != null">
 <include refid="Example_Where_Clause" />
 </if>
 </delete>

这里又出现了一个include标签，他的意思是通过id引用其他的语句，以下是通用更新的语句：

<sql id="Update_By_Example_Where_Clause">
 <where>
 <foreach collection="example.oredCriteria" item="criteria" separator="or">
 <if test="criteria.valid">
 <trim prefix="(" prefixOverrides="and" suffix=")">
 <foreach collection="criteria.criteria" item="criterion">
 <choose>
 <when test="criterion.noValue">
 and ${criterion.condition}
 </when>
 <when test="criterion.singleValue">
 and ${criterion.condition} #{criterion.value}
 </when>
 <when test="criterion.betweenValue">
 and ${criterion.condition} #{criterion.value} and #{criterion.secondValue}
 </when>
 <when test="criterion.listValue">
 and ${criterion.condition}
 <foreach close=")" collection="criterion.value" item="listItem" open="(" separator=",">
 #{listItem}
 </foreach>
 </when>
 </choose>
 </foreach>
 </trim>
 </if>
 </foreach>
 </where>
 </sql>

参数解析

where：表示where条件

foreach：循环对象

foreach一共有三种参数类型，分别为List,Array,Map三种。

item：环体中的具体对象。

collection：要做foreach的对象，作为入参时，List<?>对象默认用list代替作为键，数组对象有array代替作为键，Map对象没有默认的键。

if：条件判断

如果条件为真才会渲染if里的语句

choose...when：条件判断

当有多个条件时使用choose...when。

查

在工作中运用最多的就是查询了，怎么把查询写的漂亮也是有讲究的，首先我们一般都要定义一个Base_Column_List：

<sql id="Base_Column_List">
 id, job_key, job_group, job_status, job_cron_express, remarks, job_desc, job_params, gmt_create, gmt_modified, is_deleted
 </sql>

包含了我们一般情况下都需要查询的字段，避免以后每次查询都要重复写这些字段。

除了字段，还有查询条件。查询条件千变万化，我们也可以先把能统一的部分通用出来：

<sql id="Example_Where_Clause">
 <where>
 <foreach collection="oredCriteria" item="criteria" separator="or">
 <if test="criteria.valid">
 <trim prefix="(" prefixOverrides="and" suffix=")">
 <foreach collection="criteria.criteria" item="criterion">
 <choose>
 <when test="criterion.noValue">
 and ${criterion.condition}
 </when>
 <when test="criterion.singleValue">
 and ${criterion.condition} #{criterion.value}
 </when>
 <when test="criterion.betweenValue">
 and ${criterion.condition} #{criterion.value} and #{criterion.secondValue}
 </when>
 <when test="criterion.listValue">
 and ${criterion.condition}
 <foreach close=")" collection="criterion.value" item="listItem" open="(" separator=",">
 #{listItem}
 </foreach>
 </when>
 </choose>
 </foreach>
 </trim>
 </if>
 </foreach>
 </where>
 </sql>

这里的prefixOverrides表示删掉第一个and。

然后首先根据主键查询：

 <select id="selectByPrimaryKey" parameterType="java.lang.Long" resultMap="BaseResultMap">
 select 
 <include refid="Base_Column_List" />
 from xyh_quartz_job
 where id = #{id,jdbcType=BIGINT}
 </select>

看起来十分的简介。

根据外部条件查询：

 <select id="selectByExample" parameterType="com.xyh.entity.QuartzJobCriteria" resultMap="BaseResultMap">
 select
 <if test="distinct">
 distinct
 </if>
 <include refid="Base_Column_List" />
 from xyh_quartz_job
 <if test="_parameter != null">
 <include refid="Example_Where_Clause" />
 </if>
 <if test="orderByClause != null">
 order by ${orderByClause}
 </if>
 </select>

根据外部条件查询数量：

<select id="countByExample" parameterType="com.xyh.entity.QuartzJobCriteria" resultType="java.lang.Long">
 select count(*) from xyh_quartz_job
 <if test="_parameter != null">
 <include refid="Example_Where_Clause" />
 </if>
 </select>

当然mybatis的通用mapper就是在帮我们做这些事，不过其实通用mapper底层的方式也是这样。我们在平时写mybatis.xml的时候要养成这种书写习惯，熟练运用各种标签，能提取出来的就提取出来，使我们的主干语句看起来通俗易懂，别人看我们写的代码也不至于那么头疼了。