ILSParser Schnittstelle

Definition

[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

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IDisposable

Hinweise

Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.

LSParser stellt eine API zum Analysieren von XML bereit und erstellt die entsprechende DOM-Dokumentstruktur. Eine LSParser Instanz kann durch Aufrufen der DOMImplementationLS.createLSParser() Methode abgerufen werden.

Wie in [DOM Level 3 Core] angegeben, wenn ein Dokument zum ersten Mal über den LSParser verfügbar gemacht wird: <ul><li> gibt es nie zwei angrenzende Knoten vom Typ NODE_TEXT, und es werden niemals leere Textknoten vorhanden sein. </li li><> es wird erwartet, dass die value und nodeValue die Attribute eines Attr Knotens zunächst den normalisierten XML 1.0-Wert zurückgeben. Wenn die Parameter " validate-if-schema" und " datatype-normalization" jedoch abhängig von der verwendeten Attributnormalisierung festgelegt truesind, können sich die Attributwerte von denen unterscheiden, die durch die XML 1.0-Attributnormalisierung abgerufen wurden. Wenn die Parameter " Datentypnormalisierung" festgelegt falseist, wird die XML 1.0-Attributnormalisierung garantiert auftreten, und wenn die Attributliste keine Namespacedeklarationen enthält, stellt das attributes Attribut auf Element dem Knoten die eigenschaft <b>[attributes]</b> dar, die in [XML Information Set] definiert ist. </li></ul>

Asynchrone LSParser Objekte werden auch die events::EventTarget Schnittstelle implementieren, sodass Ereignislistener für asynchrone LSParser Objekte registriert werden können.

Von asynchronen LSParser Objekten unterstützte Ereignisse sind: <dl<>dt>load</dt><dd> The LSParser finishes to load the document. Siehe auch die Definition der LSLoadEvent Schnittstelle. </dd><dt>progress</dt><dd> The LSParser signals progress as data is parsed. Diese Spezifikation versucht nicht, genau zu definieren, wann Statusereignisse verteilt werden sollen. Dies wird absichtlich als implementierungsabhängig gelassen. Nachfolgend sehen Sie ein Beispiel dafür, wie eine Anwendung Fortschrittsereignisse verteilen kann: Sobald der Parser mit dem Empfangen von Daten beginnt, wird ein Statusereignis verteilt, um anzugeben, dass die Analyse beginnt. Von dort aus wird ein Statusereignis für alle 4096 Byte von Daten verteilt, die empfangen und verarbeitet werden. Dies ist jedoch nur ein Beispiel, und Implementierungen können sich entscheiden, Statusereignisse jederzeit während der Analyse zu verteilen oder überhaupt nicht zu verteilen. Siehe auch die Definition der LSProgressEvent Schnittstelle. </dd></dl>

<b>Hinweis:</b> Alle in dieser Spezifikation definierten Ereignisse verwenden den Namespace-URI "http://www.w3.org/2002/DOMLS".

Beim Analysieren einer Eingabequelle werden Fehler über den Fehlerhandler (LSParser.domConfigder Parameter " error-handler" ) an die Anwendung gemeldet. Diese Spezifikation versucht nicht, alle möglichen Fehler zu definieren, die beim Analysieren von XML oder einem anderen Markup auftreten können, aber einige häufige Fehlerfälle sind definiert. Die Typen (DOMError.type) von Fehlern und Warnungen, die durch diese Spezifikation definiert wurden, sind: <dl><dt>"check-character-normalization-failure" [error]</dt<>dd> Raised, wenn der Parameter "Check-character-normalization" auf "true" festgelegt ist und eine Zeichenfolge gefunden wird, die eine Normalisierungsprüfung fehlschlägt. </dd><dt>"doctype-not-allowed" [fatal]</dt><dd> Raised if the configuration parameter "disallow-doctype" is set to true and a doctype is encountered. </dd><dt>"no-input-specified" [fatal]</dt><dd> Raised beim Laden eines Dokuments und keine Eingabe im LSInput Objekt angegeben ist. </dd><dt>"pi-base-uri-not-preserved" [warning]</dt><dd> Raised if a processing instruction is encountered in a location where the base URI of the processing instruction can not be preserved. Ein Beispiel für einen Fall, in dem diese Warnung ausgelöst wird, ist, wenn der Konfigurationsparameter " entities" auf und false die folgende XML-Datei analysiert wird:

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

Und subdir/myentity.ent enthält:

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

</dd><dt>"unbound-prefix-in-entity" [warning]</dt><dd> Eine implementierungsabhängige Warnung, die ausgelöst werden kann, wenn der Konfigurationsparameter " Namespaces" festgelegt true ist und ein ungebundenes Namespacepräfix im Ersetzungstext einer Entität gefunden wird. Das Auslösen dieser Warnung wird nicht erzwungen, da einige vorhandene Parser möglicherweise keine ungebundenen Namespacepräfixe im Ersetzungstext von Entitäten erkennen. </dd><dt>"unknown-character-denormalization" [fatal]</dt><dd> Raised if the configuration parameter "ignore-unknown-character-denormalizations" is set to false and a character is encountered for which the processor cannot determine the normalization properties. </dd><dt>"unsupported-encoding" [fatal]</dt><dd> Raised, wenn eine nicht unterstützte Codierung gefunden wird. </dd><dt>"unsupported-media-type" [fatal]</dt><dd> Raised, wenn der Konfigurationsparameter "supported-media-types-only" auf und true ein nicht unterstützter Medientyp gefunden wird. </dd></dl>

Neben dem Auslösen der definierten Fehler und Warnungen werden Implementierungen erwartet, dass implementierungsspezifische Fehler und Warnungen für andere Fehler- und Warnungsfälle wie E/A-Fehler (Datei nicht gefunden, Berechtigung verweigert,...), XML-Wohlformheitsfehler usw. ausgelöst werden.

Siehe auch das Dokumentobjektmodell (DOM) Level 3 Load and Save Specification.

Java Dokumentation für org.w3c.dom.ls.LSParser.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.