er.extensions.components

Class ERXInlineTemplate

java.lang.Object

com.webobjects.appserver.WOElement

com.webobjects.appserver.WOComponent

er.extensions.components.ERXComponent

er.extensions.components.ERXNonSynchronizingComponent

er.extensions.components.ERXInlineTemplate

All Implemented Interfaces:

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

Direct Known Subclasses:

ERXStatelessInlineTemplate

public class ERXInlineTemplate
extends ERXNonSynchronizingComponent

ERXInlineTemplate allows to specify a component's template dynamically.

The content which would usually go into the ".html" file within a WOComponent's bundle, is specified using the "html" binding, the ".wod" part is specified by the "wod" binding.

When using WOOgnl with "ognl.helperFunctions = true" and "ognl.inlineBindings = true", you can leave out the WOD part.

When keys are accessed, the component first determines the first element of the path (e.g. key "foo" for path "foo.bar") and looks, if there is a binding with that key. If there is such a binding, the value is retrieved and the rest of the keyPath applied to it (valueForBinding("foo").valueForKeyPath("bar")). If there is no binding with that name and "proxyParent" is true, the keyPath is resolved against the parent component. Otherwise, dynamicBindings (ERXComponent.dynamicBindings()) are used. You can switch off the usage of dynamicBindings by setting the binding "defaultToDynamicBindings" to false. Then a warning will be logged for unknown keys.

When an error occurs, an error message is displayed. The message can be altered using the "errorTemplate" binding.

Optionally, a "cacheKey" (String) can be specified, under which the parsed WOElement will be cached. To allow updating, a "cacheVersion" (Object) is available. When the version changes, the value is recalculated.

See Also:

Serialized Form

Author:

th

Bindings

Name	Description
html	HTML-part of the component (required)
wod	WOD-part of the component (optional)
cacheKey	Key under which to cache the WOElement (optional)
cacheVersion	Hint to determine if the cached object is up-to-date (optional)
errorTemplate	Template to use for displaying error messages. Uses {@link ERXSimpleTemplateParser} for display. Method name and HTML-escaped message are provided by the "method" and "message" keys. (optional)
proxyParent	whether to proxy key path lookup to the parent (default is false)
defaultToDynamicBindings	whether to use dynamicBindings for unknown keys (default is true)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ERXInlineTemplate.Error

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.NSKeyValueCoding

NSKeyValueCoding._BooleanFieldBinding, NSKeyValueCoding._BooleanMethodBinding, NSKeyValueCoding._FieldBinding, NSKeyValueCoding._ForwardingBinding, NSKeyValueCoding._KeyBinding, NSKeyValueCoding._KeyBindingCreation, NSKeyValueCoding._MethodBinding, NSKeyValueCoding._NumberFieldBinding, NSKeyValueCoding._NumberMethodBinding, NSKeyValueCoding._ReflectionKeyBindingCreation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.MapImplementation, NSKeyValueCoding.Null<T>, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.ValueAccessor

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

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

Field Summary

Fields

Modifier and Type	Field and Description
protected ERXInlineTemplate.Error	_deferredError

Fields inherited from class er.extensions.components.ERXComponent

_dynamicBindings

Fields inherited from class com.webobjects.appserver.WOComponent

_Extension, _IsEventLoggingEnabled, _keyAssociations

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.NSKeyValueCoding

NullValue

Fields inherited from interface com.webobjects.foundation.NSValidation

_CLASS

Constructor Summary

Constructors

Constructor and Description
ERXInlineTemplate(WOContext context)

Method Summary

Modifier and Type	Method and Description
void	appendToResponse(WOResponse woresponse, WOContext wocontext) Calls ERXNonSynchronizingComponent.resetCachedBindingsInStatefulComponent() prior to super.appendToResponse.
boolean	defaultToDynamicBindings()
String	errorTemplate()
boolean	proxyParent()
void	takeValueForKey(Object obj, String s)
void	takeValueForKeyPath(Object value, String keyPath)
WOElement	template()
Object	valueForKey(String s)
Object	valueForKeyPath(String keyPath)

Methods inherited from class er.extensions.components.ERXNonSynchronizingComponent

invokeAction, resetCachedBindingsInStatefulComponent, synchronizesVariablesWithBindings, takeValuesFromRequest

Methods inherited from class er.extensions.components.ERXComponent

_awakeInContext, _checkAccess, _frameworkName, _includeCSSResources, _includeJavascriptResources, additionalCSSFiles, additionalJavascriptFiles, arrayValueForBinding, arrayValueForBinding, booleanValueForBinding, booleanValueForBinding, booleanValueForBinding, browser, checkAccess, clickToOpenEnabled, componentName, defaultCSSPath, defaultJavascriptPath, dynamicBindings, floatValueForBinding, intValueForBinding, isPageAccessAllowed, localizer, objectValueForBinding, objectValueForBinding, pageWithName, postAppendToResponse, preAppendToResponse, primaryCSSFile, primaryJavascriptFile, reset, shouldCheckAccess, stringValueForBinding, stringValueForBinding, 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, hasBinding, hasSession, isCachingEnabled, isEventLoggingEnabled, isStateless, logString, name, pageWithName, parent, path, pathURL, performParentAction, pullValuesFromParent, pushValuesToParent, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, setVariableValueForName, sleep, templateWithHTMLString, templateWithHTMLString, templateWithHTMLString, templateWithName, toString, unableToSetNullForKey, validateTakeValueForKeyPath, validateValueForKey, validationFailedWithException, valueForBinding, valueForBooleanBinding, valueForIntegerBinding, valueForNSArrayBindings, valueForNSDictionaryBindings, valueForNumberBinding, valueForStringBinding, variableValueForName, variableWithName

Methods inherited from class java.lang.Object

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

Field Detail

_deferredError

protected ERXInlineTemplate.Error _deferredError

Constructor Detail

ERXInlineTemplate

public ERXInlineTemplate(WOContext context)

Method Detail

appendToResponse

public void appendToResponse(WOResponse woresponse,
                             WOContext wocontext)

Description copied from class: ERXNonSynchronizingComponent

Calls ERXNonSynchronizingComponent.resetCachedBindingsInStatefulComponent() prior to super.appendToResponse.

Overrides:

appendToResponse in class ERXNonSynchronizingComponent

Parameters:

woresponse - to which we are appending

wocontext - context of the response

errorTemplate

public String errorTemplate()

proxyParent

public boolean proxyParent()

defaultToDynamicBindings

public boolean defaultToDynamicBindings()

takeValueForKeyPath

public void takeValueForKeyPath(Object value,
                                String keyPath)

Specified by:

takeValueForKeyPath in interface NSKeyValueCodingAdditions

Overrides:

takeValueForKeyPath in class WOComponent

valueForKeyPath

public Object valueForKeyPath(String keyPath)

Specified by:

valueForKeyPath in interface NSKeyValueCodingAdditions

Overrides:

valueForKeyPath in class WOComponent

takeValueForKey

public void takeValueForKey(Object obj,
                            String s)

Specified by:

takeValueForKey in interface NSKeyValueCoding

Overrides:

takeValueForKey in class WOComponent

valueForKey

public Object valueForKey(String s)

Specified by:

valueForKey in interface NSKeyValueCoding

Overrides:

valueForKey in class WOComponent

template

public WOElement template()

Overrides:

template in class WOComponent