V dnešním článku se podíváme na metody a atributy XHR.
Metody a atributy XHR
Máme-li vytvořený XHR, nic nám nebrání k vytváření požadavků HTTP z JavaScriptu.
Metoda/vlastnost | Popis |
abort() | Ukončí aktuální požadavek |
getAllResponseHeaders() | Vrátí hlavičky odpovědi jako řetězec |
getAllResponseHeader("headerLabel") | Vrátí jednu hlavičku odpovědi jako řetězec |
open() | Inicializuje parametry požadavku |
send() | Provede požadavek HTTP |
setRequestHeader() | Nastaví dvojici label/value hlavičky požadavku |
onreadystatechange | Používá se pro funkci zpětného volání, která ovládá změny stavu požadavku |
readyState | Vrátí stav požadavku: 0 = neinicializovaný 1 = načítání 2 = načten 3 = interaktivní 4 = dokončeno |
responseText | Vrátí odpověď serveru jako řetězec |
responseXML | Vrátí odpověď serveru jako dokument XML |
Status | Vrátí stavový požadavek |
statusText | Vrátí zprávu o stavu požadavku |
Inicializace požadavku na server
Jako první budeme volat metodu open();.
void open(string metoda, string url,bolean asynch, string uzivatel, string heslo)
Metoda open je jako jediná pro inicializaci požadavku. Má dva povinné a tři nepovinné argumenty. První povinný argument je metoda, kterou volám (GET, POST, PUT), pak URL prostředku, který voláme. Jako volitelný parametr zadáváme, zda chceme volat asynchronní požadavek (hondota true – výchozí) nebo synchronní požadavek, hodnota false. Musím vás však upozornit, že použitím synchronního požadavku ztrácí smysl použití XHR. Poslední dva argumenty mluví za sebe.
Požadavek na server
Požadavek na server provedeme metodou send();.
void send(obsah);
Pokud posíláme požadavek jako asynchronní, vrací se řízení okamžitě, v opačném případě musíme čekat na odpověď serveru. Jako nepovinný argument můžeme použít instanci objektu DOM, vstupní tok nebo řetězec.
Atribut onreadyStateChange
Atribut onreadyStateChange použijeme pro zpětné volání a nastavíme ji pro ošetření požadavku. Tato metoda je volána několikrát, a to v případě, kdy se požadavek dostane do nového stavu.
Ukázka jednoduchého požadavku
Předpokladem pro vytvoření požadavku, je událost na straně klienta (onclick, onchange, onblur atd.), která zavolá funkci JavaScriptu (pojmenujme ji například vytvorPozadavek()). Funkce vytvorPozadavek() vytvoří instanci XHR voláním funkce vytvorXHR(), kterou jsme vytvořili v minulém díle. Dále pomocí metody open() nastaví parametry volání serveru. Požadavek odešleme metodou send().
var xhr = vytvorXHR();
function vytvor pozadavek(){
var url = "phpscript.php";
xhr.open("POST",url);
xhr.onreadystatechange = volanaFunkce; //dojde-li ke změně, volej funkci volanaFunkce
xhr.send(null);
}
Jistě jste si všimli volání f-ce volanaFunkce při změně stavu požadavku. Tato funkce bude kontrolovat atribut readyState XHR a dále zjistí stavový kód přijatý od server (200 – pokud je vše OK; 404 – pokud prostředek nelze nalézt). Pokud bude kontrola úspěšná, provede akci, kterou ji určíme, jinak zobrazí hlášku o neúspěchu akce.
function volanaFunkce(){
if(xhr.readyState == 4){ //funkci provedeme, pokud je požadavek ve stavu dokončeno
if(xhr.status == 200){ //pokračuji, jen když je vše OK
//akce, co má funkce provést
}else{
alert("Vámi definovaný prostředek nelze nalézt!");
}
}
}
Úkol
Vytvořte jednoduchý ajaxový script, který bude průběžně ověřovat data ve formuláři pro registraci do diskusního fóra. Nechávám vám volnou ruku s tím, že vyžaduji dodržení několika málo věcí. Formulář bude obsahovat uživatelské jméno, jméno, příjmení, e-mail a tlačítko odeslat, na které nebude možnost kliknout. Nick, jméno a příjmení budeme kontrolovat, zda byly údaje vyplněny a u e-mail bude provedena i kontrola, jestli je ve správném tvaru. Pokud uživatel něco špatně/nic nevyplní, vždy se zobrazí červená hláška pod daným polem. Jestliže vše bude vyplněno v pořádku, nastavíme tlačítko odeslat pro možnost kliknutí.