ILSParser Interfaccia

Definizione

[Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")]
public interface ILSParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")>]
type ILSParser = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable IDisposable

Commenti

Interfaccia a un oggetto in grado di compilare o aumentare un albero DOM da varie origini di input.

LSParser fornisce un'API per l'analisi xml e la compilazione della struttura del documento DOM corrispondente. È possibile ottenere un'istanza LSParser richiamando il DOMImplementationLS.createLSParser() metodo .

Come specificato in [DOM Level 3 Core] , quando un documento viene reso disponibile per la prima volta tramite LSParser: <ul><li> non ci saranno mai due nodi adiacenti di tipo NODE_TEXT e non ci saranno mai nodi di testo vuoti. </li><li> è previsto che gli value attributi e nodeValue di un Attr nodo restituiscono inizialmente il valore normalizzato XML 1.0. Tuttavia, se i parametri " validate-if-schema" e " datatype-normalization" vengono impostati su true, a seconda della normalizzazione degli attributi usata, i valori degli attributi possono differire da quelli ottenuti dalla normalizzazione dell'attributo XML 1.0. Se i parametri " normalizzazione dei tipi di dati" sono impostati su false, viene garantita la normalizzazione dell'attributo XML 1.0 e, se l'elenco di attributi non contiene dichiarazioni di spazio dei nomi, l'attributo attributes sul Element nodo rappresenta la proprietà <b>[attributes]</b> definita in [XML Information Set] . </li></ul>

Gli oggetti asincroni LSParser devono implementare anche l'interfaccia events::EventTarget in modo che i listener di eventi possano essere registrati su oggetti asincroni LSParser .

Gli eventi supportati dagli oggetti asincroni LSParser sono: <dl<>dt>load</dt><dd> Termina LSParser per caricare il documento. Vedere anche la definizione dell'interfaccia LSLoadEvent . </dd><dt>progress</dt><dd> Lo LSParser stato di avanzamento dei segnali durante l'analisi dei dati. Questa specifica non tenta di definire esattamente quando devono essere inviati gli eventi di stato. Ciò viene lasciato intenzionalmente come dipendente dall'implementazione. Di seguito è riportato un esempio di come un'applicazione potrebbe inviare eventi di stato: dopo che il parser inizia a ricevere i dati, viene inviato un evento di stato per indicare che l'analisi viene avviata. Da qui in poi, viene inviato un evento di stato per ogni 4096 byte di dati ricevuti ed elaborati. Questo è solo un esempio, tuttavia, e le implementazioni possono scegliere di inviare eventi di stato in qualsiasi momento durante l'analisi o non inviarli affatto. Vedere anche la definizione dell'interfaccia LSProgressEvent . </dd></dl><p ><b>Nota:</b> Tutti gli eventi definiti in questa specifica usano l'URI "http://www.w3.org/2002/DOMLS"dello spazio dei nomi .

Durante l'analisi di un'origine di input, gli errori vengono segnalati all'applicazione tramite il gestore degli errori (LSParser.domConfigparametro " error-handler"). Questa specifica non tenta in alcun modo di definire tutti i possibili errori che possono verificarsi durante l'analisi di XML o qualsiasi altro markup, ma vengono definiti alcuni casi di errore comuni. I tipi (DOMError.type) di errori e avvisi definiti da questa specifica sono: <dl<>dt"check-character-normalization-failure" [error]<>/dt dd<>> Raised se il parametro " check-character-normalization" è impostato su true e viene rilevata una stringa che non riesce a normalizzare il controllo. </dd><dt/dt><"doctype-not-allowed" [fatal]<> dd> Generato se il parametro di configurazione "disallow-doctype" è impostato su true e viene rilevato un doctype. </dd><dt/dt><"no-input-specified" [fatal]<> dd> Generato durante il caricamento di un documento e non viene specificato alcun input nell'oggetto .LSInput </dd><dt/dt><<>"pi-base-uri-not-preserved" [warning] dd> Generato se viene rilevata un'istruzione di elaborazione in una posizione in cui non è possibile mantenere l'URI di base dell'istruzione di elaborazione. Un esempio di caso in cui verrà generato questo avviso è se il parametro di configurazione " entities" è impostato su false e viene analizzato il file XML seguente:

<!DOCTYPE root [ <!ENTITY e SYSTEM 'subdir/myentity.ent' ]>
            <root> &e; </root>

E subdir/myentity.ent contiene:

<one> <two/> </one> <?pi 3.14159?>
            <more/>

</dd><dt/dt><>"unbound-prefix-in-entity" [warning]< dd> Avviso dipendente dall'implementazione che può essere generato se il parametro di configurazione " namespaces" è impostato su true e viene rilevato un prefisso dello spazio dei nomi non associato nel testo di sostituzione di un'entità. La generazione di questo avviso non viene applicata perché alcuni parser esistenti potrebbero non riconoscere prefissi dello spazio dei nomi non associati nel testo sostitutivo delle entità. </dd><dt/dt><"unknown-character-denormalization" [fatal]<> dd> Generato se il parametro di configurazione "ignore-unknown-character-denormalizations" è impostato su false e viene rilevato un carattere per il quale il processore non è in grado di determinare le proprietà di normalizzazione. </dd><dt/dt<"unsupported-encoding" [fatal]> dd>>< Generato se viene rilevata una codifica non supportata. </dd><dt/dt><"unsupported-media-type" [fatal]<> dd> Generato se il parametro di configurazione "supported-media-types-only" è impostato su true e viene rilevato un tipo di supporto non supportato. </dd></dl>

Oltre a generare gli errori e gli avvisi definiti, è previsto che le implementazioni generino errori e avvisi specifici dell'implementazione per eventuali altri casi di errore e avvisi, ad esempio errori di I/O (file non trovato, autorizzazione negata,...), errori di correttezza XML e così via.

Vedere anche Document Object Model (DOM) Level 3 Load and Save Specification (Load and Save Specification).

Documentazione java per org.w3c.dom.ls.LSParser.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Campi

Proprietà

Metodi

Metodi di estensione

Si applica a