• 75376

    文章

  • 691

    评论

  • 18

    友链

  • 最近新加了换肤功能,大家多来逛逛吧~~~~
  • 喜欢这个网站的朋友可以加一下QQ群,我们一起交流技术。

SpringBoot 对Restful的支持

撸了今年阿里、腾讯和美团的面试,我有一个重要发现.......>>

一、RESTful风格API的好处

  • RESTful是基于http方法的API设计风格,而不是一种新的技术. url和http的method和statuscode都是很有历史的技术。

  • 看Url就知道要什么资源

  • 看http method就知道针对资源干什么

  • 看http status code就知道结果如何

规范了程序员的代码开发,为前端后端交互减少了接口交流的口舌成本,是"约定大于配置"的体现。通过下面的设计,大家来理解一下这三句话。

二、RESTful风格API的设计风格

  1. REST 是面向资源的(名词)

REST 通过 URI 暴露资源时,会强调不要在 URI 中出现动词。比如:

不符合REST的接口URI 符合REST接口URI 功能
GET /api/getDogs GET /api/dogs/{id} 获取一个小狗狗
GET /api/getDogs GET /api/dogs 获取所有小狗狗
GET /api/addDogs POST /api/dogs 添加一个小狗狗
GET /api/editDogs/{id} PUT /api/dogs/{id} 修改一个小狗狗
GET /api/deleteDogs/{id} DELETE /api/dogs/{id} 删除一个小狗狗
  1. 用HTTP方法体现对资源的操作(动词)

  • GET : 获取资源
  • POST : 添加资源
  • PUT : 修改资源
  • DELETE : 删除资源

实际上,这四个动词实际上就对应着增删改查四个操作,这就利用了HTTP动词来表示对资源的操作

  1. HTTP状态码

通过HTTP状态码体现动作的结果,不要自定义

200 OK 
400 Bad Request 
500 Internal Server Error

在 APP 与 API 的交互当中,其结果逃不出这三种状态:

  • 所有事情都按预期正确执行完毕 - 成功
  • APP 发生了一些错误 – 客户端错误(如:校验用户输入身份证,结果输入的是军官证,就是客户端错误)
  • API 发生了一些错误 – 服务器端错误(各种编码bug或服务内部自己导致的异常)

这三种状态与上面的状态码是一一对应的。如果你觉得这三种状态,分类处理结果太宽泛,http-statuscode还有很多。建议还是要遵循KISS(Keep It Stupid and Simple)原则,上面的三种状态码完全可以覆盖99%以上的场景。三个状态码大家都记得住,多了就不一定了。

  1. Get方法和查询参数不应该改变数据

改变数据的事交给POST、PUT、DELETE

  1. 使用复数名词

/dogs 而不是 /dog

  1. 复杂资源关系的表达

GET /cars/711/drivers/ 返回 使用car 711的所有司机

GET /cars/711/drivers/4 返回 使用car 711的4号司机

  1. 高级用法:HATEOAS

Hypermedia as the Engine of Application State 超媒体作为应用状态的引擎 RESTful API最好做到Hypermedia,或HATEOAS,即返回结果中提供链接,连向其他API方法,使得用户不查文档,也知道下一步应该做什么。比如,当用户向api.example.com的根目录发出请求,会得到这样一个文档。

{"link": {
  "rel":   "collection https://www.example.com/zoos",
  "href":  "https://api.example.com/zoos",
  "title": "List of zoos",
  "type":  "application/vnd.yourformat+json"
}}

上面代码表示,文档中有一个link属性,用户读取这个属性就知道下一步该调用什么API了。

  1. 为集合提供过滤 排序 选择和分页等功能

  • Filtering过滤:
使用唯一的查询参数进行过滤:
GET /cars?color=red 返回红色的cars
GET /cars?seats<=2 返回小于两座位的cars集合
  • Sorting排序:
允许针对多个字段排序
GET /cars?sort=-manufactorer,+model
这是返回根据生产者降序和模型升序排列的car集合
  • Field selection
移动端能够显示其中一些字段,它们其实不需要一个资源的所有字段,给API消费者一个选择字段的能力,
这会降低网络流量,提高API可用性。
GET /cars?fields=manufacturer,model,id,color
  • Paging分页
使用 limit 和offset.实现分页,缺省limit=20 和offset=0;
GET /cars?offset=10&limit=5
  1. 版本化你的API

