public class DynamicConfigurationImpl extends Object implements DynamicConfiguration
Constructor and Description |
---|
DynamicConfigurationImpl(ServiceLocatorImpl locator)
Created by the generator, and hence must be public
|
Modifier and Type | Method and Description |
---|---|
<T> ActiveDescriptor<T> |
addActiveDescriptor(ActiveDescriptor<T> activeDescriptor)
This allows third party systems to add reified active descriptors to the system.
|
<T> ActiveDescriptor<T> |
addActiveDescriptor(ActiveDescriptor<T> activeDescriptor,
boolean requiresDeepCopy)
This allows third party systems to add reified active descriptors to the system.
|
<T> ActiveDescriptor<T> |
addActiveDescriptor(Class<T> rawClass)
This adds an active descriptor to the system based completely on the analysis
of the given class.
|
<T> FactoryDescriptors |
addActiveFactoryDescriptor(Class<? extends Factory<T>> rawFactoryClass)
This adds two active descriptors to the system based completely on the analysis
of the given
Factory class. |
void |
addUnbindFilter(Filter unbindFilter)
This filter will added to the list of filters in this Configuration that will
determine which Descriptors will be removed from the system.
|
<T> ActiveDescriptor<T> |
bind(Descriptor key)
This method will bind the given descriptor to this Module.
|
<T> ActiveDescriptor<T> |
bind(Descriptor key,
boolean requiresDeepCopy)
This method will bind the given descriptor to this Module.
|
FactoryDescriptors |
bind(FactoryDescriptors factoryDescriptors)
This method will bind the descriptors found in the
FactoryDescriptors . |
FactoryDescriptors |
bind(FactoryDescriptors factoryDescriptors,
boolean requiresDeepCopy)
This method will bind the descriptors found in the
FactoryDescriptors . |
void |
commit()
This causes the configuration to get committed.
|
String |
toString() |
public DynamicConfigurationImpl(ServiceLocatorImpl locator)
locator
- The locator for which this will be the configuration servicepublic <T> ActiveDescriptor<T> bind(Descriptor key)
DynamicConfiguration
bind
in interface DynamicConfiguration
key
- May not be null. Will be used to derive the various
key fields associated with the given providerpublic <T> ActiveDescriptor<T> bind(Descriptor key, boolean requiresDeepCopy)
DynamicConfiguration
bind
in interface DynamicConfiguration
key
- May not be null. Will be used to derive the various
key fields associated with the given providerrequiresDeepCopy
- If true a deep copy will be made of the
key. If false then the Descriptor will be used as is, and it
is the responsibility of the caller to ensure that the fields
of the Descriptor never change (with the exception of any
writeable fields, such as ranking)public FactoryDescriptors bind(FactoryDescriptors factoryDescriptors)
DynamicConfiguration
FactoryDescriptors
. This method will first
validate the descriptors from the FactoryDescriptors
and then simply bind them into this configuration as
two independent descriptors. A deep copy will be made
of both descriptorsbind
in interface DynamicConfiguration
factoryDescriptors
- A description of a factory service
and the type the factory service provides. May not be nullpublic FactoryDescriptors bind(FactoryDescriptors factoryDescriptors, boolean requiresDeepCopy)
DynamicConfiguration
FactoryDescriptors
. This method will first
validate the descriptors from the FactoryDescriptors
and then simply bind them into this configuration as
two independent descriptors. A deep copy will be made
of both descriptorsbind
in interface DynamicConfiguration
factoryDescriptors
- A description of a factory service
and the type the factory service provides. May not be nullrequiresDeepCopy
- If true a deep copy will be made of the
key. If false then the Descriptor will be used as is, and it
is the responsibility of the caller to ensure that the fields
of the Descriptor never change (with the exception of any
writeable fields, such as ranking)public <T> ActiveDescriptor<T> addActiveDescriptor(ActiveDescriptor<T> activeDescriptor) throws IllegalArgumentException
DynamicConfiguration
addActiveDescriptor
in interface DynamicConfiguration
activeDescriptor
- The reified active descriptor to be added to the system. The
system will not attempt to reify this descriptor itselfIllegalArgumentException
- if the descriptor is not reifiedpublic <T> ActiveDescriptor<T> addActiveDescriptor(ActiveDescriptor<T> activeDescriptor, boolean requiresDeepCopy) throws IllegalArgumentException
DynamicConfiguration
addActiveDescriptor
in interface DynamicConfiguration
activeDescriptor
- The reified active descriptor to be added to the system. The
system will not attempt to reify this descriptor itselfrequiresDeepCopy
- If true a deep copy will be made of the
key. If false then the Descriptor will be used as is, and it
is the responsibility of the caller to ensure that the fields
of the Descriptor never change (with the exception of any
writeable fields, such as ranking)IllegalArgumentException
- if the descriptor is not reifiedpublic <T> ActiveDescriptor<T> addActiveDescriptor(Class<T> rawClass) throws IllegalArgumentException
DynamicConfiguration
addActiveDescriptor
in interface DynamicConfiguration
rawClass
- The class to analyze, must not be nullIllegalArgumentException
- if rawClass is nullpublic <T> FactoryDescriptors addActiveFactoryDescriptor(Class<? extends Factory<T>> rawFactoryClass) throws MultiException, IllegalArgumentException
DynamicConfiguration
Factory
class. The Factory
class itself and all
interfaces marked contract will be in the list of advertised services. The scope
and qualifiers will be taken from the annotations on the class. The annotations
on the Factory.provide()
method will provide the scope and qualifiers of the
service produced by the Factory
addActiveFactoryDescriptor
in interface DynamicConfiguration
rawFactoryClass
- The class to analyze, must not be nullMultiException
- If this class cannot be a serviceIllegalArgumentException
- if rawClass is nullpublic void addUnbindFilter(Filter unbindFilter) throws IllegalArgumentException
DynamicConfiguration
ActiveDescriptor
. The descriptors passed into this
filter may or may not have been reified. This filter should not reify passed in descriptors.
And descriptor for which this filter returns true will be removed from the
ServiceLocator
prior to any additions that are performed with this
Configuration object. Hence a Configuration can remove and add a descriptor of the
same type in one commit.
In order to unbind a filter the caller of commit must pass the LOOKUP validators and the UNBIND validators.
addUnbindFilter
in interface DynamicConfiguration
unbindFilter
- This filter will be added to the list of filters that this
configuration object will use to determine which descriptors to unbind from the system.
May not be nullIllegalArgumentException
- if unbindFilter is nullpublic void commit() throws MultiException
DynamicConfiguration
commit
in interface DynamicConfiguration
MultiException
- If errors were found in the commit processCopyright © 2009-2015 Oracle Corporation. All Rights Reserved.