org.apache.felix.ipojo.handlers.providedservice.strategy

Class ConfigurableCreationStrategy

java.lang.Object

org.apache.felix.ipojo.handlers.providedservice.CreationStrategy

org.apache.felix.ipojo.handlers.providedservice.strategy.ConfigurableCreationStrategy

public abstract class ConfigurableCreationStrategy
extends CreationStrategy

This CreationStrategy is here to ease customization of the strategy by hiding all the reflection stuff.

Author:

Felix Project Team

Field Summary

Fields

Modifier and Type	Field and Description
private IPOJOServiceFactory	m_factory The iPOJO ServiceFactory.
private InstanceManager	m_manager The instance manager passed to the iPOJO ServiceFactory to manage instances.
private String[]	m_specs The lists of interfaces provided by this service.

Constructor Summary

Constructors

Constructor and Description
ConfigurableCreationStrategy()

Method Summary

Modifier and Type	Method and Description
private Class[]	getModifiedSpecifications(BundleContext context) Utility method that transform the specifications names into a Class array, appending the IPOJOServiceFactory interface to it.
Object	getService(Bundle bundle, ServiceRegistration registration) Method called when a bundle want to access a service.
protected abstract IPOJOServiceFactory	getServiceFactory(InstanceManager manager) User provided CreationStrategy MUST implement this method to provide the real iPOJO ServiceFactory instance.
void	onPublication(InstanceManager manager, String[] specifications, Properties props) Method called when the underlying iPOJO Service factory is published.
void	onUnpublication() Method called when the underlying iPOJO Service factory is un-published.
void	ungetService(Bundle bundle, ServiceRegistration registration, Object service) Method called when a bundle release a service.

Methods inherited from class org.apache.felix.ipojo.handlers.providedservice.CreationStrategy

isGetServiceMethod, isUngetServiceMethod

Methods inherited from class java.lang.Object

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

Field Detail

m_manager

private InstanceManager m_manager

The instance manager passed to the iPOJO ServiceFactory to manage instances.

m_specs

private String[] m_specs

The lists of interfaces provided by this service.

m_factory

private IPOJOServiceFactory m_factory

The iPOJO ServiceFactory.

Constructor Detail

ConfigurableCreationStrategy

public ConfigurableCreationStrategy()

Method Detail

onPublication

public void onPublication(InstanceManager manager,
                          String[] specifications,
                          Properties props)

Method called when the underlying iPOJO Service factory is published.

Specified by:

onPublication in class CreationStrategy

Parameters:

manager - the instance manager

specifications - the provided specifications

props - the service properties

See Also:

CreationStrategy.onPublication(org.apache.felix.ipojo.InstanceManager, java.lang.String[], java.util.Properties)

onUnpublication

public void onUnpublication()

Method called when the underlying iPOJO Service factory is un-published.

Specified by:

onUnpublication in class CreationStrategy

See Also:

CreationStrategy.onUnpublication()

getService

public Object getService(Bundle bundle,
                         ServiceRegistration registration)

Method called when a bundle want to access a service. This method is called once per asking bundle. To turn around this limitation, a proxy is registered.

Parameters:

bundle - the asking bundle

registration - the service registration

Returns:

the service object

See Also:

ServiceFactory

ungetService

public void ungetService(Bundle bundle,
                         ServiceRegistration registration,
                         Object service)

Method called when a bundle release a service.

Parameters:

bundle - the bundle

registration - the service registration

service - the service object

See Also:

ServiceFactory

getModifiedSpecifications

private Class[] getModifiedSpecifications(BundleContext context)

Utility method that transform the specifications names into a Class array, appending the IPOJOServiceFactory interface to it.

Parameters:

context - used for class loading

Returns:

a array of Class

getServiceFactory

protected abstract IPOJOServiceFactory getServiceFactory(InstanceManager manager)

User provided CreationStrategy MUST implement this method to provide the real iPOJO ServiceFactory instance.

Parameters:

manager - InstanceManager that the factory could use

Returns:

an instance of IPOJOServiceFactory