Класс ObjectInputFilter.Config

public static ObjectInputFilter getSerialFilter()

Возвращает статический JVM-широкий фильтр десериализации или null, если он не настроен.

public static void setSerialFilter(ObjectInputFilter filter)

Устанавливает статический JVM-широкий фильтр, если он еще не был настроен или установлен.

public static BinaryOperator<ObjectInputFilter> getSerialFilterFactory()

Возвращает фабрику JVM-широких фильтров десериализации. Если фабрика фильтра была установлена, она возвращается, иначе возвращается встроенная фабрика фильтров десериализации. Фабрика фильтра предоставляет фильтр для каждого ObjectInputStream при вызове из конструкторов ObjectInputStream и при установке фильтра для конкретного потока с помощью setObjectInputFilter.

public static void setSerialFilterFactory(BinaryOperator<ObjectInputFilter> filterFactory)

Устанавливает фабрику JVM-широких фильтров десериализации. Фабрика фильтра может быть настроена ровно один раз одним из следующих способов: установка свойства jdk.serialFilterFactory в командной строке, установка свойства jdk.serialFilterFactory в файле Security или использование этого setSerialFilterFactory метода. Фабрика фильтра может быть установлена только до создания любого объекта ObjectInputStream, чтобы избежать несоответствий в используемой фабрике фильтра.

JVM-широкая фабрика фильтра вызывается при создании объекта ObjectInputStream и при установке фильтра для конкретного потока. Параметрами являются текущий фильтр и запрашиваемый фильтр, а она возвращает фильтр, который будет использоваться для потока. Если текущий фильтр non-null, фабрика фильтра должна вернуть non-null фильтр; это для предотвращения непреднамеренного отключения фильтрации после ее включения. Фабрика определяет фильтр, который будет использоваться для ObjectInputStream потоков, на основе своих входных данных, других фильтров, контекста или доступного состояния. Фабрика может генерировать исключения во время выполнения, чтобы сигнализировать об ошибочном использовании или некорректных параметрах. См. модели фильтров для примеров композиции и делегирования.

public static ObjectInputFilter createFilter(String pattern)

Возвращает ObjectInputFilter по строке шаблонов.

Шаблоны разделены символом «;» (точка с запятой). Пробелы значимы и считаются частью шаблона. Если шаблон включает присвоение по умолчанию, «=», он устанавливает предел. Если предел появляется более одного раза, используется последнее значение.

• maxdepth=value - максимальная глубина графа
• maxrefs=value - максимальное количество внутренних ссылок
• maxbytes=value - максимальное количество байтов в потоке ввода
• maxarray=value - максимальная длина массива, разрешенная

Другие шаблоны соответствуют или отклоняют имя класса или пакета, как возвращается из Class.getName(), и если присутствует необязательное имя модуля class.getModule().getName(). Обратите внимание, что для массивов в шаблоне используется тип элемента, а не тип массива.

• Если шаблон начинается с «!», класс отклоняется, если соответствует оставшаяся часть шаблона; в противном случае класс разрешен, если шаблон соответствует.
• Если шаблон содержит «/», то непустой префикс до «/» является именем модуля; если имя модуля соответствует имени модуля класса, то оставшаяся часть шаблона сопоставляется с именем класса. Если «/» отсутствует, имя модуля не сравнивается.
• Если шаблон заканчивается «.**», он сопоставляется с любым классом в пакете и во всех подпакетах.
• Если шаблон заканчивается «.*», он сопоставляется с любым классом в пакете.
• Если шаблон заканчивается «*», он сопоставляется с любым классом с шаблоном в качестве префикса.
• Если шаблон равен имени класса, он соответствует.
• В противном случае шаблон не соответствует.

Результирующий фильтр выполняет проверки пределов, а затем пытается сопоставить класс, если таковой имеется. Если любой из пределов превышен, фильтр возвращает Status.REJECTED. Если класс является массивом, класс, который нужно сопоставить, — это тип элемента. Массивы любого числа измерений обрабатываются так же, как тип элемента. Например, шаблон «!example.Foo» отклоняет создание любого экземпляра или массива example.Foo. Первый шаблон, который соответствует, работая слева направо, определяет результат Status.ALLOWED или Status.REJECTED. Если пределы не превышены и ни один шаблон не соответствует классу, результат — Status.UNDECIDED.