La classe abstraite SAXParser englobe une implémentation de la classe XMLReader.
En JAXP 1.0, cette classe englobe l'interface Parser. Toutefois, cette interface a été remplacée par XMLReader. Pour une trnasition facile, la classe SAXParser continue de s'appuyer sur le même nom et interface en plus de supporter de nouvelles méthodes. Une instance de cette classe peut être obtenue à partir de la méthode SAXParserFactory.newSAXParser(). Un fois qu'une instance est obtenue, XML peut être analysé à partir d'une variété de sources d'entrée, telles que des flux InputStream, des fichiers, des adresses URL et des sources SAX.
La méthode statique SAXParserFactory.newSAXParser() crée une nouvelle instance de fabrique basée sur le paramètrage des propriétés ou utilise les propriétés définies par défaut de la plateforme sous-jacente.
La classe DefaulHandler utilisée par des méthodes d'analyse, est contenu dans le paquetage org.xml.sax.helpers. Elle foournit une implémentation par défaut pour les gestionnaires SAX, en l'occurrence EntityResolver, DTDHandler, ContentHandler et ErrorHandler.
| Constructeur |
|---|
| Description |
| protected SAXParser() |
| crée une nouvelle instance de la classe SAXParser. Ce constructeur est protégé. |
| Méthode |
|---|
| Description |
| abstract Parser getParser() |
| retourne un analyseur SAX qui est encapsulé par l'implémentation de cette classe. |
| abstract Object getProperty(String name) |
| retourne la propriété correspondant au nom spécifié. |
| Schema getSchema() |
| retourne une référence au schéma utilisé par le processeur XML. |
| abstract XMLReader getXMLReader() |
| retourne un objet XMLReader qui est encapsulé par l'implémentation de cette classe. |
| abstract boolean isNamespaceAware() |
| indique si la fabrique est configurée pour produire des analyseurs qui prennent en compte les espaces de noms. |
| abstract boolean isValidating() |
| indique si la fabrique est configurée pour produire des analyseurs qui valident le contenu XML durant l'analyse. |
| boolean isXIncludeAware() |
| indique l'état du traitement des inclusions XML (XInclude). |
| void parse(File fichier, DefaultHandler gestionnaire) |
| analyse le contenu du fichier en utilisant le gestionnaire spécifié. |
| void parse(File f, HandlerBase hb) |
| Dépréciée car la classe org.xml.sax.HandlerBase est dépréciée. |
| void parse(InputSource is, DefaultHandler dh) |
| analyse le contenu de l'objet InputSource en utilisant le gestionnaire spécifié. |
| void parse(InputSource is, HandlerBase hb) |
| Dépréciée car la classe org.xml.sax.HandlerBase est dépréciée. |
| void parse(InputStream is, DefaultHandler dh) |
| analyse le contenu du flux InputStream en utilisant le gestionnaire spécifié. |
| void parse(InputStream is, DefaultHandler dh, String systemId) |
| analyse le contenu du flux InputStream en utilisant le gestionnaire spécifié. Le paramètre IDSysteme constitue une base pour résoudre les adresses URI relatives. |
| void parse(InputStream is, HandlerBase hb) |
| Dépréciée car la classe org.xml.sax.HandlerBase est dépréciée. |
| void parse(InputStream is, HandlerBase hb, String systemId) |
| Dépréciée car la classe org.xml.sax.HandlerBase est dépréciée. |
| void parse(String uri, DefaultHandler dh) |
| analyse le contenu de l'adresse URI en utilisant le gestionnaire spécifié. |
| void parse(String uri, HandlerBase hb) |
| Dépréciée car la classe org.xml.sax.HandlerBase est dépréciée. |
| void reset() |
| réinitialise l'objet SAXParser à sa configration initiale. |
| abstract void setProperty(String name, Object value) |
| fixe la valeur de la propriété spécifiée. |
| Les méthodes héritées de la classe java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |