Module is.codion.framework.db.core

Package is.codion.framework.db

Class AbstractEntityConnectionProvider

java.lang.Object

is.codion.framework.db.AbstractEntityConnectionProvider

All Implemented Interfaces:

EntityConnectionProvider, AutoCloseable

public abstract class AbstractEntityConnectionProvider
extends Object
implements EntityConnectionProvider

An abstract EntityConnectionProvider implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractEntityConnectionProvider.AbstractBuilder<T extends EntityConnectionProvider,B extends EntityConnectionProvider.Builder<T,B>>	An abstract EntityConnectionProvider.Builder.

Nested classes/interfaces inherited from interface is.codion.framework.db.EntityConnectionProvider

EntityConnectionProvider.Builder<T extends EntityConnectionProvider,B extends EntityConnectionProvider.Builder<T,B>>

Field Summary

Fields inherited from interface is.codion.framework.db.EntityConnectionProvider

CLIENT_CONNECTION_TYPE, CLIENT_DOMAIN_TYPE, CONNECTION_TYPE_HTTP, CONNECTION_TYPE_LOCAL, CONNECTION_TYPE_REMOTE, DESCRIPTION

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractEntityConnectionProvider(AbstractEntityConnectionProvider.AbstractBuilder<?,?> builder)

Method Summary

Modifier and Type	Method	Description
final UUID	clientId()
final Optional<String>	clientType()
final Optional<Version>	clientVersion()
final void	close()	Closes the underlying connection and performs cleanup if required
protected abstract void	close(EntityConnection connection)	Closes the given connection
protected abstract EntityConnection	connect()
final Observer<EntityConnection>	connected()
EntityConnection	connection()	Provides a EntityConnection object, is responsible for returning a healthy EntityConnection object, that is, it must reconnect an invalid connection whether remotely or locally
final boolean	connectionValid()
final DomainType	domainType()
final Entities	entities()	Returns the domain entities this connection is based on
final User	user()
protected final EntityConnection	validConnection()	Returns a valid connection or throws an exception in case one can not be established

Methods inherited from class java.lang.Object

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

Methods inherited from interface is.codion.framework.db.EntityConnectionProvider

connectionType, description

Constructor Details

AbstractEntityConnectionProvider

protected AbstractEntityConnectionProvider(AbstractEntityConnectionProvider.AbstractBuilder<?,?> builder)

Parameters:

builder - the builder

Method Details

entities

public final Entities entities()

Description copied from interface: EntityConnectionProvider

Returns the domain entities this connection is based on

Specified by:

entities in interface EntityConnectionProvider

Returns:

the underlying domain entities

user

public final User user()

Specified by:

user in interface EntityConnectionProvider

Returns:

the user used by this connection provider

domainType

public final DomainType domainType()

Specified by:

domainType in interface EntityConnectionProvider

Returns:

the domain type

clientId

public final UUID clientId()

Specified by:

clientId in interface EntityConnectionProvider

Returns:

the UUID identifying this client connection

clientType

public final Optional<String> clientType()

Specified by:

clientType in interface EntityConnectionProvider

Returns:

the String identifying the client type for this connection provider

clientVersion

public final Optional<Version> clientVersion()

Specified by:

clientVersion in interface EntityConnectionProvider

Returns:

the client version

connectionValid

public final boolean connectionValid()

Specified by:

connectionValid in interface EntityConnectionProvider

Returns:

true if a connection has been establised and the connection is in a valid state

connected

public final Observer<EntityConnection> connected()

Specified by:

connected in interface EntityConnectionProvider

Returns:

an observer notified when a connection is established

connection

public EntityConnection connection()

Description copied from interface: EntityConnectionProvider

Provides a EntityConnection object, is responsible for returning a healthy EntityConnection object, that is, it must reconnect an invalid connection whether remotely or locally

Specified by:

connection in interface EntityConnectionProvider

Returns:

a EntityConnection instance

close

public final void close()

Description copied from interface: EntityConnectionProvider

Closes the underlying connection and performs cleanup if required

Specified by:

close in interface AutoCloseable

Specified by:

close in interface EntityConnectionProvider

See Also:

• EntityConnectionProvider.Builder.onClose(Consumer)

connect

protected abstract EntityConnection connect()

Returns:

a new valid connection

close

protected abstract void close(EntityConnection connection)

Closes the given connection

Parameters:

connection - the connection to be closed

validConnection

protected final EntityConnection validConnection()

Returns a valid connection or throws an exception in case one can not be established

Returns:

a valid connection