oracle.jbo.server
Class QueryCollection

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractList
          oracle.jbo.server.QueryCollection

All Implemented Interfaces:

java.lang.Iterable, java.util.Collection, java.util.List, PCollListener

public class QueryCollection
extends java.util.AbstractList
implements PCollListener

The QueryCollection represents the result of executing a ViewRow. The QueryCollection object will use the meta-data provided to "pull-apart" the rows of data that come back and locate/construct the appropriate Entity row definition.

In essense, it is a collection of ViewRow's.

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Method Summary

void	add(int index, java.lang.Object row) Add a row to the QueryCollection at the specified index.
void	afterActivateElement(PCollection pcoll, PCollPersistable elem)
protected void	afterRemove(EntityImpl entity) Removes the ViewRow from cache and collection
void	beforePassivateElement(PCollection pcoll, PCollPersistable elem)
boolean	cancelQuery()
boolean	equals(java.lang.Object qc)
protected void	finalize()
java.lang.Object	get(int index) Return the data at the index.
protected PCollection	getCollectionInternal()
int	getCollectionSize()
java.lang.Object[]	getFilterParamValues(ViewRowImpl viewRow, java.lang.Object[] newVals, int[] newValIndices)
protected int[]	getIndexes(EntityImpl row)
java.lang.String	getName(java.lang.Object accessKey)
java.util.ArrayList	getNewRowTracker()
long	getNextObjId()
int	getNumUserParams()
java.sql.ResultSet	getResultSet()
RowFilter	getRowFilter()
protected Row[]	getRows(EntityImpl row)
protected Row[]	getRows(Key ky)
ViewRowSetImpl	getRowSetImpl()
oracle.jbo.server.ViewRowStorage	getRowStorageFromId(long id)
int	hashCode()
int	indexOf(java.lang.Object row)
boolean	isDirty()
boolean	isExecuted()
boolean	isSkipQuery()
void	printActiveObjsTab(java.io.PrintWriter pw)
void	printColl(java.io.PrintWriter pw, int printFlag)
void	printRUChain(java.io.PrintWriter pw)
java.lang.Object	remove(int index) Remove a row from the QueryCollection at the specified index.
java.lang.Object	removeAndRetain(int index)
java.lang.Object	removeFromCollection(int index)
protected void	removeReference(ViewRowImpl row, EntityImpl entity) Remove entity references, i.e, set references to null
java.lang.Object	set(int index, java.lang.Object element) Set the data at the index.
int	size() The size of the Collection.
protected void	updateReference(ViewRowImpl row, EntityImpl entity, int entityIndex) Set reference entity based on foreign keys

Methods inherited from class java.util.AbstractList

add, addAll, clear, iterator, lastIndexOf, listIterator, listIterator, removeRange, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray

Method Detail

getNewRowTracker

public java.util.ArrayList getNewRowTracker()

beforePassivateElement

public void beforePassivateElement(PCollection pcoll,
                                   PCollPersistable elem)

Specified by:

beforePassivateElement in interface PCollListener

afterActivateElement

public void afterActivateElement(PCollection pcoll,
                                 PCollPersistable elem)

Specified by:

afterActivateElement in interface PCollListener

getNextObjId

public long getNextObjId()

Specified by:

getNextObjId in interface PCollListener

getResultSet

public java.sql.ResultSet getResultSet()

cancelQuery

public boolean cancelQuery()

size

public int size()

The size of the Collection. Implementation of the Collection interface.

--Calling this method will result in the entire Collection being --brought into memory (in order to give an accurate count of the --rows in it). THIS HAS CHANGED. THE NEW BEHAVIOR IS : We're currently returning only the fetched size of the query collection We could return the correct size, if atleast one row is fetched, however we should NOT return correct size if no rows are fetched (and thereby getting all rows in memory as AbstractList.hash() performs hasNext() that performs size() leading to fetching all row at the very beginning of iteration). - modified during move to AbstractList from Vector.

Specified by:

size in interface java.util.Collection

Specified by:

size in interface java.util.List

Specified by:

size in class java.util.AbstractCollection

Returns:

the number of rows in the collection.

get

public java.lang.Object get(int index)

Return the data at the index. Implementation of the Collection interface.

Specified by:

get in interface java.util.List

Specified by:

get in class java.util.AbstractList

Parameters:

index - the row index to use.

Returns:

the data at that row.

getRowStorageFromId

public oracle.jbo.server.ViewRowStorage getRowStorageFromId(long id)

set

public java.lang.Object set(int index,
                            java.lang.Object element)

Set the data at the index. Implementation of the Collection interface.

Specified by:

set in interface java.util.List

Overrides:

set in class java.util.AbstractList

Parameters:

index - the row index to use.

element - the value to put there.

add

public void add(int index,
                java.lang.Object row)

Add a row to the QueryCollection at the specified index.

Specified by:

add in interface java.util.List

Overrides:

add in class java.util.AbstractList

Parameters:

index - the insertion index or -ve to insert at the end.

row - a ViewRow row to be inserted into the QueryCollection.

remove

public java.lang.Object remove(int index)

Remove a row from the QueryCollection at the specified index.

Specified by:

remove in interface java.util.List

Overrides:

remove in class java.util.AbstractList

Parameters:

index - the deletion index.

Returns:

the row removed.

removeFromCollection

public java.lang.Object removeFromCollection(int index)

removeAndRetain

public java.lang.Object removeAndRetain(int index)

getCollectionSize

public int getCollectionSize()

getCollectionInternal

protected PCollection getCollectionInternal()

getIndexes

protected int[] getIndexes(EntityImpl row)

Parameters:

row - to locate view rows which reference it.

Returns:

the row indexes of view rows

getRowSetImpl

public ViewRowSetImpl getRowSetImpl()

isExecuted

public final boolean isExecuted()

indexOf

public int indexOf(java.lang.Object row)

Specified by:

indexOf in interface java.util.List

Overrides:

indexOf in class java.util.AbstractList

afterRemove

protected void afterRemove(EntityImpl entity)

Removes the ViewRow from cache and collection

getRows

protected Row[] getRows(EntityImpl row)

Returns:

a list for ViewRows that reference the entity

getRows

protected Row[] getRows(Key ky)

removeReference

protected void removeReference(ViewRowImpl row,
                               EntityImpl entity)

Remove entity references, i.e, set references to null

updateReference

protected void updateReference(ViewRowImpl row,
                               EntityImpl entity,
                               int entityIndex)

Set reference entity based on foreign keys

isDirty

public boolean isDirty()

isSkipQuery

public boolean isSkipQuery()

getRowFilter

public RowFilter getRowFilter()

getNumUserParams

public int getNumUserParams()

getName

public java.lang.String getName(java.lang.Object accessKey)

getFilterParamValues

public java.lang.Object[] getFilterParamValues(ViewRowImpl viewRow,
                                               java.lang.Object[] newVals,
                                               int[] newValIndices)

printActiveObjsTab

public void printActiveObjsTab(java.io.PrintWriter pw)

printRUChain

public void printRUChain(java.io.PrintWriter pw)

printColl

public void printColl(java.io.PrintWriter pw,
                      int printFlag)

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object

hashCode

public int hashCode()

Specified by:

hashCode in interface java.util.Collection

Specified by:

hashCode in interface java.util.List

Overrides:

hashCode in class java.util.AbstractList

equals

public boolean equals(java.lang.Object qc)

Specified by:

equals in interface java.util.Collection

Specified by:

equals in interface java.util.List

Overrides:

equals in class java.util.AbstractList