9 ЋпределениЯ методов (Method Definitions).

Ќабор общих методов длЯ HTTP/1.1 приводитсЯ ниже. •отЯ этот набор может быть расширен, нельзЯ считать, что дополнительные методы имеют одиннаковую семантику, если они ЯвлЯютсЯ расширениЯми разных клиентов и серверов.

Џоле заголовка запроса Host (раздел 14.23) „Ћ‹†ЌЋ сопровождать все HTTP/1.1 запросы.

9.1 Ѓезопасные и Idempotent методы.

9.1.1 Ѓезопасные методы.

Џрограммистам следует понимать, что программное обеспечение при взаимодействии с €нтернетом представлЯет пользователЯ, и программе следует информировать пользователЯ о любых действиЯх, которые он может произвести, но которые могут иметь непредсказуемое значение длЯ него или других лиц.

‚ частности было принЯто соглашение, что методы GET и HEAD никогда не должны иметь иного значениЯ, кроме загрузки. ќти методы следует рассматривать как "безопасные". ќто позволЯет агентам пользователЯ представлЯть другие методы, такие как POST, PUT и DELETE, таким образом, чтобы пользователь был проинформирован о том, что он запрашивает выполнение потенциально опасного действиЯ.

…стественно, не возможно гарантировать, что сервер не генерирует побочные эффекты в результате выполнениЯ запроса GET; фактически, некоторые динамические ресурсы содержат такую возможность. ‚ажное различие здесь в том, что не пользователь запрашивает побочные эффекты, и, следовательно, пользователь не может нести ответственность за них.

9.1.2 Idempotent методы.

Њетоды могут также обладать свойством "idempotence" в том смысле, что побочные эффекты от N > 0 идентичных запросов такие же, как от одиночного запроса (за исключение ошибок и проблем устареваниЯ). Њетоды GET, HEAD, PUT и DELETE обладают данным свойством.

9.2 OPTIONS.

Њетод OPTIONS представлЯет запрос информации об опциЯх соединениЯ, доступных в цепочке запросов/ответов, идентифицируемой запрашиваемым URI (Request-URI). ќтот метод позволЯет клиенту определЯть опции и/или требованиЯ, свЯзанные с ресурсом, или возможностЯми сервера, но не производЯ никаких действий над ресурсом и не инициируЯ его загрузку.

…сли ответ сервера - это не сообщение об ошибке, то ответ Ќ… „Ћ‹†…Ќ содержать иной информации объекта, кроме той, которую можно рассматривать как опции соединениЯ (например Allow - можно рассматривать как опцию соединениЯ, а Content-Type - нет). Ћтветы на этот метод не кэшируютсЯ.

…сли запрашиваемый URI (Request-URI) - звездочка ("*"), то запрос OPTIONS предназначен длЯ обращениЯ к серверу в целом. …сли код состоЯниЯ в ответе - 200, то ответу ‘‹…„“…’ содержать любые полЯ заголовка, которые указывают опциональные возможности, реализуемые сервером (например, Public), включаЯ любые расширениЯ, не определенные данной спецификацией, в дополнение к соответствующим общим полЯм или полЯм заголовка ответа (response-header). Љак описано в разделе 5.1.2, запрос "OPTIONS *" может быть применен через прокси-сервер с определением адресуемого сервера в запрашиваемом URI (Request-URI) с пустым путем.

…сли запрашиваемый URI (Request-URI) не звездочка ("*"), то запрос OPTIONS применЯетсЯ к опциЯм, которые доступны при соединении с указанным ресурсом. …сли код состоЯниЯ ответа - 200, то ответу ‘‹…„“…’ содержать любые полЯ заголовка, которые указывают опциональные возможности, реализуемые сервером и применимые к указанному ресурсу (например, Allow), включаЯ любые расширениЯ, не определенные данной спецификацией, в дополнение к соответствующим общим полЯм или полЯм заголовка ответа (response-header). …сли запрос OPTIONS передаетсЯ через прокси-сервер, то последний редактирует ответ, исключаЯ те опции, которые не предусмотрены возможности этого прокси-сервера.

9.3 GET.

Њетод GET позволЯет получать любую информацию (в форме объекта), идентифицированную запрашиваемым URI (Request-URI). …сли запрашиваемый URI (Request-URI) обращаетсЯ к процессу, производЯщему данные, то в качестве объекта ответа должны быть возвращены произведенные данные, а не исходный текст процесса, если сам процесс не выводит исходный текст.

ђазличаетсЯ "условный GET" ("conditional GET"), при котором сообщение запроса включает полЯ заголовка If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, или If-Range. “словный метод GET запрашивает передачу объекта, только если он удовлетворЯет условиЯм, описанным в условных полЯх заголовка. “словный метод GET предназначен длЯ уменьшениЯ ненужной загрузки сети, и позволЯет обновлЯть кэшированные объекты без использованиЯ нескольких запросов или пересылки данных, уже сохраненных клиентом.

