Class QFactory

java.lang.Object

org.jpos.q2.QFactory

public class QFactory
extends Object

Constructor Summary

Constructors

Constructor	Description
QFactory(ObjectName loaderName, Q2 q2)

Method Summary

Modifier and Type	Method	Description
static void	autoconfigure(Object obj, Configuration cfg)
void	configureQBean(MBeanServer server, ObjectName objectName, org.jdom2.Element e)
ObjectInstance	createQBean(Q2 server, org.jdom2.Element e, Object obj)
void	destroyQBean(Q2 server, ObjectName objectName, Object obj)
static ExecutorService	executorService(boolean virtual)
static org.jdom2.Element	expandEnvProperties(org.jdom2.Element e)	Decorates an Element by replacing its attributes, and content Environment properties references.
AttributeList	getAttributeList(org.jdom2.Element e)
String	getAttributeName(String name)	sets the first character of the string to the upper case
static String	getAttributeValue(org.jdom2.Element e, String name)
protected Collection	getCollection(Class type, org.jdom2.Element e)	Creats a collection from a definition element with the format.
Configuration	getConfiguration(org.jdom2.Element e)
static String	getEagerStartAttribute(org.jdom2.Element e)
static String	getEnabledAttribute(org.jdom2.Element e)
protected Object	getObject(org.jdom2.Element childElement)	Creates an object from a definition element.
Q2	getQ2()
Object	instantiate(Q2 server, org.jdom2.Element e)
static void	invoke(Object obj, String m, Object p)	Try to invoke a method (usually a setter) on the given object silently ignoring if method does not exist
static void	invoke(Object obj, String m, Object p, Class pc)	Try to invoke a method (usually a setter) on the given object silently ignoring if method does not exist
static boolean	isEagerStart(org.jdom2.Element e)
static boolean	isEnabled(org.jdom2.Element e)
<T> T	newInstance(Class<T> clazz)
<T> T	newInstance(String clazz)
<T> T	newInstance(org.jdom2.Element e)	Creates a new instance from the values in Element e.
void	setAttribute(MBeanServer server, ObjectName objectName, String attribute, Object value)
void	setConfiguration(Object obj, org.jdom2.Element e)
void	setLogger(Object obj, org.jdom2.Element e)
void	startQBean(Q2 server, ObjectName objectName)

Methods inherited from class Object

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

Constructor Details

QFactory

public QFactory(ObjectName loaderName,
 Q2 q2)

Method Details

instantiate

public Object instantiate(Q2 server,
 org.jdom2.Element e)
                   throws ReflectionException,
MBeanException,
InstanceNotFoundException

Throws:

ReflectionException

MBeanException

InstanceNotFoundException

createQBean

public ObjectInstance createQBean(Q2 server,
 org.jdom2.Element e,
 Object obj)
                           throws MalformedObjectNameException,
InstanceAlreadyExistsException,
InstanceNotFoundException,
MBeanException,
NotCompliantMBeanException,
InvalidAttributeValueException,
ReflectionException,
ConfigurationException

Throws:

MalformedObjectNameException

InstanceAlreadyExistsException

InstanceNotFoundException

MBeanException

NotCompliantMBeanException

InvalidAttributeValueException

ReflectionException

ConfigurationException

getQ2

public Q2 getQ2()

setAttribute

public void setAttribute(MBeanServer server,
 ObjectName objectName,
 String attribute,
 Object value)
                  throws InstanceNotFoundException,
MBeanException,
InvalidAttributeValueException,
ReflectionException

Throws:

InstanceNotFoundException

MBeanException

InvalidAttributeValueException

ReflectionException

startQBean

public void startQBean(Q2 server,
 ObjectName objectName)
                throws InstanceNotFoundException,
MBeanException,
ReflectionException

Throws:

InstanceNotFoundException

MBeanException

ReflectionException

destroyQBean

public void destroyQBean(Q2 server,
 ObjectName objectName,
 Object obj)
                  throws InstanceNotFoundException,
MBeanException,
ReflectionException

Throws:

InstanceNotFoundException

MBeanException

