RFC2616-HTTP1.1-Methods(方法规定部分—单词注释版)

partof HypertextTransferProtocol–HTTP/1.1RFC2616Fielding,etal.9 MethodDefiniti

大家好,又见面了,我是你们的朋友全栈君。

part of Hypertext Transfer Protocol — HTTP/1.1
RFC 2616 Fielding, et al.

9 Method Definitions

The set of common methods for HTTP/1.1 is defined below. Although this set can be expanded(扩大;使…变大;伸展;伸开), additional(补充;额外的,附加的;另外的,追加的;外加) methods cannot be assumed(假定的;假装的;假冒的;被承担的) to share the same semantics(语义学;词义学) for separately(分别地,另行;分开,单独;分离地;个别地) extended clients and servers.

The Host request-header field (section 14.23) MUST accompany(陪伴,陪同;附加,补充;与…共存;) all HTTP/1.1 requests.

9.1 Safe(安全的;保险的,肯定的;无损的;提供保护的) and Idempotent(幂等,等幂) Methods

9.1.1 Safe Methods

Implementors(实现者) should be aware(意识到的;知道的;觉察到的) that the software(软件;软体;软设备) represents(代表;体现;表现) the user in their interactions(互动;一起活动) over the Internet, and should be careful to allow the user to be aware of any actions they might take which may have an unexpected significance(意义;重要性;意思) to themselves or others.

In particular(特别的;详细的;独有的;挑剔的), the convention(国际公约;惯例,习俗,规矩) has been established(已建立的;已设立的;已制定的;确定的) that the GET and HEAD methods SHOULD NOT have the significance of taking an action other than retrieval(检索;收回,挽回). These methods ought to be considered “safe”. This allows user agents to represent(表现,象征;代表,代理;扮演;作为示范) other methods, such as POST, PUT and DELETE, in a special way, so that the user is made aware of the fact that a possibly unsafe action is being requested.

Naturally, it is not possible to ensure that the server does not generate side-effects as a result of performing a GET request; in fact, some dynamic(动态的;动力的,动力学的;充满活力的,精力充沛的;不断变化的,充满变数的) resources consider that a feature. The important distinction(区别;荣誉;特质;卓越) here is that the user did not request the side-effects, so therefore cannot be held accountable(负有责任的) for them.

9.1.2 Idempotent Methods

Methods can also have the property of “idempotence” in that (aside from error or expiration issues(问题,发表,宣布,分配)) the side-effects of N > 0 identical(同一的;完全同样的,相同的;恒等的;) requests is the same as for a single request. The methods GET, HEAD, PUT and DELETE share this property. Also, the methods OPTIONS and TRACE SHOULD NOT have side effects(边际效应,副作用), and so are inherently(天性地,固有地) idempotent.

However, it is possible that a sequence(数列,序列;) of several requests is non- idempotent, even if all of the methods executed in that sequence are idempotent. (A sequence is idempotent if a single execution(依法处决;实行,执行;演奏) of the entire sequence always yields(产量( yield的名词复数 );收益量;[财政学]投资实得率) a result that is not changed by a reexecution(重新执行) of all, or part, of that sequence.) For example, a sequence is non-idempotent if its result depends on a value that is later modified in the same sequence.

A sequence that never has side effects is idempotent, by definition(定义;规定,明确;) (provided that no concurrent(同时发生的;同时完成的;) operations are being executed on the same set of resources).

9.2 OPTIONS

The OPTIONS method represents(代表;体现;) a request for information about the communication options available(可获得的;有空的;可购得的;能找到的) on the request/response chain identified(确认;辨认;) by the Request-URI. This method allows the client to determine the options and/or requirements associated with a resource, or the capabilities(容量;能力) of a server, without implying(暗示,暗指) a resource action or initiating(发起;开始) a resource retrieval.Responses to this method are not cacheable.

If the OPTIONS request includes an entity-body (as indicated by the presence of Content-Length or Transfer-Encoding), then the media type MUST be indicated by a Content-Type field. Although this specification does not define any use for such a body, future extensions to HTTP might use the OPTIONS body to make more detailed queries on the server. A server that does not support such an extension MAY discard(丢弃,抛弃;) the request body.

