org.norther.tammi.core.base
Class DefaultFactory

java.lang.Object
  org.norther.tammi.core.base.Adaptee
      org.norther.tammi.core.base.DefaultContainer
          org.norther.tammi.core.base.DefaultFactory

All Implemented Interfaces:

Serializable, NotificationBroadcaster, NotificationEmitter, Container, Factory, Manageable, MBeanDelegate, ObjectFactory

public class DefaultFactory
extends DefaultContainer
implements Factory

A default implementation of Factory. This implementation forwards complicated instantiations to class specific factories, but can itself instantiate any available classes with one or more public constructors.

Author:

Ilkka Priha

See Also:

Serialized Form

Field Summary

Fields inherited from class org.norther.tammi.core.base.Adaptee

ADAPTEE_NOTIF_DESCRIPTION, ADAPTEE_NOTIFICATIONS

Fields inherited from interface org.norther.tammi.core.base.MBeanDelegate

ARRAY_TYPE, OBJECT_TYPE, PRIMITIVE_TYPE, STRING_TYPE

Constructor Summary

DefaultFactory()
Constructs a new factory.

Method Summary

void	clear() Clears all MBeans from this registry.
Object	get(String className) Gets the referent of the MBean in this registry.
Object	getInstance(String className) Gets an instance of a named class.
Object	getInstance(String className, Object[] params, String[] signature) Gets an instance of a named class.
Object	getInstance(String className, ObjectName loader) Gets an instance of a named class using a specified class loader.
Object	getInstance(String className, ObjectName loader, Object[] params, String[] signature) Gets an instance of a named class using a specified class loader.
MBeanReference	getMBean(String className) Gets a reference to the MBean in this registry.
protected MBeanHandle	getMBeanHandle(String key) Gets a reference to a mapped MBean.
ObjectName	getObjectName(String className) Gets the object name of the MBean in this registry, which is also registered in the MBean server.
ObjectName	getQueryPattern(String className) Gets the query pattern, with which the MBean is registered in this registry.
boolean	isLoaderSupported(String className) Checks if specified class loaders are supported for a named class.
void	postmanaged() This method is called when the implementing adaptee has been managed either during post-registration of the corresponding adapter MBean or just after it is explicitly added to the adapter MBean during run-time.
void	remove(String key) Removes an MBean from this registry.
void	setQueryPattern(String key, String ifname, ObjectName name) Sets the interface and object name of a registry MBean.
void	unmanaged() This method is called when the implementing adaptee is unmanaged either during pre-deregistration of the corresponding adapter MBean or just before it is explicitly removed from the adapter MBean during run-time.

Methods inherited from class org.norther.tammi.core.base.DefaultContainer

containsKey, getContainerKey, getContainerKey, getContainerKey, getMBeanHandles, getMBeanInterface, getMBeanInterface, getObjectNames, registryKeySet, registryKeySet, registryKeySet, registryKeySet, registryMap, registrySize, setMBeanInterface, setQueryPattern

Methods inherited from class org.norther.tammi.core.base.Adaptee

addAdaptee, addNotificationListener, getAttributeSupport, getBroker, getCanonicalName, getDomain, getFactory, getLoader, getLog, getLog, getMBean, getMBeanServer, getNotificationInfo, getObjectName, getRegistrationTime, getSequenceNumber, hasListeners, isRegistered, premanaged, removeNotificationListener, removeNotificationListener, sendNotification, sendNotification, sendNotification, sendNotification, unregister

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.norther.tammi.core.base.Container

containsKey, getContainerKey, getContainerKey, getContainerKey, getMBeanInterface, getMBeanInterface, getObjectNames, registryKeySet, registryKeySet, registryKeySet, registryKeySet, registryMap, registrySize, setMBeanInterface, setQueryPattern

Constructor Detail

DefaultFactory

public DefaultFactory()

Constructs a new factory.

Method Detail

postmanaged

public void postmanaged()

Description copied from interface: Manageable

This method is called when the implementing adaptee has been managed either during post-registration of the corresponding adapter MBean or just after it is explicitly added to the adapter MBean during run-time.

Specified by:

postmanaged in interface Manageable

Overrides:

postmanaged in class Adaptee

unmanaged

public void unmanaged()
               throws Exception

Description copied from interface: Manageable

This method is called when the implementing adaptee is unmanaged either during pre-deregistration of the corresponding adapter MBean or just before it is explicitly removed from the adapter MBean during run-time.

Specified by:

unmanaged in interface Manageable

Overrides:

unmanaged in class Adaptee

Throws:

Exception - if the adaptee refused to be unmanaged.

getInstance

