Class SQLRowStream

  • All Implemented Interfaces:
    ReadStream<JsonArray>, StreamBase

    public class SQLRowStream
    extends Object
    implements 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.

    NOTE: This class has been automatically generated from the original non RX-ified interface using Vert.x codegen.

    • Constructor Detail

      • SQLRowStream

        public SQLRowStream​(SQLRowStream delegate)
      • SQLRowStream

        public SQLRowStream​(Object delegate)
    • Method Detail

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object
      • fetch

        public ReadStream<JsonArray> fetch​(long amount)
        Fetch the specified amount of elements. If the ReadStream has been paused, reading will recommence with the specified amount of items, otherwise the specified amount will be added to the current stream demand.
        Specified by:
        fetch in interface ReadStream<JsonArray>
        Parameters:
        amount -
        Returns:
        a reference to this, so the API can be used fluently
      • pipe

        public Pipe<JsonArray> pipe()
        Pause this stream and return a to transfer the elements of this stream to a destination .

        The stream will be resumed when the pipe will be wired to a WriteStream.

        Specified by:
        pipe in interface ReadStream<JsonArray>
        Returns:
        a pipe
      • pipeTo

        public void pipeTo​(WriteStream<JsonArray> dst,
                           Handler<AsyncResult<Void>> handler)
        Pipe this ReadStream to the WriteStream.

        Elements emitted by this stream will be written to the write stream until this stream ends or fails.

        Once this stream has ended or failed, the write stream will be ended and the handler will be called with the result.

        Specified by:
        pipeTo in interface ReadStream<JsonArray>
        Parameters:
        dst - the destination write stream
        handler -
      • pipeTo

        public void pipeTo​(WriteStream<JsonArray> dst)
        Pipe this ReadStream to the WriteStream.

        Elements emitted by this stream will be written to the write stream until this stream ends or fails.

        Once this stream has ended or failed, the write stream will be ended and the handler will be called with the result.

        Specified by:
        pipeTo in interface ReadStream<JsonArray>
        Parameters:
        dst - the destination write stream
      • rxPipeTo

        public io.reactivex.Completable rxPipeTo​(WriteStream<JsonArray> dst)
        Pipe this ReadStream to the WriteStream.

        Elements emitted by this stream will be written to the write stream until this stream ends or fails.

        Once this stream has ended or failed, the write stream will be ended and the handler will be called with the result.

        Specified by:
        rxPipeTo in interface ReadStream<JsonArray>
        Parameters:
        dst - the destination write stream
        Returns:
      • pause

        public SQLRowStream pause()
        Description copied from interface: ReadStream
        Pause the ReadStream, it sets the buffer in fetch mode and clears the actual demand.

        While it's paused, no data will be sent to the data handler.

        Specified by:
        pause in interface ReadStream<JsonArray>
        Returns:
        a reference to this, so the API can be used fluently
      • resume

        public SQLRowStream resume()
        Description copied from interface: ReadStream
        Resume reading, and sets the buffer in flowing mode.

        If the ReadStream has been paused, reading will recommence on it.

        Specified by:
        resume in interface ReadStream<JsonArray>
        Returns:
        a reference to this, so the API can be used fluently
      • endHandler

        public SQLRowStream endHandler​(Handler<Void> endHandler)
        Description copied from interface: ReadStream
        Set an end handler. Once the stream has ended, and there is no more data to be read, this handler will be called.
        Specified by:
        endHandler in interface ReadStream<JsonArray>
        Returns:
        a reference to this, so the API can be used fluently
      • column

        public 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

        public 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

        public 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
        Returns:
      • moreResults

        public void moreResults()
        Request for more results if available
      • close

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

        public 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
      • rxClose

        public io.reactivex.Completable rxClose()
        Closes the stream/underlying cursor(s). The actual close happens asynchronously.
        Returns: