Standardeeritud HTTP-meetod QUERY, mis ühendab GET ja POST võimalusi

IETF (Internet Engineering Task Force) insenerikomitee, mis tegeleb Interneti protokollide ja arhitektuuri arendamisega, on määranud HTTP meetodile QUERY "Eettasu" staatuse ning avaldanud sellega seotud spetsifikatsiooni RFC 10008. QUERY meetod sarnaselt POST meetodile edastab andmeid serverisse, kuid erineb sellest, et fookus ei ole andmete salvestamisel ja oleku muutmisel, vaid lugemisäppede tegemisel.

Lahendatavates ülesannetes on uus meetod GET-le lähedane ja võimaldab edastada päringuid, mida saab korrata või taaskäivitada ilma serveri oleku muutmiseta. Nagu POST meetodi puhul, edastatakse QUERY päringu parameetrid mitte URI-s, vaid päringu kehas. Selline lähenemine võimaldab edastada suurtes kogustes parameetreid, ületades GET meetodi parameetrite suuruse piiri (8000 baiti).

GET /feed?q=foo&limit=10&sort=-published HTTP/1.1
Host: example.org

QUERY /feed HTTP/1.1
Host: example.org
Content-Type: application/x-www-form-urlencoded

q=foo&limit=10&sort=-published

QUERY meetodi kaudu edastatud parameetreid ei kajastata logides serverite, mis see ühelt poolt raskendab päringute analüüsi ja probleemide diagnoosimist, kuid teisalt võimaldab varjata konfidentsiaalset teavet puhverserverite logidest.

Kasutusvaldkondade hulgas on QUERY meetodi rakendamisel mainitud päringute saatmist Web API-dele, mis tagastavad tulemuse JSON- või XML-formaadis, või taustsüsteemidele, mis genereerivad sisu. Uue meetodi rakendatavuse määramiseks pöördumisel soovitatakse kasutada meetodit OPTIONS, ning toetatavate formaatide määramiseks meetodit HEAD: serverile >> OPTIONS /contacts HTTP/1.1

>> Host: example.org
HTTP/1.1 200 OK

Allow: GET, QUERY, OPTIONS, HEAD
Lubage: GET, QUERY, OPTIONS, HEAD

QUERY meetodis on kätetavad vahemälu — proksiserverid või töötlejad võivad salvestada päringu teostamise tulemuse, määrata sellele URI edaspidiseks viitamiseks GET meetodi kaudu ning edastada teavet vahemälu versiooni väljastamise kohta «Last-Modified» päises. Muudatuste kontrollimiseks eelmise päringu kestusest saab kasutada päist «If-Modified-Since». Päringu täitmise alternatiivsete variantide näitamiseks vastuses võivad olla päised «Content-Location» ja «Location», mille erinevus seisneb selles, et esimene edastab lingi varem tehtud päringu tulemusele, samas kui teine on mõeldud päringu kordamiseks samade parameetritega.

> QUERY /contacts HTTP/1.1
HTTP/1.1 200 OK
> Content-Type: application/x-www-form-urlencoded
> Accept: application/json
> select=surname,givenname,email&limit=10&match=%22email=*@example.*%22

Allow: GET, QUERY, OPTIONS, HEAD
Content-Type: application/json
Content-Location: /contacts/stored-results/17
Location: /contacts/stored-queries/42
Last-Modified: Sat, 25 Aug 2012 23:34:45 GMT
Date: Sun, 17 Nov 2024, 16:10:24 GMT

> GET /contacts/stored-results/17 HTTP/1.1
HTTP/1.1 200 OK
> Accept: application/json

Lisaks tüübile «application/x-www-form-urlencoded» saab QUERY päringute parameetrite edastamiseks kasutada ka otse laiendatud vormate, nagu JSONPath (application/jsonpath), XSLT (application/xslt+xml) ja SQL (application/sql). Toetatud formaadid tagastatakse serveriga Accept-Query päises.

> HEAD /contacts HTTP/1.1
HTTP/1.1 200 OK

Allow: GET, QUERY, OPTIONS, HEAD
Content-Type: application/xhtml
Accept-Query: application/x-www-form-urlencoded, application/jsonpath, application/sql

> QUERY /errata.json HTTP/1.1
HTTP/1.1 200 OK
> Content-Type: application/jsonpath
> Accept: application/json
>
> $..[
> ?@.errata_status_code==»Rejected»
> && @.submit_date>»2024″
> ]
> [«doc-id»]

Allikas: opennet.ru