Интерфейс LSSerializerFilter
- Все суперинтерфейсы:
NodeFilter
public interface LSSerializerFilter extends NodeFilter
LSSerializerFilter предоставляют приложениям возможность проверять узлы во время их сериализации и решать, какие узлы следует сериализовать. Интерфейс LSSerializerFilter основан на интерфейсе NodeFilter, определённом в [Обход DOM уровня 2 и диапазоны] . Document, DocumentType, DocumentFragment, Notation, Entity и дочерние узлы Attr не передаются фильтру. Дочерние узлы узла EntityReference передаются фильтру только в том случае, если узел EntityReference пропускается методом LSParserFilter.acceptNode().
При сериализации Element элемент передаётся фильтру до передачи ему любых атрибутов этого элемента. Атрибуты объявлений пространств имён и атрибуты по умолчанию (кроме случая, когда параметру " discard-default-content" присвоено значение false) никогда не передаются фильтру.
Результат любой попытки изменить узел, переданный LSSerializerFilter, зависит от реализации.
DOM-приложения не должны выбрасывать исключения в фильтре. Последствия выбрасывания исключений из фильтра зависят от реализации DOM.
Для повышения эффективности узел, передаваемый фильтру, может отличаться от узла, фактически находящегося в дереве. Кроме того, фактический узел (идентичность объекта узла) может повторно использоваться в процессе фильтрации и сериализации документа.
См. также Спецификацию объектной модели документа (DOM) уровня 3: загрузка и сохранение.
- Начиная с версии:
- 1.5
Краткое описание полей
Поля, объявленные в интерфейсе NodeFilter
FILTER_ACCEPT, FILTER_REJECT, FILTER_SKIP, SHOW_ALL, SHOW_ATTRIBUTE, SHOW_CDATA_SECTION, SHOW_COMMENT, SHOW_DOCUMENT, SHOW_DOCUMENT_FRAGMENT, SHOW_DOCUMENT_TYPE, SHOW_ELEMENT, SHOW_ENTITY, SHOW_ENTITY_REFERENCE, SHOW_NOTATION, SHOW_PROCESSING_INSTRUCTION, SHOW_TEXT | Модификатор и тип | Поле | Описание |
|---|---|---|
static final short |
FILTER_ACCEPT |
Принять узел. |
static final short |
FILTER_REJECT |
Отклонить узел. |
static final short |
FILTER_SKIP |
Пропустить только этот узел. |
static final int |
SHOW_ALL |
Показывать все Nodes. |
static final int |
SHOW_ATTRIBUTE |
Показывать узлы Attr. |
static final int |
SHOW_CDATA_SECTION |
Показывать узлы CDATASection. |
static final int |
SHOW_COMMENT |
Показывать узлы Comment. |
static final int |
SHOW_DOCUMENT |
Показывать узлы Document. |
static final int |
SHOW_DOCUMENT_FRAGMENT |
Показывать узлы DocumentFragment. |
static final int |
SHOW_DOCUMENT_TYPE |
Показывать узлы DocumentType. |
static final int |
SHOW_ELEMENT |
Показывать узлы Element. |
static final int |
SHOW_ENTITY |
Показывать узлы Entity. |
static final int |
SHOW_ENTITY_REFERENCE |
Показывать узлы EntityReference. |
static final int |
SHOW_NOTATION |
Показывать узлы Notation. |
static final int |
SHOW_PROCESSING_INSTRUCTION |
Показывать узлы ProcessingInstruction. |
static final int |
SHOW_TEXT |
Показывать узлы Text. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
int |
getWhatToShow() |
Указывает LSSerializer, какие типы узлов следует показывать фильтру. |
Методы, объявленные в интерфейсе NodeFilter
acceptNode | Модификатор и тип | Метод | Описание |
|---|---|---|
short |
acceptNode |
Проверяет, виден ли указанный узел в логическом представлении TreeWalker или NodeIterator. |
Подробное описание методов
getWhatToShow
int getWhatToShow()
LSSerializer, какие типы узлов следует показывать фильтру. Если узел не показывается фильтру с помощью этого атрибута, он автоматически сериализуется. Определения констант см. в NodeFilter. Константы SHOW_DOCUMENT, SHOW_DOCUMENT_TYPE, SHOW_DOCUMENT_FRAGMENT, SHOW_NOTATION и SHOW_ENTITY здесь не имеют смысла; такие узлы никогда не передаются LSSerializerFilter. В отличие от [обхода DOM уровня 2 и диапазонов], константа
SHOW_ATTRIBUTE указывает, что узлы Attr отображаются и передаются фильтру. Используемые здесь константы определены в [обходе DOM уровня 2 и диапазонах] .
© 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.