使得API版本变得强制性,不要发布无版本的API。
/api/v1/blog
面向扩展开放,面向修改关闭。

三、开发REST接口

  1. 第一步:定义资源(对象)

@Data
@Builder
public class Article {

    private Long  id;
    private String author;
    private String title;
    private String content;
    private Date createTime;
}
  • @Data注解帮我们定义了一系列常用方法,如:getters、setters、hashcode、equals等
  1. 第二步:HTTP方法与Controller(动作)

@Slf4j
@RestController
@RequestMapping("/rest")
public class ArticleRestController {

 
    @RequestMapping(value = "/article", method = POST, produces = "application/json")
    public AjaxResponse saveArticle(@RequestBody Article article) {

        log.info("saveArticle:{}",article);
        return  AjaxResponse.success(article);
    }
 
    @RequestMapping(value = "/article/{id}", method = DELETE, produces = "application/json")
    public AjaxResponse deleteArticle(@PathVariable Long id) {

        log.info("deleteArticle:{}",id);
        return AjaxResponse.success(id);
    }
 
    @RequestMapping(value = "/article/{id}", method = PUT, produces = "application/json")
    public AjaxResponse updateArticle(@PathVariable Long id, @RequestBody Article article) {
        article.setId(id);

        log.info("updateArticle:{}",article);
        return AjaxResponse.success(article);
    }
 
    @RequestMapping(value = "/article/{id}", method = GET, produces = "application/json")
    public AjaxResponse getArticle(@PathVariable Long id) {

        Article article1 = Article.builder().id(1L).author("zimug").content("spring boot 2.深入浅出").createTime(new Date()).title("t1").build();
        return AjaxResponse.success(article1);
    }
}
  • 加上@Slf4j注解,就可以直接使用log变量打印日志

下面这个类是用于统一数据响应接口标准的。它的作用是:统一所有开发人员响应前端请求的返回结果格式,减少前后端开发人员沟通成本,是开发约定的落地。在异常处理的章节会做更加详细的说明。

public class AjaxResponse {

    private boolean isok;   //请求是否处理成功
    private int code;          //请求响应状态码(200、400、500)
    private String message;  //请求结果描述信息
    private Object data;  //请求结果数据

    private AjaxResponse() {

    }

    public static AjaxResponse success() {
        AjaxResponse resultBean = new AjaxResponse();
        resultBean.setIsok(true);
        resultBean.setCode(200);
        resultBean.setMessage("success");
        return resultBean;
    }

    public static AjaxResponse success(Object data) {
        AjaxResponse resultBean = new AjaxResponse();
        resultBean.setIsok(true);
        resultBean.setCode(200);
        resultBean.setMessage("success");
        resultBean.setData(data);
        return resultBean;
    }

    // getter / setter 略
}

四、REST接口开发常用的注解

  1. @RestController与@Controller

@RestController相当于 @Controller和@ResponseBody结合。它有两层含义:一是作为控制器注入到Spring上下文环境,二是请求响应为数据序列化(默认序列化方式是JSON),而不是跳转到html或模板页面。

  1. @RequestMapping 与@GetMapping、@PutMapping、@PostMapping、@DeleteMapping

@RequestMapping(value = “/article”, method = RequestMethod.GET) 新方法可以简写为: @GetMapping("/article"),其他同理。

  1. @RequestBody与@ResponseBody

用于接收和响应序列化数据(JSON),可以支持嵌套JSON数据结构。

  1. @PathVariable 与@RequestParam

PathVariable用于URI上的{参数}
RequestParam用于接收普通方式提交的参数


695856371Web网页设计师②群 | 喜欢本站的朋友可以收藏本站,或者加入我们大家一起来交流技术!

欢迎来到梁钟霖个人博客网站。本个人博客网站提供最新的站长新闻,各种互联网资讯。 还提供个人博客模板,最新最全的java教程,java面试题。在此我将尽我最大所能将此个人博客网站做的最好! 谢谢大家,愿大家一起进步!

转载原创文章请注明出处,转载至: 梁钟霖个人博客www.liangzl.com

1条评论

Loading...
  • 字母哥804L

    朋友,转载请注明原创文章出处:http://springboot.zimug.com/1177586



发表评论

电子邮件地址不会被公开。 必填项已用*标注

自定义皮肤
注册梁钟霖个人博客