Package io.vertx.rxjava3.pgclient
Class PgConnection
- java.lang.Object
-
- io.vertx.rxjava3.sqlclient.SqlClient
-
- io.vertx.rxjava3.sqlclient.SqlConnection
-
- io.vertx.rxjava3.pgclient.PgConnection
-
- All Implemented Interfaces:
io.vertx.lang.rx.RxDelegate
public class PgConnection extends SqlConnection implements io.vertx.lang.rx.RxDelegate
A connection to Postgres.The connection object supports all the operations defined in the interface, it also provides additional support:
- Notification
- Request Cancellation
NOTE: This class has been automatically generated from the
originalnon RX-ified interface using Vert.x codegen.
-
-
Field Summary
Fields Modifier and Type Field Description static io.vertx.lang.rx.TypeArg<PgConnection>__TYPE_ARG
-
Constructor Summary
Constructors Constructor Description PgConnection(PgConnection delegate)PgConnection(Object delegate)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description CompletablecancelRequest()Send a request cancellation message to tell the server to cancel processing request in this connection.static PgConnectioncast(SqlConnection sqlConnection)Cast a toPgConnection.PgConnectioncloseHandler(Handler<Void> handler)Set an handler called when the connection is closed.static Single<PgConnection>connect(Vertx vertx)Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build from the environment variables.static Single<PgConnection>connect(Vertx vertx, PgConnectOptions options)Connects to the database and returns the connection if that succeeds.static Single<PgConnection>connect(Vertx vertx, String connectionUri)Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build fromconnectionUri.booleanequals(Object o)PgConnectionexceptionHandler(Handler<Throwable> handler)Set an handler called with connection errors.PgConnectiongetDelegate()inthashCode()static PgConnectionnewInstance(PgConnection arg)PgConnectionnoticeHandler(Handler<PgNotice> handler)Set a handler called when the connection receives a notice from the server.PgConnectionnotificationHandler(Handler<PgNotification> handler)Set a handler called when the connection receives notification on a channel.intprocessId()CompletablerxCancelRequest()Send a request cancellation message to tell the server to cancel processing request in this connection.static Single<PgConnection>rxConnect(Vertx vertx)Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build from the environment variables.static Single<PgConnection>rxConnect(Vertx vertx, PgConnectOptions options)Connects to the database and returns the connection if that succeeds.static Single<PgConnection>rxConnect(Vertx vertx, String connectionUri)Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build fromconnectionUri.intsecretKey()StringtoString()-
Methods inherited from class io.vertx.rxjava3.sqlclient.SqlConnection
begin, databaseMetadata, isSSL, newInstance, prepare, prepare, rxBegin, rxPrepare, rxPrepare, transaction
-
Methods inherited from class io.vertx.rxjava3.sqlclient.SqlClient
close, newInstance, preparedQuery, preparedQuery, query, rxClose
-
-
-
-
Field Detail
-
__TYPE_ARG
public static final io.vertx.lang.rx.TypeArg<PgConnection> __TYPE_ARG
-
-
Constructor Detail
-
PgConnection
public PgConnection(PgConnection delegate)
-
PgConnection
public PgConnection(Object delegate)
-
-
Method Detail
-
toString
public String toString()
- Overrides:
toStringin classSqlConnection
-
equals
public boolean equals(Object o)
- Overrides:
equalsin classSqlConnection
-
hashCode
public int hashCode()
- Overrides:
hashCodein classSqlConnection
-
getDelegate
public PgConnection getDelegate()
- Specified by:
getDelegatein interfaceio.vertx.lang.rx.RxDelegate- Overrides:
getDelegatein classSqlConnection
-
connect
public static Single<PgConnection> connect(Vertx vertx, PgConnectOptions options)
Connects to the database and returns the connection if that succeeds. The connection interracts directly with the database is not a proxy, so closing the connection will close the underlying connection to the database.- Parameters:
vertx- the vertx instanceoptions- the connect options- Returns:
- a future notified with the connection or the failure
-
rxConnect
public static Single<PgConnection> rxConnect(Vertx vertx, PgConnectOptions options)
Connects to the database and returns the connection if that succeeds. The connection interracts directly with the database is not a proxy, so closing the connection will close the underlying connection to the database.- Parameters:
vertx- the vertx instanceoptions- the connect options- Returns:
- a future notified with the connection or the failure
-
connect
public static Single<PgConnection> connect(Vertx vertx)
Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build from the environment variables.- Parameters:
vertx-- Returns:
-
rxConnect
public static Single<PgConnection> rxConnect(Vertx vertx)
Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build from the environment variables.- Parameters:
vertx-- Returns:
-
connect
public static Single<PgConnection> connect(Vertx vertx, String connectionUri)
Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build fromconnectionUri.- Parameters:
vertx-connectionUri-- Returns:
-
rxConnect
public static Single<PgConnection> rxConnect(Vertx vertx, String connectionUri)
Likeconnect(io.vertx.rxjava3.core.Vertx, io.vertx.pgclient.PgConnectOptions)with options build fromconnectionUri.- Parameters:
vertx-connectionUri-- Returns:
-
notificationHandler
public PgConnection notificationHandler(Handler<PgNotification> handler)
Set a handler called when the connection receives notification on a channel. The handler is called with thePgNotificationand has access to the channel name and the notification payload.- Parameters:
handler- the handler- Returns:
- the transaction instance
-
noticeHandler
public PgConnection noticeHandler(Handler<PgNotice> handler)
Set a handler called when the connection receives a notice from the server.- Parameters:
handler-- Returns:
-
cancelRequest
public Completable cancelRequest()
Send a request cancellation message to tell the server to cancel processing request in this connection.
Note: Use this with caution because the cancellation signal may or may not have any effect.- Returns:
- a future notified if cancelling request is sent
-
rxCancelRequest
public Completable rxCancelRequest()
Send a request cancellation message to tell the server to cancel processing request in this connection.
Note: Use this with caution because the cancellation signal may or may not have any effect.- Returns:
- a future notified if cancelling request is sent
-
processId
public int processId()
- Returns:
- The process ID of the target backend
-
secretKey
public int secretKey()
- Returns:
- The secret key for the target backend
-
exceptionHandler
public PgConnection exceptionHandler(Handler<Throwable> handler)
Description copied from class:SqlConnectionSet an handler called with connection errors.- Overrides:
exceptionHandlerin classSqlConnection- Parameters:
handler-- Returns:
-
closeHandler
public PgConnection closeHandler(Handler<Void> handler)
Description copied from class:SqlConnectionSet an handler called when the connection is closed.- Overrides:
closeHandlerin classSqlConnection- Parameters:
handler-- Returns:
-
cast
public static PgConnection cast(SqlConnection sqlConnection)
Cast a toPgConnection. This is mostly useful for Vert.x generated APIs like RxJava/Mutiny.- Parameters:
sqlConnection- the connection to cast- Returns:
- a
instance
-
newInstance
public static PgConnection newInstance(PgConnection arg)
-
-