http 1
Egy sor közös módszerek a HTTP / 1.1 az alábbiakban. Bár ez a készlet bővíthető, nem lehet feltételezni, hogy további módszereket ugyanazt a szemantika, mintha azok kiterjesztését a különböző kliensek és szerverek.
Host kérésfejlécmező (rész 14,23) kell kísérnie az összes HTTP / 1.1 kéréseket.
A programozók úgy kell érteni, hogy a szoftver az interakció az internet a felhasználót, és a felhasználói program minden olyan intézkedés, hogy tájékoztatni kell képes, de nem várt jelentőségű maguk vagy mások.
Különösen abban állapodtak meg, hogy a GET és a fej módszerek soha más értelme eltérő betöltése. Ezek a módszerek kell tekinteni „biztonságos”. Ez lehetővé teszi a felhasználói alkalmazások képviseletére más módszerek, mint például a POST, PUT és DELETE, oly módon, hogy a felhasználó már tájékoztatták, hogy végrehajtását kéri a potenciálisan veszélyes művelet.
Persze, nem lehet biztosítani, hogy a szerver nem generál mellékhatások következtében GET kérés; sőt, néhány dinamikus források nyújtanak egy ilyen lehetőséget. A lényeges különbség az, hogy a felhasználó nem kérte a mellékhatásokat, és így a felhasználó nem tehető felelőssé őket.
Módszerek is van a tulajdonsága „idempotencia” abban az értelemben, hogy a mellékhatások a N> 0 azonosak kérések ugyanazok, mint az egyetlen kérésre (hiba vagy lejárati problémák). Módszerek GET, HEAD, PUT és DELETE rendelkeznek ezzel a tulajdonsággal.
OPCIÓK módszer jelentése kérhet tájékoztatást a kommunikációs lehetőségek állnak rendelkezésre a lánc kérések / válaszok által azonosított kért URI (Request-URI). Ez a módszer lehetővé teszi, hogy az ügyfél határozza meg a lehetőségeket, és / vagy kapcsolódó követelmények erőforrás, vagy a képességeit a szerveren, de semmit sem tesz az erőforrás vagy kezdeményező letölthető.
Ha a válasz a szerver - ez nem egy hibaüzenet, akkor a válasz nem tartalmaz semmilyen más információs objektum mellett, amit meg lehet tekinteni a csatlakozási lehetőségek (pl engedélyezése - lehet tekinteni, mint a megfelelő, de Content-Type - nem). Az erre a módszerre nincs a gyorsítótárban.
Amennyiben a kért URI (Request-URI) nem egy csillag ( „*”), a lehetőségek kérés az opciók állnak rendelkezésre, ha kommunikál, hogy az erőforrás. Ha a válasz állapotát kód - 200, a válasz tartalmaz olyan fejléc mezők azt jelzik, hogy az opcionális funkciók által végrehajtott szerver és alkalmazandó, hogy az erőforrás (például engedélyezése), beleértve a kiterjesztést, nem része a leírásban, amellett, hogy a mindenkori közös mezőkhöz, vagy válasz fejléce (válasz-fejléc). Ha az opciót kérelem átmegy a proxy szerver, szerkeszteni a választ, hogy kizárják azokat a lehetőségeket, amelyek nem nyújtanak erre proxy szerver.
A GET metódus azt letölteni bármilyen információt (formájában egység) azonosítjuk a kért URI (Request-URI). Amennyiben a kért URI (Request-URI) egy olyan eljárás, amely termel adat a válasz egy objektumot kell visszaküldeni az előállított adatok és nem a forrás szövegét a folyamatot, ha a folyamat nem ad az eredeti szöveg.
Változó "feltételes GET" ( "feltételes GET"), ahol a kérelem üzenet mezőket tartalmaz If-Modified-Since fejlécet, ha-módosítatlan-, mivel ha-Match, If-None-Match, vagy ha-tartomány. A feltételes GET metódus azt kéri, hogy az egység átruházása csak, ha megfelel a leírt feltételek a feltételes fejléc mezőket. A feltételes GET módszer célja, hogy csökkentse a felesleges hálózati forgalmat, és lehetővé teszi, hogy frissítse a gyorsítótárban tárgyak használata nélkül több megkeresés vagy adatátvitel már birtokában az ügyfél.
Ez változik, mint egy „részleges GET” ( „részleges GET”), ahol a kérelem üzenet tartalmaz egy sor fejléc mezőt. A részleges GET kérések csak egy része a tárgy, pontban leírtak szerint 14.36. Részleges GET módszer célja, hogy csökkentse a felesleges hálózati forgalmat, és lehetővé teszi, hogy összegyűjti az elemeket a darabokat, anélkül, hogy az adatátvitel már birtokában az ügyfél.
Válaszul egy GET kérés gyorsítótárazható akkor és csak akkor, ha az megfelel a követelményeknek HTTP caching pontban leírt 13.
A HEAD módszer azonos a GET, kivéve, hogy a szerver nem adhat vissza az üzenet szövegét a válasz (üzenet-test). Meta szereplő információk fejlécében HTTP-válasz a HEAD kérés azonosnak kell lennie az információkat, válaszul a GET kérés. Ez a módszer használható megszerzésére meta-információt a kérés nélkül át az objektumot test (entitás törzsén). Ezt a módszert gyakran használják a vizsgálathoz hiperhivatkozások érvényességét, az elérhetőség és módosítási idő.
HEAD válasz a kérésre lehet cache abban az értelemben, hogy az információk a válasz lehet használni, hogy frissítse a korábban cache objektum ebből a forrásból. Ha az új mező értékek jelzik, hogy a tárolt egység eltér a jelenlegi objektum (paraméterek, mint a Content-Length, Content-MD5, ETag vagy Last-Modified), akkor a cache kell kezelnie állott.
Az akció által végzett POST módszer nem tud eredményeként erőforrás, hogy lehet használni, hogy azonosítsa URI. Ebben az esetben, attól függően, hogy a válasz objektum áll, amely leírja az eredményt, vagy nem, az állapot kódot a válasz lehet 200 (OK), és 204 (Nincs tartalom Nincs tartalom).
Ha az erőforrás hozta létre a származási szerver, a választ kell 201 (létrehozva, Alkotó-kód) és tartalmaz olyan szervezet, amely leírja az állapotát a kérelmet, és utal az új erőforrás, és a hely header (lásd 14.30).
Responses to ez a módszer nem gyorsítótárazhatók, kivéve, ha a válasz tartalmazza megfelelő mezőben gyorsítótár-Control vagy lejár fejléc. Azonban a választ egy státusz kódot 303 (Lásd másik, See Egyéb) lehet használni, hogy irányítsa át a felhasználói ügynök letölteni a tárolt erőforrás.
POST kéréseket meg kell felelniük az üzenet továbbítása meghatározott követelményeknek 8.2.
Módszer kérések PUT, amelyek tárgya alatt tárolt a kért URI (kérés URI). Ha a kérés URI kifejezés egy meglévő erőforrások, a mellékelt személyt kell tekinteni, mint egy módosított változata az egyetlen tartózkodó az eredeti szerver. Ha a kérés URI-ja nem pont egy meglévő erőforrás, és lehet értelmezni ágens, mint új erőforrás kéri, hogy az eredeti szerver is létrehozhat az erőforrást az URI. Ha egy új erőforrás jön létre, az eredeti szerver tájékoztatnia kell a böngésző ezen keresztül választ status code 201 (létrehozva, Készítette). Ha egy meglévő erőforrás módosítjuk, akkor jelzi a sikeres kérelmet kell küldeni a választ egy státusz kódot vagy 200 (OK), vagy 204 (Nincs tartalom, tartalom nincs). Ha az erőforrás nem lehet létrehozni, illetve módosítani a kért URI (Request-URI), szükséges, hogy küldjön egy választ, amely tükrözi a probléma természetét. A címzett objektum nem hagyhatjuk figyelmen kívül tartalmi * fejlécek (pl Content-Range), amely nem érti, vagy végre, és hogy ebben az esetben vissza választ állapot 501 (nem hajtják végre, nem valósult meg) kódot.
Ha a kérés áthalad egy cache és a Request-URI (Request-URI) azonosítja egy vagy több jelenleg cache-elt szervezetek, azokat a bejegyzéseket a cache ezeket a tárgyakat kell kezelni állott. Az erre a módszer nem gyorsítótárazhatók.
Az alapvető különbség a PUT és a POST kérések tükröződik a különböző értékek a kért URI (Request-URI). URI egy POST kérés azonosítja az erőforrás, amely kezeli a mellékelt entitás. Ez az erőforrás lehet egy folyamat befogadó adatok átjáró egy másik protokoll, illetve egy külön egység, amely megkapja jelöléseket (elfogadja jelölések). Éppen ellenkezőleg, URI egy PUT kérés azonosítja a szervezet zárt kérésére - a felhasználói ügynök hozzárendel egy URI, a szerver nem törekedhet, hogy alkalmazza a kérést egy másik forrás. Ha a szerver hajlandó alkalmazni a kérést egy másik URI, el kell küldenie egy válasz kód 301 (Véglegesen áthelyezve, Véglegesen áthelyezve); A felhasználói ügynök ezután saját maga határozatot az áthelyezésről kérelmet.
HTTP / 1.1 nem határozza meg, hogy egy PUT módszer befolyásolja az állam az eredeti szerver.
PUT kéréseket meg kell felelniük az üzenet továbbítása meghatározott követelményeknek 8.2.
A DELETE módszer azt kéri, hogy az eredeti szerver törli az erőforrás által azonosított kért URI (Request-URI). Ez a módszer lehet felülbírálni emberi beavatkozás (vagy más módon) a származási szerveren. Az ügyfél nem lehet garantálni, hogy a műveletet végrehajtották, akkor is, ha az állapot kódot vissza a származási kiszolgáló azt jelzi, hogy az akció sikeresen befejeződött. Azonban a kiszolgáló nem jelzi sikert, hacsak abban az időben a választ szándékozik törölni az erőforrás, vagy vigye egy elérhetetlen helyen.
A sikeres választ kell 200 (OK), ha a válasz tartalmazza az egység helyzetét leíró vagy állapot 202 kód (Elfogadva, Elfogadva), ha a keresetet még nem állítottak elő, vagy az állapot 204 kód (No Content, Nincs tartalom), ha a válasz jelentések siker (OK), de nem tartalmazza az objektum.
Ha a kérés áthalad egy cache és a Request-URI (Request-URI) azonosítja egy vagy több jelenleg cache-elt szervezetek, azokat a bejegyzéseket kell őket kezelni állott. Az erre a módszer nem gyorsítótárazhatók.
TRACE módszert alkalmazzák, hogy kezdeményezi a távoli visszatérítési kérelem üzenetet az alkalmazás szintjén. Végső címzett kérelmet kell tükröznie a kapott üzenetet küld vissza az ügyfélnek, mint a test a válasz objektum állapotát kód: 200 (OK). A végső kedvezményezett vagy az eredeti szerver vagy az első proxy vagy átjáró az első, kap egy nulla értékű (0) és Max-Csatárok mezőt a kérelmet (lásd. Szakasz 14,31). TRACE kérés nem tartalmazhat az egység.
TRACE lehetővé teszi az ügyfél, hogy mi történik a másik végén a kérés lánc és a kapott adatok vizsgálatára vagy diagnosztikai információkat. Mező Érték Via (Section 14.44) fejléc különösen érdekes, mert úgy viselkedik, mint egy nyoma kérés láncot. A Max-Csatárok mező fejléc lehetővé teszi az ügyfél, hogy korlátozza a hossza a kérelmet lánc, ami hasznos lehet a tesztelés egy végtelen ciklus a lánc proxy üzenetek továbbítása.
Ha a lekérdezés sikeresen lefut, a válasz tartalmazza a teljes kérelem üzenetet a szervezetben a tárgy (entity-body), és a Content-Type-ra kell állítani „üzenet / http”. Az erre a módszer NEM tárolásra kerülnek.