今天完成的事情：

完成了所有接口文档，在这过程中发现原先表设计的不足，新加了一张留言回复reply表方便管理留言回复：

所有接口文档如下：

1 登录接口

请求地址：POST /a/login

请求参数：

返回参数：

2 Banner管理

2.1 新增banner

请求地址：POST /a/u/banner

请求参数：

返回参数：

2.2 删除banner

请求地址：DELETE /a/u/banner/{id}

返回参数：

2.3 修改banner

请求地址：PUT /a/u/banner/{id}

请求参数：

返回参数：

2.4 上架下架banner

请求地址：PUT /a/u/banner/state/{id}

请求参数：

返回参数：

2.5 查询单个banner

请求地址：GET /a/u/banner/{id}

返回参数：

data

2.6 按照条件查询banner

请求地址：GET /a/u/banner/list

请求参数：

返回参数：

data

3 留言管理

3.1 新建留言

请求地址：POST /a/u/message

请求参数：

返回参数：

3.2 删除留言

请求地址：DELETE  /a/u/message/{id}

返回参数：

3.3 编辑留言状态

请求地址：PUT /a/u/message/{id}

请求参数：

返回参数：

3.4 查询留言

请求地址：GET /a/u/message/list

请求参数：

返回参数：

data

3.5 查看留言详情

请求地址：GET /a/u/message/{id}

返回参数：

data

4 留言回复管理

4.1 回复留言

请求地址：POST /a/u/reply

请求参数：

返回参数：

4.2 删除回复

请求地址：DELETE /a/u/reply/{id}

返回参数：

4.3 修改回复

请求地址：PUT /a/u/reply/{id}

请求参数：

返回参数：

4.4 留言回复列表

请求地址：GET /a/u/reply/{message.id} （留言id）

返回参数：

data

5 作品集管理

5.1 新增作品集

请求地址：POST /a/u/portfolio

请求参数：

返回参数：

5.2 删除作品集

请求地址：DELETE /a/u/portfolio/{id}

返回参数：

5.3 更新作品集名称

请求地址：PUT /a/u/portfolio/{id}

请求参数：

返回参数：

5.4 更新作品集状态

请求地址：PUT /a/u/portfolio/state/{id}

请求参数：

返回参数：

5.5 查询单个作品集

请求地址：GET /a/u/portfolio/{id}

返回参数：

data

5.6 按条件查询作品集

请求地址：GET /a/u/portfolio/list

请求参数：

返回参数：

data

6 作品集分类列表管理

6.1 新增作品集分类

请求地址：POST /a/u/secondportfolio

请求参数：

返回参数：

6.2 删除作品集分类

请求地址：DELETE /a/u/secondportfolio/{id}

返回参数：

6.3 编辑作品集分类名称

请求地址：PUT /a/u/secondportfolio/{id}

请求参数：

返回参数：

6.4 编辑作品集分类状态

请求地址：PUT /a/u/secondportfolio/state/{id}

请求参数：

返回参数：

6.5 查询单个作品集

请求地址：GET /a/u/secondportfolio/{id}

返回参数：

data

6.6 按条件查询作品集分类

请求地址:GET /a/u/secondportfolio/list

请求参数：

返回参数：

data

7 作品管理

7.1 新增作品

请求地址：POST /a/u/works

请求参数：

返回参数：

7.2 删除作品

请求地址：DELETE /a/u/works/{id}

返回参数：

7.3 更新作品

请求地址：PUT /a/u/works/{id}

请求参数：

返回参数：

7.4 编辑作品上下架状态

请求地址：PUT /a/u/works/state/{id}

请求参数：

返回参数：

7.5 查询单个作品

请求地址：GET /a/u/works/{id}

返回参数：

data

7.6 按条件查询作品

请求地址：GET /a/u/works/list

请求参数：

返回参数：

data

8 工作室管理

8.1 新增工作室

请求地址：POST /a/u/studio

请求参数：

返回参数：

8.2 删除工作室

请求地址：DELETE /a/u/studio/{id}

返回参数：

8.3 编辑工作室

请求地址：PUT /a/u/studio/{id}

请求参数：

返回参数：

8.4 编辑工作室上下架状态

请求地址：PUT /a/u/studio/{id}

请求参数：

返回参数：

8.5 查询工作室

请求地址：GET /a/u/studio/list

请求参数：

返回参数：

data

9 账户管理

9.1 新建账户

请求路径：POST /a/u/account

请求参数：

返回参数：

9.2 删除账户

请求地址：DELETE /a/u/account/{id}

返回参数：

9.3 编辑账户

请求地址：PUT /a/u/account/{id}

请求参数：

返回参数：

9.4 查询账户

请求地址：GET /a/u/account

请求参数：

返回参数：

data

自动生成的接口里面的方法除了4个基础的增删改查之外，还多了几个：

public interface WorksMapper {
    int deleteByPrimaryKey(Long id);

    int insert(Works record);

    int insertSelective(Works record);

    Works selectByPrimaryKey(Long id);

    int updateByPrimaryKeySelective(Works record);

    int updateByPrimaryKeyWithBLOBs(Works record);

    int updateByPrimaryKey(Works record);
}

查了一下它们的用法：

加了Selective的是对数据进行了判断的，比如updateByPrimartKeySelective只更新非0的字段。写service接口的时候可以根据需要去掉这个。

这里卡在按条件查询了，之前只写过单条件查询的方法，这个是多条件查询。

在网上查了一下发现有很多种方法：

其中一种是将查询条件封装到pojo类中：

例如：

在WorksMapper中加一个select Works方法：

List<Works> selectWorks(Works record);

然后再WorksMapper.xml中加上：

<select id="selectWorks" resultType="Works" parameterType="Works">
  select * from works
  where
  name like CONCAT('%', #{name}, '%') and
  state=#{state}
</select>

这样可以实现根据作品名称和上架状态来查询作品，但是也有一个问题，原接口中的请求参数name和state不是必传的，如果只传一个参数的话就会出错。

这里我参考上面自动生成的updateByPrimartKeySelective方法，加了if test语句：

<select id="selectWorks" resultType="Works" parameterType="Works">
  select * from works
  where
  <if test="name != null">
  name like CONCAT('%', #{name}, '%')
  </if>
  <if test="state != null">
  and state=#{state}
  </if>

</select>

如果不为空就用这个条件查询，但还是有一点问题就是如果name设为空，state不为空，sql语句就多了个and，会直接报错。

去看了一下动态sql基本语句，在where后面加个条件：1=1就可以解决了！

像这样：

<select id="selectWorks" resultType="Works" parameterType="Works">
  select * from works
  where 1=1
  <if test="name != null">
  name like CONCAT('%', #{name}, '%')
  </if>
  <if test="state != null">
  and state=#{state}
  </if>
</select>

或者加上<where></where>标签：

<select id="selectWorks" resultType="Works" parameterType="Works">
  select * from works
  <where>
  <if test="name != null">
  name like CONCAT('%', #{name}, '%')
  </if>
  <if test="state != null">
  and state=#{state}
  </if>
  </where>
</select>

收获：学习了动态sql基本语句

每天计划完成的事情：

完成所有接口