From e24304934e89d0d2a6bc7399fffa949bceeb9a67 Mon Sep 17 00:00:00 2001
From: Patrick Schmitt
- * This property control (enable/disable) if
* Allowed Values (case sensitive String):
*
- * This property control (enable/disable) if
* Allowed Values (case sensitive String):
*
* Allowed Values (case sensitive String):
* 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";
/**
* InterruptedException
fired when dead-lock diagnostic is enabled.
+ * This property control (enable/disable) if {@code InterruptedException} fired when dead-lock diagnostic is enabled.
*
- *
*/
@@ -159,16 +160,16 @@ public class SystemProperties {
/**
* 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
+ * ConcurrencyException
fired when dead-lock diagnostic is enabled.
+ * This property control (enable/disable) if {@code ConcurrencyException} fired when dead-lock diagnostic is enabled.
*
- *
*/
@@ -180,8 +181,8 @@ public class SystemProperties {
* 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
+ *
- *
*/
public static final String CONCURRENCY_MANAGER_ALLOW_STACK_TRACE_READ_LOCK = "eclipselink.concurrency.manager.allow.readlockstacktrace";
@@ -192,13 +193,13 @@ public class SystemProperties {
* 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