ђазличаетсЯ также "частичный GET" ("partial GET"), при котором сообщение запроса включает поле заголовка Range. —астичный GET запрашивает передачу только части объекта, как описано в разделе 14.36. —астичный метод GET предназначен длЯ уменьшениЯ ненужной загрузки сети, и позволЯет собирать объекты из частей, без передачи частей данных, уже сохраненных клиентом.

Ћтвет на запрос GET кэшируем тогда и только тогда, когда он отвечает требованиЯм HTTP кэшированиЯ, описанным в разделе 13.

9.4 HEAD.

Њетод HEAD идентичен GET, за исключением того, что сервер Ќ… „Ћ‹†…Ќ возвращать в ответе тело сообщениЯ (message-body). Њетаинформации, содержащейсЯ в HTTP заголовках ответа на запрос HEAD ‘‹…„“…’ быть идентичной информации, представлЯемой в ответ на запрос GET. ќтот метод может использоватьсЯ длЯ получениЯ метаинформации об объекте запроса без непосредственной пересылки тела объекта (entity-body). ќтот метод часто используетсЯ длЯ тестированиЯ гипертекстовых свЯзей в целЯх проверки правильности, достижимости, и времени модификации.

Ћтвет на запрос HEAD может быть кэшируемым в том смысле, что информациЯ, содержащаЯсЯ в ответе может использоватьсЯ длЯ модифицикации предварительно кэшированного объекта из этого ресурса. …сли новые значениЯ полЯ указывают, что кэшируемый объект отличаетсЯ от текущего объекта (по таким параметрам, как Content-Length, Content-MD5, ETag или Last-Modified), то кэш „Ћ‹†…Ќ обрабатывать содержимое как просроченное.

9.5 POST.

Њетод POST используетсЯ длЯ запроса, при котором адресуемый сервер принимает объект, включенный в запрос, как новое подчинение ресурса, идентифицированного запрашиваемым URI (Request-URI) в строке запроса (Request-Line). POST разработан длЯ того, чтобы общим методом реализовать следующие функции:

ЂннотациЯ существующих ресурсов;
ђегистрациЯ сообщениЯ на электронной доске объЯвлений (bulletin board), в конференции новостей (newsgroup), списке рассылки (mailing list), или подобной группе статей;
Џередача блока данных, например результат ввода в форме, процессу обработки;
ђасширение базы данных посредством конкатенирующей операции (append operation).

”актически функциЯ, выполнЯемаЯ методом POST, определЯетсЯ сервером и обычно зависит от запрашиваемого URI (Request-URI). Ћбъект, передаваемый методом POST, относитсЯ к этому URI таким же образом, как файл относитсЯ к каталогу, в котором он находитсЯ, статьЯ относитсЯ к конференции новостей (newsgroup), в которой она зарегистрирована, а запись относитсЯ к базе данных.

„ействие, выполнЯемое методом POST может не давать в качестве результата ресурс, который можно было бы идентифицировать URI. ‚ этом случае, в зависимости от того, включает ли ответ объект, описывающий результат, или нет, код состоЯниЯ в ответе может быть как 200 (OK), так и 204 (Ќет содержимого, No Content).

…сли ресурс был создан на первоначальном сервере, ответу ‘‹…„“…’ содержать код состоЯниЯ 201 (‘оздан, Created) и включать объект, который описывает состоЯние запроса и ссылаетсЯ на новый ресурс, а также заголовок Location (смотрите раздел 14.30).

Ћтветы на этот метод не кэшируемы, если ответ не включает соответствующие полЯ заголовка Cache-Control или Expires. Ћднако, ответ с кодом состоЯниЯ 303 (‘мотреть другой, See Other) может использоватьсЯ длЯ перенаправлениЯ агента пользователЯ длЯ загрузки кэшируемого ресурса.

‡апросы POST должны отвечать требованиЯм передачи сообщениЯ, изложенным в разделе 8.2.

9.6 PUT.

‡апросы с методом PUT, которые содержат объект, сохранЯютсЯ под запрашиваемым URI (Request-URI). …сли Request-URI обращаетсЯ к уже существующему ресурсу, включенный объект ‘‹…„“…’ рассматривать как модифицированную версию объекта, находЯщегосЯ на первоначальном сервере. …сли Request-URI не указывает на существующий ресурс, и может интерпретироватьсЯ агентом пользователЯ как новый ресурс длЯ запросов, первоначальный сервер может создать ресурс с данным URI. …сли новый ресурс создан, то первоначальный сервер „Ћ‹†…Ќ сообщить агенту пользователЯ об этом посредством ответа с кодом состоЯниЯ 201 (‘оздан, Created). …сли существующий ресурс модифицирован, то длЯ указаниЯ успешного завершениЯ запроса ‘‹…„“…’ послать ответ с кодом состоЯниЯ либо 200 (OK), либо 204 (Ќет содержимого, No Content). …сли ресурс не может быть создан или изменен длЯ запрашиваемого URI (Request-URI), то ‘‹…„“…’ послать ответ, отражающий характер проблемы. Џолучатель объекта Ќ… „Ћ‹†…Ќ игнорировать заголовков Content-* (например Content-Range), которых не понимает или не реализует, а „Ћ‹†…Ќ в данном случае возвратить ответ с кодом состоЯниЯ 501 (Ќе реализовано, Not Implemented).

