org.apache.cayenne.configuration

Class CayenneRuntime

java.lang.Object

org.apache.cayenne.configuration.CayenneRuntime

Direct Known Subclasses:

ServerRuntime

public abstract class CayenneRuntime
extends Object

A superclass of various Cayenne runtime stacks. A Runtime is the main access point to Cayenne for a user application. It provides a default Cayenne configuration as well as a way to customize this configuration via a built-in dependency injection (DI) container. In fact implementation-wise, Runtime object is just a convenience thin wrapper around a DI Injector.

Since:

3.1

Field Summary

Fields

Modifier and Type	Field and Description
protected Injector	injector
protected Module	module
protected static ThreadLocal<Injector>	threadInjector A holder of an Injector bound to the current thread.

Constructor Summary

Constructors

Constructor and Description
CayenneRuntime(Module module) Creates a CayenneRuntime with configuration based on the supplied array of DI modules.

Method Summary

Methods

Modifier and Type	Method and Description
static void	bindThreadInjector(Injector injector) Binds a DI Injector bound to the current thread.
DataChannel	getChannel() Returns the runtime DataChannel.
ObjectContext	getContext() Deprecated. since 3.1 use better named newContext() instead.
ObjectContext	getContext(DataChannel parentChannel) Deprecated. since 3.1 use better named newContext(DataChannel) instead.
Injector	getInjector() Returns DI injector used by this runtime.
Module	getModule() Returns the module used to initialize this runtime.
Module[]	getModules() Deprecated. since 4.0. We only keep one module now, so use getModule().
static Injector	getThreadInjector() Returns the Injector bound to the current thread.
ObjectContext	newContext() Returns a new ObjectContext instance based on the runtime's main DataChannel.
ObjectContext	newContext(DataChannel parentChannel) Returns a new ObjectContext which is a child of the specified DataChannel.
void	shutdown() Shuts down the DI injector of this runtime, giving all services that need to release some resources a chance to do that.

Methods inherited from class java.lang.Object

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

Field Detail

threadInjector

protected static final ThreadLocal<Injector> threadInjector

A holder of an Injector bound to the current thread. Used mainly to allow serializable contexts to attach to correct Cayenne stack on deserialization.

Since:

3.1

injector

protected Injector injector

module

protected Module module

Constructor Detail

CayenneRuntime

public CayenneRuntime(Module module)

Creates a CayenneRuntime with configuration based on the supplied array of DI modules.

Method Detail

bindThreadInjector

public static void bindThreadInjector(Injector injector)

Binds a DI Injector bound to the current thread. It is primarily intended for deserialization of ObjectContexts.

Since:

3.1

getThreadInjector

public static Injector getThreadInjector()

Returns the Injector bound to the current thread. Will return null if none is bound.

Since:

3.1

getModules

@Deprecated
public Module[] getModules()

Deprecated. since 4.0. We only keep one module now, so use getModule().

Returns an array of modules used to initialize this runtime.

getModule

public Module getModule()

Returns the module used to initialize this runtime.

Since:

4.0

getInjector

public Injector getInjector()

Returns DI injector used by this runtime.

shutdown

@BeforeScopeEnd
public void shutdown()

Shuts down the DI injector of this runtime, giving all services that need to release some resources a chance to do that.

getChannel

public DataChannel getChannel()

Returns the runtime DataChannel.

newContext

public ObjectContext newContext()

Returns a new ObjectContext instance based on the runtime's main DataChannel.

Since:

4.0

newContext

public ObjectContext newContext(DataChannel parentChannel)

Returns a new ObjectContext which is a child of the specified DataChannel. This method is used for creation of nested ObjectContexts, with parent ObjectContext passed as an argument.

Since:

4.0

getContext

@Deprecated
public ObjectContext getContext()

Deprecated. since 3.1 use better named newContext() instead.

getContext

@Deprecated
public ObjectContext getContext(DataChannel parentChannel)

Deprecated. since 3.1 use better named newContext(DataChannel) instead.