com.goldencode.p2j.persist.dirty

Class DirtyShareSupport

java.lang.Object

com.goldencode.p2j.persist.dirty.DirtyShareSupport

public final class DirtyShareSupport
extends java.lang.Object

This class globally enables/disables the dirty share feature and optionally collects information about dirty share use in an application. The information collected can include table/DMO and index encountered for which a record search's results have been changed by dirty share information from the current or another session. It may optionally include the location (file and line number) in an application where such use was found. The more detailed the information collected, the higher the impact on the runtime performance of an application.

The logging level determines whether and how much information to collect:

• INFO and higher: no information is collected;
• FINE: the table/DMO and index for which a record search was affected by a dirty read is reported;
• FINEST: additionally, the file and line number of application source code which led to the dirty read is reported

The INFO level (or higher) is intended for production use. FINE may have an impact on performance and will have an impact on memory use. FINEST will likely have a noticeable impact on performance and will use more memory.

The collected information is aggregated and reported in the server log at server shutdown.

Field Summary

Fields

Modifier and Type	Field and Description
private static boolean	enabledCrossSession true if cross-session dirty sharing is enabled.
private static boolean	enabledIntraSession true if dirty sharing within the same session is enabled.
private static boolean	forceCrossSession Flag which overrides the absence of DMO dirty-read annotations to force dirty sharing across sessions.
private static boolean	forceIntraSession Flag which overrides the absence of DMO dirty-intra-read annotations to force dirty sharing within the same session.
private static boolean	globalNotifications true if global notifications are enabled for cross-session dirty sharing.
private static CentralLogger	log Logger

Constructor Summary

Constructors

Constructor and Description
DirtyShareSupport()

Method Summary

Modifier and Type	Method and Description
static void	bootstrap() Method called at server bootstrap that initializes values from the directory configuration.
static boolean	isEnabledCrossSection() Returns the value of the flag that indicates if cross-session dirty sharing is enabled.
static boolean	isEnabledIntraSession() Returns the value of the flag that indicates if dirty sharing within the same session is enabled.
static boolean	isForceCrossSession() Returns the value of the flag that indicates if dirty sharing is forced across sessions.
static boolean	isForceIntraSession() Returns the value of the flag that indicates if dirty sharing is forced within the same session.
static boolean	isGlobalNotificationEnabled() Returns the value of the flag that indicates if global notifications are enabled for cross-session dirty sharing.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

private static final CentralLogger log

Logger

enabledCrossSession

private static boolean enabledCrossSession

true if cross-session dirty sharing is enabled.

enabledIntraSession

private static boolean enabledIntraSession

true if dirty sharing within the same session is enabled.

forceCrossSession

private static boolean forceCrossSession

Flag which overrides the absence of DMO dirty-read annotations to force dirty sharing across sessions.

forceIntraSession

private static boolean forceIntraSession

Flag which overrides the absence of DMO dirty-intra-read annotations to force dirty sharing within the same session.

globalNotifications

private static boolean globalNotifications

true if global notifications are enabled for cross-session dirty sharing.

Constructor Detail

DirtyShareSupport

public DirtyShareSupport()

Method Detail

bootstrap

public static void bootstrap()

Method called at server bootstrap that initializes values from the directory configuration. Until this method is called, default values are used.

isEnabledCrossSection

public static boolean isEnabledCrossSection()

Returns the value of the flag that indicates if cross-session dirty sharing is enabled.

Returns:

true if cross-session dirty sharing is enabled, false otherwise.

isEnabledIntraSession

public static boolean isEnabledIntraSession()

Returns the value of the flag that indicates if dirty sharing within the same session is enabled.

Returns:

true if dirty sharing within the same session is enabled, false otherwise.

isForceCrossSession

public static boolean isForceCrossSession()

Returns the value of the flag that indicates if dirty sharing is forced across sessions.

Returns:

true if dirty sharing is forced across sessions, false otherwise.

isForceIntraSession

public static boolean isForceIntraSession()

Returns the value of the flag that indicates if dirty sharing is forced within the same session.

Returns:

true if dirty sharing is forced within the same session, false otherwise.

isGlobalNotificationEnabled

public static boolean isGlobalNotificationEnabled()

Returns the value of the flag that indicates if global notifications are enabled for cross-session dirty sharing.

Returns:

true if global notifications are enabled for cross-session dirty sharing, false otherwise.