public Object getInstance(String className)
                   throws ConstructionException

Description copied from interface: ObjectFactory

Gets an instance of a named class.

Specified by:

getInstance in interface ObjectFactory

Parameters:

className - the name of the class.

Returns:

the instance.

Throws:

ConstructionException - if construction fails.

getInstance

public Object getInstance(String className,
                          ObjectName loader)
                   throws ConstructionException

Description copied from interface: ObjectFactory

Gets an instance of a named class using a specified class loader.

Class loaders are supported only if the isLoaderSupported method returns true. Otherwise the loader parameter is ignored.

Specified by:

getInstance in interface ObjectFactory

Parameters:

className - the name of the class.

loader - the class loader.

Returns:

the instance.

Throws:

ConstructionException - if construction fails.

getInstance

public Object getInstance(String className,
                          Object[] params,
                          String[] signature)
                   throws ConstructionException

Description copied from interface: ObjectFactory

Gets an instance of a named class. Parameters for its constructor are given as an array of objects, primitive types must be wrapped with a corresponding class.

Specified by:

getInstance in interface ObjectFactory

Parameters:

className - the name of the class.

params - an array containing the parameters of the constructor.

signature - an array containing the signature of the constructor.

Returns:

the instance.

Throws:

ConstructionException - if construction fails.

getInstance

public Object getInstance(String className,
                          ObjectName loader,
                          Object[] params,
                          String[] signature)
                   throws ConstructionException

Description copied from interface: ObjectFactory

Gets an instance of a named class using a specified class loader. Parameters for its constructor are given as an array of objects, primitive types must be wrapped with a corresponding class.

Class loaders are supported only if the isLoaderSupported method returns true. Otherwise the loader parameter is ignored.

Specified by:

getInstance in interface ObjectFactory

Parameters:

className - the name of the class.

loader - the class loader.

params - an array containing the parameters of the constructor.

signature - an array containing the signature of the constructor.

Returns:

the instance.

Throws:

ConstructionException - if construction fails.

isLoaderSupported

public boolean isLoaderSupported(String className)

Description copied from interface: ObjectFactory

Checks if specified class loaders are supported for a named class.

Specified by:

isLoaderSupported in interface ObjectFactory

Parameters:

className - the name of the class.

Returns:

true if class loaders are supported, false otherwise.

get

public Object get(String className)

Description copied from interface: Container

Gets the referent of the MBean in this registry.

Specified by:

get in interface Container

Overrides:

get in class DefaultContainer

Parameters:

className - the registry key.

Returns:

the referent or null.

getMBean

public MBeanReference getMBean(String className)

Description copied from interface: Container

Gets a reference to the MBean in this registry.

Specified by:

getMBean in interface Container

Overrides:

getMBean in class DefaultContainer

Parameters:

className - the registry key.

Returns:

the reference or null.

getQueryPattern

public ObjectName getQueryPattern(String className)

Description copied from interface: Container

Gets the query pattern, with which the MBean is registered in this registry. The MBean registration is not checked from the MBean server.

Specified by:

getQueryPattern in interface Container

Overrides:

getQueryPattern in class DefaultContainer

Parameters:

className - the registry key.

Returns:

the pattern or null if not registered.

setQueryPattern

public void setQueryPattern(String key,
                            String ifname,
                            ObjectName name)

Description copied from interface: Container

Sets the interface and object name of a registry MBean. If the registry is already configured for a specific interface, the interface name must correspond to it.

Specified by:

setQueryPattern in interface Container

Overrides:

setQueryPattern in class DefaultContainer

Parameters:

key - the registry key.

ifname - the class or interface name.

name - the object name or query pattern.

getObjectName

public ObjectName getObjectName(String className)

Description copied from interface: Container

Gets the object name of the MBean in this registry, which is also registered in the MBean server.

Specified by:

getObjectName in interface Container

Overrides:

getObjectName in class DefaultContainer

Parameters:

className - the registry key.

Returns:

the name or null if not in registered.

remove

public void remove(String key)

Description copied from interface: Container

Removes an MBean from this registry.

Specified by:

remove in interface Container

Overrides:

remove in class DefaultContainer

Parameters:

key - the registry key.

clear

public void clear()

Description copied from interface: Container

Clears all MBeans from this registry.

Specified by:

clear in interface Container

Overrides:

clear in class DefaultContainer

getMBeanHandle

protected MBeanHandle getMBeanHandle(String key)

Description copied from class: DefaultContainer

Gets a reference to a mapped MBean.

Note that the reference is meant for internal use only.

Overrides:

getMBeanHandle in class DefaultContainer

Parameters:

key - the key to the MBean.

Returns:

the reference or null.