ReflectionException

configureQBean

public void configureQBean(MBeanServer server,
 ObjectName objectName,
 org.jdom2.Element e)
                    throws ConfigurationException

Throws:

ConfigurationException

getAttributeList

public AttributeList getAttributeList(org.jdom2.Element e)
                               throws ConfigurationException

Throws:

ConfigurationException

getObject

protected Object getObject(org.jdom2.Element childElement)
                    throws ConfigurationException

Creates an object from a definition element. The element may have an attribute called type indicating the type of the object to create, if this attribute is not present java.lang.String is assumed. int, long and boolean are converted to their wrappers.

Parameters:

childElement - Dom Element with the definition of the object.

Returns:

The created object.

Throws:

ConfigurationException - If an exception is found trying to create the object.

getCollection

protected Collection getCollection(Class type,
 org.jdom2.Element e)
                            throws ConfigurationException

Creats a collection from a definition element with the format.

    invalid input: '<'{attr|item} type="...">
        invalid input: '<'item [type="..."]>...
        ...
    
 

Parameters:

type - class type

e - the Element

Returns:

the object collection

Throws:

ConfigurationException

getAttributeName

public String getAttributeName(String name)

sets the first character of the string to the upper case

Parameters:

name - attribute name

Returns:

attribute name

newInstance

public <T> T newInstance(String clazz)
                  throws ConfigurationException

Throws:

ConfigurationException

newInstance

public <T> T newInstance(Class<T> clazz)
                  throws ConfigurationException

Throws:

ConfigurationException

newInstance

public <T> T newInstance(org.jdom2.Element e)
                  throws ConfigurationException

Creates a new instance from the values in Element e.

The method honors the enabled attribute in the given Element e, returning null immediately if enabled is computed to a true-equivalent.

It also calls setLogger(Object, Element) to set logger and realm, and setConfiguration(Object, Element) to trigger the standard [auto]configuration sequence from properties and XML.

Parameters:

e - The XML config

Returns:

the new instance, or null if not enabled

Throws:

ConfigurationException - if the instance can't be created (e.g. class not found) or the configuration process itself threw the exception.

getConfiguration

public Configuration getConfiguration(org.jdom2.Element e)
                               throws ConfigurationException

Throws:

ConfigurationException

setLogger

public void setLogger(Object obj,
 org.jdom2.Element e)

getAttributeValue

public static String getAttributeValue(org.jdom2.Element e,
 String name)

setConfiguration

public void setConfiguration(Object obj,
 org.jdom2.Element e)
                      throws ConfigurationException

Throws:

ConfigurationException

invoke

public static void invoke(Object obj,
 String m,
 Object p)
                   throws ConfigurationException

Try to invoke a method (usually a setter) on the given object silently ignoring if method does not exist

Parameters:

obj - the object

m - method to invoke

p - parameter

Throws:

ConfigurationException - if method happens to throw an exception

invoke

public static void invoke(Object obj,
 String m,
 Object p,
 Class pc)
                   throws ConfigurationException

Try to invoke a method (usually a setter) on the given object silently ignoring if method does not exist

Parameters:

obj - the object

m - method to invoke

p - parameter

pc - parameter class

Throws:

ConfigurationException - if method happens to throw an exception

isEnabled

public static boolean isEnabled(org.jdom2.Element e)

isEagerStart

public static boolean isEagerStart(org.jdom2.Element e)

getEnabledAttribute

public static String getEnabledAttribute(org.jdom2.Element e)

getEagerStartAttribute

public static String getEagerStartAttribute(org.jdom2.Element e)

autoconfigure

public static void autoconfigure(Object obj,
 Configuration cfg)
                          throws IllegalAccessException

Throws:

IllegalAccessException

expandEnvProperties

public static org.jdom2.Element expandEnvProperties(org.jdom2.Element e)

Decorates an Element by replacing its attributes, and content Environment properties references.

Parameters:

e - The element being decorated.

Returns:

The modified element, it is modified in place, but it is returned to ease method chaining or call composition.

executorService

public static ExecutorService executorService(boolean virtual)