Class RemoteResultSetCursorImpl<T extends PersistentDomainObject<T>>

java.lang.Object

org.tentackle.dbms.trip.RemoteDbDelegateImpl<T>

org.tentackle.persist.trip.RemoteResultSetCursorImpl<T>

Type Parameters:

T - the object type

All Implemented Interfaces:

RemoteDbDelegate, RemoteResultSetCursor<T>, Remote

public class RemoteResultSetCursorImpl<T extends PersistentDomainObject<T>>
extends RemoteDbDelegateImpl<T>
implements RemoteResultSetCursor<T>

Remote delegate implementation for ResultSetCursor.

Author:

harald

Constructor Summary

Constructors

Constructor	Description
RemoteResultSetCursorImpl(RemoteDbSessionImpl session, Class<T> clazz)	Creates a remote cursor delegate.

Method Summary

Modifier and Type	Method	Description
int	afterLast()	Positions the cursor after the last row. Works even for empty cursors.
void	beforeFirst()	Positions the cursor before the first row. Works even for empty cursors.
void	close()	Closes the scrollable resource. The scrollable resource is opened in its constructor.
void	configureDelegate(Object... args)	Configures the delegate.
ResultSetCursor.FetchList<T>	fetch()	Fetches the next objects up to the fetchsize. This method is provided to minimize the number of roundtrips especially for remote cursors.
boolean	first()	Rewinds the cursor to the first row.
T	get()	Gets the data object of the current row.
ResultSetCursor<T>	getCursor()	Gets the local cursor.
int	getFetchDirection()	Gets the fetch direction.
int	getFetchSize()	Gets the fetchsize.
boolean	isAfterLast()	Checks whether the cursor is after the last row.
int	last()	Positions the cursor on the last row.
boolean	next()	Moves the cursor to the next row.
boolean	previous()	Moves the cursor to the previous row.
int	scroll(int rows)	Moves the cursor a given number of rows.
void	setCursor(ResultSetCursor<T> cursor)	Sets the local cursor.
void	setFetchDirection(int direction)	Sets the fetch direction.
void	setFetchSize(int rows)	Sets the fetchsize. This is the number of rows the cursor will fetch from the server in one batch.
int	setRow(int row)	Sets the cursor to a given row. Row numbers start at 1.
List<T>	toList()	Returns the objects of this cursor as a list.
String	toString()

Methods inherited from class RemoteDbDelegateImpl

getServerSession, getServicedClass, getSession, initialize

Methods inherited from class Object

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

Constructor Details

RemoteResultSetCursorImpl

public RemoteResultSetCursorImpl(RemoteDbSessionImpl session,
 Class<T> clazz)

Creates a remote cursor delegate.

Parameters:

session - the TRIP session

clazz - the PDO interface class

Method Details

toString

public String toString()

Overrides:

toString in class RemoteDbDelegateImpl<T extends PersistentDomainObject<T>>

configureDelegate

public void configureDelegate(Object... args)

Configures the delegate.

Invoked from RemoteDbSessionImpl.createRemoteDelegateInstance(Class, Class, Class, Class, Object...) by reflection.

Parameters:

args - the configuration parameters

setCursor

public void setCursor(ResultSetCursor<T> cursor)

Sets the local cursor.

Parameters:

cursor - the cursor

getCursor

public ResultSetCursor<T> getCursor()

Gets the local cursor.

Returns:

the local cursor

afterLast

public int afterLast()

Description copied from interface: RemoteResultSetCursor

Positions the cursor after the last row.
Works even for empty cursors.

Specified by:

afterLast in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

the current row

beforeFirst

public void beforeFirst()

Description copied from interface: RemoteResultSetCursor

Positions the cursor before the first row.
Works even for empty cursors.

Specified by:

beforeFirst in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

close

public void close()

Description copied from interface: RemoteResultSetCursor

Closes the scrollable resource.
The scrollable resource is opened in its constructor. Closing an already closed scrollable resource is allowed.

Specified by:

close in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

first

public boolean first()

Description copied from interface: RemoteResultSetCursor

Rewinds the cursor to the first row.

Specified by:

first in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

true if rewound, false if cursor is empty

get

public T get()

Description copied from interface: RemoteResultSetCursor

Gets the data object of the current row.

Specified by:

get in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

the object, null if invalid row or no such object

isAfterLast

public boolean isAfterLast()

Description copied from interface: RemoteResultSetCursor

Checks whether the cursor is after the last row.

Specified by:

isAfterLast in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

true if after last

last

public int last()

Description copied from interface: RemoteResultSetCursor

Positions the cursor on the last row.

Specified by:

last in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

the current row

next

public boolean next()

Description copied from interface: RemoteResultSetCursor

Moves the cursor to the next row. If there are no more rows the current row remains unchanged.

Specified by:

next in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

true if moved, false if no more rows

previous

public boolean previous()

Description copied from interface: RemoteResultSetCursor

Moves the cursor to the previous row. If we are already at the beginning, the cursor remains unchanged.

Specified by:

previous in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

true if advanced, false if already at the beginning

setRow

public int setRow(int row)

Description copied from interface: RemoteResultSetCursor

Sets the cursor to a given row.
Row numbers start at 1.

Specified by:

setRow in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Parameters:

row - the row number (must be ≥ 0)

Returns:

the new row number

scroll

public int scroll(int rows)

Description copied from interface: RemoteResultSetCursor

Moves the cursor a given number of rows.

Specified by:

scroll in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Parameters:

rows - the number of rows to move, negative to move backwards

Returns:

the current row

toList

public List<T> toList()

Description copied from interface: RemoteResultSetCursor

Returns the objects of this cursor as a list.

Specified by:

toList in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

the list

setFetchSize

public void setFetchSize(int rows)

Description copied from interface: RemoteResultSetCursor

Sets the fetchsize.
This is the number of rows the cursor will fetch from the server in one batch. A fetchsize of 0 means server default.

Specified by:

setFetchSize in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Parameters:

rows - the fetchsize

getFetchSize

public int getFetchSize()

Description copied from interface: RemoteResultSetCursor

Gets the fetchsize.

Specified by:

getFetchSize in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

the fetchsize

setFetchDirection

public void setFetchDirection(int direction)

Description copied from interface: RemoteResultSetCursor

Sets the fetch direction.

Specified by:

setFetchDirection in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Parameters:

direction - the direction, see ResultSet.setFetchDirection(int)

getFetchDirection

public int getFetchDirection()

Description copied from interface: RemoteResultSetCursor

Gets the fetch direction.

Specified by:

getFetchDirection in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

the direction

fetch

public ResultSetCursor.FetchList<T> fetch()

Description copied from interface: RemoteResultSetCursor

Fetches the next objects up to the fetchsize.
This method is provided to minimize the number of roundtrips especially for remote cursors. The cursor is closed at the end of the cursor.

Specified by:

fetch in interface RemoteResultSetCursor<T extends PersistentDomainObject<T>>

Returns:

the list of objects, null if no more objects found