13.12.1 Oggetti XMLReader

L'interfaccia XMLReader supporta i seguenti metodi:

parse( source): Processa un codice in ingresso, producendo eventi SAX. L'oggetto source pu� essere un identificatore di sistema (una stringa identificante il codice sorgente - tipicamente un nome di un file o di una URL), un oggetto simile a file, o un oggetto InputSource. Quando parse() ritorna, l'input � stato completamente processato e l'oggetto parser pu� essere abbandonato o resettato. Come limitazione la corrente implementazione accetta flussi di byte. I futuri studi vanno nella direzione dei flussi di caratteri.

setContentHandler( handler): Imposta il corrente ContentHandler. Se nessun ContentHandler viene impostato, gli eventi contenuti vengono abbandonati.

setDTDHandler( handler): Imposta il corrente DTDHandler. Se nessun DTDHandler viene assegnato, gli eventi DTD vengono abbandonati.

setEntityResolver( handler): Imposta il corrente EntityResolver. Se nessun EntityResolver viene assegnato, tenta di risolvere un'entit� esterna che risulter� nell'apertura di un identificatore di sistema per l'entit� e fallisce se non � disponibile.

setErrorHandler( handler): Imposta il corrente gestore di errori. Se ErrorHandler non viene impostata, l'errore sollever� un'eccezione e verranno stampati gli avvertimenti.

setLocale( locale): Consente ad un'applicazione di impostare l'ambiente per errori ed avvisi.
I parser SAX non vengono richiesti per fornire la localizzazione se non supportano l'ambiente richiesto. Comunque dovranno lanciare un'eccezione SAX. Applicazioni possono richiedere cambiamenti dell'ambiente locale nel mezzo di un'analisi.

getFeature( featurename): Restituisce la corrente impostazione per la funzionalit� featurename. Se la funzionalit� non viene riconosciuta verr� sollevata un'eccezione SAXNotRecognizedException. Le ben conosciute funzionalit� sui nomi vengono elencate nel modulo xml.sax.handler.

setFeature( featurename, value): Imposta featurename a value. Se una funzionalit� non viene riconosciuta, viene sollevata un'eccezione SAXNotRecognizedException. Se la funzionalit� o la sua impostazione non � supportata dal parser, viene sollevata un'eccezione SAXNotRecognizedException.

getProperty( propertyname): Restituisce la corrente impostazione della propriet� propertyname. Se la propriet� non viene riconosciuta, verr� sollevata un'eccezione SAXNotRecognizedException. Le ben conosciute propertyname vengono elencate nel modulo xml.sax.handler.

setProperty( propertyname, value): Imposta propertyname a value. Se la propriet� non viene riconosciuta, viene sollevata l'eccezione SAXNotRecognizedException. Se la propriet� o la sua impostazione non sono supportate dal parser viene sollevata l'eccezione SAXNotSupportedException.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.