…сли запрос передаетсЯ через кэш и запрашиваемый URI (Request-URI) идентифицирует один или несколько кэшированных в настоЯщее времЯ объектов, то вхождениЯ в кэш этих объектов должны обрабатыватьсЯ как просроченные. Ћтветы на этот метод не кэшируемы.

”ундаментальное различие между POST и PUT запросами, отражено в различном значении запрашиваемого URI (Request-URI). URI в запросе POST идентифицирует ресурс, который обрабатывает включенный объект. ќтим ресурсом может быть процесс, принимающий данные, шлюз к некоторому другому протоколу, или отдельный объект, который принимает аннотации (accepts annotations). Ќапротив, URI в запросе PUT идентифицирует объект, включенный в запрос - агент пользователЯ назначает данный URI включенному ресурсу, а сервер Ќ… „Ћ‹†…Ќ пытатьсЯ применить запрос к некоторому другому ресурсу. …сли сервер желает применить запрос к другому URI, он „Ћ‹†…Ќ послать ответ с кодом 301 (Џеремещен постоЯнно, Moved Permanently); агент пользователЯ ЊЋ†…’ затем принЯть собственное решение относительно переназначениЯ запроса.

Ћдиночный ресурс ЊЋ†…’ быть идентифицирован несколькими различными URI. Ќапример, статьЯ может иметь URI идентифицирующий "текущую версию", который отличен от URI, идентифицирующего каждую специфическую версию. ‚ этом случае, запрос PUT на общий URI может отразитьсЯ (may result) на нескольких других URI, определенных сервером происхождениЯ.

HTTP/1.1 не определЯет каким образом метод PUT воздействует на состоЯние первоначального сервера.

‡апросы PUT должны подчинЯтьсЯ требованиЯм передачи сообщений, изложенным в разделе 8.2.

9.7 DELETE.

Њетод DELETE запрашивает первоначальный сервер об удалении ресурса, идентифицируемого запрашиваемым URI (Request-URI). ќтот метод ЊЋ†…’ быть отменен человеческим вмешательством (или другими средствами) на первоначальном сервере. Љлиенту нельзЯ гарантировать, что операциЯ была выполнена, даже если код состоЯниЯ, возвращенный первоначальным сервером указывает на то, что действие было завершено успешно. Ћднако, серверу Ќ… ‘‹…„“…’ отвечать об успешном выполнении, если во времЯ ответа он предполагает удалить ресурс или переместить его в недоступное положение.

“спешному ответу ‘‹…„“…’ иметь код состоЯниЯ 200 (OK), если ответ включает объект, описывающий состоЯние, либо иметь код состоЯниЯ 202 (ЏринЯто, Accepted), если действие еще не было произведено, либо иметь код состоЯниЯ 204 (Ќет содержимого, No Content), если ответ сообщает об успехе (OK), но не содержит объекта.

…сли запрос передаетсЯ через кэш и запрашиваемый URI (Request-URI) идентифицирует один или несколько кэшированных в настоЯщее времЯ объектов, то вхождениЯ их должны обрабатыватьсЯ как просроченные. Ћтветы на этот метод не кэшируемы.

9.8 TRACE.

Њетод TRACE используетсЯ длЯ вызова удаленного возврата сообщениЯ запроса на уровне приложениЯ. Љонечному получателю запроса ‘‹…„“…’ отразить полученное сообщение обратно клиенту как тело объекта ответа с кодом состоЯниЯ 200 (OK). Љонечным получателем ЯвлЯетсЯ либо сервер происхождениЯ, либо первый прокси-сервер, либо первый шлюз, получивший нулевое значение (0) в поле Max-Forwards в запросе (см. раздел 14.31). ‡апрос TRACE Ќ… „Ћ‹†…Ќ содержать объекта.

TRACE позволЯет клиенту видеть, что получаетсЯ на другом конце цепочки запросов и использовать эти данные длЯ тестированиЯ или диагностической информации. ‡начение полЯ заголовка Via (раздел 14.44) представлЯет особый интерес, так как оно действует как след цепочки запросов. €спользование полЯ заголовка Max-Forwards позволЯет клиенту ограничивать длину цепочки запросов, что ЯвлЯетсЯ полезным при тестировании бесконечных циклов в цепочке прокси-серверов, пересылающих сообщениЯ.

…сли запрос успешно выполнен, то ответу ‘‹…„“…’ содержать все сообщение запроса в теле объекта (entity-body), а Content-Type следует быть равным "message/http". Ћтветы на этот метод Ќ… „Ћ‹†Ќ› кэшироватьсЯ.