io.vertx.ext.sql

Interface SQLRowStream

All Superinterfaces:

ReadStream<JsonArray>, StreamBase

public interface SQLRowStream
extends ReadStream<JsonArray>

A ReadStream of Rows from the underlying RDBMS. This class follows the ReadStream semantics and will automatically close the underlying resources if all returned rows are returned. For cases where the results are ignored before the full processing of the returned rows is complete the close method **MUST** be called in order to release underlying resources. The interface is minimal in order to support all SQL clients not just JDBC.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the stream/underlying cursor(s).
void	close(Handler<AsyncResult<Void>> handler) Closes the stream/underlying cursor(s).
int	column(String name) Will convert the column name to the json array index.
List<String>	columns() Returns all column names available in the underlying resultset.
SQLRowStream	endHandler(Handler<Void> endHandler)
SQLRowStream	exceptionHandler(Handler<Throwable> handler)
SQLRowStream	handler(Handler<JsonArray> handler)
void	moreResults() Request for more results if available
SQLRowStream	pause()
SQLRowStream	resultSetClosedHandler(Handler<Void> handler) Event handler when a resultset is closed.
SQLRowStream	resume()

Methods inherited from interface io.vertx.core.streams.ReadStream

fetch, pipe, pipeTo, pipeTo

Method Detail

exceptionHandler

SQLRowStream exceptionHandler(Handler<Throwable> handler)

Specified by:

exceptionHandler in interface ReadStream<JsonArray>

Specified by:

exceptionHandler in interface StreamBase

handler

SQLRowStream handler(Handler<JsonArray> handler)

Specified by:

handler in interface ReadStream<JsonArray>

pause

SQLRowStream pause()

Specified by:

pause in interface ReadStream<JsonArray>

resume

SQLRowStream resume()

Specified by:

resume in interface ReadStream<JsonArray>

endHandler

SQLRowStream endHandler(Handler<Void> endHandler)

Specified by:

endHandler in interface ReadStream<JsonArray>

column

int column(String name)

Will convert the column name to the json array index.

Parameters:

name - the column name

Returns:

the json array index

columns

List<String> columns()

Returns all column names available in the underlying resultset. One needs to carefully use this method since in contrast to the singular version it does not perform case insensitive lookups or takes alias in consideration on the column names.

Returns:

the list of columns names returned by the query

resultSetClosedHandler

SQLRowStream resultSetClosedHandler(Handler<Void> handler)

Event handler when a resultset is closed. This is useful to request for more results.

Parameters:

handler - called when the current result set is closed

moreResults

void moreResults()

Request for more results if available

close

void close()

Closes the stream/underlying cursor(s). The actual close happens asynchronously.

close

void close(Handler<AsyncResult<Void>> handler)

Closes the stream/underlying cursor(s). The actual close happens asynchronously.

Parameters:

handler - called when the stream/underlying cursor(s) is(are) closed