org.apache.felix.ipojo.composite
Class CompositeFactory

java.lang.Object
  org.apache.felix.ipojo.IPojoFactory
      org.apache.felix.ipojo.ComponentFactory
          org.apache.felix.ipojo.composite.CompositeFactory

All Implemented Interfaces:

Factory, TrackerCustomizer, org.osgi.service.cm.ManagedServiceFactory

public class CompositeFactory
extends ComponentFactory
implements TrackerCustomizer

The component factory manages component instance objects. This management consist in creating and managing component instance build with the component factory. This class could export Factory and ManagedServiceFactory services.

Author:

Felix Project Team

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.felix.ipojo.IPojoFactory

IPojoFactory.RequiredHandler

Field Summary

protected Tracker

m_tracker Tracker used to track required handler factories.

Fields inherited from class org.apache.felix.ipojo.IPojoFactory

INSTANCE_NAME, m_componentDesc, m_componentInstances, m_componentMetadata, m_context, m_factoryName, m_isPublic, m_listeners, m_logger, m_requiredHandlers, m_sr, m_state, m_version

Fields inherited from interface org.apache.felix.ipojo.Factory

INVALID, VALID

Constructor Summary

CompositeFactory(org.osgi.framework.BundleContext context, Element metadata)
Create a composite factory.

Method Summary

void	check(Element metadata) Check if the metadata are well formed.
ComponentInstance	createInstance(java.util.Dictionary configuration, IPojoContext context, HandlerManager[] handlers) Create an instance from the current factory.
java.lang.String	getClassName() Gets the class name.
java.lang.String	getFactoryName() Computes the factory name.
java.util.List	getRequiredHandlerList() Compute required handlers.
void	reconfigure(java.util.Dictionary properties) Reconfigure an existing instance.
void	starting() Start all the instance managers.
void	stopping() Stop all the instance managers.

Methods inherited from class org.apache.felix.ipojo.ComponentFactory

addedService, addingService, defineClass, getBundleClassLoader, getComponentTypeDescription, getPojoMetadata, getResource, getVersion, loadClass, modifiedService, removedService

Methods inherited from class org.apache.felix.ipojo.IPojoFactory

addFactoryStateListener, checkAcceptability, computeDescription, computeFactoryState, createComponentInstance, createComponentInstance, deleted, disposed, generateName, getBundleContext, getComponentDescription, getDescription, getHandler, getIPOJOBundleContext, getLogger, getMissingHandlers, getName, getRequiredHandlers, getState, isAcceptable, match, removeFactoryStateListener, start, stop, updated

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.felix.ipojo.util.TrackerCustomizer

addedService, addingService, modifiedService, removedService

Field Detail

m_tracker

protected Tracker m_tracker

Tracker used to track required handler factories.

Constructor Detail

CompositeFactory

public CompositeFactory(org.osgi.framework.BundleContext context,
                        Element metadata)
                 throws ConfigurationException

Create a composite factory.

Parameters:

context - : bundle context

metadata - : metadata of the component to create

Throws:

ConfigurationException - occurs when the element describing the factory is malformed.

Method Detail

check

public void check(Element metadata)
           throws ConfigurationException

Check if the metadata are well formed.

Overrides:

check in class ComponentFactory

Parameters:

metadata - : metadata

Throws:

ConfigurationException - occurs when the element describing the factory is malformed.

See Also:

ComponentFactory.check(org.apache.felix.ipojo.metadata.Element)

getClassName

public java.lang.String getClassName()

Description copied from class: ComponentFactory

Gets the class name. No synchronization needed, the classname is immutable.

Specified by:

getClassName in interface Factory

Overrides:

getClassName in class ComponentFactory

Returns:

the class name.

See Also:

IPojoFactory.getClassName()

getRequiredHandlerList

public java.util.List getRequiredHandlerList()

Compute required handlers.

Overrides:

getRequiredHandlerList in class ComponentFactory

Returns:

the list of required handler.

stopping

public void stopping()

Stop all the instance managers.

Overrides:

stopping in class ComponentFactory

starting

public void starting()

Start all the instance managers.

Overrides:

starting in class ComponentFactory

createInstance

public ComponentInstance createInstance(java.util.Dictionary configuration,
                                        IPojoContext context,
                                        HandlerManager[] handlers)
                                 throws ConfigurationException

Create an instance from the current factory.

Overrides:

createInstance in class ComponentFactory

Parameters:

configuration - : instance configuration

context - : bundle context to inject in the instance manager

handlers - : array of handler object to attached on the instance

Returns:

the created instance

Throws:

ConfigurationException - either the instance configuration or the instance starting has failed

See Also:

ComponentFactory.createInstance(java.util.Dictionary, org.apache.felix.ipojo.IPojoContext, org.apache.felix.ipojo.HandlerManager[])

reconfigure

public void reconfigure(java.util.Dictionary properties)
                 throws UnacceptableConfiguration,
                        MissingHandlerException

Reconfigure an existing instance.

Specified by:

reconfigure in interface Factory

Overrides:

reconfigure in class IPojoFactory

Parameters:

properties - : the new configuration to push.

Throws:

UnacceptableConfiguration - : occurs if the new configuration is not consistent with the component type.

MissingHandlerException - : occurs when an handler is unavailable when creating the instance.

See Also:

Factory.reconfigure(java.util.Dictionary)

getFactoryName

public java.lang.String getFactoryName()

Description copied from class: ComponentFactory

Computes the factory name. The factory name is computed from the 'name' and 'classname' attributes. This method does not manipulate any non-immutable fields, so does not need to be synchronized.

Overrides:

getFactoryName in class ComponentFactory

Returns:

the factory name.