io.r2dbc.postgresql.api

Interface PostgresqlConnection

All Superinterfaces:

io.r2dbc.spi.Closeable, io.r2dbc.spi.Connection

public interface PostgresqlConnection
extends io.r2dbc.spi.Connection

A Connection for connecting to a PostgreSQL database.

Method Summary

Modifier and Type	Method and Description
Mono<Void>	beginTransaction()
Mono<Void>	beginTransaction(io.r2dbc.spi.TransactionDefinition definition)
Mono<Void>	cancelRequest() Cancel currently running query by sending CancelRequest to a server.
Mono<Void>	close()
Mono<Void>	commitTransaction()
CopyInBuilder	copyIn(String sql) Obtain a CopyInBuilder to configure a COPY FROM STDIN operation for very fast copying into a database table.
default Mono<Long>	copyIn(String sql, Publisher<io.netty.buffer.ByteBuf> stdin) Use COPY FROM STDIN for very fast copying into a database table.
PostgresqlBatch	createBatch()
Mono<Void>	createSavepoint(String name)
PostgresqlStatement	createStatement(String sql)
PostgresqlConnectionMetadata	getMetadata()
Flux<Notification>	getNotifications() Return a Flux of Notification received from LISTEN registrations.
io.r2dbc.spi.IsolationLevel	getTransactionIsolationLevel()
boolean	isAutoCommit()
Mono<Void>	releaseSavepoint(String name)
Mono<Void>	rollbackTransaction()
Mono<Void>	rollbackTransactionToSavepoint(String name)
Mono<Void>	setAutoCommit(boolean autoCommit)
Mono<Void>	setLockWaitTimeout(Duration lockTimeout) Sets Lock Acquisition Timeout through SET LOCK_TIMEOUT.
Mono<Void>	setStatementTimeout(Duration statementTimeout) Sets Statement Timeout through SET STATEMENT_TIMEOUT.
Mono<Void>	setTransactionIsolationLevel(io.r2dbc.spi.IsolationLevel isolationLevel)
String	toString()
Mono<Boolean>	validate(io.r2dbc.spi.ValidationDepth depth)

Method Detail

beginTransaction

Mono<Void> beginTransaction()

Specified by:

beginTransaction in interface io.r2dbc.spi.Connection

beginTransaction

Mono<Void> beginTransaction(io.r2dbc.spi.TransactionDefinition definition)

Specified by:

beginTransaction in interface io.r2dbc.spi.Connection

See Also:

PostgresTransactionDefinition

close

Mono<Void> close()

Specified by:

close in interface io.r2dbc.spi.Closeable

Specified by:

close in interface io.r2dbc.spi.Connection

commitTransaction

Mono<Void> commitTransaction()

Specified by:

commitTransaction in interface io.r2dbc.spi.Connection

copyIn

CopyInBuilder copyIn(String sql)

Obtain a CopyInBuilder to configure a COPY FROM STDIN operation for very fast copying into a database table.

Parameters:

sql - the COPY … FROM STDIN sql statement

Returns:

the builder to configure the copy operation.

Since:

1.0

copyIn

default Mono<Long> copyIn(String sql,
                          Publisher<io.netty.buffer.ByteBuf> stdin)

Use COPY FROM STDIN for very fast copying into a database table.

Parameters:

sql - the COPY … FROM STDIN sql statement

stdin - the ByteBuf publisher

Returns:

a Mono with the amount of rows inserted

Since:

1.0

See Also:

CopyInBuilder

createBatch

PostgresqlBatch createBatch()

Specified by:

createBatch in interface io.r2dbc.spi.Connection

createSavepoint

Mono<Void> createSavepoint(String name)

Specified by:

createSavepoint in interface io.r2dbc.spi.Connection

createStatement

PostgresqlStatement createStatement(String sql)

Specified by:

createStatement in interface io.r2dbc.spi.Connection

getNotifications

Flux<Notification> getNotifications()

Return a Flux of Notification received from LISTEN registrations. The stream is a hot stream producing messages as they are received. Notifications received by this connection are published as they are received. When the client gets closed, the subscription completes normally. Otherwise (transport connection disconnected unintentionally) with an error.

Returns:

a hot Flux of Notifications

cancelRequest

Mono<Void> cancelRequest()

Cancel currently running query by sending CancelRequest to a server.

Returns:

a Mono that indicates that a cancel frame was delivered to the backend

Since:

0.9

getMetadata

PostgresqlConnectionMetadata getMetadata()

Specified by:

getMetadata in interface io.r2dbc.spi.Connection

getTransactionIsolationLevel

io.r2dbc.spi.IsolationLevel getTransactionIsolationLevel()

Specified by:

getTransactionIsolationLevel in interface io.r2dbc.spi.Connection

isAutoCommit

boolean isAutoCommit()

Specified by:

isAutoCommit in interface io.r2dbc.spi.Connection

releaseSavepoint

Mono<Void> releaseSavepoint(String name)

Specified by:

releaseSavepoint in interface io.r2dbc.spi.Connection

rollbackTransaction

Mono<Void> rollbackTransaction()

Specified by:

rollbackTransaction in interface io.r2dbc.spi.Connection

rollbackTransactionToSavepoint

Mono<Void> rollbackTransactionToSavepoint(String name)

Specified by:

rollbackTransactionToSavepoint in interface io.r2dbc.spi.Connection

setAutoCommit

Mono<Void> setAutoCommit(boolean autoCommit)

Specified by:

setAutoCommit in interface io.r2dbc.spi.Connection

setLockWaitTimeout

Mono<Void> setLockWaitTimeout(Duration lockTimeout)

Sets Lock Acquisition Timeout through SET LOCK_TIMEOUT.

Specified by:

setLockWaitTimeout in interface io.r2dbc.spi.Connection

Returns:

a Mono that indicates that a lockTimeout frame was delivered to the backend

Since:

0.8.9

setStatementTimeout

Mono<Void> setStatementTimeout(Duration statementTimeout)

Sets Statement Timeout through SET STATEMENT_TIMEOUT.

Specified by:

setStatementTimeout in interface io.r2dbc.spi.Connection

Returns:

a Mono that indicates that a statementTimeout frame was delivered to the backend

Since:

0.8.9

setTransactionIsolationLevel

Mono<Void> setTransactionIsolationLevel(io.r2dbc.spi.IsolationLevel isolationLevel)

Specified by:

setTransactionIsolationLevel in interface io.r2dbc.spi.Connection

toString

String toString()

Overrides:

toString in class Object

validate

Mono<Boolean> validate(io.r2dbc.spi.ValidationDepth depth)

Specified by:

validate in interface io.r2dbc.spi.Connection