org.apache.felix.scr.impl.manager

Class ComponentFactoryImpl<S>

java.lang.Object

org.apache.felix.scr.impl.manager.AbstractComponentManager<S>

org.apache.felix.scr.impl.manager.ComponentFactoryImpl<S>

All Implemented Interfaces:

ComponentContainer<S>, ComponentManager<S>, org.osgi.service.component.ComponentFactory<S>

public class ComponentFactoryImpl<S>
extends AbstractComponentManager<S>
implements org.osgi.service.component.ComponentFactory<S>, ComponentContainer<S>

The ComponentFactoryImpl extends the AbstractComponentManager class to implement the component factory functionality. As such the OSGi Declarative Services ComponentFactory interface is implemented.

In addition the ComponentHolder interface is implemented to use this class directly as the holder for component instances created by the newInstance(Dictionary) method.

This class implements spec-compliant component factories and the felix "persistent" component factory, where the factory is always registered whether or not all dependencies are present and the created components also persist whether or not the dependencies are present to allow the component instance to exist.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.felix.scr.impl.manager.AbstractComponentManager

AbstractComponentManager.State

Field Summary

Fields

Modifier and Type	Field and Description
protected long	m_changeCount Configuration change count (R5) or imitation (R4)
protected TargetedPID	m_targetedPID

Fields inherited from class org.apache.felix.scr.impl.manager.AbstractComponentManager

m_activationLock, m_container, m_factoryInstance

Fields inherited from interface org.apache.felix.scr.impl.manager.ComponentManager

STATE_ACTIVE, STATE_DISPOSED, STATE_SATISFIED, STATE_UNSATISFIED_CONFIGURATION, STATE_UNSATISFIED_REFERENCE

Constructor Summary

Constructors

Constructor and Description
ComponentFactoryImpl(ComponentContainer<S> container, ComponentMethods componentMethods)

Method Summary

Modifier and Type	Method and Description
protected boolean	collectDependencies(ComponentContextImpl<S> componentContext) Collect and store in m_dependencies_map all the services for dependencies, outside of any locks.
protected void	deleteComponent(int reason) The component factory does not have a component to delete.
void	dispose(int reason) Disposes off all components ever created by this component holder.
void	disposed(SingleComponentManager<S> component) Informs the holder that the component has been disposed as a result of calling the dispose method.
boolean	equals(Object object) Compares this ComponentFactoryImpl object to another object.
void	getComponentManagers(List<AbstractComponentManager<S>> cms)
protected void	getComponentManagers(Map<?,SingleComponentManager<S>> componentMap, List<AbstractComponentManager<S>> componentManagers)
TargetedPID	getConfigurationTargetedPID(TargetedPID pid, TargetedPID factoryPid)
Map<String,Object>	getProperties() For ComponentFactoryImpl, this is used only for updating targets on the dependency managers, so we don't need any other properties.
protected String[]	getProvidedServices()
Dictionary<String,Object>	getServiceProperties() Returns the subset of component properties to be used as service properties.
boolean	hasConfiguration()
int	hashCode() Returns a hash code value for the object.
boolean	isFactory()
org.osgi.service.component.ComponentInstance<S>	newInstance(Dictionary<String,?> dictionary)
void	reconfigure(Map<String,Object> configuration, boolean configurationDeleted, TargetedPID factoryPid)
void	setServiceProperties(Dictionary<String,?> serviceProperties)
protected boolean	verifyDependencyManagers()

Methods inherited from class org.apache.felix.scr.impl.manager.AbstractComponentManager

copyTo, copyToDictionary, copyToMap, disable, enable, getActivator, getBundle, getComponentMetadata, getFailureReason, getId, getLogger, getReferenceManagers, getRegisteredServiceReference, getServiceRegistration, getSpecState, isImmediate, registerService, setFailureReason, setServiceProperties, toString, unregisterService

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.felix.scr.impl.manager.ComponentContainer

getActivator, getComponentMetadata, getLogger

Field Detail

m_changeCount

protected volatile long m_changeCount

