Rozhraní SAX, SAX vs. SAX2 Jaroslav Ciml
Použití SAX - připomenutí Vytvoření instance parseru XMLReader xmlreader = XMLReaderFactory.createXMLReader(); Registrace handleru xmlreader.setcontenthandler( contenthandler); Parsování xmlreader.parse(inputsource); Třída InputSouce zapouzdřuje různé způsoby předání XML dokumentu ( InputStream, Reader, systemid)
Atributy Zpracování atrubut ů zajišťuje ContentHandler jako reakci na událost startelement void startelement(string uri, String localname, String qname, Attributes atts) Rozhraní Attributes reprezentuje množinu všech atribut ů uvedených v otevíracím tagu elementu 3 možnosti přístupu k jednotlivým atributům pomocí indexu pomocí jména atributu (raw name) pomocí namespace a lokálního jména atributu
Atributy - příklad Atribut bez namespace <lastname lang="en">smith</lastname> kvalifikované jméno (raw, prefixed, qualified name) namespace (uri) lokální jméno (local name) Atribut s namespace lang prázdný řetězec lang <rootelem xmlns:ns= http://www.mff.cuni.cz/namespace > <lastname ns:lang="en">smith</lastname> </rootelem> kvalifikované jméno ns:lang namespace (uri) http://www.mff.cuni.cz/namespace lokální jméno lang
Metody rozhraní Attributes Přístup přes index int getlength() String getqname(int index) String geturi(int index) String getlocalname(int index) String getvalue(int index) Přístup přes jméno atributu String getvalue(string qname) Přístup přes namespace a lokální jméno String getvalue(string uri, String localname)
Atributy - dodatky Pokud nemá parser zapnutou podporu namespaces, je k dispozici pouze kvalifikované jméno Přístup přes kvalifikované jméno nemusí fungovat správn ě, pokud nemá parser nastavenou vlastnost xmlreader.setfeature( http://xml.org/sax/features/namespace-prefixes, true); Rozhraní Attributes existuje až od SAX 2.0, v SAX 1.0 rozhraní AttributeList bez podpory namespaces (pouze raw names)
Handlery U parseru lze zaregistrovat 4 handlery třídy implementující následující rozhraní ContentHandler ErrorHandler DTDHandler EntityResolver Všechna rozhraní implementuje třída DefaultHandler (těla všech metod jsou prázdná)
ContentHandler startdocument, enddocument, startelement, endelement characters, ignorablewhitespace Mapování prefixu na namespace void startprefixmapping(string prefix, String uri) void endprefixmapping(string prefix) Příklad <rootelem xmlns:ns= http://www.mff.cuni.cz/namespace > při vstup do elementu (ješt ě před událostí startelement) zavolá parser metodu startprefixmapping( ns, http://www.mff.cuni.cz/namespace )
ContentHandler Pro deklarace <?target data?> se volá void processinginstruction( String target, String data) metoda se nezavolá pro deklaraci xml <?xml version= 1.0?> Lokátor Parser ješt ě před událostí startdocument zavolá metodu void setdocumentlocator(locator locator) Klientský kód si může instanci typu Locator uložit Během parsování dokumentu (mezi událostmi startdocument a enddocument) se lze dotazovat na pozici int getlinenumber() int getcolumnnumber()
ErrorHandler void fatalerror( SAXParseException exception) nezotavitelná chyba (typicky: dokument není dobře formovaný) void error( SAXParseException exception) zotavitelná chyba (typicky: dokument není validní) void warning( SAXParseException exception) Po zpracování události error nebo warning pokračuje parsování dokumentu. Klientský kód může parsování dokumentu ukončit vyhozením výjimky SAXException.
DTDHandler, EntityResolver DTDHandler umožňuje reagovat pouze na neparsované entity a notace <!DOCTYPE document [ <!NOTATION WAV SYSTEM "/usr/local/bin/wave_player"> <!ENTITY music SYSTEM "drop.wav" NDATA WAV> ]> <document> <sound what="music"/> </document> EntityResolver zpracovává externí entity (nap. ř odkaz na externí DTD)
Handlery SAX 1.0 V SAX 1.0 opět chybí podpora namespaces Rozhraní DocumentHandler (místo ContentHandler) používá pouze raw names chybí metody startprefixmapping, endprefixmapping Defaultní implementace handler ů třída HandlerBase (místo DefaultHandler)
Parsery Vytvoření instance parseru XMLReader xmlreader = XMLReaderFactory.createXMLReader(); Registrace handleru xmlreader.setcontenthandler(contenthandler); xmlreader.seterrorhandler(errorhandler); xmlreader.setdtdhandler(dtdhandler); xmlreader.setentityresolver(entityresolver); Parsování xmlreader.parse(inputsource);
Parsery features, properties void setproperty(string name, Object value) nastavuje vlastnosti parseru formou dvojic jméno-hodnota p ř.: nastavení validace podle XML Schema xmlreader.setproperty( http://java.sun.com/xml/jaxp/properties/schemalanguage, http://www.w3.org/2001/xmlschema ); void setfeature(string name, boolean value) zapíná / vypíná vlastnosti parseru p ř.: zapnutí validace některých časov ě náročných podmínek (například omezení unique) xmlreader.setproperty( http://apache.org/xml/features/validation/ + schema-full-checking, true);
Parsery SAX 1.0 Vytvoření instance parseru Parser parser = ParserFactory.makeParser(); Rozhraní Parser nepodporuje namespaces, nepodporuje properties ani features, ke všem setter metodám chybí getter metody Z instance typu Parser lze vytvořit objekt chovající se jako XMLReader a naopak XMLReader xmlreader = new ParserAdapter(parser); Parser parser = new XMLReaderAdapter(xmlReader);
Parsery alternativní přístup Vytvoření továrny SAXParserFactory factory = SAXParserFactory.newInstance(); Na továrn ě lze nastavit setfeature(string name, boolean value) void setvalidating(boolean validating) void setnamespaceaware(boolean awareness) Vytvoření parseru SAXParser saxparser = factory.newparser(); Vzniklý parser v sob ě obsahuje instanci typu Parser i instanci typu XMLReader (dostupné pomocí metod getparser, getxmlreader)
Parsery alternativní přístup Na parseru lze nastavit properties void setproperty(string name, Object value) Spousta variant přetížené metody parse, všechny mají parametry XML dokument (InputStream, InputSource, URI, File) Implementace handler ů ( DefaultHandler, HandlerBase)
Filtry Filtry umožňují změnit události, které se dostávají k obslužným metodám handler ů (nap ř. lze pro každou událost startelement vygenerovat atribut id) Filtry jsou objekty implementující rozhraní XMLFilter interface XMLFilter extends XMLReader Třída XMLFilterImpl je defaultní implementací XMLFilter. Nový filtr se typicky vytvoří zděděním této třídy.
Přidání filtru Obyčejné použití parseru vytvoření instance parseru nastavení handlerů volání metody parse Použití parseru s filtrem vytvoření instance parseru přidání filtru XMLReader filteringxmlreader = new XMLFilterImpl( xmlreader); nastavení handlerů (na objektu filteringxmlreader) volání metody parse (na filteringxmlreader)
Jak funguje XMLFilterImpl XMLFilterImpl si zapamatuje skutečný parser předaný jako parametr konstruktoru XMLFilterImpl si zapamatuje všechny nastavené handlery jako své atributy (dostupné přes metody getcontenthandler,...) Při volání metody parse nejprve XMLFilterImpl zaregistruje u parseru sebe (implementuje všechny handler rozhraní). Poté deleguje na parser volání parse. Metody startelement,... definované třídou XMLFilterImpl pouze delegují volání na uložené handlery. Předpokládá se, že potomci předefinují toto chování.
Zdroje http://xml.apache.org/xerces-j http://www.saxproject.org http://www.cafeconleche.org/books/xmljava