13.10.4 Oggetti ErrorHandler

Gli oggetti con questa interfaccia vengono utilizzati per ricevere informazioni di errore o avvertimento da XMLReader. Se si crea un oggetto che implementa questa interfaccia e lo si registra con XMLReader, il parser chiamer� i metodi di questo oggetto per segnalare tutti gli errori e gli avvertimenti. Sono disponibili tre livelli di errore: avvertimenti, errori (potenzialmente) recuperabili, ed errori irrecuperabili. Tutti i metodi ricevono un oggetto SAXParseException come unico parametro. Errori ed avvertimenti possono essere convertiti in un'eccezione sollevando a loro volta l'eccezione passata in ingresso come oggetto eccezione.

error( exception): Chiamato quando il parser incontra un errore recuperabile. Se questo metodo non solleva un'eccezione, l'analisi pu� continuare, ma l'applicazione non si deve aspettare l'informazione contenuta nel documento successiva all'errore. Il fatto di permettere al parser di continuare l'analisi pu� risultare utile per l'identificazione di ulteriori errori all'interno del documento.

fatalError( exception): Chiamato quando il parser incontra un errore che non � in grado di recuperare; ci si aspetta che l'analisi termini una volta terminata l'esecuzione del metodo.

warning( exception): Chiamato quando il parser segnala degli avvertimenti all'applicazione. L'analisi ci si aspetta continui una volta terminata l'esecuzione di questo metodo, e l'informazione contenuta nel documento successiva alla segnalazione continuer� ad essere restituita all'applicazione. Sollevare un'eccezione in questo metodo causer� la fine dell'analisi.

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