モジュール java.xml
パッケージ org.w3c.dom

インタフェースEntityReference

  • すべてのスーパー・インタフェース:
    Node
    public interface EntityReference
extends Node
    EntityReferenceノードを使用してツリーのエンティティ参照を表現できます。 文字がエンティティ参照ではなく同等のUnicodeで表現されるように、文字参照と事前定義済みエンティティへの参照が、HTMLプロセッサかXMLプロセッサによって展開されます。 さらに、XMLプロセッサはEntityReferenceノードを提供する代わりに、Documentの構築中にエンティティへの参照を完全に展開できます。 このようなノードが提供される場合は、既知のエンティティへの参照を表すEntityReferenceノードに対してEntityが存在し、EntityReferenceノードのサブツリーはEntityノードのサブツリーのコピーになります。 ただし、バインドされていない名前空間の接頭辞がエンティティに含まれる場合は例外です。 この場合、名前空間の接頭辞の解決はエンティティ参照の場所に依存するため、EntityReferenceノードの子孫が別の名前空間URIにバインドされている可能性があります。 EntityReferenceノードが未知のエンティティへの参照を表す場合、そのノードは子やその置換値を持たず、たとえばAttr.valueで使用されると空になります。

    Entityノードから見ると、EntityReferenceノードとその子孫はすべて読取り専用です。

    注: EntityReferenceノードは、エンティティ参照が展開されたあと、XML 1.0やXMLスキーマなどで正規化が実行されると、要素コンテンツと属性値の正規化で問題を生じる可能性があります。

    「Document Object Model (DOM) Level 3 Core Specification」も参照してください。