public interface SortObserver
Some sample uses include:
SortController
Modifier and Type | Method and Description |
---|---|
void |
addToFreeList(DataValueDescriptor[] objectArray,
int maxFreeListSize) |
boolean |
deferrable()
Overridden by subclasses that observe sorters with uniqueness checking.
|
boolean |
deferred()
Overridden by subclasses that observe sorters with uniqueness checking.
|
DataValueDescriptor[] |
getArrayClone() |
DataValueDescriptor[] |
insertDuplicateKey(DataValueDescriptor[] insertRow,
DataValueDescriptor[] existingRow)
Called prior to inserting a duplicate sort
key.
|
DataValueDescriptor[] |
insertNonDuplicateKey(DataValueDescriptor[] insertRow)
Called prior to inserting a distinct sort
key; in other words, the first time that a
key is inserted into the sorter, this method
is called.
|
void |
rememberDuplicate(DataValueDescriptor[] row)
Overridden by subclasses that observe sorters with uniqueness checking.
|
DataValueDescriptor[] insertNonDuplicateKey(DataValueDescriptor[] insertRow) throws StandardException
This method will most commonly be used to clone the row that is retained by the sorter, or possibly to do some initialization of that row.
insertRow
- the current row that the sorter
is on the verge of retainingStandardException
- either on unexpected exception,
or on expected user error that is to percolate back
to the driver of the sort.DataValueDescriptor[] insertDuplicateKey(DataValueDescriptor[] insertRow, DataValueDescriptor[] existingRow) throws StandardException
insertRow
- the current row that the sorter
is on the verge of retaining. It is a duplicate
of existingRow.existingRow
- the row that is already in the
the sorter which is a duplicate of insertRowStandardException
- either on unexpected exception,
or on expected user error that is to percolate back
to the driver of the sort.void addToFreeList(DataValueDescriptor[] objectArray, int maxFreeListSize)
DataValueDescriptor[] getArrayClone() throws StandardException
StandardException
boolean deferrable()
boolean deferred()
void rememberDuplicate(DataValueDescriptor[] row) throws StandardException
row
- data of offending keyStandardException
- standard error policyApache Derby V10.13 Internals - Copyright © 2004,2016 The Apache Software Foundation. All Rights Reserved.