Класс DocumentFilter

public class DocumentFilter
extends Object

DocumentFilter, как следует из названия, является фильтром для методов мутации Document. Когда изменяется Document, содержащий DocumentFilter, он пересылает соответствующий вызов метода в DocumentFilter. По умолчанию выполнение модификации разрешено. Подклассы могут фильтровать модификации, условно вызывая методы в суперклассе или вызывая необходимые методы в переданном FilterBypass. Подклассы НЕ должны вызывать обратный вызов в Document для модификации, вместо этого вызов должен выполняться в суперклассе или в FilterBypass.

При вызове remove или insertString на DocumentFilter, DocumentFilter может вызывать обратный вызов в FilterBypass несколько раз или для разных областей, но он не должен вызывать обратный вызов в FilterBypass после возвращения из метода remove или insertString.

По умолчанию методы мутации документов, связанные с текстом, такие как insertString, replace и remove в AbstractDocument, используют DocumentFilter, если доступно, а методы мутации, связанные с Element, такие как create, insert и removeElement в DefaultStyledDocument, не используют DocumentFilter. Если метод не следует этим умолчаниям, это должно быть явно указано в документации к методу.