Ajax - 6. lekce

V dnešní lekci se podíváme na opakované asynchronní požadavky a naučíme se elegantně ošetřit chyby PHP, které můžou vzniknout.

Elegantní ošetření chyb PHP

Stejně jako při zpracování scriptu na straně klienta, tak i na straně serveru se mohou objevit události, které vedou ke vzniku výjimky či chyby. Stejně jako ostatní OOP jazyky, i PHP5 podporuje výjimky. Jsou však omezeny na objekty výjimek, které sami vyhodíme a následně zachytíme. Samotné jádro PHP5 při chybových událostech výjimky negeneruje. Interpret PHP hlásí chybu vždy, když se objeví nějaký problém.

K zachycení chyb PHP definuje následující funkci:

mixed set_error_handler ( callback $error_handler [, int $error_types ] )

Ta přebírá dva parametry. Za první parametr dosadíme vlastní funkci, kterou si za chvíli popíšeme. Druhým parametrem je typ chyby, kterou budeme zachytávat (pro možnosti ladění na localhost nastavíme na E_ALL).

Námi definovaná funkce bude přebírat 4 parametry: $errLine a bude vypadat následovně:

function zachyt_chybu($errNo, $errStr, $errFile, $errLine){
    //nejprve smažu dosavadní výstupy
    if(ob_get_length()) ob_clean();
    //sestavím chybovou zprávu
    $message = "ERRNO: ". $errNo."
nr".
               "Text chyby: ".$errStr."
nr".
               "Soubor: ".$errFile."
nr".
               "Řádek: ".$errLine."
nr";
    //zobrazím chybovou zprávu
    echo $message;
    //zabráním dalšímu zpracování
    exit;
  }

V prvním kroku funkce pomocí ob_clean vymaže všechny výstupy, nadále definujeme vlastní elegantní chybový výstup, který nakonec vytiskneme uživateli na obrazovku. Vše nyní uložíme do souboru zachyt_chybu.php, který od nynějška budeme includovat do všech scriptů. Celý script vypadá následovně:

nr".
               "Text chyby: ".$errStr."
nr".
               "Soubor: ".$errFile."
nr".
               "Řádek: ".$errLine."
nr";
    //zobrazím chybovou zprávu
    echo $message;
    //zabráním dalšímu zpracování
    exit;
  }
?>

Opakované asynchronní požadavky

Opakované asynchronní požadavky nás zbaví nutnosti použití tlačítka aktualizovat při změně údajů na stránce (např. počasí, kurzy akcií, kurzy měn a jiné). Pomocí Ajaxu můžeme obnovovat jen určitou část stránky. Dobrým příkladem této techniky je například stránka http://digg.com/spy.

Tvorba opakovaného asynchronního požadavku je velmi jednoduchá. Použijeme k tomu funkci JavaScriptu setTimeout(), která bude obsažena ve všech funkcích spuštěných vlastností onreadstate. Umožňuje opakované spouštění určité funkce v pravidelném intervalu zadaném v milisekundách.

