Интерфейс сущности

public interface Entity
extends Node

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

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

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

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

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

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

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

См. также Спецификацию ядра Объектной модели документа (DOM) уровня 3.

Методы

getPublicId

String getPublicId()

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

getSystemId

String getSystemId()

Системный идентификатор, связанный с сущностью, если он задан, и null в противном случае. Это может быть абсолютный URI или нет.

getNotationName

String getNotationName()

Для непроанализированных сущностей – имя нотации для сущности. Для проанализированных сущностей это null.

getInputEncoding

String getInputEncoding()

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

Since:

DOM Level 3

getXmlEncoding

String getXmlEncoding()

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

Since:

DOM Level 3

getXmlVersion

String getXmlVersion()

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

Since:

DOM Level 3