org.davidmoten.rx.jdbc

Class Database

java.lang.Object

org.davidmoten.rx.jdbc.Database

All Implemented Interfaces:

AutoCloseable

public final class Database
extends Object
implements AutoCloseable

Field Summary

Fields

Modifier and Type	Field and Description
static Object	NULL_BLOB Sentinel object used to indicate in parameters of a query that rather than calling PreparedStatement.setObject(int, Object) with a null we call PreparedStatement.setNull(int, int) with Types.CLOB.
static Object	NULL_CLOB
static Object	NULL_NUMBER

Method Summary

Modifier and Type	Method and Description
<T> io.reactivex.Completable	apply(io.reactivex.functions.Consumer<? super Connection> consumer)
<T> io.reactivex.Single<T>	apply(io.reactivex.functions.Function<? super Connection,? extends T> function)
static Object	blob(byte[] bytes)
CallableBuilder	call(String sql)
static Object	clob(String s)
void	close()
io.reactivex.Single<Connection>	connection()
io.reactivex.Flowable<Connection>	connections() Returns a flowable stream of checked out Connections from the pool.
static Database	from(Pool<Connection> pool)
static Database	from(Pool<Connection> pool, io.reactivex.functions.Action closeAction)
static Database	from(String url, int maxPoolSize)
static Database	fromBlocking(ConnectionProvider cp)
static Database	fromBlocking(DataSource dataSource)
io.reactivex.Single<Member<Connection>>	member() Returns a Single of a member of the connection pool.
static NonBlockingConnectionPool.Builder<Database>	nonBlocking()
<T> SelectAutomappedBuilder<T>	select(Class<T> cls)
SelectBuilder	select(String sql)
static Database	test() Returns a new testing Apache Derby in-memory database with a connection pool of size 3.
static Database	test(int maxPoolSize)
static Object	toSentinelIfNull(byte[] bytes)
static Object	toSentinelIfNull(String s)
TransactedBuilder	tx(Tx<?> tx)
UpdateBuilder	update(String sql)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NULL_CLOB

public static final Object NULL_CLOB

NULL_NUMBER

public static final Object NULL_NUMBER

NULL_BLOB

public static final Object NULL_BLOB

Sentinel object used to indicate in parameters of a query that rather than calling PreparedStatement.setObject(int, Object) with a null we call PreparedStatement.setNull(int, int) with Types.CLOB. This is required by many databases for setting CLOB and BLOB fields to null.

Method Detail

nonBlocking

public static NonBlockingConnectionPool.Builder<Database> nonBlocking()

from

public static Database from(@Nonnull
                            String url,
                            int maxPoolSize)

from

public static Database from(@Nonnull
                            Pool<Connection> pool)

from

public static Database from(@Nonnull
                            Pool<Connection> pool,
                            io.reactivex.functions.Action closeAction)

fromBlocking

public static Database fromBlocking(@Nonnull
                                    ConnectionProvider cp)

fromBlocking

public static Database fromBlocking(@Nonnull
                                    DataSource dataSource)

test

public static Database test(int maxPoolSize)

test

public static Database test()

Returns a new testing Apache Derby in-memory database with a connection pool of size 3.

Returns:

new testing Database instance

connection

public io.reactivex.Single<Connection> connection()

connections

public io.reactivex.Flowable<Connection> connections()

Returns a flowable stream of checked out Connections from the pool. It's preferrable to use the connection() method and subscribe to a MemberSingle instead because the sometimes surprising request patterns of Flowable operators may mean that more Connections are checked out from the pool than are needed. For instance if you use

 Flowable<Connection> cons = Database.connection().repeat()
 

then you will checkout more (1 more) Connection with repeat than you requested because repeat subscribes one more time than dictated by the requests (buffers).

Returns:

stream of checked out connections from the pool. When you call close() on a connection it is returned to the pool

close

public void close()

Specified by:

close in interface AutoCloseable

call

public CallableBuilder call(@Nonnull
                            String sql)

select

public <T> SelectAutomappedBuilder<T> select(@Nonnull
                                             Class<T> cls)

select

public SelectBuilder select(@Nonnull
                            String sql)

update

public UpdateBuilder update(@Nonnull
                            String sql)

tx

public TransactedBuilder tx(@Nonnull
                            Tx<?> tx)

toSentinelIfNull

public static Object toSentinelIfNull(@Nullable
                                      String s)

toSentinelIfNull

public static Object toSentinelIfNull(@Nullable
                                      byte[] bytes)

clob

public static Object clob(@Nullable
                          String s)

blob

public static Object blob(@Nullable
                          byte[] bytes)

member

public io.reactivex.Single<Member<Connection>> member()

Returns a Single of a member of the connection pool. When finished with the emitted member you must call member.checkin() to return the connection to the pool.

Returns:

a single member of the connection pool

apply

public <T> io.reactivex.Single<T> apply(io.reactivex.functions.Function<? super Connection,? extends T> function)

apply

public <T> io.reactivex.Completable apply(io.reactivex.functions.Consumer<? super Connection> consumer)