org.jvnet.hk2.config

Class ConfigBean

java.lang.Object

org.glassfish.hk2.utilities.DescriptorImpl

org.glassfish.hk2.utilities.AbstractActiveDescriptor

org.jvnet.hk2.config.Dom

org.jvnet.hk2.config.ConfigBean

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.reflect.InvocationHandler, ActiveDescriptor, Descriptor, SingleCache, ConfigView, ObservableBean

public class ConfigBean
extends Dom
implements ConfigView

ConfigBean is the core implementation of the config beans. It has features like locking view creation and optional features attachement.

Author:

Jerome Dochez

See Also:

Serialized Form

Field Summary

Fields inherited from class org.jvnet.hk2.config.Dom

document, model

Constructor Summary

Constructors

Constructor and Description
ConfigBean(Dom source, Dom parent) Copy constructor, used to get a deep copy of the passed instance.
ConfigBean(ServiceLocator habitat, DomDocument document, ConfigBean parent, ConfigModel model, javax.xml.stream.XMLStreamReader in)

Method Summary

Methods

Modifier and Type	Method and Description
void	addInterceptor(java.lang.Class<?> interceptorType, ConfigBeanInterceptor interceptor) Add a new ConfigBeanInterceptor to this ConfigBean instance.
ConfigBean	allocate(java.lang.Class<?> type) Allocate a new ConfigBean object as part of the Transaction associated with this configuration object.
protected <T extends Dom> T	copy(T parent) Returns a copy of itself providing the parent for the new copy.
java.util.concurrent.locks.Lock	getLock() Returns the lock on this object, only one external view (usually the writeable view) can acquire the lock ensuring that the objects cannot be concurrently modified
ConfigBean	getMasterView() We are the master view.
javax.management.ObjectName	getObjectName()
<T> T	getOptionalFeature(java.lang.Class<T> featureType) Returns an optional feature of the ConfigBean.
<T extends ConfigBeanProxy> T	getProxy(java.lang.Class<T> proxyType) Creates a proxy for this view.
protected java.lang.Object	getter(ConfigModel.Property target, java.lang.reflect.Type t)
ConfigBean	parent() If this DOM is a child of another DOM, the parent pointer.
void	setMasterView(ConfigView view)
void	setObjectName(javax.management.ObjectName objectNameIn)
protected void	setter(ConfigModel.Property target, java.lang.Object value)

Methods inherited from class org.jvnet.hk2.config.Dom

addDefaultChildren, addLeafElement, addListener, attribute, attribute, attributes, changeLeafElement, convertName, create, createCreator, createProxy, createProxy, digAnnotation, digAnnotation, domNodeByTypeElements, element, equals, get, getAttributeNames, getCache, getContractTypes, getElementNames, getFactoryLocatorId, getFactoryServiceId, getHabitat, getImplementationClass, getInjectees, getInjector, getKey, getLocation, getProxyType, getQualifierAnnotations, getScopeAnnotation, getServiceLocator, getSymbolSpaceRoot, hashCode, initializationCompleted, inject, insertAfter, invoke, invoke, isCacheSet, isReified, leafElement, leafElements, nodeByTypeElement, nodeByTypeElements, nodeElement, nodeElements, rawAttribute, rawLeafElement, rawLeafElements, releaseCache, removeChild, removeLeafElement, removeListener, replaceChild, resolveReference, setCache, setLeafElements, setNodeElements, skipFromXml, unwrap, writeTo, writeToXml

Methods inherited from class org.glassfish.hk2.utilities.AbstractActiveDescriptor

addContractType, addQualifierAnnotation, dispose, removeContractType, removeQualifierAnnotation, setFactoryId, setName, setReified

Methods inherited from class org.glassfish.hk2.utilities.DescriptorImpl

