|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DynamicConfiguration
This class is used to add Descriptor
s to a ServiceLocator
instance. No operation performed on this object will be reflected
in the ServiceLocator
until the commit method is called.
Method Summary | ||
---|---|---|
|
addActiveDescriptor(ActiveDescriptor<T> activeDescriptor)
This allows third party systems to add reified active descriptors to the system. |
|
|
addActiveDescriptor(Class<T> rawClass)
This adds an active descriptor to the system based completely on the analysis of the given 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. |
|
ActiveDescriptor<?> |
bind(Descriptor key)
This method will bind the given descriptor to this Module. |
|
FactoryDescriptors |
bind(FactoryDescriptors factoryDescriptors)
This method will bind the descriptors found in the FactoryDescriptors . |
|
void |
commit()
This causes the configuration to get committed. |
Method Detail |
---|
ActiveDescriptor<?> bind(Descriptor key)
key
- May not be null. Will be used to derive the various
key fields associated with the given provider
IllegalArgumentException
- if there is an error in the keyFactoryDescriptors bind(FactoryDescriptors factoryDescriptors)
FactoryDescriptors
. This method will first
validate the descriptors from the FactoryDescriptors
and then simply bind them into this configuration as
two independent descriptors.
factoryDescriptors
- A description of a factory service
and the type the factory service provides. May not be null
IllegalArgumentException
- if there is an error in the input parameter<T> ActiveDescriptor<T> addActiveDescriptor(ActiveDescriptor<T> activeDescriptor) throws IllegalArgumentException
activeDescriptor
- The reified active descriptor to be added to the system. The
system will not attempt to reify this descriptor itself
IllegalArgumentException
- if the descriptor is not reified<T> ActiveDescriptor<T> addActiveDescriptor(Class<T> rawClass) throws MultiException, IllegalArgumentException
rawClass
- The class to analyze, must not be null
MultiException
- If this class cannot be a service
IllegalArgumentException
- if rawClass is nullvoid addUnbindFilter(Filter unbindFilter) throws IllegalArgumentException
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.
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 null
IllegalArgumentException
- if unbindFilter is nullvoid commit() throws MultiException
MultiException
- If errors were found in the commit process
IllegalStateException
- if this method was called more than once
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |