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 and Description
static class	AbstractEntityConnectionProvider.AbstractBuilder<T extends EntityConnectionProvider,B extends EntityConnectionProvider.Builder<T,B>>

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_CLASS, CONNECTION_TYPE_HTTP, CONNECTION_TYPE_LOCAL, CONNECTION_TYPE_REMOTE

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	addOnConnectListener(EventDataListener<EntityConnection> listener) Adds a listener notified each time this connection provider establishes a connection to the database
UUID	clientId()
String	clientTypeId()
Version	clientVersion()
void	close() Logs out, disconnects and performs cleanup if required
protected abstract void	close(EntityConnection connection) Closes the given connection
protected abstract EntityConnection	connect()
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
String	domainClassName()
protected String	domainTypeName(String domainClass)
Entities	entities() Returns the domain entities this connection is based on
boolean	isConnected()
boolean	isConnectionValid()
void	removeOnConnectListener(EventDataListener<EntityConnection> listener) Removes the given listener
User	user()

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

builder, connectionType, description

Constructor Detail

AbstractEntityConnectionProvider

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

Method Detail

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

domainClassName

public final String domainClassName()

Specified by:

domainClassName in interface EntityConnectionProvider

Returns:

the domain model classname

clientId

public final UUID clientId()

Specified by:

clientId in interface EntityConnectionProvider

Returns:

the UUID identifying this client connection

clientTypeId

public final String clientTypeId()

Specified by:

clientTypeId in interface EntityConnectionProvider

Returns:

the String identifying the client type for this connection provider

clientVersion

public final Version clientVersion()

Specified by:

clientVersion in interface EntityConnectionProvider

Returns:

the client version

isConnected

public final boolean isConnected()

Specified by:

isConnected in interface EntityConnectionProvider

Returns:

true if a connection has been established, note that this does not check if the actual connection is valid, only that one has been established.

See Also:

EntityConnectionProvider.isConnectionValid()

isConnectionValid

public final boolean isConnectionValid()

Specified by:

isConnectionValid in interface EntityConnectionProvider

Returns:

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

addOnConnectListener

public final void addOnConnectListener(EventDataListener<EntityConnection> listener)

Description copied from interface: EntityConnectionProvider

Adds a listener notified each time this connection provider establishes a connection to the database

Specified by:

addOnConnectListener in interface EntityConnectionProvider

Parameters:

listener - a listener notified when a connection is established

removeOnConnectListener

public final void removeOnConnectListener(EventDataListener<EntityConnection> listener)

Description copied from interface: EntityConnectionProvider

Removes the given listener

Specified by:

removeOnConnectListener in interface EntityConnectionProvider

Parameters:

listener - the listener to remove

connection

public final 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

Logs out, disconnects and performs cleanup if required

Specified by:

close in interface EntityConnectionProvider

Specified by:

close in interface AutoCloseable

connect

protected abstract EntityConnection connect()

Returns:

an established connection

close

protected abstract void close(EntityConnection connection)

Closes the given connection

Parameters:

connection - the connection to be closed

domainTypeName

protected String domainTypeName(String domainClass)