[14] RFR (doc) 8237651 Clarify initialization of jdk.serialFilter
Roger Riggs
Roger.Riggs at oracle.com
Fri Jan 24 19:51:51 UTC 2020
Please review a doc change in the description of the initialization of
the jdk.serialFilter from
a system property to generalize it beyond only command line invocation.
diff a/src/java.base/share/classes/java/io/ObjectInputFilter.java b/src/java.base/share/classes/java/io/ObjectInputFilter.java
--- a/src/java.base/share/classes/java/io/ObjectInputFilter.java
+++ b/src/java.base/share/classes/java/io/ObjectInputFilter.java
@@ -204,15 +204,14 @@
* When setting the filter, it should be stateless and idempotent,
* reporting the same result when passed the same arguments.
* <p>
* The filter is configured during the initialization of the {@code ObjectInputFilter.Config}
* class. For example, by calling {@link #getSerialFilter() Config.getSerialFilter}.
- * If the system property {@systemProperty jdk.serialFilter} is defined on the command line,
- * it is used to configure the filter.
- * If the system property is not defined on the command line, and the
- * {@link java.security.Security} property {@code jdk.serialFilter} is defined
- * then it is used to configure the filter.
+ * If the Java virtual machine is started with the system property
+ * {@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.
* 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)
* System.setProperty} <em>does not set the filter</em>.
Thanks, Roger
Issue:
https://bugs.openjdk.java.net/browse/JDK-8237651
Webrev:
http://cr.openjdk.java.net/~rriggs/webrev-filter-8237651/
More information about the core-libs-dev
mailing list