org.jvnet.hk2.config
Class ConfigBean

java.lang.Object
  com.sun.hk2.component.AbstractInhabitantImpl<T>
      com.sun.hk2.component.EventPublishingInhabitant<T>
          com.sun.hk2.component.LazyInhabitant
              org.jvnet.hk2.config.Dom
                  org.jvnet.hk2.config.ConfigBean

All Implemented Interfaces:

com.sun.hk2.component.ClassLoaderHolder, com.sun.hk2.component.Holder, java.lang.reflect.InvocationHandler, org.jvnet.hk2.component.Inhabitant, 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

Nested Class Summary

Nested classes/interfaces inherited from interface com.sun.hk2.component.Holder

com.sun.hk2.component.Holder.Impl<T>

Field Summary

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

document, model

Fields inherited from class com.sun.hk2.component.LazyInhabitant

habitat

Fields inherited from class com.sun.hk2.component.EventPublishingInhabitant

real

Constructor Summary

ConfigBean(Dom source, Dom parent)
Copy constructor, used to get a deep copy of the passed instance.

ConfigBean(org.jvnet.hk2.component.Habitat habitat, DomDocument document, ConfigBean parent, ConfigModel model, javax.xml.stream.XMLStreamReader in)

Method Summary

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, createCreator, createProxy, createProxy, digAnnotation, digAnnotation, domNodeByTypeElements, element, getAttributeNames, getElementNames, getHabitat, getInjector, getKey, getLocation, getProxyType, getSymbolSpaceRoot, initializationCompleted, inject, injectInto, insertAfter, invoke, invoke, leafElement, leafElements, nodeByTypeElement, nodeByTypeElements, nodeElement, nodeElements, rawAttribute, rawLeafElement, rawLeafElements, release, removeChild, removeLeafElement, removeListener, replaceChild, resolveReference, setLeafElements, setNodeElements, unwrap, writeTo

Methods inherited from class com.sun.hk2.component.LazyInhabitant

fetch, getClassLoader, lead, loadClass, metadata, type, typeName

Methods inherited from class com.sun.hk2.component.EventPublishingInhabitant

addInhabitantListener, get, isInstantiated, notify, removeInhabitantListener, toString

Methods inherited from class com.sun.hk2.component.AbstractInhabitantImpl

companions, get, getAnnotation, getAnnotation, getSerializedMetadata, getSerializedMetadata, setCompanions

Methods inherited from class java.lang.Object

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

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

getProxyType

Methods inherited from interface java.lang.reflect.InvocationHandler

invoke

Constructor Detail

ConfigBean

public ConfigBean(org.jvnet.hk2.component.Habitat 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