er.ajax

Class AjaxComponent

java.lang.Object

com.webobjects.appserver.WOElement

com.webobjects.appserver.WOComponent

er.ajax.AjaxComponent

All Implemented Interfaces:

com.webobjects.appserver.WOActionResults, com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCodingAdditions, com.webobjects.foundation.NSValidation, IAjaxElement, Serializable, Cloneable

Direct Known Subclasses:

AjaxAccordion, AjaxAutoComplete, AjaxBusyIndicator, AjaxBusySpinner, AjaxDatePicker, AjaxDraggable, AjaxDroppable, AjaxExpansion, AjaxModalDialog, AjaxModalDialogOpener, AjaxProxy, AjaxSelectionList, AjaxSlider, AjaxSortableList, MTAccordionComponent, MTAccordionContainer, MTAjaxAutoComplete, MTAjaxDraggable, MTAjaxSortableList, MTJSDatePicker

public abstract class AjaxComponent
extends com.webobjects.appserver.WOComponent
implements IAjaxElement

This abstract (by design) superclass component isolate general utility methods.

Version:

$Revision $, $Date $
© 2006 OS communications informatiques, inc. http://www.os.ca Tous droits réservés.

See Also:

Serialized Form

Author:

Jean-Francois Veillette <jean.francois.veillette@gmail.com>

Nested Class Summary

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

com.webobjects.appserver.WOComponent._EventLoggingEnabler, com.webobjects.appserver.WOComponent.Event

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

com.webobjects.foundation.NSKeyValueCodingAdditions.DefaultImplementation, com.webobjects.foundation.NSKeyValueCodingAdditions.Utility

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

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

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

com.webobjects.foundation.NSValidation._MethodBinding, com.webobjects.foundation.NSValidation._ValidationBinding, com.webobjects.foundation.NSValidation.DefaultImplementation, com.webobjects.foundation.NSValidation.Utility, com.webobjects.foundation.NSValidation.ValidationException

Field Summary

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
AjaxComponent(com.webobjects.appserver.WOContext context)

Method Summary

Modifier and Type	Method and Description
protected String	_containerID(com.webobjects.appserver.WOContext context) Returns the ID that represents this container for the purposes of Ajax updates.
protected abstract void	addRequiredWebResources(com.webobjects.appserver.WOResponse response) Override this method to append the needed scripts for this component.
protected void	addScriptResourceInHead(com.webobjects.appserver.WOResponse _response, String _fileName)
protected void	addScriptResourceInHead(com.webobjects.appserver.WOResponse _response, String _framework, String _fileName)
protected void	addStylesheetResourceInHead(com.webobjects.appserver.WOResponse _response, String _fileName)
protected void	addStylesheetResourceInHead(com.webobjects.appserver.WOResponse _response, String _framework, String _fileName)
void	appendTagAttributeToResponse(com.webobjects.appserver.WOResponse response, String name, Object object)
void	appendToResponse(com.webobjects.appserver.WOResponse response, com.webobjects.appserver.WOContext context) Overridden to call addRequiredWebResources(WOResponse).
boolean	booleanValueForBinding(String name, boolean defaultValue) Utility to get the boolean value of a binding or a default value if none is supplied.
abstract com.webobjects.appserver.WOActionResults	handleRequest(com.webobjects.appserver.WORequest request, com.webobjects.appserver.WOContext context) Override this method to return the response for an Ajax request.
com.webobjects.appserver.WOActionResults	invokeAction(com.webobjects.appserver.WORequest request, com.webobjects.appserver.WOContext context) Execute the request, if it's coming from our action, then invoke the ajax handler and put the key AJAX_REQUEST_KEY in the request userInfo dictionary (request.userInfo()).
String	safeElementID()
protected boolean	shouldHandleRequest(com.webobjects.appserver.WORequest request, com.webobjects.appserver.WOContext context)
Object	valueForBinding(String name, Object defaultValue) Utility to get the value of a binding or a default value if none is supplied.
Object	valueForBinding(String name, Object defaultValue, com.webobjects.appserver.WOComponent component)
Object	valueForBinding(String name, com.webobjects.appserver.WOComponent component)

Methods inherited from class com.webobjects.appserver.WOComponent