If the Request-URI is an asterisk (“*”), the OPTIONS request is intended(预期的;有意的) to apply to the server in general rather than to a specific resource. Since a server’s communication options typically depend on the resource, the “*” request is only useful as a “ping” or “no-op” type of method; it does nothing beyond allowing the client to test the capabilities of the server. For example, this can be used to test a proxy for HTTP/1.1 compliance(服从,听从) (or lack thereof).

If the Request-URI is not an asterisk, the OPTIONS request applies only to the options that are available when communicating with that resource.

A 200 response SHOULD include any header fields that indicate optional features implemented(执行;实现) by the server and applicable(适当的;可应用的) to that resource (e.g., Allow), possibly including extensions not defined by this specification. The response body, if any, SHOULD also include information about the communication options. The format for such a body is not defined by this specification, but might be defined by future extensions to HTTP. Content negotiation(协商,谈判;转让;通过) MAY be used to select the appropriate response format. If no response body is included, the response MUST include a Content-Length field with a field-value of “0”.

The Max-Forwards request-header field MAY be used to target a specific proxy in the request chain. When a proxy receives an OPTIONS request on an absoluteURI for which request forwarding is permitted, the proxy MUST check for a Max-Forwards field. If the Max-Forwards field-value is zero (“0”), the proxy MUST NOT forward the message; instead, the proxy SHOULD respond with its own communication options. If the Max-Forwards field-value is an integer greater than zero, the proxy MUST decrement(减量;消耗;缩减) the field-value when it forwards the request. If no Max-Forwards field is present in the request, then the forwarded request MUST NOT include a Max-Forwards field.

9.3 GET

The GET method means retrieve(取回;恢复,挽回;) whatever information (in the form of an entity) is identified(确认;辨认;) by the Request-URI. If the Request-URI refers to a data-producing process, it is the produced data which shall(必须;应该;可以;将要) be returned as the entity in the response and not the source text of the process, unless that text happens to be the output of the process.

The semantics of the GET method change to a “conditional(视…而定的;) GET” if the request message includes an If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, or If-Range header field. A conditional GET method requests that the entity be transferred only under the circumstances(境况;境遇;) described by the conditional header field(s). The conditional GET method is intended to reduce unnecessary network usage by allowing cached entities to be refreshed without requiring multiple requests or transferring data already held by the client.

The semantics of the GET method change to a “partial GET” if the request message includes a Range header field. A partial GET requests that only part of the entity be transferred, as described in section 14.35. The partial GET method is intended to reduce unnecessary network usage by allowing partially-retrieved(部分检索) entities to be completed without transferring data already held by the client.

The response to a GET request is cacheable if and only if it meets the requirements for HTTP caching described in section 13.

See section 15.1.3 for security considerations(考虑) when used for forms.

9.4 HEAD

The HEAD method is identical(同一的;完全同样的,相同的;) to GET except that the server MUST NOT return a message-body in the response. The metainformation(元信息) contained in the HTTP headers in response to a HEAD request SHOULD be identical to the information sent in response to a GET request. This method can be used for obtaining metainformation about the entity implied by the request without transferring the entity-body itself. This method is often used for testing hypertext links for validity, accessibility, and recent modification.

The response to a HEAD request MAY be cacheable in the sense(感到;理解,领会;检测出) that the information contained in the response MAY be used to update a previously cached entity from that resource. If the new field values indicate that the cached entity differs from the current entity (as would be indicated by a change in Content-Length, Content-MD5, ETag or Last-Modified), then the cache MUST treat(对待;处理;款) the cache entry as stale.

9.5 POST

The POST method is used to request that the origin server accept the entity enclosed(封闭的;被附上的;) in the request as a new subordinate(次要的;附属的) of the resource identified by the Request-URI in the Request-Line. POST is designed to allow a uniform method to cover the following functions:

      – Annotation(注释) of existing resources;

      – Posting a message to a bulletin(公布,公告;) board, newsgroup, mailing list,or similar group of articles;

      – Providing a block of data, such as the result of submitting a form, to a data-handling process;

      – Extending a database through an append operation.

The actual function performed by the POST method is determined by the server and is usually dependent on the Request-URI. The posted entity is subordinate to that URI in the same way that a file is subordinate to a directory containing it, a news article is subordinate to a newsgroup to which it is posted, or a record is subordinate to a database.

