Интерфейс 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

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getWhatToShow()`	Сообщает `LSSerializer`, какие типы узлов следует передавать фильтру.

Методы, объявленные в интерфейсе NodeFilter

acceptNode

Подробное описание методов

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/ls/LSSerializerFilter.html