Package org.apache.cayenne.remote

Class ClientChannel

java.lang.Object

org.apache.cayenne.remote.ClientChannel

All Implemented Interfaces:

org.apache.cayenne.DataChannel

public class ClientChannel
extends Object
implements org.apache.cayenne.DataChannel

A DataChannel implementation that accesses a remote server via a ClientConnection.

Since:

1.2

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	channelEventsEnabled
protected ClientConnection	connection
protected org.apache.cayenne.graph.GraphDiffCompressor	diffCompressor
protected org.apache.cayenne.map.EntityResolver	entityResolver
protected org.apache.cayenne.event.EventManager	eventManager

Fields inherited from interface org.apache.cayenne.DataChannel

FLUSH_CASCADE_SYNC, FLUSH_NOCASCADE_SYNC, GRAPH_CHANGED_SUBJECT, GRAPH_FLUSHED_SUBJECT, GRAPH_ROLLEDBACK_SUBJECT, ROLLBACK_CASCADE_SYNC

Constructor Summary

Constructors

Constructor	Description
ClientChannel(ClientConnection connection, boolean channelEventsEnabled, org.apache.cayenne.event.EventManager eventManager, boolean remoteEventsOptional)

Method Summary

Modifier and Type	Method	Description
ClientConnection	getConnection()
org.apache.cayenne.map.EntityResolver	getEntityResolver()	Returns EntityResolver obtained from the server.
org.apache.cayenne.event.EventManager	getEventManager()
boolean	isChannelEventsEnabled()
org.apache.cayenne.QueryResponse	onQuery(org.apache.cayenne.ObjectContext context, org.apache.cayenne.query.Query query)
org.apache.cayenne.graph.GraphDiff	onSync(org.apache.cayenne.ObjectContext originatingContext, org.apache.cayenne.graph.GraphDiff changes, int syncType)
protected <T> T	send(org.apache.cayenne.remote.ClientMessage message, Class<T> resultClass)	Sends a message via connector, getting a result as an instance of a specific class.
protected boolean	setupRemoteChannelListener()	Starts up an EventBridge to listen for remote updates.

Methods inherited from class java.lang.Object

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

Field Detail

connection

protected ClientConnection connection

eventManager

protected org.apache.cayenne.event.EventManager eventManager

entityResolver

protected org.apache.cayenne.map.EntityResolver entityResolver

channelEventsEnabled

protected boolean channelEventsEnabled

diffCompressor

protected org.apache.cayenne.graph.GraphDiffCompressor diffCompressor

Constructor Detail

ClientChannel

public ClientChannel(ClientConnection connection,
                     boolean channelEventsEnabled,
                     org.apache.cayenne.event.EventManager eventManager,
                     boolean remoteEventsOptional)
              throws org.apache.cayenne.CayenneRuntimeException

Parameters:

remoteEventsOptional - if true, failure to start an EventBridge will not result in an exception.

Throws:

org.apache.cayenne.CayenneRuntimeException

Since:

3.0

Method Detail

getConnection

public ClientConnection getConnection()

Since:

3.1

isChannelEventsEnabled

public boolean isChannelEventsEnabled()

Since:

3.1

getEventManager

public org.apache.cayenne.event.EventManager getEventManager()

Specified by:

getEventManager in interface org.apache.cayenne.DataChannel

onQuery

public org.apache.cayenne.QueryResponse onQuery(org.apache.cayenne.ObjectContext context,
                                                org.apache.cayenne.query.Query query)

Specified by:

onQuery in interface org.apache.cayenne.DataChannel

onSync

public org.apache.cayenne.graph.GraphDiff onSync(org.apache.cayenne.ObjectContext originatingContext,
                                                 org.apache.cayenne.graph.GraphDiff changes,
                                                 int syncType)

Specified by:

onSync in interface org.apache.cayenne.DataChannel

getEntityResolver

public org.apache.cayenne.map.EntityResolver getEntityResolver()

Returns EntityResolver obtained from the server. On first access, this method sends a message to the server to retrieve the EntityResolver. On subsequent calls locally cached resolver is used.

Specified by:

getEntityResolver in interface org.apache.cayenne.DataChannel

setupRemoteChannelListener

protected boolean setupRemoteChannelListener()
                                      throws org.apache.cayenne.CayenneRuntimeException

Starts up an EventBridge to listen for remote updates. Returns true if the listener was setup, false if not. False can be returned if the underlying connection doesn't support events of if there is no EventManager available.

Throws:

org.apache.cayenne.CayenneRuntimeException

send

protected <T> T send(org.apache.cayenne.remote.ClientMessage message,
                     Class<T> resultClass)

Sends a message via connector, getting a result as an instance of a specific class.

Throws:

org.apache.cayenne.CayenneRuntimeException - if an underlying connector exception occurred, or a result is not of expected type.