er.directtoweb

Class ERDirectToWeb

java.lang.Object

er.extensions.ERXFrameworkPrincipal

er.directtoweb.ERDirectToWeb

public class ERDirectToWeb
extends ERXFrameworkPrincipal

Principle class of the ERDirectToWeb framework. This class is loaded when the NSBundle of this framework is loaded. When loaded this class configures the directtoweb runtime to use the ERD2WModel and ERD2WFactory subclasses instead of the default implementations. See each class for a description of the additions/improvements made to the base implementation. This class also has a bunch of utility methods that are used throughout this framework.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ERDirectToWeb.D2WException Subclass of NSForwardException that can hold a d2wContext.

Nested classes/interfaces inherited from class er.extensions.ERXFrameworkPrincipal

ERXFrameworkPrincipal.Observer

Field Summary

Fields

Modifier and Type	Field and Description
static Logger	componentNameLog
static com.webobjects.foundation.NSSelector	D2WCONTEXT_SELECTOR
static String	D2WDEBUGGING_ENABLED_KEY
static String	D2WDISPLAY_COMPONENTNAMES_KEY
static String	D2WDISPLAY_DETAILED_PAGE_METRICS_KEY
static String	D2WDISPLAY_PAGE_METRICS_KEY
static String	D2WDISPLAY_PROPERTYKEYS_KEY
static Logger	debugLog
static Logger	log logging support
static Logger	propertyKeyLog
static Class[]	REQUIRES
static Logger	trace

Fields inherited from class er.extensions.ERXFrameworkPrincipal

initializedFrameworks, launchingFrameworks

Constructor Summary

Constructors

Constructor and Description
ERDirectToWeb()

Method Summary

Modifier and Type	Method and Description
static boolean	booleanForKey(com.webobjects.directtoweb.D2WContext context, String key)
static void	configureTraceRuleFiring()
void	configureTraceRuleFiring(com.webobjects.foundation.NSNotification n)
static NSMutableArray	convertedPropertyKeyArray(NSArray keyArray, char startChar, char endChar) Converts a given array of keys to a format usable for section and tab display.
static String	convertedPropertyKeyFromString(String s, char start, char end) Checks if a given property key is in the format (foo) or [foo] and returns the stripped string.
static String	createConfigurationForEntityNamed(String entityName)
static boolean	d2wComponentNameDebuggingEnabled(com.webobjects.appserver.WOSession s)
static Object	d2wContextValueForKey(String key, String entityName)
static Object	d2wContextValueForKey(String key, String entityName, NSDictionary extraValuesForContext)
static boolean	d2wDebuggingEnabled(com.webobjects.appserver.WOSession s)
static boolean	d2wPropertyKeyDebuggingEnabled(com.webobjects.appserver.WOSession s)
static boolean	detailedPageMetricsEnabled()
static NSArray	displayableArrayForKeyPathArray(NSArray array, String entityForReportName)
static String	displayNameForPropertyKey(String key, String entityName)
void	finishInitialization() Overridden by subclasses to provide framework initialization.
static NSMutableDictionary	informationForContext(com.webobjects.appserver.WOContext context) Gathers D2W-related information from the current context.
static NSMutableDictionary	informationForD2WContext(com.webobjects.directtoweb.D2WContext d2wContext) Gathers D2W-related information from the current context.
static boolean	pageMetricsEnabled()
static void	reportException(Exception ex, com.webobjects.directtoweb.D2WContext d2wContext) Logs some debugging info and and throws a D2WException that wraps the original exception.
void	resetModel(com.webobjects.foundation.NSNotification n)
static String	resolveUnit(String userInfoUnitString, com.webobjects.eocontrol.EOEnterpriseObject object, String prefixKeyPath)
static void	setD2wComponentNameDebuggingEnabled(com.webobjects.appserver.WOSession s, boolean enabled)
static void	setD2wDebuggingEnabled(com.webobjects.appserver.WOSession s, boolean enabled)
static void	setD2wPropertyKeyDebuggingEnabled(com.webobjects.appserver.WOSession s, boolean enabled)
static void	setDetailedPageMetricsEnabled(boolean value)
static void	setPageMetricsEnabled(boolean value)
static boolean	shouldRaiseException(boolean defaultValue) Checks the system property er.directtoweb.ERDirectToWeb.shouldRaiseExceptions.
static NSArray<com.webobjects.eocontrol.EOSortOrdering>	sortOrderings(com.webobjects.directtoweb.D2WContext d2wContext) Returns a valid sort ordering based on the defaultSortOrdering key.
void	sortRules(com.webobjects.foundation.NSNotification n)
static void	warmUpRuleCache()

Methods inherited from class er.extensions.ERXFrameworkPrincipal

didFinishInitialization, hasFrameworkInstalled, initialize, setUpFrameworkPrincipalClass, sharedInstance, toString

Methods inherited from class java.lang.Object

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

Field Detail

REQUIRES

public static final Class[] REQUIRES

log

public static final Logger log

logging support

D2WDEBUGGING_ENABLED_KEY

public static final String D2WDEBUGGING_ENABLED_KEY

See Also:

Constant Field Values

D2WDISPLAY_COMPONENTNAMES_KEY

public static final String D2WDISPLAY_COMPONENTNAMES_KEY

See Also:

Constant Field Values

D2WDISPLAY_PROPERTYKEYS_KEY

public static final String D2WDISPLAY_PROPERTYKEYS_KEY

See Also:

Constant Field Values

D2WDISPLAY_PAGE_METRICS_KEY

public static final String D2WDISPLAY_PAGE_METRICS_KEY

See Also:

Constant Field Values