The action performed by the POST method might not result in a resource that can be identified by a URI. In this case, either 200 (OK) or 204 (No Content) is the appropriate response status, depending on whether or not the response includes an entity that describes the result.

If a resource has been created on the origin server, the response SHOULD be 201 (Created) and contain an entity which describes the status of the request and refers to the new resource, and a Location header (see section 14.30).

Responses to this method are not cacheable, unless the response includes appropriate Cache-Control or Expires header fields. However, the 303 (See Other) response can be used to direct the user agent to retrieve a cacheable resource.

POST requests MUST obey the message transmission(传送;播送;) requirements set out in section 8.2.

See section 15.1.3 for security considerations.

9.6 PUT

The PUT method requests that the enclosed entity be stored under the supplied Request-URI. If the Request-URI refers(提到) to an already existing resource, the enclosed entity SHOULD be considered as a modified version of the one residing(定居;居住) on the origin server. If the Request-URI does not point to an existing resource, and that URI is capable(能干的;有才能的;有才华的;能胜任的) of being defined as a new resource by the requesting user agent, the origin server can create the resource with that URI. If a new resource is created, the origin server MUST inform(通知;使活跃,使充满;预示) the user agent via the 201 (Created) response. If an existing resource is modified, either the 200 (OK) or 204 (No Content) response codes SHOULD be sent to indicate successful completion of the request. If the resource could not be created or modified with the Request-URI, an appropriate(适当的;合适的;) error response SHOULD be given that reflects the nature of the problem. The recipient of the entity MUST NOT ignore any Content-* (e.g. Content-Range) headers that it does not understand or implement(实施,执行;) and MUST return a 501 (Not Implemented) response in such cases.

If the request passes through a cache and the Request-URI identifies one or more currently cached entities, those entries SHOULD be treated as stale. Responses to this method are not cacheable.

The fundamental(基础的,基本的,根本的,重要的,原始的,主要的,十分重大的;) difference between the POST and PUT requests is reflected(考虑;反照;表达) in the different meaning of the Request-URI. The URI in a POST request identifies the resource that will handle the enclosed entity. That resource might be a data-accepting process, a gateway to some other protocol, or a separate entity that accepts annotations. In contrast(对比,对照;), the URI in a PUT request identifies the entity enclosed with the request — the user agent knows what URI is intended and the server MUST NOT attempt(尝试;试图) to apply the request to some other resource. If the server desires(渴望;希望) that the request be applied to a different URI,it MUST send a 301 (Moved Permanently) response; the user agent MAY then make its own decision regarding whether or not to redirect the request.

A single resource MAY be identified(确认;辨认;认出) by many different URIs. For example, an article might have a URI for identifying “the current version” which is separate from the URI identifying each particular version. In this case, a PUT request on a general URI might result in several other URIs being defined by the origin server.

HTTP/1.1 does not define how a PUT method affects the state of an origin server.

PUT requests MUST obey(服从,听从) the message transmission requirements set out in section 8.2.

Unless otherwise specified for a particular entity-header, the entity-headers in the PUT request SHOULD be applied to the resource created or modified by the PUT.

9.7 DELETE

The DELETE method requests that the origin server delete the resource identified by the Request-URI. This method MAY be overridden by human intervention(介入,干涉,干预;调解,排解) (or other means) on the origin server. The client cannot be guaranteed(有保证的;有人担保的) that the operation(手术;操作,经营;) has been carried out, even if the status code returned from the origin server indicates that the action has been completed successfully. However, the server SHOULD NOT indicate success unless, at the time the response is given, it intends to delete the resource or move it to an inaccessible(达不到的;难见到的;不能接近的;无法理解的) location.

A successful response SHOULD be 200 (OK) if the response includes an entity describing the status, 202 (Accepted) if the action has not yet been enacted(制定), or 204 (No Content) if the action has been enacted but the response does not include an entity.

If the request passes through a cache and the Request-URI identifies one or more currently cached entities, those entries SHOULD be treated as stale. Responses to this method are not cacheable.

9.8 TRACE(跟踪,追踪;追溯,探索;探索;查找)

