diff --git a/foundation/org.eclipse.persistence.core/src/main/java/org/eclipse/persistence/config/SystemProperties.java b/foundation/org.eclipse.persistence.core/src/main/java/org/eclipse/persistence/config/SystemProperties.java
index ebd54be3a00..b5d9c0127af 100644
--- a/foundation/org.eclipse.persistence.core/src/main/java/org/eclipse/persistence/config/SystemProperties.java
+++ b/foundation/org.eclipse.persistence.core/src/main/java/org/eclipse/persistence/config/SystemProperties.java
@@ -1,5 +1,6 @@
/*
* Copyright (c) 1998, 2024 Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2024 Contributors to the Eclipse Foundation. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0 which is available at
@@ -75,7 +76,7 @@ public class SystemProperties {
/**
* This system property can be set to override target server platform set by the Java EE container
- * with the one either set in persistence.xml or auto detected.
+ * with the one either set in persistence.xml or auto-detected.
*/
public static final String ENFORCE_TARGET_SERVER = "eclipselink.target-server.enforce";
@@ -94,7 +95,7 @@ public class SystemProperties {
public static final String CONVERSION_USE_DEFAULT_TIMEZONE = "org.eclipse.persistence.conversion.useDefaultTimeZoneForJavaTime";
/**
- * This property can be set to false
to enable UPDATE call to set
+ * This property can be set to {@code false} to enable UPDATE call to set
* foreign key value in the target row in unidirectional 1-Many mapping
* with not nullable FK. In previous versions of EclipseLink this was
* the default behaviour.
@@ -104,7 +105,7 @@ public class SystemProperties {
/**
* This system property in milliseconds can control thread management in org.eclipse.persistence.internal.helper.ConcurrencyManager.
- * It control how much time loop wait before it try acquire lock for current thread again. It value is set above above 0 dead lock detection
+ * It controls how much time loop wait before it tries to acquire lock for current thread again. If the value is set above 0 deadlock detection
* mechanism and related extended logging will be activated.
* Default value is 0 (unit is ms). Allowed values are: long
*/
@@ -112,46 +113,46 @@ public class SystemProperties {
/**
* This system property in milliseconds can control thread management in org.eclipse.persistence.internal.helper.ConcurrencyManager.
- * It control how much time ConcurrencyManager will wait before it will identify, that thread which builds new object/entity instance
- * should be identified as a potential dead lock source. It leads into some additional log messages.
+ * It controls how much time ConcurrencyManager will wait before it will identify, that thread which builds new object/entity instance
+ * should be identified as a potential deadlock source. It leads into some additional log messages.
* Default value is 0 (unit is ms). In this case extended logging is not active. Allowed values are: long
*/
public static final String CONCURRENCY_MANAGER_BUILD_OBJECT_COMPLETE_WAIT_TIME = "eclipselink.concurrency.manager.build.object.complete.waittime";
/**
* This system property in milliseconds can control thread management in org.eclipse.persistence.internal.helper.ConcurrencyManager.
- * It control how long we are willing to wait before firing up an exception
+ * It controls how long we are willing to wait before firing up an exception
* Default value is 40000 (unit is ms). Allowed values are: long
*/
public static final String CONCURRENCY_MANAGER_MAX_SLEEP_TIME = "eclipselink.concurrency.manager.maxsleeptime";
/**
* This system property in milliseconds can control thread management in org.eclipse.persistence.internal.helper.ConcurrencyManager and org.eclipse.persistence.internal.helper.ConcurrencyUtil.
- * It control how frequently the tiny dump log message is created.
+ * It controls how frequently the tiny dump log message is created.
* Default value is 40000 (unit is ms). Allowed values are: long
*/
public static final String CONCURRENCY_MANAGER_MAX_FREQUENCY_DUMP_TINY_MESSAGE = "eclipselink.concurrency.manager.maxfrequencytodumptinymessage";
/**
* This system property in milliseconds can control thread management in org.eclipse.persistence.internal.helper.ConcurrencyManager and org.eclipse.persistence.internal.helper.ConcurrencyUtil.
- * It control how frequently the massive dump log message is created.
+ * It controls how frequently the massive dump log message is created.
* Default value is 60000 (unit is ms). Allowed values are: long
*/
public static final String CONCURRENCY_MANAGER_MAX_FREQUENCY_DUMP_MASSIVE_MESSAGE = "eclipselink.concurrency.manager.maxfrequencytodumpmassivemessage";
/**
*
- * This property control (enable/disable) if InterruptedException
fired when dead-lock diagnostic is enabled.
+ * This property control (enable/disable) if {@code InterruptedException} fired when dead-lock diagnostic is enabled.
*
* Allowed Values (case sensitive String): *
false
" - if aborting frozen thread is not effective it is preferable to not fire the interrupted exception let the system
+ * true
" (DEFAULT) - if we want the to fire up an exception to try to get the current thread to release all of its acquired locks and allow other
+ *
- * This property control (enable/disable) if ConcurrencyException
fired when dead-lock diagnostic is enabled.
+ * This property control (enable/disable) if {@code ConcurrencyException} fired when dead-lock diagnostic is enabled.
*
* Allowed Values (case sensitive String): *
false
" - if aborting frozen thread is not effective it is preferable to not fire the concurrency exception let the system
+ * true
" (DEFAULT) - if we want the to fire up an exception to try to get the current thread to release all of its acquired
+ * * Allowed Values (case sensitive String): *
false
" (DEFAULT) - don't collect debug/trace information during ReadLock acquisition
- * true
" - collect debug/trace information during ReadLock acquisition. Has negative impact to the performance.
+ * true
this property to try reduce the likelihood of having dead locks is to allow less threads to start object
+ * Enable {@code true} this property to try reduce the likelihood of having dead locks is to allow less threads to start object
* building in parallel. In this case there should be negative impact to the performance.
* Note: Parallel access to the same entity/entity tree from different threads is not recommended technique in EclipseLink.
* true
" - means we want to override vanilla behavior and use a semaphore to not allow too many
+ * false
" (DEFAULT) - means just go ahead and try to build the object without any semaphore (false is
+ * true
" - means we want to override vanilla behavior and use a semaphore to not allow too many
+ * false
" (DEFAULT) - means just go ahead and try to build the object without any semaphore (false is
+ *
* This property control number of threads in semaphore in {@link org.eclipse.persistence.internal.descriptors.ObjectBuilder}
- * If "eclipselink.concurrency.manager.object.building.semaphore" property is true
default value is 10. Allowed values are: int
- * If "eclipselink.concurrency.manager.object.building.semaphore" property is false
(DEFAULT) number of threads is unlimited.
+ * If "eclipselink.concurrency.manager.object.building.semaphore" property is {@code true} default value is 10. Allowed values are: int
+ * If "eclipselink.concurrency.manager.object.building.semaphore" property is {@code false} (DEFAULT) number of threads is unlimited.
*
* This property control number of threads in semaphore in {@link org.eclipse.persistence.internal.helper.WriteLockManager#acquireRequiredLocks}
- * If "eclipselink.concurrency.manager.write.lock.manager.semaphore" property is true
default value is 2. Allowed values are: int
- * If "eclipselink.concurrency.manager.write.lock.manager.semaphore" property is false
(DEFAULT) number of threads is unlimited.
+ * If "eclipselink.concurrency.manager.write.lock.manager.semaphore" property is {@code true} default value is 2. Allowed values are: int
+ * If "eclipselink.concurrency.manager.write.lock.manager.semaphore" property is {@code false} (DEFAULT) number of threads is unlimited.
*
* Allowed Values (case sensitive String): *
eclipselink
" (DEFAULT) - use ASM implementation from org.eclipse.persistence.asm project.ow2
" - use ASM implementation from org.ow2.asm project.+ * This property controls the random number generator (RNG) used for password encryption. + *
+ * Allowed Values (case sensitive String): + *
* Do privileged blocks can be used with a security manager to grant a code base (eclipselink.jar) access to certain * Java operations such as reflection. Generally a security manager is not enabled in a JVM, so this is not an issue. * If a security manager is enabled, then either the application can be configured to have access to operations such as * reflection, or only EclipseLink can be given access. If only EclipseLink is desired to be given access then * do privileged must be enabled through the System property "eclipselink.security.usedoprivileged"=true. - * + *
* Note the usage of do privileged has major impacts on performance, so should normally be avoided.
*/
public class PrivilegedAccessHelper {
@@ -75,6 +76,7 @@ public class PrivilegedAccessHelper {
SystemProperties.CONCURRENCY_MANAGER_ACQUIRE_WAIT_TIME, SystemProperties.CONCURRENCY_MANAGER_BUILD_OBJECT_COMPLETE_WAIT_TIME, SystemProperties.CONCURRENCY_MANAGER_MAX_SLEEP_TIME,
SystemProperties.CONCURRENCY_MANAGER_MAX_FREQUENCY_DUMP_TINY_MESSAGE, SystemProperties.CONCURRENCY_MANAGER_MAX_FREQUENCY_DUMP_MASSIVE_MESSAGE,
SystemProperties.CONCURRENCY_MANAGER_ALLOW_INTERRUPTED_EXCEPTION, SystemProperties.CONCURRENCY_MANAGER_ALLOW_CONCURRENCY_EXCEPTION, SystemProperties.CONCURRENCY_MANAGER_ALLOW_STACK_TRACE_READ_LOCK,
+ SystemProperties.SECURITY_ENCRYPTOR_USE_STRONG_RANDOM_NUMBER_GENERATOR,
ServerPlatformBase.JMX_REGISTER_RUN_MBEAN_PROPERTY, ServerPlatformBase.JMX_REGISTER_DEV_MBEAN_PROPERTY,
XMLPlatformFactory.XML_PLATFORM_PROPERTY};
private final static Set