org.jboss.ejb3.common.registrar.plugin.mc
Class Ejb3McRegistrar

java.lang.Object
  org.jboss.ejb3.common.registrar.plugin.mc.Ejb3McRegistrar

All Implemented Interfaces:

Ejb3Registrar

public class Ejb3McRegistrar
extends java.lang.Object
implements Ejb3Registrar

Ejb3McRegistrar Microcontainer-based Implementation of the Ejb3Registrar

See Also:

Ejb3Registrar}

Constructor Summary

Ejb3McRegistrar(org.jboss.kernel.Kernel kernel)

Method Summary

void	bind(java.lang.Object name, java.lang.Object value) Binds the specified value to the key of specified name, throwing a DuplicateBindException in the case the name is not unique
org.jboss.kernel.Kernel	getProvider() Returns a provider implementation-specific class to break contract and invoke upon vendor-specific features.
java.lang.Object	invoke(java.lang.Object name, java.lang.String methodName, java.lang.Object[] arguments, java.lang.String[] signature) Invokes the specified method name on the object bound at the specified name, returning the result
java.util.Map<java.lang.Object,java.lang.Object>	list() Lists out all installed (bound) objects in form key == name , value == object.
java.lang.Object	lookup(java.lang.Object name) Obtains the value bound at the specified name, throwing NotBoundException if there is nothing bound at the key
java.lang.Object	lookup(java.lang.Object name, boolean checkInstalled) Obtains the value bound at the specified name, throwing NotBoundException if there is nothing bound at the key.
<T> T	lookup(java.lang.Object name, java.lang.Class<T> type) Obtains the value bound at the specified name, throwing NotBoundException if there is nothing bound at the key.
void	rebind(java.lang.Object name, java.lang.Object value) Binds the specified value to the key of specified name, optionally unbinding the current value if one exists
void	unbind(java.lang.Object name) Unbinds the object at the specified name, throwing NotBoundException if no object exists at that name

Methods inherited from class java.lang.Object

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

Constructor Detail

Ejb3McRegistrar

public Ejb3McRegistrar(org.jboss.kernel.Kernel kernel)

Method Detail

list

public java.util.Map<java.lang.Object,java.lang.Object> list()

Lists out all installed (bound) objects in form key == name , value == object. Primarily for metrics/debugging/management. If nothing is installed, an empty Map will be returned. The returned Map is immutable.

Specified by:

list in interface Ejb3Registrar

Returns:

lookup

public java.lang.Object lookup(java.lang.Object name)
                        throws NotBoundException

Obtains the value bound at the specified name, throwing NotBoundException if there is nothing bound at the key

Specified by:

lookup in interface Ejb3Registrar

Parameters:

name -

Returns:

Throws:

NotBoundException

lookup

public java.lang.Object lookup(java.lang.Object name,
                               boolean checkInstalled)
                        throws NotBoundException

Obtains the value bound at the specified name, throwing NotBoundException if there is nothing bound at the key. If the "checkInstalled" flag is true, this implementation will also ensure that the lookup value is of ControllerState.INSTALLED, else NotBoundException

Parameters:

name -

checkInstalled -

Returns:

Throws:

NotBoundException

lookup

public <T> T lookup(java.lang.Object name,
                    java.lang.Class<T> type)
         throws NotBoundException

Obtains the value bound at the specified name, throwing NotBoundException if there is nothing bound at the key. The value returned will be automatically casted to the specified type.

Specified by:

lookup in interface Ejb3Registrar

Type Parameters:

T -

Parameters:

name -

type -

Returns:

Throws:

NotBoundException

bind

public void bind(java.lang.Object name,
                 java.lang.Object value)
          throws DuplicateBindException

Binds the specified value to the key of specified name, throwing a DuplicateBindException in the case the name is not unique

Specified by:

bind in interface Ejb3Registrar

Parameters:

name -

value -

Throws:

DuplicateBindException

rebind

public void rebind(java.lang.Object name,
                   java.lang.Object value)

Binds the specified value to the key of specified name, optionally unbinding the current value if one exists

Specified by:

rebind in interface Ejb3Registrar

Parameters:

name -

value -

unbind

public void unbind(java.lang.Object name)
            throws NotBoundException

Unbinds the object at the specified name, throwing NotBoundException if no object exists at that name

Specified by:

unbind in interface Ejb3Registrar

Parameters:

name -

Throws:

NotBoundException

getProvider

public org.jboss.kernel.Kernel getProvider()

Returns a provider implementation-specific class to break contract and invoke upon vendor-specific features.

Specified by:

getProvider in interface Ejb3Registrar

Returns:

invoke

public java.lang.Object invoke(java.lang.Object name,
                               java.lang.String methodName,
                               java.lang.Object[] arguments,
                               java.lang.String[] signature)
                        throws NotBoundException

Invokes the specified method name on the object bound at the specified name, returning the result

Specified by:

invoke in interface Ejb3Registrar

Parameters:

name -

methodName -

arguments - Arguments to pass to the method

signature - String representation of fully-qualified class names of parameter types

Returns:

Throws:

NotBoundException - If no object is bound at the specified name