Entity

(Auszug aus "XML in a Nutshell" von Elliotte Rusty Harold & W. Scott Means)

Das Entity-Objekt repräsentiert einen Wert, der ein konkretes, allgemeines XML-Entity ersetzt. Ob der DOM-Benutzer Entity-Objekte tatsächlich zu sehen bekommt, hängt davon ab, ob die jeweilige Implementierung validiert und ob Entity-Referenzen automatisch ersetzt werden oder nicht.

Java-Beispiel

// Finde die Deklaration des Entity mein_entity.
Entity ndEnt = (Entity)doc.getDoctype().getEntities(  ).
    getNamedItem("mein_entity");

 


Attribute

Ein Entity-Objekt besitzt die folgenden Attribute, die allesamt nur-lesbar sind:

 


inputEncoding: DOMString (3)

Liefert die Zeichenkodierung, die zur Parse-Zeit für ein externes geparstes Entity ermittelt wurde. Mehr Informationen zu Zeichenkodierungen finden Sie unter Internationalisierung. Bei internen geparsten Entities oder wenn die Kodierung nicht bekannt ist, hat das Attribut den Wert null. Nur-lesbar.

Java-Bindung
public String getInputEncoding( );

 


notationName: DOMString

Falls das Entity nicht vom Parser ersetzt wird, ist dies der Notationsname des Entity. Andernfalls erhält dieses Attribut den Wert null.

Java-Bindung
public String getNotationName( );

Java-Beispiel

 

// Ist dies ein vom Parser zu ersetzendes Entity?
boolean fParsedEnt = ndEnt.getNotationName(  ) == null;

 


publicId: DOMString

Der PUBLIC-Identifier (ein URI) des Entitys oder null, falls keine angegeben wurde.

Java-Bindung
public String getPublicId( );

 


systemId: DOMString

Der SYSTEM-Identifier (ein URI) des Entitys oder null, falls keine angegeben wurde.

Java-Bindung
public String getSystemId( );

Java-Beispiel

// Lies PUBLIC- oder SYSTEM-Identifier dieses Entitys.
Entity ndEnt = (Entity)doc.getDoctype().getEntities(  ).getNamedItem("my_ entity");

String strURL = ndEnt.getPublicId(  );

// Wenn es keinen PUBLIC-Identifier gibt, ...
if (strURL == null) {
    // ... nehmen wir den SYSTEM-Identifier.
    strURL = ndEnt.getSystemId(  );
}

 

 


xmlEncoding: DOMString (3)

 

Liefert die Zeichenkodierung, die im encoding-Pseudo-Attribut der Text-Deklaration für ein externes geparstes Entity angegeben wurde. Ist keine Text-Deklaration vorhanden, ist der Wert null. Nur-lesbar.

Java-Bindung
public String getXmlEncoding( );

 


xmlVersion: DOMString (3)

Liefert den Wert des version-Pseudo-Attributs der Text-Deklaration eines externen geparsten Entitys. Ist keine Text-Deklaration vorhanden, ist der Wert null. Nur-lesbar.

Java-Bindung
public String getXmlVersion( );

 


Methoden

Das Objekt Entity hat keine Methoden.

 

  

<< zurück vor >>

 

 

 

Tipp der data2type-Redaktion:
Zum Thema XML bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

  


Copyright © 2005 O'Reilly Verlag GmbH & Co. KG
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XML in a Nutshell" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

O’Reilly Verlag GmbH & Co. KG, Balthasarstraße 81, 50670 Köln, kommentar(at)oreilly.de