er.directtoweb.components
Class ERDCustomComponent

java.lang.Object
  com.webobjects.appserver.WOElement
      com.webobjects.appserver.WOComponent
          er.extensions.components.ERXComponent
              er.extensions.components.ERXNonSynchronizingComponent
                  er.directtoweb.components.ERDCustomComponent

All Implemented Interfaces:

WOActionResults, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions, NSValidation, ERXExceptionHolder, Serializable, Cloneable

Direct Known Subclasses:

ERCDisplayHelpText, ERDActionButton, ERDAttributeRepetition, ERDBannerComponent, ERDCustomEditComponent, ERDCustomQueryComponent, ERDDisplayTemplateString, ERDEmptyListMessage, ERDQuickSearch, ERDSectionImage, ERDSectionText, ERDSpacer, ERDTabText

public abstract class ERDCustomComponent
extends ERXNonSynchronizingComponent
implements ERXExceptionHolder

Base class of many custom components.
Has a lot of nifty features including resolving bindings against the rule system and inherits all the value pulling methods from ERXNonSynchronizingComponent. Subclasses should be able to run stand alone without a D2W context. This is achieved by pulling values first from the bindings, then from the d2wContext and finally from an "extraBindings" binding.

See Also:

Serialized Form

Nested Class Summary

static interface

ERDCustomComponent.Keys

Nested classes/interfaces inherited from class com.webobjects.appserver.WOComponent

WOComponent._EventLoggingEnabler, WOComponent.Event

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSValidation

NSValidation._MethodBinding, NSValidation._ValidationBinding, NSValidation.DefaultImplementation, NSValidation.Utility, NSValidation.ValidationException

Field Summary

protected Object	extraBindings Holds the extra bindings.
protected static Integer	FALSE
static Logger	log logging support
protected static Integer	TRUE

Fields inherited from class er.extensions.components.ERXComponent

_dynamicBindings

Fields inherited from class com.webobjects.appserver.WOComponent

_Extension, _IsEventLoggingEnabled, _keyAssociations, MINUSONE

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding.ErrorHandling

_CLASS

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_CLASS, _KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSValidation

_CLASS

Constructor Summary

ERDCustomComponent(WOContext context)
Designated constructor

Method Summary

void	appendToResponse(WOResponse r, WOContext c) Calls _checkAccess prior to super.appendToResponse and adds support for ClickToOpen (TM).
boolean	booleanForBinding(String binding) Deprecated. use booleanValueForBinding() instead
void	clearValidationFailed() Implementation of the ERXExceptionHolder interface.
boolean	d2wComponentNameDebuggingEnabled() Should the component name be shown.
D2WContext	d2wContext() The active D2WContext.
protected D2WContext	d2wContextFromBindings() Returns the active d2wContext.
protected Object	d2wContextValueForBinding(String binding) Utility to pull the value from the D2WContext.
boolean	d2wDebuggingEnabled() Is D2W debugging enabled.
boolean	d2wPropertyKeyDebuggingEnabled() Should the property keys be shown.
Object	extraBindings() Extra bindings supplied to the component.
protected Object	extraBindingsValueForBinding(String binding) Utility to pull the value from the extra bindings if supplied.
boolean	hasBinding(String binding) Checks if the binding can be pulled.
Integer	integerBooleanForBinding(String binding)
String	key() The active property key.
D2WContext	localContext() The active D2WContext.
protected void	logDebugInfo() Utility to dump some debug info about this component and its parent
protected Object	originalValueForBinding(String binding) Utility to pull the value from the components actual bindings.
protected Object	parentValueForBinding(String binding) Utility to pull the value from the components parent, if the parent is a D2W wrapper component.
void	reset() Used by stateless subclasses.
void	setD2wContext(D2WContext value) Sets the D2WContext.
void	setExtraBindings(Object value) Sets the extra bindings.
void	setKey(String newKey) Sets the property key.
void	setLocalContext(D2WContext value) Sets the D2WContext.
boolean	synchronizesVariablesWithBindings() Overridden from superclass to turn on component synching, which is the default.
void	validationFailedWithException(Throwable e, Object value, String keyPath) Validation Support.
Object	valueForBinding(String binding) Fetches an object from the bindings.

Methods inherited from class er.extensions.components.ERXNonSynchronizingComponent

isStateless

Methods inherited from class er.extensions.components.ERXComponent

_awakeInContext, _checkAccess, _frameworkName, _includeCSSResources, _includeJavascriptResources, additionalCSSFiles, additionalJavascriptFiles, booleanValueForBinding, booleanValueForBinding, booleanValueForBinding, checkAccess, clickToOpenEnabled, componentName, defaultCSSPath, defaultJavascriptPath, dynamicBindings, floatValueForBinding, intValueForBinding, invokeAction, isPageAccessAllowed, localizer, objectValueForBinding, objectValueForBinding, pageWithName, postAppendToResponse, preAppendToResponse, primaryCSSFile, primaryJavascriptFile, stringValueForBinding, stringValueForBinding, takeValuesFromRequest, useDefaultComponentCSS, useDefaultComponentJavascript