addAdvertisedContract, addMetadata, addMetadata, addQualifier, clearMetadata, getAdvertisedContracts, getClassAnalysisName, getDescriptorType, getDescriptorVisibility, getImplementation, getLoader, getLocatorId, getMetadata, getName, getQualifiers, getRanking, getScope, getServiceId, isProxiable, pretty, readExternal, readObject, removeAdvertisedContract, removeAllMetadata, removeMetadata, removeQualifier, setClassAnalysisName, setDescriptorType, setDescriptorVisibility, setImplementation, setLoader, setLocatorId, setMetadata, setProxiable, setRanking, setScope, setServiceId, toString, writeExternal, writeObject

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.jvnet.hk2.config.ConfigView

getProxyType

Methods inherited from interface java.lang.reflect.InvocationHandler

invoke

Methods inherited from interface org.glassfish.hk2.api.Descriptor

getAdvertisedContracts, getClassAnalysisName, getDescriptorType, getDescriptorVisibility, getImplementation, getLoader, getLocatorId, getMetadata, getName, getQualifiers, getRanking, getScope, getServiceId, isProxiable, setRanking

Constructor Detail

ConfigBean

public ConfigBean(ServiceLocator habitat,
          DomDocument document,
          ConfigBean parent,
          ConfigModel model,
          javax.xml.stream.XMLStreamReader in)

ConfigBean

public ConfigBean(Dom source,
          Dom parent)

Copy constructor, used to get a deep copy of the passed instance.

Parameters:

source - the instance to copy

Method Detail

getObjectName

public javax.management.ObjectName getObjectName()

setObjectName

public void setObjectName(javax.management.ObjectName objectNameIn)

copy

protected <T extends Dom> T copy(T parent)

Returns a copy of itself providing the parent for the new copy.

Overrides:

copy in class Dom

Parameters:

parent - the parent instance for the cloned copy

Returns:

the cloned copy

getOptionalFeature

public <T> T getOptionalFeature(java.lang.Class<T> featureType)

Returns an optional feature of the ConfigBean. Optional features are implemented by other objects and attached to this instance. Attached features can be queried using the getOptionalFeature method giving the type of the requestion optional feature.

Parameters:

featureType - type of the optional feature requested.

Returns:

optional feature implementation is one is attached to this instance

setter

protected void setter(ConfigModel.Property target,
          java.lang.Object value)
               throws java.lang.Exception

Overrides:

setter in class Dom

Throws:

java.lang.Exception

getter

protected java.lang.Object getter(ConfigModel.Property target,
                      java.lang.reflect.Type t)

Overrides:

getter in class Dom

addInterceptor

public void addInterceptor(java.lang.Class<?> interceptorType,
                  ConfigBeanInterceptor interceptor)

Add a new ConfigBeanInterceptor to this ConfigBean instance. The inteceptor will be called each time a attribute of this bean is accessed.

Parameters:

interceptorType - type of the type interceptor.

interceptor - the new interceptor

getMasterView

public ConfigBean getMasterView()

We are the master view.

Specified by:

getMasterView in interface ConfigView

Returns:

the master view

setMasterView

public void setMasterView(ConfigView view)

Specified by:

setMasterView in interface ConfigView

getProxy

public <T extends ConfigBeanProxy> T getProxy(java.lang.Class<T> proxyType)

Creates a proxy for this view.

Specified by:

getProxy in interface ConfigView

Parameters:

proxyType - requested proxy type

Returns:

Java SE proxy

allocate

public ConfigBean allocate(java.lang.Class<?> type)

Allocate a new ConfigBean object as part of the Transaction associated with this configuration object. This will eventually be moved to a factory.

Parameters:

type - the request configuration object type

Returns:

the properly constructed configuration object

getLock

public java.util.concurrent.locks.Lock getLock()

Returns the lock on this object, only one external view (usually the writeable view) can acquire the lock ensuring that the objects cannot be concurrently modified

Returns:

lock instance

parent

public ConfigBean parent()

Description copied from class: Dom

If this DOM is a child of another DOM, the parent pointer. Otherwise null.

Overrides:

parent in class Dom