__valueForBinding, _associationWithName, _awakeInContext, _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, reset, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, setVariableValueForName, sleep, synchronizesVariablesWithBindings, takeValueForKey, takeValueForKeyPath, takeValuesFromRequest, template, templateWithHTMLString, templateWithHTMLString, templateWithHTMLString, templateWithName, toString, unableToSetNullForKey, validateTakeValueForKeyPath, validateValueForKey, validationFailedWithException, valueForBinding, valueForBooleanBinding, valueForIntegerBinding, valueForKey, valueForKeyPath, valueForNSArrayBindings, valueForNSDictionaryBindings, valueForNumberBinding, valueForStringBinding, variableValueForName, variableWithName

Methods inherited from class java.lang.Object

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

Constructor Detail

AjaxComponent

public AjaxComponent(com.webobjects.appserver.WOContext context)

Method Detail

valueForBinding

public Object valueForBinding(String name,
                              Object defaultValue)

Utility to get the value of a binding or a default value if none is supplied.

Parameters:

name - name of the binding

defaultValue - value to return if unbound

Returns:

value for binding or defaultValue value if unbound

booleanValueForBinding

public boolean booleanValueForBinding(String name,
                                      boolean defaultValue)

Utility to get the boolean value of a binding or a default value if none is supplied. Handles non-boolean bindings Numbers, NSArray, String, NSKeyValueCoding.

Parameters:

name - name of the binding

defaultValue - value to return if unbound

Returns:

value for binding or defaultValue value if unbound

valueForBinding

public Object valueForBinding(String name,
                              com.webobjects.appserver.WOComponent component)

Specified by:

valueForBinding in interface IAjaxElement

valueForBinding

public Object valueForBinding(String name,
                              Object defaultValue,
                              com.webobjects.appserver.WOComponent component)

Specified by:

valueForBinding in interface IAjaxElement

addScriptResourceInHead

protected void addScriptResourceInHead(com.webobjects.appserver.WOResponse _response,
                                       String _fileName)

addScriptResourceInHead

protected void addScriptResourceInHead(com.webobjects.appserver.WOResponse _response,
                                       String _framework,
                                       String _fileName)

addStylesheetResourceInHead

protected void addStylesheetResourceInHead(com.webobjects.appserver.WOResponse _response,
                                           String _fileName)

addStylesheetResourceInHead

protected void addStylesheetResourceInHead(com.webobjects.appserver.WOResponse _response,
                                           String _framework,
                                           String _fileName)

invokeAction

public com.webobjects.appserver.WOActionResults invokeAction(com.webobjects.appserver.WORequest request,
                                                             com.webobjects.appserver.WOContext context)

Execute the request, if it's coming from our action, then invoke the ajax handler and put the key AJAX_REQUEST_KEY in the request userInfo dictionary (request.userInfo()).

Overrides:

invokeAction in class com.webobjects.appserver.WOComponent

Parameters:

request - the request

context - context of the transaction

Returns:

a WOActionResults containing the result of the request

_containerID

protected String _containerID(com.webobjects.appserver.WOContext context)

Returns the ID that represents this container for the purposes of Ajax updates. In common cases, this corresponds to your updateContainerID.

Parameters:

context - the current context

Returns:

your container ID

shouldHandleRequest

protected boolean shouldHandleRequest(com.webobjects.appserver.WORequest request,
                                      com.webobjects.appserver.WOContext context)

safeElementID

public String safeElementID()

appendToResponse

public void appendToResponse(com.webobjects.appserver.WOResponse response,
                             com.webobjects.appserver.WOContext context)

Overridden to call addRequiredWebResources(WOResponse).

Overrides:

appendToResponse in class com.webobjects.appserver.WOComponent

Parameters:

response - the HTTP response that an application returns to a Web server to complete a cycle of the request-response loop

context - context of a transaction

appendTagAttributeToResponse

public void appendTagAttributeToResponse(com.webobjects.appserver.WOResponse response,
                                         String name,
                                         Object object)

addRequiredWebResources

protected abstract void addRequiredWebResources(com.webobjects.appserver.WOResponse response)

Override this method to append the needed scripts for this component.

Parameters:

response - the response to write to

handleRequest

public abstract com.webobjects.appserver.WOActionResults handleRequest(com.webobjects.appserver.WORequest request,
                                                                       com.webobjects.appserver.WOContext context)

Override this method to return the response for an Ajax request.

Specified by:

handleRequest in interface IAjaxElement

Parameters:

request - the request

context - the context