Methods inherited from class com.webobjects.appserver.WOComponent

__valueForBinding, _associationWithName, _childTemplate, _cleanUpStatelessComponent, _componentDefinition, _componentUnroll, _isPage, _setContext, _setIsPage, _setParent, _setSubcomponent, _sleepInContext, _subcomponentForElementWithID, _templateNameForClass, _unroll, application, awake, baseURL, bindingKeys, canAccessFieldsDirectly, canGetValueForBinding, canSetValueForBinding, clone, context, debugString, descriptionForResponse, ensureAwakeInContext, frameworkName, generateResponse, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hasSession, isCachingEnabled, isEventLoggingEnabled, logString, name, pageWithName, parent, path, pathURL, performParentAction, pullValuesFromParent, pushValuesToParent, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, sleep, takeValueForKey, takeValueForKeyPath, template, templateWithHTMLString, templateWithHTMLString, templateWithName, toString, unableToSetNullForKey, validateTakeValueForKeyPath, validateValueForKey, valueForBooleanBinding, valueForIntegerBinding, valueForKey, valueForKeyPath, valueForNSArrayBindings, valueForNSDictionaryBindings, valueForNumberBinding, valueForStringBinding

Methods inherited from class java.lang.Object

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

Field Detail

log

public static final Logger log

logging support

extraBindings

protected Object extraBindings

Holds the extra bindings.

TRUE

protected static Integer TRUE

FALSE

protected static Integer FALSE

Constructor Detail

ERDCustomComponent

public ERDCustomComponent(WOContext context)

Designated constructor

Method Detail

setLocalContext

public void setLocalContext(D2WContext value)

Sets the D2WContext. Applies when used inside a D2WCustomComponent.

setD2wContext

public void setD2wContext(D2WContext value)

Sets the D2WContext. Applies when used inside a property key repetition.

localContext

public D2WContext localContext()

The active D2WContext. Simply calls to d2wContext()

d2wContext

public D2WContext d2wContext()

The active D2WContext.

d2wContextFromBindings

protected D2WContext d2wContextFromBindings()

Returns the active d2wContext. If the value was not set via KVC, tries to get the value from the bindings if the component is non-syncing

validationFailedWithException

public void validationFailedWithException(Throwable e,
                                          Object value,
                                          String keyPath)

Validation Support. Passes errors to the parent.

Overrides:

validationFailedWithException in class WOComponent

clearValidationFailed

public void clearValidationFailed()

Implementation of the ERXExceptionHolder interface. Clears exceptions in the parent if possible.

Specified by:

clearValidationFailed in interface ERXExceptionHolder

booleanForBinding

public boolean booleanForBinding(String binding)

Deprecated. use booleanValueForBinding() instead

integerBooleanForBinding

public Integer integerBooleanForBinding(String binding)

hasBinding

public boolean hasBinding(String binding)

Checks if the binding can be pulled. If the component is synching, throws an Exception. Otherwise checks the superclass and if the value for the binding is not null.

Overrides:

hasBinding in class WOComponent

logDebugInfo

protected void logDebugInfo()

Utility to dump some debug info about this component and its parent

parentValueForBinding

protected Object parentValueForBinding(String binding)

Utility to pull the value from the components parent, if the parent is a D2W wrapper component.

originalValueForBinding

protected Object originalValueForBinding(String binding)

Utility to pull the value from the components actual bindings.

d2wContextValueForBinding

protected Object d2wContextValueForBinding(String binding)

Utility to pull the value from the D2WContext.

extraBindingsValueForBinding

protected Object extraBindingsValueForBinding(String binding)

Utility to pull the value from the extra bindings if supplied.

valueForBinding

public Object valueForBinding(String binding)

Fetches an object from the bindings. Tries the actual supplied bindings, the supplied d2wContext, the parent and finally the extra bindings dictionary.

Overrides:

valueForBinding in class WOComponent

reset

public void reset()

Used by stateless subclasses.

Overrides:

reset in class ERXComponent

setExtraBindings

public void setExtraBindings(Object value)

Sets the extra bindings.

extraBindings

public Object extraBindings()

Extra bindings supplied to the component. If this is a dictionary, it will be used for additional bindings.

setKey

public void setKey(String newKey)

Sets the property key.

key

public String key()

The active property key.

synchronizesVariablesWithBindings

public boolean synchronizesVariablesWithBindings()

Overridden from superclass to turn on component synching, which is the default.

Overrides:

synchronizesVariablesWithBindings in class ERXNonSynchronizingComponent

d2wDebuggingEnabled

public boolean d2wDebuggingEnabled()

Is D2W debugging enabled.

d2wComponentNameDebuggingEnabled

public boolean d2wComponentNameDebuggingEnabled()

Should the component name be shown.

d2wPropertyKeyDebuggingEnabled

public boolean d2wPropertyKeyDebuggingEnabled()

Should the property keys be shown.

appendToResponse

public void appendToResponse(WOResponse r,
                             WOContext c)

Description copied from class: ERXComponent

Calls _checkAccess prior to super.appendToResponse and adds support for ClickToOpen (TM).

Overrides:

appendToResponse in class ERXComponent