Jako další příklad mohu uvést službu Windows Live Hotmail (http://hotmail.com/), která opakované asynchronní požadavky používá pro načtení nových e-mailových zpráv.

Pro demonstraci opakovaných asynchronních požadavků si vytvoříme miniaplikaci, která bude zobrazovat posledních 10 článků. Články se budou vždy v určitém intervalu znovu načítat z databáze, a pokud se objeví nový článek, zobrazí se klientovi bez nutnosti použít tlačítko aktualizovat nebo klávesy F5.

Vytvoření miniaplikace

Naše miniaplikace bude pouze vypisovat 10 nejnovějších článků, u nichž budeme zobrazovat titulek, datum publikování, autora a perex článku.

1. Vytvoříme si tabulku clanky, která bude obsahovat sloupce id, nazev, autor, datum, perex.

 CREATE TABLE 'clanky' (
'id' INT( 20 ) NOT NULL AUTO_INCREMENT PRIMARY KEY ,
'nazev' VARCHAR( 255 ) NOT NULL ,
'autor' VARCHAR( 100 ) NOT NULL ,
'datum' DATETIME NOT NULL ,
'perex' TEXT NOT NULL
) ENGINE = InnoDB 

2. Tabulku naplníme daty:

INSERT INTO `ajax`.`clanky` (
`id` ,
`nazev` ,
`autor` ,
`datum` ,
`perex`
)
VALUES (
'1', 'Pokusny clanek', 'Petr Laslo', '2008-08-18 20:24:05', 'Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. '
), (
'2', 'Pokusny clanek 2', 'Petr Laslo', '2008-08-18 20:25:11', 'Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. Tohle je pokusny clanek. '
);

3. Budeme používat téměř stejné funkce JavaScriptu jako ve 3. lekci; pokud dojde k nějaké změně, upozorním na to. Funkci pro vytvoření objektu XHR jsme se naučili používat ve 2. lekci. První upravenou funkcí bude prectiSoubor();:

function prectiSoubor(){
if(xhr){
  try{
    //jedniá změna, budeme volat soubor clanky.php
    xhr.open("POST","clanky.php",true);
    xhr.onreadystatechange = ctiOdpoved;
    xhr.send(null);
  }catch(e){
    alert("Nelze se připojik k serveru:n" + e.toString());
  }
}else{
  alert("Funkce "precitSoubor()": chybí objekt XMLHttpRequest");
}
}

4. Následují další drobné úpravy ve funkci ctiOdpoved();:

function ctiOdpoved(){
  if(xhr.readyState == 4){
    if(xhr.status == 200){
      try{
        var XMLRes = xhr.responseXML;
        //zachycení chyb IE a Opery
        if(!XMLRes || !XMLRes.documentElement){
          throw("Chybná struktura XML:n"+xhr.responseText);
        }
        //zachycení chyb ohnivé lišky :-)
        var rootNodeName = XMLRes.documentElement.nodeName;
        if(rootNodeName == "parsereerror"){
          throw("Chybná struktura XML:n"+xhr.responseText);
        }
        //čtu dokument, jelikož je vše ok :-)
        xmlRoot = XMLRes.documentElement;
        //další změna čteme XML tag titulek
        titulek = xmlRoot.getElementsByTagName("titulek");
        //další změna  čteme XML tag autor
        autor = xmlRoot.getElementsByTagName("autor");
        //další změna  čteme XML tag datum
        datum = xmlRoot.getElementsByTagName("datum");
        //další změna čteme XML tag prefex
        prefex = xmlRoot.getElementsByTagName("prefex");
        
        //sem budem ukládat výstup
        var vystup ="";
        
        //vytvoříme obsah
        for(var i=0;i < titulek.length; i++){
          vystup += "
"+titulek.item(i).firstChild.data+"
"+
                    "
Autor:"+autor.item(i).firstChild.data+" Datum:"+datum.item(i).firstChild.data+"
"+
                    "
"+prefex.item(i).firstChild.data+"
";
        }
        
        //získám odkaz na emelent DIV
        div = document.getElementById("seznam");
        //do DIV vložím obsah
        div.innerHTML = vystup;
        //doplníme funkci setTimeou, funkci prectiSoubor budeme volat každých 5sekund
        setTimeout("prectiSoubor();",5000);

      }catch(e){
        alert("Chyba při čtení odpovědi:"+e.toString());
      }
    }else{
      alert("Požadavek HTTP není v pořádku.")
    }
  }
}

5. Nyní si vytvoříme soubor clanky.php. Postup pro jeho vytvoření jsem popsal v 5.lekci.

 query($sql);

//výstup je XML dokument, proto odešlu správný mime-type
header("Content-Type: text/xml");

//tvořím nový XML
$xml = new DOMDocument("1.0","utf-8");
//vytvočím kořenový element zamesntanci
$clanky = $xml->createElement("clanky");
$xml->appendChild($clanky);
//zde vytvořím element book, do kterého pomocí cyklu načtu data z MySQL

while($zaznam = $res->fetch_object()){
$clanek = $xml->createElement("clanek");
//vytvorim element titulek a vložím do něj data
$titulek = $xml->createElement("titulek");
$titulekData = $xml->createTextNode($zaznam ->nazev);
$titulek->appendChild($titulekData);
//vytvorim element autor a vložím do něj data
$autor = $xml->createElement("autor");
$autorData = $xml->createTextNode($zaznam ->autor);
$autor->appendChild($autorData);
//vytvorim element datum a vložím do něj data
$datum = $xml->createElement("datum");
$datumData = $xml->createTextNode($zaznam ->datum);
$datum->appendChild($datumData);
//vytvorim element prefex a vložím do něj data
$prefex = $xml->createElement("prefex");
$prefexData = $xml->createTextNode($zaznam ->prefex);
$prefex->appendChild($prefexData);
//jmeno id a pozice jsou potomci zamestnanec
$clanek->appendChild($titulek);
$clanek->appendChild($autor);
$clanek->appendChild($datum);
$clanek->appendChild($prefex);
$clanky->appendChild($clanek);
}
//uložím XML výstup
$vystup= $xml->saveXML();
//zobrazím
echo $vystup;
?>

6. Posledním krokem je vytvoření souboru index.html:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="cs">
  <head>
    <meta http-equiv="content-type" content="application/xhtml+xml; charset=utf-8" />
    <meta http-equiv="content-language" content="cs" />
    <meta http-equiv="pragma" content="no-cache" />
    <meta http-equiv="cache-control" content="no-cache, must-revalidate" />
    <meta http-equiv="expires" content="0" />
    <meta name="generator" content="PSPad editor, www.pspad.com" />
    <meta name="author" content="all: Petr 'plasmo' Láslo; mailto: plasmo@email.cz; web: http://plasmo.ic.cz" />
    <script src="js.js" type="text/javascript"></script>
    <title>Opakované asynchronní požadavky</title>
  </head>
  <body onload="prectiSoubor()">
    <h1>Články</h1>
    <div id="seznam" />
  </body>
</html>

Domácí úkol

V dnešní domácí úloze budeme vycházet z dnes vytvořených kódů. Vašim úkolem bude upravení miniaplikací tak, aby byl nově zobrazený článek po obnově dokumentu podbarvený zelenou barvou. Návštěvník stránek tedy bude mít vždy přehled o nových položkách.

Závěr

Šestá lekce obsahovala pro pravidelné čtenáře kurzu Ajax z 99% již známý kód. Jedinou novinkou byla aplikace funkce setTimeout(), která slouží pro opakované volání. Na závěr bych chtěl pogratulovat všem, kteří si příklady z lekce vyzkoušeli - dnes jste vytvořili svojí první opravdovou Ajaxovou aplikaci.

• Ukázka
• Download scriptů