Class ComponentMetadata
- java.lang.Object
-
- org.apache.felix.scr.impl.metadata.ComponentMetadata
-
public class ComponentMetadata extends Object
This class holds the information associated to a component in the descriptor
-
-
Field Summary
Fields Modifier and Type Field Description static String
CONFIGURATION_POLICY_IGNORE
static String
CONFIGURATION_POLICY_OPTIONAL
static String
CONFIGURATION_POLICY_REQUIRE
-
Constructor Summary
Constructors Constructor Description ComponentMetadata(DSVersion dsVersion)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addDependency(ReferenceMetadata newReference)
Used to add a reference metadata to the componentvoid
addFactoryProperty(PropertyMetadata newProperty)
Used to add a factory property to the instancevoid
addProperty(PropertyMetadata newProperty)
Used to add a property to the instanceString
getActivate()
Returns the name of the activate methodList<String>
getActivationFields()
Returns the names of the activation fieldsList<String>
getConfigurationPid()
Returns the configuration pid for the component.String
getConfigurationPolicy()
Returns the configuration PolicyString
getDeactivate()
Returns the name of the deactivate methodList<ReferenceMetadata>
getDependencies()
Returns the dependency descriptorsDSVersion
getDSVersion()
Returns the namespace code of the namespace of the component element declaring this component.String
getFactoryIdentifier()
Returns the factory identifierMap<String,Object>
getFactoryProperties()
Returns the factory properties.String
getImplementationClassName()
Returns the name of the implementation classString
getModified()
Returns the name of the modified methodString
getName()
Returns the name of the componentint
getNumberOfConstructorParameters()
Returns the number of constructor parameters (0 is default)int
getPidIndex(TargetedPID pid)
Map<String,Object>
getProperties()
Returns the properties.ServiceMetadata
getServiceMetadata()
Returns the associated ServiceMetadataServiceMetadata.Scope
getServiceScope()
boolean
isActivateDeclared()
Returns whether the activate method has been declared in the descriptor or not.boolean
isConfigurableServiceProperties()
boolean
isConfigurationIgnored()
Returnstrue
if the configuration policy is configured toCONFIGURATION_POLICY_IGNORE
.boolean
isConfigurationOptional()
Returnstrue
if the configuration policy is configured toCONFIGURATION_POLICY_OPTIONAL
.boolean
isConfigurationPidDeclared()
Returns whether the configuration-pid has been declared in the descriptor or not.boolean
isConfigurationRequired()
Returnstrue
if the configuration policy is configured toCONFIGURATION_POLICY_REQUIRE
.boolean
isConfigureWithInterfaces()
boolean
isDeactivateDeclared()
Returns whether the deactivate method has been declared in the descriptor or not.boolean
isDelayedKeepInstances()
boolean
isDeleteCallsModify()
boolean
isEnabled()
Returns the value of the enabled flagboolean
isFactory()
Test to see if this service is a factoryboolean
isImmediate()
Returns the flag that defines the activation policy for the component.boolean
isObsoleteFactoryComponentFactory()
boolean
isPersistentFactoryComponent()
void
setActivate(String activate)
Sets the name of the activate methodvoid
setActivationFields(String[] fields)
void
setConfigurableServiceProperties(boolean configurableServiceProperties)
void
setConfigurationPid(String[] configurationPid)
Setter for the configuration-pid component (since DS 1.2)void
setConfigurationPolicy(String configurationPolicy)
Sets the configuration policyvoid
setConfigureWithInterfaces(boolean configureWithInterfaces)
void
setDeactivate(String deactivate)
Sets the name of the deactivate methodvoid
setDelayedKeepInstances(boolean delayedKeepInstances)
void
setDeleteCallsModify(boolean deleteCallsModify)
void
setEnabled(boolean enabled)
Setter for the enabled propertyvoid
setFactoryIdentifier(String factoryIdentifier)
void
setImmediate(boolean immediate)
Setter for the immediate propertyvoid
setImplementationClassName(String implementationClassName)
Sets the name of the implementation classvoid
setInit(String value)
void
setModified(String modified)
Sets the name of the modified methodvoid
setName(String name)
Setter for the namevoid
setObsoleteFactoryComponentFactory(boolean obsoleteFactoryComponentFactory)
void
setPersistentFactoryComponent(boolean persistentFactoryComponent)
void
setService(ServiceMetadata service)
Used to set a ServiceMetadata object.void
validate()
Method used to verify if the semantics of this metadata are correct
-
-
-
Field Detail
-
CONFIGURATION_POLICY_REQUIRE
public static final String CONFIGURATION_POLICY_REQUIRE
- See Also:
- Constant Field Values
-
CONFIGURATION_POLICY_IGNORE
public static final String CONFIGURATION_POLICY_IGNORE
- See Also:
- Constant Field Values
-
CONFIGURATION_POLICY_OPTIONAL
public static final String CONFIGURATION_POLICY_OPTIONAL
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
ComponentMetadata
public ComponentMetadata(DSVersion dsVersion)
-
-
Method Detail
-
setConfigurationPid
public void setConfigurationPid(String[] configurationPid)
Setter for the configuration-pid component (since DS 1.2)- Parameters:
configurationPid
-
-
setName
public void setName(String name)
Setter for the name- Parameters:
name
-
-
setEnabled
public void setEnabled(boolean enabled)
Setter for the enabled property- Parameters:
enabled
-
-
setFactoryIdentifier
public void setFactoryIdentifier(String factoryIdentifier)
- Parameters:
factoryIdentifier
-
-
setImmediate
public void setImmediate(boolean immediate)
Setter for the immediate property- Parameters:
immediate
-
-
setImplementationClassName
public void setImplementationClassName(String implementationClassName)
Sets the name of the implementation class- Parameters:
implementationClassName
- a class name
-
setConfigurationPolicy
public void setConfigurationPolicy(String configurationPolicy)
Sets the configuration policy- Parameters:
configurationPolicy
- configuration policy- Since:
- 1.2.0 (DS 1.1)
-
setActivate
public void setActivate(String activate)
Sets the name of the activate method- Parameters:
activate
- a method name- Since:
- 1.2.0 (DS 1.1)
-
setDeactivate
public void setDeactivate(String deactivate)
Sets the name of the deactivate method- Parameters:
deactivate
- a method name- Since:
- 1.2.0 (DS 1.1)
-
setModified
public void setModified(String modified)
Sets the name of the modified method- Parameters:
modified
- a method name- Since:
- 1.2.0 (DS 1.1)
-
addProperty
public void addProperty(PropertyMetadata newProperty)
Used to add a property to the instance- Parameters:
newProperty
- a property metadata object
-
addFactoryProperty
public void addFactoryProperty(PropertyMetadata newProperty)
Used to add a factory property to the instance- Parameters:
newProperty
- a property metadata object
-
setService
public void setService(ServiceMetadata service)
Used to set a ServiceMetadata object.- Parameters:
service
- a ServiceMetadata
-
addDependency
public void addDependency(ReferenceMetadata newReference)
Used to add a reference metadata to the component- Parameters:
newReference
- a new ReferenceMetadata to be added
-
setConfigurableServiceProperties
public void setConfigurableServiceProperties(boolean configurableServiceProperties)
-
setPersistentFactoryComponent
public void setPersistentFactoryComponent(boolean persistentFactoryComponent)
-
setDeleteCallsModify
public void setDeleteCallsModify(boolean deleteCallsModify)
-
setObsoleteFactoryComponentFactory
public void setObsoleteFactoryComponentFactory(boolean obsoleteFactoryComponentFactory)
-
setConfigureWithInterfaces
public void setConfigureWithInterfaces(boolean configureWithInterfaces)
-
setDelayedKeepInstances
public void setDelayedKeepInstances(boolean delayedKeepInstances)
-
setActivationFields
public void setActivationFields(String[] fields)
-
setInit
public void setInit(String value)
-
getDSVersion
public DSVersion getDSVersion()
Returns the namespace code of the namespace of the component element declaring this component. This is one of the XmlHandler.DS_VERSION_* constants.
-
getName
public String getName()
Returns the name of the component- Returns:
- A string containing the name of the component
-
getConfigurationPid
public List<String> getConfigurationPid()
Returns the configuration pid for the component. The pid is the one specified in the component's configuration-pid DS 1.2 attribute, if specified. Else the component name is used as the pid by default.
-
getPidIndex
public int getPidIndex(TargetedPID pid)
-
isConfigurationPidDeclared
public boolean isConfigurationPidDeclared()
Returns whether the configuration-pid has been declared in the descriptor or not.- Returns:
- whether the configuration-pid has method has been declared in the descriptor or not.
- Since:
- DS 1.2
-
isEnabled
public boolean isEnabled()
Returns the value of the enabled flag- Returns:
- a boolean containing the value of the enabled flag
-
getFactoryIdentifier
public String getFactoryIdentifier()
Returns the factory identifier- Returns:
- A string containing a factory identifier or null
-
isImmediate
public boolean isImmediate()
Returns the flag that defines the activation policy for the component.This method may only be trusted after this instance has been validated by the
validate( )
call. Else it will either return the value of an explicitly set "immediate" attribute or return false if a service element or the factory attribute is set or true otherwise. This latter default value deduction may be unsafe while the descriptor has not been completely read.- Returns:
- a boolean that defines the activation policy
-
getImplementationClassName
public String getImplementationClassName()
Returns the name of the implementation class- Returns:
- the name of the implementation class
-
getConfigurationPolicy
public String getConfigurationPolicy()
Returns the configuration Policy- Returns:
- the configuration policy
- Since:
- 1.2.0 (DS 1.1)
-
getActivate
public String getActivate()
Returns the name of the activate method- Returns:
- the name of the activate method
- Since:
- 1.2.0 (DS 1.1)
-
isActivateDeclared
public boolean isActivateDeclared()
Returns whether the activate method has been declared in the descriptor or not.- Returns:
- whether the activate method has been declared in the descriptor or not.
- Since:
- 1.2.0 (DS 1.1)
-
getNumberOfConstructorParameters
public int getNumberOfConstructorParameters()
Returns the number of constructor parameters (0 is default)- Returns:
- The number of constructor parameters
- Since:
- 2.1.0 (DS 1.4)
-
getActivationFields
public List<String> getActivationFields()
Returns the names of the activation fields- Returns:
- the list of activation fields or
null
- Since:
- 2.1.0 (DS 1.4)
-
getDeactivate
public String getDeactivate()
Returns the name of the deactivate method- Returns:
- the name of the deactivate method
- Since:
- 1.2.0 (DS 1.1)
-
isDeactivateDeclared
public boolean isDeactivateDeclared()
Returns whether the deactivate method has been declared in the descriptor or not.- Returns:
- whether the deactivate method has been declared in the descriptor or not.
- Since:
- 1.2.0 (DS 1.1)
-
getModified
public String getModified()
Returns the name of the modified method- Returns:
- the name of the modified method
- Since:
- 1.2.0 (DS 1.1)
-
getServiceMetadata
public ServiceMetadata getServiceMetadata()
Returns the associated ServiceMetadata- Returns:
- a ServiceMetadata object or null if the Component does not provide any service
-
getServiceScope
public ServiceMetadata.Scope getServiceScope()
-
getProperties
public Map<String,Object> getProperties()
Returns the properties.- Returns:
- the properties as a Dictionary
-
getFactoryProperties
public Map<String,Object> getFactoryProperties()
Returns the factory properties.- Returns:
- the factory properties as a Dictionary
-
getDependencies
public List<ReferenceMetadata> getDependencies()
Returns the dependency descriptors- Returns:
- a Collection of dependency descriptors
-
isFactory
public boolean isFactory()
Test to see if this service is a factory- Returns:
- true if it is a factory, false otherwise
-
isConfigurationRequired
public boolean isConfigurationRequired()
Returnstrue
if the configuration policy is configured toCONFIGURATION_POLICY_REQUIRE
.
-
isConfigurationIgnored
public boolean isConfigurationIgnored()
Returnstrue
if the configuration policy is configured toCONFIGURATION_POLICY_IGNORE
.
-
isConfigurationOptional
public boolean isConfigurationOptional()
Returnstrue
if the configuration policy is configured toCONFIGURATION_POLICY_OPTIONAL
.
-
isConfigurableServiceProperties
public boolean isConfigurableServiceProperties()
-
isPersistentFactoryComponent
public boolean isPersistentFactoryComponent()
-
isDeleteCallsModify
public boolean isDeleteCallsModify()
-
isObsoleteFactoryComponentFactory
public boolean isObsoleteFactoryComponentFactory()
-
isConfigureWithInterfaces
public boolean isConfigureWithInterfaces()
-
isDelayedKeepInstances
public boolean isDelayedKeepInstances()
-
validate
public void validate()
Method used to verify if the semantics of this metadata are correct
-
-