com.pivotal.gemfirexd.procedure

Interface IncomingResultSet

public interface IncomingResultSet

An interface for retrieving rows as List<Object> from an incoming result set. Uses blocking, balking, and timeout semantics in the style of a BlockingQueue.

See Also:

BlockingQueue

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.List<java.lang.Object>	END_OF_RESULTS A zero-length row when returned indicates that there are no more results in this result set.

Method Summary

Modifier and Type	Method and Description
java.sql.ResultSetMetaData	getMetaData() Return metadata information about the columns in this result set.
java.util.List<java.lang.Object>	peekRow() Retrieves, but does not remove, the head row of this result set, returns null if there is no row currently available in this result set, or returns END_OF_RESULTS if there are no more rows in this result set.
java.util.List<java.lang.Object>	peekRow(long timeout, java.util.concurrent.TimeUnit unit) Retrieves, but does not remove, the head row of this result set, waiting up to the specified wait time if necessary for a row to become available, or returns END_OF_RESULTS if there are no more rows in this result set.
java.util.List<java.lang.Object>	pollRow() Retrieves and removes the head row of this result set, returns null if there is no row currently available in this result set, or returns END_OF_RESULTS if there are no more rows in this result set.
java.util.List<java.lang.Object>	pollRow(long timeout, java.util.concurrent.TimeUnit unit) Retrieves and removes the head row of this result set, waiting up to the specified wait time if necessary for a row to become available, or returns END_OF_RESULTS if there are no more rows in this result set.
java.util.List<java.lang.Object>	takeRow() Retrieve and removes the head row in this result set as a List<Object>, waiting if necessary until an element becomes available, or returning END_OF_RESULTS if there are no more rows in this result set.
java.util.List<java.lang.Object>	waitPeekRow() Retrieves, but does not remove, the head row of this result set, waiting if necessary until an element becomes available, or returning END_OF_RESULTS if there are no more rows in this result set.

Field Detail

END_OF_RESULTS

static final java.util.List<java.lang.Object> END_OF_RESULTS

A zero-length row when returned indicates that there are no more results in this result set.

Method Detail

takeRow

java.util.List<java.lang.Object> takeRow()
                                  throws java.lang.InterruptedException

Retrieve and removes the head row in this result set as a List<Object>, waiting if necessary until an element becomes available, or returning END_OF_RESULTS if there are no more rows in this result set.

Returns:

the head row of this result set, or returns END_OF_RESULTS if there are no more rows in this result set.

Throws:

java.lang.InterruptedException - if interrupted while waiting

pollRow

java.util.List<java.lang.Object> pollRow()

Retrieves and removes the head row of this result set, returns null if there is no row currently available in this result set, or returns END_OF_RESULTS if there are no more rows in this result set.

Returns:

the head row of this result set if it is available, null if there is no row in this result set currently available, or END_OF_RESULTS if there are no more rows in this result set.

pollRow

java.util.List<java.lang.Object> pollRow(long timeout,
                                         java.util.concurrent.TimeUnit unit)
                                  throws java.lang.InterruptedException

Retrieves and removes the head row of this result set, waiting up to the specified wait time if necessary for a row to become available, or returns END_OF_RESULTS if there are no more rows in this result set.

Parameters:

timeout - how long to wait before giving up, in units of unit

unit - a TimeUnit determining how to interpret the timeout parameter

Returns:

the head row of this queue, null if the specified waiting time elapses before an element is available, or END_OF_RESULTS if there are no more rows in this result set.

Throws:

java.lang.InterruptedException - if interrupted while waiting

peekRow

java.util.List<java.lang.Object> peekRow(long timeout,
                                         java.util.concurrent.TimeUnit unit)
                                  throws java.lang.InterruptedException

Retrieves, but does not remove, the head row of this result set, waiting up to the specified wait time if necessary for a row to become available, or returns END_OF_RESULTS if there are no more rows in this result set.

Parameters:

timeout - how long to wait before giving up, in units of unit

unit - a TimeUnit determining how to interpret the timeout parameter

Returns:

the head row of this queue, null if the specified waiting time elapses before an element is available, or END_OF_RESULTS if there are no more rows in this result set.

Throws:

java.lang.InterruptedException - if interrupted while waiting

peekRow

java.util.List<java.lang.Object> peekRow()

Retrieves, but does not remove, the head row of this result set, returns null if there is no row currently available in this result set, or returns END_OF_RESULTS if there are no more rows in this result set.

Returns:

the head row of this result set if it is available, null if there is no row in this result set currently available, or END_OF_RESULTS if there are no more rows in this result set.

waitPeekRow

java.util.List<java.lang.Object> waitPeekRow()
                                      throws java.lang.InterruptedException

Retrieves, but does not remove, the head row of this result set, waiting if necessary until an element becomes available, or returning END_OF_RESULTS if there are no more rows in this result set.

Returns:

the head row of this result set, or returns END_OF_RESULTS if there are no more rows in this result set.

Throws:

java.lang.InterruptedException - if interrupted while waiting

getMetaData

java.sql.ResultSetMetaData getMetaData()
                                throws java.lang.InterruptedException

Return metadata information about the columns in this result set. May block until the metadata is available.

Throws:

java.lang.InterruptedException - if interrupted while waiting