er.extensions.components.javascript

Class ERXJSToManyRelationshipEditor

java.lang.Object

com.webobjects.appserver.WOElement

com.webobjects.appserver.WOComponent

er.extensions.components.ERXComponent

er.extensions.components.ERXNonSynchronizingComponent

er.extensions.components.javascript.ERXJSToManyRelationshipEditor

All Implemented Interfaces:

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

public class ERXJSToManyRelationshipEditor
extends ERXNonSynchronizingComponent

A fancy to-many relationship editor component.

See Also:

Serialized Form

Author:

Travis Cripps

Bindings

Name	Description
displayString	for the items in the menu, this should be a keyPath that will be resolved from each item to produce the display string for the item.
item	to use as an iteration variable
list	of items to display; equivalent to the possible values from which a user might choose
selections	items from the list that are selected. The resulting selections will be pushed back into the parent component's variable that is bound to the selections binding.
sortKey	(optional) to use in order to produce a sorted menu

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ERXJSToManyRelationshipEditor.Keys

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

Modifier and Type	Field and Description
protected NSArray	_list
protected NSArray	_selections
protected Object	currentItem

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

Method Summary

Modifier and Type	Method and Description
String	addItemScript() Builds the JavaScript used to add the selected item from the selections popup to the selected items.
void	appendToResponse(com.webobjects.appserver.WOResponse aResponse, com.webobjects.appserver.WOContext aContext) Calls ERXNonSynchronizingComponent.resetCachedBindingsInStatefulComponent() prior to super.appendToResponse.
String	availableValuesPopupMenu() Builds the select menu for adding available items to the selected items.
Object	currentItem() Gets the item currently being displayed.
String	displayString() Gets the display string for the current item.
String	editorContextID() Gets the context ID of the editor (this component), escaped for use in JavaScript.
String	editorName() Formats the name of this editor instance.
String	hiddenFieldName() Formats the name of the hidden field for this editor instance.
void	invalidateCaches() Resets the state variables.
boolean	isListEmpty() Determines if the list is empty
boolean	isStateless()
int	itemIndex() Gets the index of the current item in the overall list.
String	javascriptForThisEditorInstance() Formats the JavaScript used to initialize this instance of the editor.
NSArray	list() Gets the list of items to display.
NSArray	maybeSortedList() Gets the list of items and sorts it by the sort key if a sort key is available.
String	removeItemScript() Builds the JavaScript used to remove the item from the selections.
void	reset() このメソッドは、指定されているコンテクストのオブジェクトに対する、 ステートレス・コンポーネントの一時的リファレンスをリセットもしくは削除します。 あるコンポーネントの共有化されたインスタンスが、他のセッションによって再利用されるとき、 このメソッドを利用し、各コンポーネントのインスタンス変数を解放します。
String	selectedValuesTableName() Formats the name of the selected values table for this editor instance.
NSArray	selections() Gets the selections.
String	selectionsString() Formats the selection string for the hidden field from the indexes of the items in the selection subset of the list.
void	setCurrentItem(Object anItem) Sets the item being displayed.
void	setSelectionsString(String value) Sets the selection string from the input.
void	sleep()

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, 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, logString, name, pageWithName, parent, path, pathURL, performParentAction, pullValuesFromParent, pushValuesToParent, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, setVariableValueForName, takeValueForKey, takeValueForKeyPath, 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

Field Detail

_list

protected NSArray _list

_selections

protected NSArray _selections

currentItem

protected Object currentItem

Constructor Detail

ERXJSToManyRelationshipEditor

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

Method Detail

isStateless

public boolean isStateless()

Overrides:

isStateless in class com.webobjects.appserver.WOComponent

reset

public void reset()

Description copied from class: ERXComponent

このメソッドは、指定されているコンテクストのオブジェクトに対する、 ステートレス・コンポーネントの一時的リファレンスをリセットもしくは削除します。 あるコンポーネントの共有化されたインスタンスが、他のセッションによって再利用されるとき、 このメソッドを利用し、各コンポーネントのインスタンス変数を解放します。

Overrides:

reset in class ERXComponent

currentItem

public Object currentItem()

Gets the item currently being displayed.

Returns:

the item

setCurrentItem

public void setCurrentItem(Object anItem)

Sets the item being displayed.

Parameters:

anItem - to display

list

public NSArray list()

Gets the list of items to display.

Returns:

the list of items

selections

public NSArray selections()

Gets the selections.

Returns:

the selections

displayString

public String displayString()

Gets the display string for the current item.

Returns:

the display string

invalidateCaches

public void invalidateCaches()

Resets the state variables.

sleep

public void sleep()

Overrides:

sleep in class com.webobjects.appserver.WOComponent

appendToResponse

public void appendToResponse(com.webobjects.appserver.WOResponse aResponse,
                             com.webobjects.appserver.WOContext aContext)

Description copied from class: ERXNonSynchronizingComponent

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

Overrides:

appendToResponse in class ERXNonSynchronizingComponent

Parameters:

aResponse - to which we are appending

aContext - context of the response

maybeSortedList

public NSArray maybeSortedList()

Gets the list of items and sorts it by the sort key if a sort key is available.

Returns:

the maybe sorted list

isListEmpty

public boolean isListEmpty()

Determines if the list is empty

Returns:

true if the list is empty

itemIndex

public int itemIndex()

Gets the index of the current item in the overall list.

Returns:

the index of the current item

selectionsString

public String selectionsString()

Formats the selection string for the hidden field from the indexes of the items in the selection subset of the list.

Returns:

the selection string

setSelectionsString

public void setSelectionsString(String value)

Sets the selection string from the input. Parses the input string to isolate the indexes of the selected items and looks them up in the array. Then pushes the selections up to the parent binding.

Parameters:

value - of the selections string

editorContextID

public String editorContextID()

Gets the context ID of the editor (this component), escaped for use in JavaScript.

Returns:

the context ID

editorName

public String editorName()

Formats the name of this editor instance.

Returns:

the editor name

hiddenFieldName

public String hiddenFieldName()

Formats the name of the hidden field for this editor instance.

Returns:

the hidden field's name

selectedValuesTableName

public String selectedValuesTableName()

Formats the name of the selected values table for this editor instance.

Returns:

the table's name

javascriptForThisEditorInstance

public String javascriptForThisEditorInstance()

Formats the JavaScript used to initialize this instance of the editor.

Returns:

the script for this editor

removeItemScript

public String removeItemScript()

Builds the JavaScript used to remove the item from the selections.

Returns:

the script

addItemScript

public String addItemScript()

Builds the JavaScript used to add the selected item from the selections popup to the selected items.

Returns:

the script

availableValuesPopupMenu

public String availableValuesPopupMenu()

Builds the select menu for adding available items to the selected items.

Returns:

the string for the select menu