Spring Boot学习笔记（六）结合MyBatis实现较为复杂的RESTful API

前两篇已经构建了RESTful API标准工程实例，也整合了MyBatis实现了简单数据库访问，本篇主要更深入的学习下，实现较为完整的数据库CRUD的标准服务。

首先看下要实现的效果吧，完成下面截图部分的API，除了CRUD之外，分页查询也是使用的比较多的。

这次是采用代码编写的方式，没有使用通用mapper和分页组件，打算先熟悉下整个流程，后面实际开发功能的话还是使用的好，提高开发效率。

下面是编码的详细步骤：

编写TempMapper

我们优先实现数据库访问，之前一直采用的是注解的方式，所以这次就注解到底了。

但是遇到了第一个问题，sql如何拼接，之前简单的例子不会涉及，但这次有分页，有更新（可能更新某个字段）。

网上看了下，一种方式是使用<script>方法动态去拼接，尝试了一下，发现这代码可读性太差了，还不如直接用xml的方式了，后来才知道有@Provider,动态语言注解，其实就是通过该注解去指向你生成动态Sql的方法，相关代码如下：

我们定义一个TempSqlProvider类，用于提供所需要的Sql字符串，这里写了两个方法，分别生成分页查询的sql语句和更新sql语句：

public class TempSqlProvider {
    //生成分页Sql
    public String sqlTempPaging(Map<String, Object> map)
    {
        StringBuffer sql = new StringBuffer("select id,name,content from temp where 1=1 ");
        if(map.get("id")!=null)
        {
            sql.append(" and id=#{id}");
        }
        if(map.get("name")!=null)
        {
            sql.append(" and name=#{name}");
        }
        if(map.get("content")!=null)
        {
            sql.append(" and content=#{content}");
        }
        if(map.get("offect")!=null&&map.get("limit")!=null)
        {
            sql.append(" limit #{offset}, #{limit}");
        }
        return sql.toString();
    }
    
    //生成更新Sql
    public String updateTempSql(Temp temp)
    {
        return new SQL(){{
            UPDATE("temp");

            if(temp.getName() != null){
                SET("name=#{name}");
            }
            if(temp.getContent() != null){
                SET("content=#{content}");
            }
            WHERE("id=#{id}");
        }}.toString();
    }
}

可以看到，这里用了两种方式，查询的sql我通过字符串拼接的方式直接写sql，而更新的sql我使用MyBatis提供了SQL类org.apache.ibatis.jdbc.SQL,大家可以参考下，后者看起来更优雅点。

然后我们可以编写TempMapper了，具体代码如下：

@Mapper
public interface TempMapper {

    @Select("SELECT `id`,`name`,`content` FROM TEMP WHERE ID = #{id}")
    Temp findById(@Param("id") Integer id);

    @SelectProvider(type=TempSqlProvider.class,method="sqlTempPaging")
    List<Temp> getTempPaging(Map<String, Object> map);

    @Insert("INSERT INTO TEMP(NAME, CONTENT) VALUES(#{name}, #{content})")
    int insert(@Param("name") String name,@Param("content") String content);

    @UpdateProvider(type=TempSqlProvider.class,method="updateTempSql")
    int update(Temp temp);

    @Delete("DELETE FROM TEMP WHERE ID=#{id}")
    int delete(@Param("id") Integer id);
}

这里可以看到，我们分别通过@SelectProvider和@UpdateProvider注解，指向对应sql的类和方法，实现动态sql。

到这里，最复杂的数据访问基本就算编写完了。

轻插：MyBatis的一些注解说明

除了常规的CRUD的注解之外(@Select,@Update,@Insert,@Delete)和使用动态语言注解@Provider之外，有必要再说明下传参方式。

使用@Parm

基本上有三种，在上面的demo都有使用到findById方法，@Parm中定义的id对应sql中#{id}。

使用Map

当参数过多且不确定时，通过Map对象来作为传递参数的容器，如上面getTempPaging方法，但是在代码可读性上比较差点，我只有到具体sql中才能找到具体有哪些参数。

使用对象

使用普通的java对象来作为传参方式，如上面的update方法，当参数确定时使用对象的方式比较好。

编写Service层

我们继续编写Service层。

首先定义TempService接口，确认给要输出的方法，代码如下，简单的CRUD和一个分页的查询方法：

public interface TempService {
    Temp getTemp(Integer id);
    List<Temp> getTempPaging(Map<String, Object> map);
    Boolean insertTemp(Temp temp);
    Boolean updateTemp(Temp entity);
    Boolean deleteTemp(Integer id);
}

然后编写对应实现TempServiceImpl，代码如下：

@Service
public class TempServiceImpl implements TempService{

    @Autowired
    private TempMapper tempMapper;

    @Override
    public Temp getTemp(Integer id)
    {
        return tempMapper.findById(id);
    }

    @Override
    public List<Temp> getTempPaging(Map<String, Object> map)
    {
        return tempMapper.getTempPaging(map);
    }

    @Override
    public Boolean insertTemp(Temp temp)
    {
        return tempMapper.insert(temp.getName(),temp.getContent())>0;
    }

    @Override
    public Boolean updateTemp(Temp entity)
    {
        return tempMapper.update(entity)>0;
    }

    @Override
    public Boolean deleteTemp(Integer id)
    {
        return tempMapper.delete(id)>0;
    }
}

这部分没有什么好说的，由于没有很复杂的逻辑，直接调用的mapper。

编写Controller

暴露对外访问路由，同时整合Swagger，整体代码如下：

@Api(description ="Temp测试服务")
@RestController
@RequestMapping("/temp")
public class TempController {
    @Autowired
    private TempService tempService;

    @ApiOperation(value="根据Id查询Temp信息", notes="MyBatis实现数据库访问demo")
    @RequestMapping(value = "/{id}",method = RequestMethod.GET)
    public Temp getTemp(@ApiParam(name="id",value="主键id",required=true) @PathVariable  Integer id)
    {
        Temp t=tempService.getTemp(id);
        return t;
    }

    @ApiOperation(value="分页查询Temp信息", notes="MyBatis实现数据库访问demo")
    @RequestMapping(value = "/paging",method = RequestMethod.GET)
    @ResponseBody
    public List<Temp> getTempPaging(@RequestParam Map<String,Object> map)
    {
        List<Temp> t=tempService.getTempPaging(map);
        return t;
    }

    @ApiOperation(value="新增Temp信息", notes="MyBatis实现数据库访问demo")
    @RequestMapping(value = "",method = RequestMethod.POST)
    public String postTemp(@RequestBody  Temp temp)
    {
        tempService.insertTemp(temp);
        return "success";
    }

    @ApiOperation(value="根据Id更新Temp信息", notes="MyBatis实现数据库访问demo")
    @RequestMapping(value = "/{id}",method = RequestMethod.PUT)
    public String putTemp(@PathVariable  Integer id,@RequestBody  Temp temp)
    {
        temp.setId(id);
        tempService.updateTemp(temp);
        return "success";
    }

    @ApiOperation(value="根据Id删除Temp信息", notes="MyBatis实现数据库访问demo")
    @RequestMapping(value = "/{id}",method = RequestMethod.DELETE)
    public String deleteTemp(@PathVariable  Integer id)
    {
        Boolean result=tempService.deleteTemp(id);
        return result.toString();
    }

}

主要实现了五个接口，简单的CRUD和一个分页。

到这里，代码基本编写完成，如无意外的话，编译后即可得到上面说的截图效果。