JavaTM 2 Platform
Standard Ed. 5.0

org.w3c.dom
インタフェース Entity

すべてのスーパーインタフェース:
Node

public interface Entity
extends Node

このインタフェースは、XML 文書内の解析対象または解析対象外の既知のエンティティを表します。このインタフェースによってモデル化されるのは、「エンティティ宣言ではなく」エンティティ自体です。

Node を継承する nodeName 属性には、エンティティ名が含まれています。

XML プロセッサは、構造モデルを DOM に渡す前にエンティティを完全に展開できます。展開が行われた場合、文書ツリー内に EntityReference ノードは作成されません。

XML では、外部サブセット内で作成されたエンティティ宣言、またはパラメータエンティティ内で宣言されたエンティティ宣言の非検証 XML プロセッサによる読み取りおよび処理は義務付けられていません。つまり、外部サブセット内に宣言された解析対象エンティティを、アプリケーションクラスを使用して展開する必要はありません。また、エンティティの置換テキストは使用できない可能性があります。置換テキストが使用できる場合、対応する Entity ノードの子リストは、その置換値の構造を表します。使用できない場合、子リストは空です。

DOM レベル 3 は、Entity ノードの編集をサポートしません。Entity のコンテンツに変更を加えたい場合は、Entity のコンテンツの複製で構造モデル内の関連の EntityReference ノードを置き換え、これらの複製に必要な変更を加えます。Entity ノードとその子孫は読み取り専用です。

Entity ノードは親ノードを持ちません。

注: エンティティに未バインドの名前空間接頭辞が含まれている場合、Entity ノードのサブツリーにある対応するノードの namespaceURInull になります。このエンティティを参照する EntityReference ノードが Document インタフェースの createEntityReference メソッドを使用して作成されている場合も同様です。

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


フィールドの概要
 
インタフェース org.w3c.dom.Node から継承されたフィールド
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
メソッドの概要
 String getInputEncoding()
          エンティティが外部解析対象エンティティである場合は、解析時にこのエンティティに使用されるエンコーディングを指定する属性。
 String getNotationName()
          解析対象外エンティティの場合はエンティティの表記法の名前。
 String getPublicId()
          エンティティに関連する公開識別子 (指定されている場合)。
 String getSystemId()
          エンティティに関連するシステム識別子 (指定されている場合)。
 String getXmlEncoding()
          エンティティが外部解析対象エンティティである場合に、テキスト宣言の一部として、このエンティティのエンコーディングを指定する属性。
 String getXmlVersion()
          エンティティが外部解析対象エンティティである場合に、テキスト宣言の一部として、このエンティティのバージョン番号を指定する属性。
 
インタフェース org.w3c.dom.Node から継承されたメソッド
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
 

メソッドの詳細

getPublicId

String getPublicId()
エンティティに関連する公開識別子 (指定されている場合)。指定されていない場合は null になります。


getSystemId

String getSystemId()
エンティティに関連するシステム識別子 (指定されている場合)。指定されていない場合は null。システム識別子は、絶対 URI の場合もあり、そうでない場合もあります。


getNotationName

String getNotationName()
解析対象外エンティティの場合はエンティティの表記法の名前。解析対象エンティティの場合は null になります。


getInputEncoding

String getInputEncoding()
エンティティが外部解析対象エンティティである場合は、解析時にこのエンティティに使用されるエンコーディングを指定する属性。エンティティが内部サブセットのエンティティであるか、未知の場合は null になります。

導入されたバージョン:
DOM Level 3

getXmlEncoding

String getXmlEncoding()
エンティティが外部解析対象エンティティである場合に、テキスト宣言の一部として、このエンティティのエンコーディングを指定する属性。外部解析対象エンティティでない場合は null になります。

導入されたバージョン:
DOM Level 3

getXmlVersion

String getXmlVersion()
エンティティが外部解析対象エンティティである場合に、テキスト宣言の一部として、このエンティティのバージョン番号を指定する属性。外部解析対象エンティティでない場合は null になります。

導入されたバージョン:
DOM Level 3

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。