Интерфейс Entity

Все суперинтерфейсы:: Node

public interface Entity extends Node

Этот интерфейс представляет известную сущность в XML-документе, разобранную или неразобранную. Обратите внимание, что он моделирует саму сущность, а не объявление сущности.

Атрибут nodeName, унаследованный от Node, содержит имя сущности.

XML-процессор может полностью раскрыть сущности до передачи структурной модели в DOM; в этом случае в дереве документа не будет узлов EntityReference.

XML не требует от непроверяющего XML-процессора считывать и обрабатывать объявления сущностей из внешнего подмножества или объявленные в параметрических сущностях. Это означает, что некоторые классы приложений могут не раскрывать разобранные сущности, объявленные во внешнем подмножестве, и текст замены сущности может быть недоступен. Если текст замены доступен, список дочерних узлов соответствующего узла Entity представляет структуру этого значения замены. В противном случае список дочерних узлов пуст.

DOM Level 3 не поддерживает редактирование узлов Entity; если пользователь хочет изменить содержимое Entity, каждый связанный узел EntityReference в структурной модели необходимо заменить клоном содержимого Entity, после чего внести нужные изменения в каждый из этих клонов. Узлы Entity и все их потомки доступны только для чтения.

У узла Entity нет родительского узла.

Примечание: Если сущность содержит несвязанный префикс пространства имён, null namespaceURI соответствующего узла в поддереве узла Entity. То же верно для узлов EntityReference, ссылающихся на эту сущность, если они созданы с помощью метода createEntityReference интерфейса Document.

См. также спецификацию объектной модели документа (DOM) Level 3 Core.

Начиная с версии:: 1.4, DOM Level 2

Краткое описание полей

Поля, объявленные в интерфейсе 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()`	Общий идентификатор, связанный с сущностью, если он указан, и `null` в противном случае.
`String`	`getSystemId()`	Системный идентификатор, связанный с сущностью, если он указан, и `null` в противном случае.
`String`	`getXmlEncoding()`	Атрибут, указывающий в составе текстового объявления кодировку этой сущности, если это внешняя разобранная сущность.
`String`	`getXmlVersion()`	Атрибут, указывающий в составе текстового объявления номер версии этой сущности, если это внешняя разобранная сущность.

Методы, объявленные в интерфейсе 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 или относительный URI.

getNotationName

String getNotationName()

Для неразобранных сущностей — имя нотации сущности. Для разобранных сущностей это null.

getInputEncoding

String getInputEncoding()

Атрибут, указывающий кодировку, использованную для этой сущности при разборе, если это внешняя разобранная сущность. Значение null используется, если сущность находится во внутреннем подмножестве или если кодировка неизвестна.

Начиная с версии:: 1.5, DOM Level 3

getXmlEncoding

String getXmlEncoding()

Атрибут, указывающий в составе текстового объявления кодировку этой сущности, если это внешняя разобранная сущность. В противном случае это значение null.

Начиная с версии:: 1.5, DOM Level 3

getXmlVersion

String getXmlVersion()

Атрибут, указывающий в составе текстового объявления номер версии этой сущности, если это внешняя разобранная сущность. В противном случае это значение null.

Начиная с версии:: 1.5, DOM Level 3

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/Entity.html