8276609: Document setting property jdk.serialFilter to an invalid v…

…alue throws `ExceptionInInitializerError` Reviewed-by: dfuchs, lancea
openjdk · Nov 16, 2021 · 8ed384c · 8ed384c · openjdk-notifier · Nov 16, 2021
1 parent cddc6ce
commit 8ed384c
Showing 1 changed file with 2 additions and 0 deletions.
diff --git a/src/java.base/share/classes/java/io/ObjectInputFilter.java b/src/java.base/share/classes/java/io/ObjectInputFilter.java
@@ -523,6 +523,8 @@ enum Status {
      * {@systemProperty jdk.serialFilter}, its value is used to configure the filter.
      * If the system property is not defined, and the {@link java.security.Security} property
      * {@code jdk.serialFilter} is defined then it is used to configure the filter.
+     * The filter is created as if {@link #createFilter(String) createFilter} is called;
+     * if the filter string is invalid, an {@link ExceptionInInitializerError} is thrown.
      * Otherwise, the filter is not configured during initialization and
      * can be set with {@link #setSerialFilter(ObjectInputFilter) Config.setSerialFilter}.
      * Setting the {@code jdk.serialFilter} with {@link System#setProperty(String, String)