fr.liglab.adele.cilia.runtime

Class CiliaInstanceWrapper

java.lang.Object

java.util.Observable

fr.liglab.adele.cilia.runtime.CiliaInstanceWrapper

All Implemented Interfaces:

CiliaInstance, org.apache.felix.ipojo.InstanceStateListener, org.apache.felix.ipojo.util.TrackerCustomizer

public class CiliaInstanceWrapper
extends Observable
implements CiliaInstance, org.apache.felix.ipojo.util.TrackerCustomizer, org.apache.felix.ipojo.InstanceStateListener

This class wraps a Pojo object, their instance and their factory.

Author:

Cilia Project Team

Constructor Summary

Constructors

Constructor and Description
CiliaInstanceWrapper(org.osgi.framework.BundleContext context, String instanceName, String filter, Dictionary props, Observer obs) Create an iPOJO wrap instance.

Method Summary

Methods

Modifier and Type	Method and Description
void	addedService(org.osgi.framework.ServiceReference reference) When the factory service is tracked.
boolean	addingService(org.osgi.framework.ServiceReference reference) Bassed on the filter, the addingService must be the good one.
protected void	createInstance(org.apache.felix.ipojo.Factory ipojoFactory) Create the instance usgin the iPOJO Factory
org.apache.felix.ipojo.ComponentInstance	getInstanceManager()
Dictionary	getInstanceProperties() Obtain a copy of the instance properties.
Object	getInstanceProperty(Object key) Obtain the instance property.
String	getName() Get the instance name.
Object	getObject() Get the object instance.
int	getState() Get the instance state.
String	getStateAsString() Get the state value as a string.
void	modifiedService(org.osgi.framework.ServiceReference reference, Object service) Modifying the factory service, nothing to do.
void	refresh() Will notify the observers there is a change in the instance status.
void	removedService(org.osgi.framework.ServiceReference reference, Object service) When removing the factory service, it must remove the instance.
void	start() Start the tracker.
void	stateChanged(org.apache.felix.ipojo.ComponentInstance instance, int newState)
void	stop() Stop the Instance wrapper, it unregister the tracker and dispose the instance.
protected void	unregisterTracker() Unregistering the factory tracker.
void	updateInstanceProperties(Dictionary properties) Update the instance's runtime properties

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

CiliaInstanceWrapper

public CiliaInstanceWrapper(org.osgi.framework.BundleContext context,
                    String instanceName,
                    String filter,
                    Dictionary props,
                    Observer obs)

Create an iPOJO wrap instance.

Parameters:

context - The OSGi bundle context.

instanceName - The name of the instance, this is not the iPOJO instance name, is an abstract name.

filter - A filter to search the iPOJO factory which will create the instance.

props - Properties used when creating the instance.

obs - The observer reference.

Method Detail

createInstance

protected void createInstance(org.apache.felix.ipojo.Factory ipojoFactory)

Create the instance usgin the iPOJO Factory

getInstanceProperties

public Dictionary getInstanceProperties()

Obtain a copy of the instance properties.

Specified by:

getInstanceProperties in interface CiliaInstance

Returns:

getInstanceProperty

public Object getInstanceProperty(Object key)

Obtain the instance property.

Specified by:

getInstanceProperty in interface CiliaInstance

Returns:

getObject

public Object getObject()

Get the object instance. return the object instance. Null when the instance is not valid.

Specified by:

getObject in interface CiliaInstance

Returns:

getState

public int getState()

Get the instance state.

Specified by:

getState in interface CiliaInstance

Returns:

getStateAsString

public String getStateAsString()

Get the state value as a string.

refresh

public void refresh()

Will notify the observers there is a change in the instance status. It notify only true, when the instance is valid, and false, when the instance is invalid.

Specified by:

refresh in interface CiliaInstance

getName

public String getName()

Get the instance name. return name The instance name.

Specified by:

getName in interface CiliaInstance

Returns:

start

public void start()

Start the tracker.

Specified by:

start in interface CiliaInstance

stop

public void stop()

Stop the Instance wrapper, it unregister the tracker and dispose the instance.

Specified by:

stop in interface CiliaInstance

updateInstanceProperties

public void updateInstanceProperties(Dictionary properties)

Description copied from interface: CiliaInstance

Update the instance's runtime properties

Specified by:

updateInstanceProperties in interface CiliaInstance

stateChanged

public void stateChanged(org.apache.felix.ipojo.ComponentInstance instance,
                int newState)

Specified by:

stateChanged in interface org.apache.felix.ipojo.InstanceStateListener

getInstanceManager

public org.apache.felix.ipojo.ComponentInstance getInstanceManager()

unregisterTracker

protected void unregisterTracker()

Unregistering the factory tracker.

addedService

public void addedService(org.osgi.framework.ServiceReference reference)

When the factory service is tracked.

Specified by:

addedService in interface org.apache.felix.ipojo.util.TrackerCustomizer

addingService

public boolean addingService(org.osgi.framework.ServiceReference reference)

Bassed on the filter, the addingService must be the good one.

Specified by:

addingService in interface org.apache.felix.ipojo.util.TrackerCustomizer

modifiedService

public void modifiedService(org.osgi.framework.ServiceReference reference,
                   Object service)

Modifying the factory service, nothing to do.

Specified by:

modifiedService in interface org.apache.felix.ipojo.util.TrackerCustomizer

removedService

public void removedService(org.osgi.framework.ServiceReference reference,
                  Object service)

When removing the factory service, it must remove the instance.

Specified by:

removedService in interface org.apache.felix.ipojo.util.TrackerCustomizer