er.extensions.appserver
Class ERXDisplayGroup<T>

java.lang.Object
  com.webobjects.appserver.WODisplayGroup
      er.extensions.appserver.ERXDisplayGroup<T>

All Implemented Interfaces:

com.webobjects.eocontrol.EOKeyValueArchiving, com.webobjects.eocontrol.EOKeyValueArchiving.Awaking, com.webobjects.foundation.NSDisposable, com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, java.io.Serializable

Direct Known Subclasses:

ERXBatchingDisplayGroup

public class ERXDisplayGroup<T>
extends com.webobjects.appserver.WODisplayGroup

Extends WODisplayGroup

• provide access to the filtered objects
• allows you to add qualifiers to the final query qualifier (as opposed to just min/equals/max with the keys)
• clears out the sort ordering when the datasource changes. This is a cure fix to prevent errors when using switch components.

See Also:

Serialized Form

Author:

ak

Nested Class Summary

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

com.webobjects.appserver.WODisplayGroup.Delegate

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.DefaultImplementation, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCoding.Null, com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException, com.webobjects.foundation.NSKeyValueCoding.Utility, com.webobjects.foundation.NSKeyValueCoding.ValueAccessor

Nested classes/interfaces inherited from interface com.webobjects.eocontrol.EOKeyValueArchiving

com.webobjects.eocontrol.EOKeyValueArchiving._NullValueSupport, com.webobjects.eocontrol.EOKeyValueArchiving._NumberSupport, com.webobjects.eocontrol.EOKeyValueArchiving._TimestampSupport, com.webobjects.eocontrol.EOKeyValueArchiving.Awaking, com.webobjects.eocontrol.EOKeyValueArchiving.FinishInitialization, com.webobjects.eocontrol.EOKeyValueArchiving.Support

Field Summary

Fields inherited from class com.webobjects.appserver.WODisplayGroup

DisplayGroupWillFetchNotification

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

_CLASS, NullValue

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

_CLASS

Fields inherited from interface com.webobjects.foundation.NSDisposable

_CLASS

Fields inherited from interface com.webobjects.eocontrol.EOKeyValueArchiving

_CLASS

Fields inherited from interface com.webobjects.eocontrol.EOKeyValueArchiving.Awaking

_CLASS

Constructor Summary

ERXDisplayGroup()

Method Summary

com.webobjects.foundation.NSArray<T>	allObjects() Overridden to return generic types
com.webobjects.foundation.NSArray<java.lang.String>	allQualifierOperators() Overridden to return generic types
void	clearExtraQualifiers()
static java.lang.Object	decodeWithKeyValueUnarchiver(com.webobjects.eocontrol.EOKeyValueUnarchiver unarchiver) Decodes an ERXDisplayGroup from the given unarchiver.
com.webobjects.foundation.NSArray<T>	displayedObjects() Overridden to return generic types
java.lang.Object	displayNextBatch() Overriden to re-set the selection.
java.lang.Object	displayPreviousBatch() Overriden to re-set the selection.
java.lang.Object	fetch() Overridden to localize the fetch specification if needed.
com.webobjects.foundation.NSArray<T>	filteredObjects() Returns all objects, filtered by the qualifier().
int	indexOfFirstDisplayedObject() Overridden to return correct result when no objects are displayed
int	indexOfLastDisplayedObject() Overridden to return correct index if the number of filtered objects is not a multiple of numberOfObjectsPerBatch and we are on the last batch index.
com.webobjects.eocontrol.EOQualifier	qualifierFromQueryValues() Overridden to support extra qualifiers.
T	selectedObject() Overridden to return generic types
com.webobjects.foundation.NSArray<T>	selectedObjects() Overridden to track selection changes.
java.lang.Object	selectFilteredObjects() Selects the visible objects.
void	setDataSource(com.webobjects.eocontrol.EODataSource eodatasource) Overridden to clear out the sort ordering if it is no longer applicable.
void	setNumberOfObjectsPerBatch(int i) Overriden to re-set the selection.
void	setQualifierForKey(com.webobjects.eocontrol.EOQualifier qualifier, java.lang.String key)
void	setSelectedObjects(com.webobjects.foundation.NSArray nsarray) Overridden to track selection changes.
boolean	setSelectionIndexes(com.webobjects.foundation.NSArray nsarray) Overridden to track selection changes.
void	setSortOrderings(com.webobjects.foundation.NSArray nsarray) Overridden to log a message when more than one sort order exists.
com.webobjects.foundation.NSArray<T>	sortedObjects() Returns allObjects(), first filtered by the qualifier(), then sorted by the sortOrderings().
com.webobjects.foundation.NSArray<com.webobjects.eocontrol.EOSortOrdering>	sortOrderings() Overridden to return generic types