The TRACE method is used to invoke(借助) a remote, application-layer loop-back of the request message. The final recipient of the request SHOULD reflect the message received back to the client as the entity-body of a 200 (OK) response. The final recipient is either the origin server or the first proxy or gateway to receive a Max-Forwards value of zero (0) in the request (see section 14.31). A TRACE request MUST NOT include an entity.

TRACE allows the client to see what is being received at the other end of the request chain and use that data for testing or diagnostic(诊断的,判断的;特征的) information. The value of the Via header field (section 14.45) is of particular interest, since it acts as a trace of the request chain. Use of the Max-Forwards header field allows the client to limit the length of the request chain, which is useful for testing a chain of proxies forwarding messages in an infinite(无限的,无穷的;无数的,许许多多的;极大的) loop.

If the request is valid, the response SHOULD contain the entire request message in the entity-body, with a Content-Type of “message/http”. Responses to this method MUST NOT be cached.

9.9 CONNECT

This specification reserves the method name CONNECT for use with a proxy that can dynamically switch to being a tunnel (e.g. SSL tunneling [44]).

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/124407.html原文链接:https://javaforall.cn

【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛

【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

(0)


相关推荐

  • 移动端左滑右滑组件

    移动端左滑右滑组件

  • Java学习路线(完整详细版)超详细

    一门永不过时的编程语言——Java软件开发。Java编程语言占比:据官方数据统计,在全球编程语言工程师的数量上,Java编程语言以1000万的程序员数量位居首位。而且很多软件的开发都离不开Java编程,因此其程序员的数量最多。而在以Java编程为核心的开发领域中,javaEE程序员的需求量10年来一直居于首位!Java工程师就业:1.通过各大招聘网站统计,全国海量公司都在招聘J…

  • 华为P40怎么解账号锁P40Pro忘记密码ID账号锁解除方案开机设备解锁帐号软件使用方法

    华为P40怎么解账号锁P40Pro忘记密码ID账号锁解除方案开机设备解锁帐号软件使用方法​今天带来一台用户华为mate30手机强制清除华为账号锁案例分享,这个台手机是用户公司手机,由于前使用者离职后未能退出手机的华为账号和锁屏密码,导致手机无法使用。自己通过简单的恢复出厂设置后,发现手机有华为账号锁无法激活手机,这才联系到刷机爱好者技术人员,给予远程强制刷机移除华为mate30的账号锁。在此提醒广大用户,登录的华为账号建议绑定经常使用的手机号码,防止无法找回密码从而到时手机无法使用。在刷机解锁过程中需要准备以下工具:准备windwos系统电脑一台,有条件的用户可以找台配置.

  • display:flex垂直居中

    display:flex垂直居中布局说明:1.场次为一场比赛     2.比赛双方是交战的两个队伍        3.一场比赛可以有多种玩法,所以场的每个玩法的布局的高度都不确定。主要说下我学到的垂直居中的flex。1.第一次尝试。1divclass=”parent”>2h1>我是通过flex的水平垂直居中噢h1>3h1>我是通过fl

  • python join函数_Python join()函数原理及使用方法

    python join函数_Python join()函数原理及使用方法函数:string.join()Python中有join()和os.path.join()两个函数,具体作用如下:join():连接字符串数组。将字符串、元组、列表中的元素以指定的字符(分隔符)连接生成一个新的字符串os.path.join():将多个路径组合后返回一、函数说明1、join()函数语法:’sep’.join(seq)参数说明sep:分隔符。可以为空seq:要连接的元素序列、字…

    2022年10月25日
  • 史上最全安装Maven教程「建议收藏」

    史上最全安装Maven教程「建议收藏」史上最全安装Maven教程简单了解一下什么是Maven1.Maven翻译为“专家“,”内行”的意思,是著名Apache公司下基于Java开发的开源项目。2.Maven项目对象模型(POM)是一个项目管理工具软件,可以通过简短的中央信息描述来管理项目的搭建,报告和文档等步骤。3.Maven是一个项目管理的工具,可以对项目进行构建、依赖的管理。PS:(Gradle的项目搭建方式,将在不久的未来取代Maven,大势所趋。原因如何?小Du下期为您揭晓)一.官网下载下载官网→_→传送门二.配

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号