org.mule.runtime.core.registry

Class SimpleRegistry

java.lang.Object

org.mule.runtime.core.registry.AbstractRegistry

org.mule.runtime.core.registry.TransientRegistry

org.mule.runtime.core.registry.SimpleRegistry

All Implemented Interfaces:

org.mule.runtime.api.lifecycle.Disposable, org.mule.runtime.api.lifecycle.Initialisable, Injector, LifecycleRegistry, Registry

public class SimpleRegistry
extends TransientRegistry
implements LifecycleRegistry, Injector

A very simple implementation of LifecycleRegistry. Useful for starting really lightweight contexts which don't depend on heavier object containers such as Spring or Guice (testing being the best example).

The inject(Object) operation will only consider fields annotated with Inject and will perform the injection using simple, not-cached reflection. Also, initialisation lifecycle will be performed in pseudo-random order, no analysis will be done to ensure that dependencies of a given object get their lifecycle before it.

Since:

3.7.0

Field Summary

Fields inherited from class org.mule.runtime.core.registry.AbstractRegistry

lifecycleManager, logger, muleContext

Fields inherited from interface org.mule.runtime.api.lifecycle.Initialisable

PHASE_NAME

Fields inherited from interface org.mule.runtime.api.lifecycle.Disposable

PHASE_NAME

Constructor Summary

Constructors

Constructor and Description
SimpleRegistry(MuleContext muleContext)

Method Summary

Modifier and Type	Method and Description
Object	applyLifecycle(Object object) Will fire any lifecycle methods according to the current lifecycle without actually registering the object in the registry.
Object	applyLifecycle(Object object, String phase) Will fire the given lifecycle phase without actually registering the object in the registry.
void	applyLifecycle(Object object, String startPhase, String toPhase) Applies lifecycle phase to an object independent of the current lifecycle phase.
protected Object	applyProcessors(Object object, Object metadata)
protected void	doInitialise()
protected void	doRegisterObject(String key, Object object, Object metadata)
<T> T	inject(T object) Injects dependencies into the given object
<T> T	lookupObject(String key, boolean applyLifecycle) This implementation doesn't support applying lifecycle upon lookup and thus this method simply delegates into TransientRegistry.lookupObject(String)

Methods inherited from class org.mule.runtime.core.registry.TransientRegistry

applyProcessors, checkDisposed, doDispose, doGet, doPut, doUnregisterObject, hasFlag, isReadOnly, isRemote, lookupByType, lookupLocalObjects, lookupObject, lookupObject, lookupObjects, registerObject, registerObject, registerObjects

Methods inherited from class org.mule.runtime.core.registry.AbstractRegistry

createLifecycleManager, dispose, fireLifecycle, get, getLifecycleManager, getRegistryId, initialise, isInitialised, lookupObjectsForLifecycle, unregisterObject, unregisterObject

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mule.runtime.core.api.registry.Registry

fireLifecycle, get, getRegistryId, isReadOnly, isRemote, lookupByType, lookupLocalObjects, lookupObject, lookupObject, lookupObjects, lookupObjectsForLifecycle, registerObject, registerObject, registerObjects, unregisterObject, unregisterObject

Methods inherited from interface org.mule.runtime.api.lifecycle.Initialisable

initialise

Methods inherited from interface org.mule.runtime.api.lifecycle.Disposable

dispose

Constructor Detail

SimpleRegistry

public SimpleRegistry(MuleContext muleContext)

Method Detail

doInitialise

protected void doInitialise()
                     throws org.mule.runtime.api.lifecycle.InitialisationException

Overrides:

doInitialise in class TransientRegistry

Throws:

org.mule.runtime.api.lifecycle.InitialisationException

lookupObject

public <T> T lookupObject(String key,
                          boolean applyLifecycle)

This implementation doesn't support applying lifecycle upon lookup and thus this method simply delegates into TransientRegistry.lookupObject(String)

Specified by:

lookupObject in interface LifecycleRegistry

Parameters:

key - the key of the object you're looking for

applyLifecycle - if lifecycle should be applied to the returned object. Passing true doesn't guarantee that the lifecycle is applied

Returns:

object or null if not found

doRegisterObject

protected void doRegisterObject(String key,
                                Object object,
                                Object metadata)
                         throws RegistrationException

Overrides:

doRegisterObject in class TransientRegistry

Throws:

RegistrationException

applyLifecycle

public Object applyLifecycle(Object object)
                      throws org.mule.runtime.api.exception.MuleException

Will fire any lifecycle methods according to the current lifecycle without actually registering the object in the registry. This is useful for prototype objects that are created per request and would clutter the registry with single use objects.

Specified by:

applyLifecycle in interface LifecycleRegistry

Parameters:

object - the object to process

Returns:

the same object with lifecycle methods called (if it has any)

Throws:

org.mule.runtime.api.exception.MuleException - if the registry fails to perform the lifecycle change for the object.

applyLifecycle

public Object applyLifecycle(Object object,
                             String phase)
                      throws org.mule.runtime.api.exception.MuleException

Will fire the given lifecycle phase without actually registering the object in the registry. This is useful for prototype objects that are created per request and would clutter the registry with single use objects.

Specified by:

applyLifecycle in interface LifecycleRegistry

Parameters:

object - the object to process

phase - the specific lifecycle phase you want to fire

Returns:

either the same object but with the lifecycle applied or a proxy to it

Throws:

org.mule.runtime.api.exception.MuleException - if the registry fails to perform the lifecycle change for the object.

applyLifecycle

public void applyLifecycle(Object object,
                           String startPhase,
                           String toPhase)
                    throws org.mule.runtime.api.exception.MuleException

Applies lifecycle phase to an object independent of the current lifecycle phase. All phases between the startPhase and the endPhase will be executed.

Specified by:

applyLifecycle in interface LifecycleRegistry

Parameters:

object - the object to apply lifecycle to

startPhase - the lifecycle phase the object is currently in. Must not be null.

toPhase - the lifecycle phase to transition the object to. Must not be null.

Throws:

org.mule.runtime.api.exception.MuleException - if there is an exception while invoking lifecycle on the object

inject

public <T> T inject(T object)

Injects dependencies into the given object

Specified by:

inject in interface Injector

Parameters:

object - the object on which dependencies are to be injected on

Returns:

the injected object or a proxy to it

applyProcessors

protected Object applyProcessors(Object object,
                                 Object metadata)

Overrides:

applyProcessors in class TransientRegistry