D2WDISPLAY_DETAILED_PAGE_METRICS_KEY

public static final String D2WDISPLAY_DETAILED_PAGE_METRICS_KEY

See Also:

Constant Field Values

debugLog

public static final Logger debugLog

componentNameLog

public static final Logger componentNameLog

propertyKeyLog

public static final Logger propertyKeyLog

D2WCONTEXT_SELECTOR

public static final com.webobjects.foundation.NSSelector D2WCONTEXT_SELECTOR

trace

public static Logger trace

Constructor Detail

ERDirectToWeb

public ERDirectToWeb()

Method Detail

finishInitialization

public void finishInitialization()

Description copied from class: ERXFrameworkPrincipal

Overridden by subclasses to provide framework initialization.

Specified by:

finishInitialization in class ERXFrameworkPrincipal

resetModel

public void resetModel(com.webobjects.foundation.NSNotification n)

sortRules

public void sortRules(com.webobjects.foundation.NSNotification n)

setD2wDebuggingEnabled

public static void setD2wDebuggingEnabled(com.webobjects.appserver.WOSession s,
                                          boolean enabled)

d2wDebuggingEnabled

public static boolean d2wDebuggingEnabled(com.webobjects.appserver.WOSession s)

setD2wComponentNameDebuggingEnabled

public static void setD2wComponentNameDebuggingEnabled(com.webobjects.appserver.WOSession s,
                                                       boolean enabled)

d2wComponentNameDebuggingEnabled

public static boolean d2wComponentNameDebuggingEnabled(com.webobjects.appserver.WOSession s)

setD2wPropertyKeyDebuggingEnabled

public static void setD2wPropertyKeyDebuggingEnabled(com.webobjects.appserver.WOSession s,
                                                     boolean enabled)

d2wPropertyKeyDebuggingEnabled

public static boolean d2wPropertyKeyDebuggingEnabled(com.webobjects.appserver.WOSession s)

pageMetricsEnabled

public static boolean pageMetricsEnabled()

setPageMetricsEnabled

public static void setPageMetricsEnabled(boolean value)

detailedPageMetricsEnabled

public static boolean detailedPageMetricsEnabled()

setDetailedPageMetricsEnabled

public static void setDetailedPageMetricsEnabled(boolean value)

resolveUnit

public static String resolveUnit(String userInfoUnitString,
                                 com.webobjects.eocontrol.EOEnterpriseObject object,
                                 String prefixKeyPath)

convertedPropertyKeyFromString

public static String convertedPropertyKeyFromString(String s,
                                                    char start,
                                                    char end)

Checks if a given property key is in the format (foo) or [foo] and returns the stripped string.

Parameters:

s - the String to convert

start - the start char

end - the end char to check for

Returns:

stripped String or null if the string does not start with start and ends with end.

convertedPropertyKeyArray

public static NSMutableArray convertedPropertyKeyArray(NSArray keyArray,
                                                       char startChar,
                                                       char endChar)

Converts a given array of keys to a format usable for section and tab display. For example ("(foo)", bar, baz) is transformed to a list of ERD2WContainers usable for section display. The format ((foo, bar, baz)) is also understood.

Parameters:

keyArray - the NSArray to convert

startChar - the start char

endChar - the end char to check for

Returns:

nested NSMutableArray.

sortOrderings

public static NSArray<com.webobjects.eocontrol.EOSortOrdering> sortOrderings(com.webobjects.directtoweb.D2WContext d2wContext)

Returns a valid sort ordering based on the defaultSortOrdering key.

Parameters:

d2wContext -

booleanForKey

public static boolean booleanForKey(com.webobjects.directtoweb.D2WContext context,
                                    String key)

reportException

public static void reportException(Exception ex,
                                   com.webobjects.directtoweb.D2WContext d2wContext)

Logs some debugging info and and throws a D2WException that wraps the original exception. This is useful when your app fails very deep inside of a repetition of switch components and you need to find out just what the state of the D2WContext is.

Parameters:

ex -

d2wContext -

informationForContext

public static NSMutableDictionary informationForContext(com.webobjects.appserver.WOContext context)

Gathers D2W-related information from the current context. This is mainly useful for debugging.

Parameters:

context - the current context

Returns:

a dictionary of D2W-related keys to describe the D2W state of the context.

informationForD2WContext

public static NSMutableDictionary informationForD2WContext(com.webobjects.directtoweb.D2WContext d2wContext)

Gathers D2W-related information from the current context. This is mainly useful for debugging.

Parameters:

d2wContext - the D2W context from which to derive the debugging information

Returns:

a dictionary of D2W-related keys to describe the state of the provided D2W context.

shouldRaiseException

public static boolean shouldRaiseException(boolean defaultValue)

Checks the system property er.directtoweb.ERDirectToWeb.shouldRaiseExceptions.

Parameters:

defaultValue -

displayNameForPropertyKey

public static String displayNameForPropertyKey(String key,
                                               String entityName)

d2wContextValueForKey

public static Object d2wContextValueForKey(String key,
                                           String entityName)

d2wContextValueForKey

public static Object d2wContextValueForKey(String key,
                                           String entityName,
                                           NSDictionary extraValuesForContext)

createConfigurationForEntityNamed

public static String createConfigurationForEntityNamed(String entityName)

warmUpRuleCache

public static void warmUpRuleCache()

configureTraceRuleFiring

public void configureTraceRuleFiring(com.webobjects.foundation.NSNotification n)

configureTraceRuleFiring

public static void configureTraceRuleFiring()

displayableArrayForKeyPathArray

public static NSArray displayableArrayForKeyPathArray(NSArray array,
                                                      String entityForReportName)