org.eclipse.persistence.internal.sessions.remote

Class RemoteScrollableCursor

java.lang.Object

org.eclipse.persistence.queries.Cursor

org.eclipse.persistence.queries.ScrollableCursor

org.eclipse.persistence.internal.sessions.remote.RemoteScrollableCursor

All Implemented Interfaces:

java.io.Serializable, java.util.Enumeration, java.util.Iterator, java.util.ListIterator

public class RemoteScrollableCursor
extends ScrollableCursor

Purpose: The object is used as a wrapper to the ScrollableCursor object in the remote transaction (via RMI, CORBA, etc.)

Responsibilities: Wraps a database result set cursor to provide a stream to the remote client side on the resulting selected objects.

Note: Most of the APIs only work with JDBC 2.0

Since:

TOPLink/Java 3.0

Author:

King (Yaoping) Wang

See Also:

Serialized Form

Field Summary

Fields inherited from class org.eclipse.persistence.queries.Cursor

policy, query

Constructor Summary

Constructors

Constructor and Description
RemoteScrollableCursor(ScrollableCursor serverScrollableCursor)

Method Summary

Modifier and Type	Method and Description
boolean	absolute(int rows) Moves the cursor to the given row number in the result set
void	afterLast() Moves the cursor to the end of the result set, just after the last row.
void	beforeFirst() Moves the cursor to the front of the result set, just before the first row
void	close() Close the wrapped cursored stream This should be performed whenever the user has finished with the stream.
int	currentIndex() Retrieves the current row index number
boolean	first() Moves the cursor to the first row in the result set
java.rmi.server.ObjID	getID() INTERNAL: Retreive the OID of the wrapped cursored stream.
boolean	isAfterLast() Indicates whether the cursor is after the last row in the result set.
boolean	isBeforeFirst() Indicates whether the cursor is before the first row in the result set.
boolean	isClosed() INTERNAL: Return if the stream is closed.
boolean	isFirst() Indicates whether the cursor is on the first row of the result set.
boolean	isLast() Indicates whether the cursor is on the last row of the result set.
boolean	last() Moves the cursor to the last row in the result set
boolean	relative(int rows) Moves the cursor a relative number of rows, either positive or negative.

Methods inherited from class org.eclipse.persistence.queries.ScrollableCursor

add, getPosition, hasMoreElements, hasNext, hasNextElement, hasPrevious, next, next, nextElement, nextIndex, previous, previousIndex, set

Methods inherited from class org.eclipse.persistence.queries.Cursor

clear, getAccessor, getExecutionSession, getFields, getInitiallyConformingIndex, getObjectCollection, getPageSize, getPolicy, getQuery, getResultSet, getSelectionCriteriaClone, getSession, remove, setInitiallyConformingIndex, setObjectCollection, setPolicy, setSelectionCriteriaClone, setSession, setSize, setTranslationRow, size

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.ListIterator

remove

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Detail

RemoteScrollableCursor

public RemoteScrollableCursor(ScrollableCursor serverScrollableCursor)

Method Detail

absolute

public boolean absolute(int rows)
                 throws DatabaseException

Moves the cursor to the given row number in the result set

Overrides:

absolute in class ScrollableCursor

Throws:

DatabaseException

afterLast

public void afterLast()
               throws DatabaseException

Moves the cursor to the end of the result set, just after the last row.

Overrides:

afterLast in class ScrollableCursor

Throws:

DatabaseException

beforeFirst

public void beforeFirst()
                 throws DatabaseException

Moves the cursor to the front of the result set, just before the first row

Overrides:

beforeFirst in class ScrollableCursor

Throws:

DatabaseException

close

public void close()
           throws DatabaseException

Close the wrapped cursored stream This should be performed whenever the user has finished with the stream.

Overrides:

close in class Cursor

Throws:

DatabaseException

currentIndex

public int currentIndex()
                 throws DatabaseException

Retrieves the current row index number

Overrides:

currentIndex in class ScrollableCursor

Throws:

DatabaseException

first

public boolean first()
              throws DatabaseException

Moves the cursor to the first row in the result set

Overrides:

first in class ScrollableCursor

Throws:

DatabaseException

getID

public java.rmi.server.ObjID getID()

INTERNAL: Retreive the OID of the wrapped cursored stream.

isAfterLast

public boolean isAfterLast()
                    throws DatabaseException

Indicates whether the cursor is after the last row in the result set.

Overrides:

isAfterLast in class ScrollableCursor

Throws:

DatabaseException

isBeforeFirst

public boolean isBeforeFirst()
                      throws DatabaseException

Indicates whether the cursor is before the first row in the result set.

Overrides:

isBeforeFirst in class ScrollableCursor

Throws:

DatabaseException

isClosed

public boolean isClosed()

INTERNAL: Return if the stream is closed.

Overrides:

isClosed in class Cursor

isFirst

public boolean isFirst()
                throws DatabaseException

Indicates whether the cursor is on the first row of the result set.

Overrides:

isFirst in class ScrollableCursor

Throws:

DatabaseException

isLast

public boolean isLast()
               throws DatabaseException

Indicates whether the cursor is on the last row of the result set.

Overrides:

isLast in class ScrollableCursor

Throws:

DatabaseException

last

public boolean last()
             throws DatabaseException

Moves the cursor to the last row in the result set

Overrides:

last in class ScrollableCursor

Throws:

DatabaseException

relative

public boolean relative(int rows)
                 throws DatabaseException

Moves the cursor a relative number of rows, either positive or negative. Attempting to move beyond the first/last row in the result set positions the cursor before/after the the first/last row

Overrides:

relative in class ScrollableCursor

Throws:

DatabaseException