Configuration change count (R5) or imitation (R4)

m_targetedPID

protected TargetedPID m_targetedPID

Constructor Detail

ComponentFactoryImpl

public ComponentFactoryImpl(ComponentContainer<S> container,
                            ComponentMethods componentMethods)

Method Detail

verifyDependencyManagers

protected boolean verifyDependencyManagers()

Overrides:

verifyDependencyManagers in class AbstractComponentManager<S>

isFactory

public boolean isFactory()

Overrides:

isFactory in class AbstractComponentManager<S>

newInstance

public org.osgi.service.component.ComponentInstance<S> newInstance(Dictionary<String,?> dictionary)

Specified by:

newInstance in interface org.osgi.service.component.ComponentFactory<S>

equals

public boolean equals(Object object)

Compares this ComponentFactoryImpl object to another object.

A component factory impl is considered to be equal to another component factory impl if the component names are equal(using String.equals).

Overrides:

equals in class Object

Parameters:

object - The ComponentFactoryImpl object to be compared.

Returns:

true if object is a ComponentFactoryImpl and is equal to this object; false otherwise.

hashCode

public int hashCode()

Returns a hash code value for the object.

Overrides:

hashCode in class Object

Returns:

An integer which is a hash code value for this object.

deleteComponent

protected void deleteComponent(int reason)

The component factory does not have a component to delete.

But in the backwards compatible case any instances created for factory configuration instances are to disabled as a consequence of deactivating the component factory.

Specified by:

deleteComponent in class AbstractComponentManager<S>

getProvidedServices

protected String[] getProvidedServices()

Overrides:

getProvidedServices in class AbstractComponentManager<S>

hasConfiguration

public boolean hasConfiguration()

getProperties

public Map<String,Object> getProperties()

For ComponentFactoryImpl, this is used only for updating targets on the dependency managers, so we don't need any other properties.

Specified by:

getProperties in interface ComponentManager<S>

Specified by:

getProperties in class AbstractComponentManager<S>

setServiceProperties

public void setServiceProperties(Dictionary<String,?> serviceProperties)

Specified by:

setServiceProperties in class AbstractComponentManager<S>

getServiceProperties

public Dictionary<String,Object> getServiceProperties()

Description copied from class: AbstractComponentManager

Returns the subset of component properties to be used as service properties. These properties are all component properties where property name does not start with dot (.), properties which are considered private.

Overrides:

getServiceProperties in class AbstractComponentManager<S>

collectDependencies

protected boolean collectDependencies(ComponentContextImpl<S> componentContext)

Description copied from class: AbstractComponentManager

Collect and store in m_dependencies_map all the services for dependencies, outside of any locks.

Overrides:

collectDependencies in class AbstractComponentManager<S>

Parameters:

componentContext - possible instance key for prototype scope references

Returns:

true if all references can be collected, false if some dependency is no longer available.

dispose

public void dispose(int reason)

Disposes off all components ever created by this component holder. This method is called if either the Declarative Services runtime is stopping or if the owning bundle is stopped. In both cases all components created by this holder must be disposed off.

Overrides:

dispose in class AbstractComponentManager<S>

disposed

public void disposed(SingleComponentManager<S> component)

Description copied from interface: ComponentContainer

Informs the holder that the component has been disposed as a result of calling the dispose method.

Specified by:

disposed in interface ComponentContainer<S>

getComponentManagers

protected void getComponentManagers(Map<?,SingleComponentManager<S>> componentMap,
                                    List<AbstractComponentManager<S>> componentManagers)

getConfigurationTargetedPID

public TargetedPID getConfigurationTargetedPID(TargetedPID pid,
                                               TargetedPID factoryPid)

reconfigure

public void reconfigure(Map<String,Object> configuration,
                        boolean configurationDeleted,
                        TargetedPID factoryPid)

Specified by:

reconfigure in class AbstractComponentManager<S>

getComponentManagers

public void getComponentManagers(List<AbstractComponentManager<S>> cms)

Specified by:

getComponentManagers in class AbstractComponentManager<S>