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

IETF-i (Internet Engineering Task Force) insenerikomisjon, mis tegeleb interneti protokollide ja arhitektuuri arendamisega, andis HTTP-meetodile QUERY «Eelnõudatud standardi» staatuse ja avaldas sellega seotud spetsifikatsiooni RFC 10008. QUERY meetod andmeedastuse korraldamise osas kordab POST meetodit, kuid erineb sellest mitte andmete kirjutamise ja oleku muutmise, vaid päringute lugemise loomise suunaga.

Uus meetod lahendatavate ülesannete poolest sarnaneb GET-iga ja võimaldab saata päringuid, mida saab korrata või taaskäivitada ilma serveri oleku muutmiseta. Nagu POST meetodil, edastatakse QUERY päringu parameetrid mitte URI-s, vaid päringu kehas. Selline lähenemine võimaldab edastada suurtes kogustes parameetreid, mis ületavad GET meetodi parameetrite suuruse piiri (8000 bait).

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 parameetrid ei kajastu logides serverid, mis ühelt poolt raskendab päringute analüüsi ja probleemide diagnoosimist, kuid teiselt poolt võimaldab see peita konfidentsiaalseid andmeid vahe-serverite logidest.

QUERY meetodi rakendamisvaldkondade hulgas mainitakse päringute saatmist Web API-dele, mis tagastavad tulemuse JSON või XML formaadis, või tagakülgedele, mis genereerivad sisu. Uue meetodi kasutamise võimaluse määramiseks soovitatakse kasutada OPTIONS meetodit, ning toetatud formaatide määramiseks HEAD meetodit: serveri > OPTIONS /contacts HTTP/1.1

> Host: example.org
HTTP/1.1 200 OK

Allow: GET, QUERY, OPTIONS, HEAD
Lubatud: GET, QUERY, OPTIONS, HEAD

QUERY meetod toetab vahemälu — proksiserverid või käsitlejad saavad salvestada päringu täitmise tulemuse, määrata sellele URI hilisemaks juurdepääsuks GET meetodi kaudu ja edastada teavet vahemälustatud versiooni kohta kaudu päist "Last-Modified". Muudatuste olemasolu kontrollimiseks eelmise päringu ajast võib 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 varasemalt täidetud päringu tulemusele, samas kui teine on ette nähtud sama 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="email=*@example.*"

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

Peale tüübi "application/x-www-form-urlencoded" on QUERY päringutes ka otse võimalik kasutada laienevaid formaate, nagu JSONPath (application/jsonpath), XSLT (application/xslt+xml) ja SQL (application/sql). Toetatud formaadid tagastatakse serverilt päises Accept-Query.

> 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