专栏首页Bug生活2048Spring Boot学习笔记(六)结合MyBatis实现较为复杂的RESTful API

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

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

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

image1

这次是采用代码编写的方式,没有使用通用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和一个分页。

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

轻插:Swagger常用注解说明

上面代码中使用了一些Swagger基本的注解:

  • @Api:用在请求的类上,表示对类的说明
  • @ApiOperation:用在请求的方法上,说明方法的用途、作用
  • @ApiParam:用在请求的方法上,表示参数说明

主要用了这三个,@Api主要描述下整个服务组的一些说明,@ApiOperation主要描述单个服务的说明,这两个感觉还是有点必要的。

至于其他的,感觉视情况而定吧,如果要把一个服务全部描述清楚,这代码看上去真的有点恐怖。

下面是一些Swagger其他一些注解,供大家了解参考,因为没有使用到,没有深入去研究,详细的可以参考官网

  • @ApiModel: 用于类表示对类进行说明,用于参数用实体类接收
  • @ApiModelProperty:用于方法,字段 表示对model属性的说明或者数据操作更改
  • @ApiIgnore:用于类,方法,方法参数 表示这个方法或者类被忽略
  • @ApiImplicitParam: 用于方法 表示单独的请求参数
  • @ApiImplicitParams:用于方法,包含多个 @ApiImplicitParam

总结

本篇主要结合Spring Boot学习笔记(四)构建RESTful API标准工程实例和Spring Boot学习笔记(五)整合MyBatis实现数据库访问,填充了CURD服务的基本实现。

开发应用时,主流程实现应该没有问题了,但还有很多不足,比如日志,一些传参验证,异常捕获等。后期也会慢慢学习,分享出来。

本文分享自微信公众号 - Bug生活2048(BugLife2048),作者:Bug生活2048

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2018-03-11

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Spring Boot学习笔记(五)整合MyBatis实现数据库访问

    这里主要依赖两个,一个是连接MySql的`mysql-connector-java`,还一个是SpringBoot整合MyBatis的核心依赖`mybatis-...

    Bug生活2048
  • Spring Boot学习笔记(四)构建RESTful API标准工程实例

    通过`Spring Initializr`创建工程,选择所需要的jar包,如下图:

    Bug生活2048
  • [mini-blog][v1.6.0]体现后台管理功能的价值时刻到了——丰富文章的筛选

    这次改版,用户最直观的效果就是可以对文章进行筛选了,最早期的一版,只能通过简单的搜索框进行筛选:

    Bug生活2048
  • 腾讯QQ音乐一面和二面

    一面是面试官直接打电话过来,没有任何提前预约,所以也没有拿纸记下来,就记得这几个题目了

    牛客网
  • Facebook秘密文件泄露:赚钱(和背锅)是AI的使命

    美国媒体The Intercept最新获取了一份Facebook机密文件,其中透露了Facebook提供给广告主的一项贴心服务:忠诚度预测。

    量子位
  • 别让自己成为一名废弃的程序员

      前几天半夜接到老友的电话,一个三十多岁的男人,蹲在自家黑漆漆的车库里抱头大哭。

    美的让人心动
  • vue实战-实现换主题/皮肤功能

    接下来就是具体实现换皮肤功能了,换皮肤一般都是点击一个按钮弹出一些皮肤的选项,选中选项后皮肤生效。 我们将换皮肤功能抽成一个组件theme-switch。pc...

    我的小熊不见了丶
  • Web前端学习 第7章 Vue基础教程1 Vue概述

    Angular是谷歌公司开发的前端框架,在国外的用户比国内用户多很多,国内始终是不温不火的状态。

    学习猿地
  • Web前端学习 第7章 Vue基础教程1 Vue概述

    Angular是谷歌公司开发的前端框架,在国外的用户比国内用户多很多,国内始终是不温不火的状态。

    学习猿地
  • 【数据分析可视化】用python分析了5000部票房,发现赚钱的电影都有这些特征~

    通过上面的数据集信息可以知道:整个数据集缺失的数据比较少 其中release_date(首次上映日期)缺失1个数据,runtime(电影时长)缺失2个数据,可...

    瑞新

扫码关注云+社区

领取腾讯云代金券