Simple API for XML

Simple API for XML (zkráceně SAX) umožňuje sériový přístup ke XML. Jde o tzv. proudové zpracování, při kterém se dokument rozdělí na jednotlivé jeho části (počáteční a koncové značky, obsahy elementů, komentáře, atd.). Postupně se pak volají jednotlivé události, které ohlašují nalezení konkrétní části. Způsob zpracování těchto jednotlivých událostí je pak již plně v kompetenci programátora.

Tato metoda vypadá na první pohled velice náročně, své uplatnění však má v konkrétních složitějších způsobech zpracování XML, zvláště tam, kde se k dokumentu nepřistupuje náhodně, ale sekvenčně se postupně čte celý obsah. Její další výhoda spočívá v rychlosti zpracovávání a menší paměťové náročnosti. Oproti DOMu bývá několikrát rychlejší, což u větších dokumentů může značně zkrátit čas vykonávání jednotlivých skriptů.

Příklad použití SAXu v PHP

<?php
	// vytvoření nového SAX parseru
	$this->parser = xml_parser_create();

	// při nalezení počátečního a koncového tagu se bude volat funkce onStartElement() a onEndElement
	xml_set_element_handler($this->parser, "onStartElement", "onEndElement");

	// nastavení funkce pro zpracování obsahu tagů na onContent()
	xml_set_character_data_handler($this->parser, "onContent");

	// postupné čtení vstupního souboru (zde example.xml)
	if ($f = fopen("example.xml","r"))
	{
		// čtení souboru po 4 KB a jeho zpracovávání parserem
		while ($xml_data = fread($f,4096))
			if (!$this->parseString($xml_data, feof($f)))
			{ // vrátí-li metoda nulovou hodnotu, došlo k chybě
				echo "Chyba parsování!";
			}
		fclose($f);
	}

	// tato funkce je volána při nalezení počátečního tagu
	function onStartElement($parser, $elementName, $attributes)
	{
		echo "nalezen počátečni tag s názvem $elementName: ";
		foreach ($attributes as $nazev => $hodnota)
			echo " atribut $nazev = '$hodnota';\n";
		echo "\n";
	}

	// tato funkce je volána při nalezení koncového tagu
	function onEndElement($parser, $elementName)
	{
		echo "nalezen koncový tag s názvem $elementName: ";
	}

	// tato funkce je volána poté, co je znám obsah elementu
	function onContent ($parser, $content)
	{
		echo "obsah elementu: ".$content."<br />" ;
	}
?>