Methods inherited from class com.webobjects.appserver.WODisplayGroup

_beginObserverNotification, _deleteObject, _insertObjectAtIndex, _lastObserverNotified, awakeFromKeyValueUnarchiver, batchCount, clearSelection, currentBatchIndex, dataSource, defaultStringMatchFormat, defaultStringMatchOperator, delegate, delete, deleteObjectAtIndex, deleteSelection, detailKey, displayBatchContainingSelectedObject, dispose, editingContextPresentErrorMessage, encodeWithCoder, encodeWithKeyValueArchiver, endEditing, fetchesOnLoad, finishInitialization, globalDefaultForValidatesChangesImmediately, globalDefaultStringMatchFormat, globalDefaultStringMatchOperator, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hasDetailDataSource, hasMultipleBatches, initWithCoder, inQueryMode, insert, insertedObjectDefaultValues, insertNewObjectAtIndex, insertObjectAtIndex, localKeys, masterObject, numberOfObjectsPerBatch, objectsChangedInEditingContext, objectsInvalidatedInEditingContext, qualifier, qualifyDataSource, qualifyDisplayGroup, queryBindings, queryMatch, queryMax, queryMin, queryOperator, redisplay, relationalQualifierOperators, selectionIndexes, selectNext, selectObject, selectObjectsIdenticalTo, selectObjectsIdenticalToSelectFirstOnNoMatch, selectPrevious, selectsFirstObjectAfterFetch, setCurrentBatchIndex, setDefaultStringMatchFormat, setDefaultStringMatchOperator, setDelegate, setDetailKey, setFetchesOnLoad, setGlobalDefaultForValidatesChangesImmediately, setGlobalDefaultStringMatchFormat, setGlobalDefaultStringMatchOperator, setInQueryMode, setInsertedObjectDefaultValues, setLocalKeys, setMasterObject, setObjectArray, setQualifier, setSelectedObject, setSelectsFirstObjectAfterFetch, setValidatesChangesImmediately, stringQualifierOperators, takeValueForKey, toString, unableToSetNullForKey, undoManager, updateDisplayedObjects, validatesChangesImmediately, valueForKey, willChange

Methods inherited from class java.lang.Object

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

Constructor Detail

ERXDisplayGroup

public ERXDisplayGroup()

Method Detail

decodeWithKeyValueUnarchiver

public static java.lang.Object decodeWithKeyValueUnarchiver(com.webobjects.eocontrol.EOKeyValueUnarchiver unarchiver)

Decodes an ERXDisplayGroup from the given unarchiver.

Parameters:

unarchiver - the unarchiver to construct this display group with

Returns:

the corresponding batching display group

setQualifierForKey

public void setQualifierForKey(com.webobjects.eocontrol.EOQualifier qualifier,
                               java.lang.String key)

qualifierFromQueryValues

public com.webobjects.eocontrol.EOQualifier qualifierFromQueryValues()

Overridden to support extra qualifiers.

Overrides:

qualifierFromQueryValues in class com.webobjects.appserver.WODisplayGroup

fetch

public java.lang.Object fetch()

Overridden to localize the fetch specification if needed.

Overrides:

fetch in class com.webobjects.appserver.WODisplayGroup

