er.extensions.components
Class ERXListDisplay

java.lang.Object
  com.webobjects.appserver.WOElement
      com.webobjects.appserver.WOComponent
          er.extensions.components.ERXListDisplay

All Implemented Interfaces:

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

public class ERXListDisplay
extends com.webobjects.appserver.WOComponent

Useful for displaying a list of objects. Ex. a list of person eos could be displayed as "Fred, Mark and Max".
If you give the "item" binding, then the content is used to render. Otherwise the "attribute" binding will get used.

See Also:

Serialized Form

Author:

NetStruxr, kieran - I noticed nullArrayDisplay binding was not implemented. Implemented more useful emptyArrayDisplay with fallback to nullArrayDisplay binding for backwards compatibility.

Bindings

list	list
attribute	attribute
emptyArrayDisplay	the string to display when the array is null or empty
item	current item if in content mode
separator	separator to use for the first items (default ", ")
finalSeparator	separator for the last items (default localized " and ")
escapeHTML	escapeHTML

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.Null, 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

protected java.lang.String	finalSeparator
int	index
protected com.webobjects.foundation.NSArray	list
protected java.lang.String	separator

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

ERXListDisplay(com.webobjects.appserver.WOContext aContext)

Method Summary

java.lang.String	currentSeparator()
java.lang.String	displayString()
java.lang.String	emptyArrayDisplay()
boolean	escapeHTML()
java.lang.String	finalSeparator()
boolean	isEmptyList()
boolean	isStateless()
java.lang.Object	item()
com.webobjects.foundation.NSArray	list()
void	reset()
java.lang.String	separator()
void	setItem(java.lang.Object item)
boolean	synchronizesVariablesWithBindings()
boolean	useContent()

Methods inherited from class com.webobjects.appserver.WOComponent

_associationWithName, _awakeInContext, _childTemplate, _componentDefinition, _componentUnroll, _isPage, _setContext, _setIsPage, _setParent, _setSubcomponent, _sleepInContext, _subcomponentForElementWithID, _templateNameForClass, _unroll, appendToResponse, application, awake, baseURL, bindingKeys, canAccessFieldsDirectly, canGetValueForBinding, canSetValueForBinding, clone, context, debugString, descriptionForResponse, ensureAwakeInContext, frameworkName, generateResponse, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hasBinding, hasSession, invokeAction, isCachingEnabled, isEventLoggingEnabled, logString, name, pageWithName, parent, path, pathURL, performParentAction, pullValuesFromParent, pushValuesToParent, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, sleep, takeValueForKey, takeValueForKeyPath, takeValuesFromRequest, template, templateWithHTMLString, templateWithName, toString, unableToSetNullForKey, validateTakeValueForKeyPath, validateValueForKey, validationFailedWithException, valueForBinding, valueForKey, valueForKeyPath

Methods inherited from class java.lang.Object

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

Field Detail

index

public int index

list

protected com.webobjects.foundation.NSArray list

finalSeparator

protected java.lang.String finalSeparator

separator

protected java.lang.String separator

Constructor Detail

ERXListDisplay

public ERXListDisplay(com.webobjects.appserver.WOContext aContext)

Method Detail

synchronizesVariablesWithBindings

public boolean synchronizesVariablesWithBindings()

Overrides:

synchronizesVariablesWithBindings in class com.webobjects.appserver.WOComponent

isStateless

public boolean isStateless()

Overrides:

isStateless in class com.webobjects.appserver.WOComponent

escapeHTML

public boolean escapeHTML()

useContent

public boolean useContent()

list

public com.webobjects.foundation.NSArray list()

isEmptyList

public boolean isEmptyList()

Returns:

true if the array is null or empty

item

public java.lang.Object item()

setItem

public void setItem(java.lang.Object item)

currentSeparator

public java.lang.String currentSeparator()

finalSeparator

public java.lang.String finalSeparator()

separator

public java.lang.String separator()

reset

public void reset()

Overrides:

reset in class com.webobjects.appserver.WOComponent

displayString

public java.lang.String displayString()

emptyArrayDisplay

public java.lang.String emptyArrayDisplay()

Returns:

what to display when the list is null or empty. Supporting null or empty makes sense since an empty relationship will return an empty array, not a null array.