• 说说自己对RESTful API的理解


    REST不是英文上的rest单词,其英文缩写为presentational State Transfer ,直译为表现状态转移,咋看起来很学术,不懂,其实不用去死抠这个词的意思。REST是一种约束和架构(设计),符合这个风格的都算API。如果实在想了解REST ,直接看提出REST的那篇论文。

    知乎上有句话总结的很好了,URL定位资源用HTTP动词(GET POST DELETE)描述操作。

    其实只要理解以下几个原则就可以了:

    1.提供资源定位

    一般在计算机系统中,client和server通信交换信息,发出Action来完成任务。假设在一个to-do-list的Web应用中,客户需要添加或者修改to-do-list,如果用非

    REST的方法是这样的:

    www/changeTodoList.php?item=35&action=changeTitle&title=new_title

    以上的URL是向Web API发出修改的指令,之后跟着的是一些修改的参数。但是,changeTodoList.php表述的不是一个事物,也不是一个资源(resource),在REST的架构风格中,服务器只提供资源(only offer resources), 资源表述的是C/S通信中的概念(即名词)。以下就是REST的方式:

    www/todolists/7/items/35/

    以上的URL在语义上表现就不是一些系列命令了,只仅仅是资源的URL地址。

    2.只交换自描述(self-descriptive)的消息

    考虑以下场景:

    /search-results?q=todo

    /search-results?page=2

    /search-results?page=3

    以上的Web API,第一个代表搜索todo的结果,第二行todo结果的第二页,之后类推。但是单独从第二行的参数就无法看出这API是干嘛的,什么的第二页?不得而知。

    以下是RESTful的设计:

    /search-results?q=to-do

    /search-results?q=todo&page=2

    /search-results?q=todo&page=3

    这样单独每行都能解释自身的意思,也就是自圆其说了。

    3.通过连接(Links)链接资源(resources)

    假设App向server端请求你的to-do-list:

    /todolists/7/
    { "name": "My to-dos",
    "items": [35, 36]
    }
    返回了以上的json串,item号数为35,36,但是App开发者应该从哪里通过item号来获取API呢?没办法,得通过提供的文档来向相关的Item查找Web API来查。
    以下是RESTful的设计:
    todolists/7/

    {

    "name": "My to-dos",

    "items": ["/todolists/7/items/35/", "/todolists/7/items/36/"]

    }

    上面json直接返回相关item的URL,App开发者直接就可以获取字符串发送请求了。
    只要遵循以上几个原则,那么设计出来的API就是RESTful的。

    references: https://www.zhihu.com/question/28557115

  • 相关阅读:
    Solaris 10 10/09发布
    MySQL数据库下损坏数据的恢复操作其过程总结
    [.net自定义控件]ComboBox控件重写 之ComboBoxEx
    Qt之正则表达式 QRegExp
    JavaScript中的JSON
    visual studio2008 OpenGL开发配置
    在母版页中使用UpdatePanel
    ASHX中使用Session
    ASP.NET(c#)实现中英文域名查询
    主打小巧快速Puppy Linux 4.3.1正式版发布
  • 原文地址:https://www.cnblogs.com/xuxiuxiu/p/7736801.html
Copyright © 2020-2023  润新知