filteredObjects

public com.webobjects.foundation.NSArray<T> filteredObjects()

Returns all objects, filtered by the qualifier().

sortedObjects

public com.webobjects.foundation.NSArray<T> sortedObjects()

Returns allObjects(), first filtered by the qualifier(), then sorted by the sortOrderings().

selectedObjects

public com.webobjects.foundation.NSArray<T> selectedObjects()

Overridden to track selection changes.

Overrides:

selectedObjects in class com.webobjects.appserver.WODisplayGroup

setSelectedObjects

public void setSelectedObjects(com.webobjects.foundation.NSArray nsarray)

Overridden to track selection changes.

Overrides:

setSelectedObjects in class com.webobjects.appserver.WODisplayGroup

setSelectionIndexes

public boolean setSelectionIndexes(com.webobjects.foundation.NSArray nsarray)

Overridden to track selection changes.

Overrides:

setSelectionIndexes in class com.webobjects.appserver.WODisplayGroup

setNumberOfObjectsPerBatch

public void setNumberOfObjectsPerBatch(int i)

Overriden to re-set the selection. Why is this cleared in the super class?

Overrides:

setNumberOfObjectsPerBatch in class com.webobjects.appserver.WODisplayGroup

setDataSource

public void setDataSource(com.webobjects.eocontrol.EODataSource eodatasource)

Overridden to clear out the sort ordering if it is no longer applicable.

Overrides:

setDataSource in class com.webobjects.appserver.WODisplayGroup

displayNextBatch

public java.lang.Object displayNextBatch()

Overriden to re-set the selection. Why is this cleared in the super class?

Overrides:

displayNextBatch in class com.webobjects.appserver.WODisplayGroup

displayPreviousBatch

public java.lang.Object displayPreviousBatch()

Overriden to re-set the selection. Why is this cleared in the super class?

Overrides:

displayPreviousBatch in class com.webobjects.appserver.WODisplayGroup

selectFilteredObjects

public java.lang.Object selectFilteredObjects()

Selects the visible objects.

setSortOrderings

public void setSortOrderings(com.webobjects.foundation.NSArray nsarray)

Overridden to log a message when more than one sort order exists. Useful to track down errors.

Overrides:

setSortOrderings in class com.webobjects.appserver.WODisplayGroup

clearExtraQualifiers

public void clearExtraQualifiers()

allObjects

public com.webobjects.foundation.NSArray<T> allObjects()

Overridden to return generic types

Overrides:

allObjects in class com.webobjects.appserver.WODisplayGroup

allQualifierOperators

public com.webobjects.foundation.NSArray<java.lang.String> allQualifierOperators()

Overridden to return generic types

Overrides:

allQualifierOperators in class com.webobjects.appserver.WODisplayGroup

displayedObjects

public com.webobjects.foundation.NSArray<T> displayedObjects()

Overridden to return generic types

Overrides:

displayedObjects in class com.webobjects.appserver.WODisplayGroup

selectedObject

public T selectedObject()

Overridden to return generic types

Overrides:

selectedObject in class com.webobjects.appserver.WODisplayGroup

sortOrderings

public com.webobjects.foundation.NSArray<com.webobjects.eocontrol.EOSortOrdering> sortOrderings()

Overridden to return generic types

Overrides:

sortOrderings in class com.webobjects.appserver.WODisplayGroup

indexOfFirstDisplayedObject

public int indexOfFirstDisplayedObject()

Overridden to return correct result when no objects are displayed

Overrides:

indexOfFirstDisplayedObject in class com.webobjects.appserver.WODisplayGroup

indexOfLastDisplayedObject

public int indexOfLastDisplayedObject()

Overridden to return correct index if the number of filtered objects is not a multiple of numberOfObjectsPerBatch and we are on the last batch index. The superclass incorrectly uses allObjects instead of displayedObjects to determine the index value.

Overrides:

indexOfLastDisplayedObject in class com.webobjects.appserver.WODisplayGroup