何时使用自定义HTTP 方法
问题描述
您想知道使用自定义HTTP方法的影响。
解决方案
避免使用非标准的自定义HTTP方法,因为引入新方法后,就不能依赖那些只了解标准HTTP 方法的现有软件了。
您应该设计一个可以抽象此类操作的控制器(详见2.6 节)资源,并使用HTTP 的POST方法。
问题讨论
扩展HTTP 方法最重要的好处是,它可以让服务器为扩展方法定义清晰的语义并保持接口一致。但是,除非得到广泛支持,否则扩展方法将会降低互操作性。
例如,WebDAV 将MOVE 的语义定义为“逻辑上与复制一致,接着是一致性维护处理,最后进行源文件的删除,所有这三个动作是以原子操作的形式来执行的。”任何客户端都可以通过提交OPTIONS 请求以确认一个WebDAV 资源是否实现了MOVE方法。需要时,如果资源支持MOVE方法,客户端可以提交MOVE请求把资源从一个地方移动到另一个地方:
# 发现所支持方法的请求
OPTIONS /docs/annual_report HTTP/1.1
Host: www.example.org
# 响应
HTTP/1.1. 204 No Content
Allow: GET, PUT, DELETE, MOVE
# 移动
MOVE /docs/annual_report HTTP/1.1
Host: www.example.org
Destination:http://www.example.org/docs/annual_report_2009
# 响应
HTTP/1.1 201 Created
Location:http://www.example.org/docs/annual_report_2009
当然也可以遵循WebDAV 的做法,设计一个新方法,比如CLONE,创建一个现有的
资源的副本:
# 克隆请求
CLONE /po/1234 HTTP/1.1
Host: www.example.org
# 已创建克隆
HTTP/1.1 201 Created
Location: www.example.org/po/5678
客户端会发现服务器支持这一方法,并提交CLONE请求。
实际上,代理、缓存及HTTP库会将这些方法认定为非幂等、不安全及不可缓存的。
换言之,它们对这样的扩展方法使用和POST 一样的处理规则,POST 也是非幂等、不安全且在大部分情况下是不可缓存的。这是因为幂等性和安全性是服务器必须保证的。对于未知的自定义方法,代理、缓存和HTTP 库不能假定服务器提供了这样的保证。因此,对大部分基于HTTP 的软件和工具,自定义HTTP 方法等同于POST方法。
# 克隆请求
POST /clone-orders HTTP/1.1
Host: www.example.org
Content-Type:application/x-www-form-urlencoded
id=urn:example:po:1234
# 已创建克隆
HTTP/1.1 201 Created
Location: www.example.org/po/5678
此外,并不是所有的HTTP软件(包括防火墙)都支持任意的扩展方法。因此,只有在互操作性不是主要问题时才考虑使用自定义HTTP 方法。
优先使用POST而非自定义HTTP 方法。不是每一个HTTP 软件都可以让您使用自定义HTTP方法的。使用POST是一个更安全的选择。
本文节选自《RESTful Web Services Cookbook中文版》一书
图书详细信息:http://blog.csdn.net/broadview2006/article/details/6826999
分享到:
相关推荐
C#自定义命名空间与使用自定义的命名空间方法,学习文章。
首先是这次自定义View的效果图,是一张饼图。如果是用java写的话也就几十行,觉得换成Kotlin的话可能会更少。 示例代码 主要的功能是可以任设定数据的个数,我这里是4个数据,可以任意设定每个数据的颜色。 #####...
wordpress主题自定义导航菜单操作使用方法
泛微OA前端开发接口方法和自定义方方法总结注释 适用于刚接触泛微OA前端开发的小白和不了解泛微OA开发的老手 有什么问题可以私信问我 前端代码开发方式 方式1:模板上代码块,针对单个节点,在显示/打印/移动模板...
使用自定义模板时翻页时发生错误的解决方法
android自定义listview使用方法 提供一般listview 带图片的listview 带按钮的listview listview学习的好Demo
IWindowsFormsEditorService 只能通过 PropertyGrid 控件的 GetService 方法使用。 此服务通常用于显示来自 UITypeEditor 的 EditValue 方法的窗体。当 PropertyGrid 调用 UITypeEditor 的 EditValue 方法来提供...
1、.NET Core工程介绍 2、通过依赖注入方式使用自定义服务
在Linux系统下使用curl自定义HTTP头的方法.docx
启用了自定义HTTP方法的...要使用curl测试自定义http方法,请执行以下操作: curl -X DOSTUFF your-server-address:port/myrest 或者,安装phpunit(如果尚未安装) composer global require phpunit/phpunit 并在
solarwinds自定义oid模板,以及使用导入方法,亲测有效
学习创建和使用自定义控件写的试验代码,centos qt5.8可以使用。具体实现过程见我的文章:http://blog.csdn.net/csdn83419527/article/details/78870487 调试过程中出现的问题都有描述。另外控件代码用的lx100991的...
个人平时使用的自定义python 常用方法
叫你java中自定义标签的使用方法,简单的很,让你轻松掌握
开发者模式,微信公众使用自定义菜单的方法
webservice传递的内容必须是可序列化的,不管是参数还是返回值。解决方法很多比如序列化,类型控制等
android 自定义so库使用与方法调用demo 这个是一个自定义的so实例使用
通过拖动节点到画布的方式进行节点的添加,使用element组件实现鼠标移入节点后的自定义功能,使用antv/x6自带的api和事件系统实现节点、连线、连接桩的添加、删除功能,节点使用自定义HTML进行绘制。使用其自带的...
3000款PS自定义形状免费大放送及使用方法
演示在netBeans6.5中如何定义和引用自定义库,第三方库(如JDBC驱动、JSTL库等),这是入门时使用的一种方法,在使用熟悉后,可以灵活使用多种方法来添加外部库。