/*
 * Copyright 2014 Red Hat, Inc.
 *
 * Red Hat licenses this file to you under the Apache License, version 2.0
 * (the "License"); you may not use this file except in compliance with the
 * License.  You may obtain a copy of the License at:
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
 * License for the specific language governing permissions and limitations
 * under the License.
 */

package io.reactiverse.rxjava.pgclient;

import java.util.Map;
import rx.Observable;
import rx.Single;
import io.vertx.core.AsyncResult;
import io.vertx.core.Handler;

A cursor that reads progressively the rows from Postgres, it is usefull for reading very large result.

NOTE: This class has been automatically generated from the original non RX-ified interface using Vert.x codegen.
/** * A cursor that reads progressively the rows from Postgres, it is usefull for reading very large result. * * <p/> * NOTE: This class has been automatically generated from the {@link io.reactiverse.pgclient.PgCursor original} non RX-ified interface using Vert.x codegen. */
@io.vertx.lang.rx.RxGen(io.reactiverse.pgclient.PgCursor.class) public class PgCursor { @Override public String toString() { return delegate.toString(); } @Override public boolean equals(Object o) { if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; PgCursor that = (PgCursor) o; return delegate.equals(that.delegate); } @Override public int hashCode() { return delegate.hashCode(); } public static final io.vertx.lang.rx.TypeArg<PgCursor> __TYPE_ARG = new io.vertx.lang.rx.TypeArg<>( obj -> new PgCursor((io.reactiverse.pgclient.PgCursor) obj), PgCursor::getDelegate ); private final io.reactiverse.pgclient.PgCursor delegate; public PgCursor(io.reactiverse.pgclient.PgCursor delegate) { this.delegate = delegate; } public io.reactiverse.pgclient.PgCursor getDelegate() { return delegate; }
Read rows from the cursor, the result is provided asynchronously to the handler.
Params:
  • count – the amount of rows to read
  • handler – the handler for the result
/** * Read rows from the cursor, the result is provided asynchronously to the <code>handler</code>. * @param count the amount of rows to read * @param handler the handler for the result */
public void read(int count, Handler<AsyncResult<io.reactiverse.rxjava.pgclient.PgRowSet>> handler) { delegate.read(count, new Handler<AsyncResult<io.reactiverse.pgclient.PgRowSet>>() { public void handle(AsyncResult<io.reactiverse.pgclient.PgRowSet> ar) { if (ar.succeeded()) { handler.handle(io.vertx.core.Future.succeededFuture(io.reactiverse.rxjava.pgclient.PgRowSet.newInstance(ar.result()))); } else { handler.handle(io.vertx.core.Future.failedFuture(ar.cause())); } } }); }
Read rows from the cursor, the result is provided asynchronously to the handler.
Params:
  • count – the amount of rows to read
Returns:
/** * Read rows from the cursor, the result is provided asynchronously to the <code>handler</code>. * @param count the amount of rows to read * @return */
public Single<io.reactiverse.rxjava.pgclient.PgRowSet> rxRead(int count) { return Single.create(new io.vertx.rx.java.SingleOnSubscribeAdapter<>(fut -> { read(count, fut); })); }
Returns true when the cursor has results in progress and the should be called to retrieve them.
Returns:whether the cursor has more results,
/** * Returns <code>true</code> when the cursor has results in progress and the should be called to retrieve * them. * @return whether the cursor has more results, */
public boolean hasMore() { boolean ret = delegate.hasMore(); return ret; }
Release the cursor.

It should be called for prepared queries executed with a fetch size.
/** * Release the cursor. * <p/> * It should be called for prepared queries executed with a fetch size. */
public void close() { delegate.close(); }
Like close but with a completionHandler called when the cursor has been released.
Params:
  • completionHandler –
/** * Like {@link io.reactiverse.rxjava.pgclient.PgCursor#close} but with a <code>completionHandler</code> called when the cursor has been released. * @param completionHandler */
public void close(Handler<AsyncResult<Void>> completionHandler) { delegate.close(completionHandler); }
Like close but with a completionHandler called when the cursor has been released.
Returns:
/** * Like {@link io.reactiverse.rxjava.pgclient.PgCursor#close} but with a <code>completionHandler</code> called when the cursor has been released. * @return */
public Single<Void> rxClose() { return Single.create(new io.vertx.rx.java.SingleOnSubscribeAdapter<>(fut -> { close(fut); })); } public static PgCursor newInstance(io.reactiverse.pgclient.PgCursor arg) { return arg != null ? new PgCursor(arg) : null; } }