Simple API for XML (SAX) Ulrich Hoffmann

Größe: px

Ab Seite anzeigen:

Download "Simple API for XML (SAX) Ulrich Hoffmann"

Erwin Lehmann
vor 6 Jahren
Abrufe

1 Simple API for XML (SAX) Ulrich Hoffmann 1

2 Simple API für XML (SAX) Ereignisbasierte Verarbeitung von XML Programmiersprachunabhängig: Implementierungen in Java, C++, Python, Perl, Eiffel Java: SAX2 Bestandteil JDK seit 1.4: Java APIs for XML Processing (JAXP) 2

3 Komponenten einer SAX-Applikation Kontrolle Parser Handler Applikation XML-Daten Files GUI usw. 3

4 Struktur von SAX ParserFactory Erzeugen unterschiedlicher Parser ausprägungen (validierend/nichtvalidierend, Namespaces) Parser SAX definiert nur abstrake Schnittstellen Implementierungen bieten meist Standardimplementierungen 4

5 Parser Schnittstellen ContentHandler: Dokumentereignisse startelement, processinginstruction,... ErrorHandler: Fehlerklassen error, fatalerror, warning DTDHandler: Notations, unparsed Entities EntityResolver: Entities 5

6 SAX-Ausführungsmodell Handler behandeln Ereignisse (Call Backs) Kein durchgängiger Programmfluss geringer Speicherverbrauch (XML > RAM) Push-Modell Keine Änderung des XMLs möglich 6

7 Struktur eines SAX-Programms Handler-Definitionen durch Implementierung der SAX-Schnittstellen (oder erben aus der Standardimplementierung DefaultHandler) Hauptprogramm: ParserFactory erzeugen (newinstance) ggf. ParserFactory konfigurieren Parser erzeugen (newsaxparser) parse-methode aufrufen 7

8 Gerüst für SAX-Programm import org.xml.sax.helpers.defaulthandler; import javax.xml.parsers.saxparser; import javax.xml.parsers.saxparserfactory; public class SAXExample1 extends DefaultHandler { public void startdocument() { System.out.println("document started"); public void enddocument() { System.out.println("document ended"); public static void main(string args[]) throws Exception { SAXParserFactory spf = SAXParserFactory.newInstance(); SAXParser sp = spf.newsaxparser(); sp.parse(args[0], new SAXExample1()); 8

9 Die ContentHandler-Schnittstelle startdocument() Operation processinginstruction(string target, String data) startelement(string namespaceuri, String localname, String qname, Attributes atts) characters(char[] ch, int start, int length) ignorablewhitespace(char[] ch, int start, int length) endelement(string namespaceuri, String localname, String qname) startprefixmapping(string prefix, String uri) endprefixmapping(string prefix) enddocument() Funktionalität Dokumentenbeginn Verarbeitungsanweisungen Öffnendes Tags Element-Text ignorierbare Leerzeichen Schliessende Tags Gültigkeitsbeginn Präfix Gültigkeitsende Präfix Dokumentenende 9

10 SAX-Dokumentation Homepage des SAX-Projekts: Java API-Dokumentation: api/org/xml/sax/package-summary.html 10

11 Konfigurieren der ParserFactory Aktivierung der Funktionalität für Namensräume und Validierung SpezialMethoden am ParserFactoryObjekt: setnamespaceaware(bool); setvalidating(bool); Generele Methode am ParserFactoryObjekt: setfeature(string, bool); 11

12 Fehlerbehandlung Für Fehler während der XML-Bearbeitung mit SAX werden SAXExceptions ausgelöst: SaxNotRecognizedException Initialisierung, falsche Parametrierung SaxParseException während des Parsens - Wohlgeformtheit SaxNotSupportedException Parametrierung richtig aber nicht unterstützt 12

13 SaxParseException Exceptionobjekt hat Methoden um die Fehlerstelle zu lokalisieren: getcolumnnumber getlinenumber getsystemid / getpublicid 13

14 Fehlerbehandlungsbeispiel import org.xml.sax.saxparseexception; import org.xml.sax.helpers.defaulthandler; import javax.xml.parsers.saxparser; import javax.xml.parsers.saxparserfactory; public class SAXExample2 extends DefaultHandler { public static void main(string args[]) throws Exception { SAXParserFactory spf = SAXParserFactory.newInstance(); SAXParser sp = spf.newsaxparser(); try { sp.parse(args[0], new SAXExample2()); catch (SAXParseException spe) { System.out.println("A SAXParseException occured...\n" + "at column " + spe.getcolumnnumber() + "\n" + "at line " + spe.getlinenumber() + "\n" + "public identifier of document is: " + spe.getpublicid() + "\n" + "system identifier of document is: " + spe.getsystemid()); 14

Ähnliche Dokumente

Semistrukturierte Daten

Teil 6: SAX Semistrukturierte Daten Sommersemester 2007 6.1. Überblick 6.2. ContentHandler 6.3. weitere Event Handler 6.4. XMLReader 6.5. Benutzung von SAX in JAXP 6.6. SAX-Filter 6.7. Epilog 6.1. Überblick