fr.liglab.adele.icasa.device.util

Class LocatedDeviceTracker

java.lang.Object

fr.liglab.adele.icasa.device.util.LocatedDeviceTracker

All Implemented Interfaces:

LocatedDeviceTrackerCustomizer

public class LocatedDeviceTracker
extends Object
implements LocatedDeviceTrackerCustomizer

Utility class to track iCasa devices.

Author:

Thomas Leveque

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.felix.ipojo.util.Tracker	contextMgrTracker Tracker of technical service used to listen device events.
protected static org.slf4j.Logger	logger
protected org.osgi.framework.BundleContext	m_context The bundle context against which this LocatedDeviceTracker object is tracking.
protected LocatedDeviceTrackerCustomizer	m_customizer The LocatedDeviceTrackerCustomizer object for this tracker.
protected LocatedDeviceFilter	m_propFilter the filter specifying prop matching criteria for the devices to track.
protected LocatedDeviceFilter	m_typeFilter the filter specifying type criteria for the devices to track.

Constructor Summary

Constructors

Constructor and Description
LocatedDeviceTracker(org.osgi.framework.BundleContext context, Class<? extends GenericDevice> clazz, LocatedDeviceTrackerCustomizer customizer, String... mandatoryProperties) Creates a LocatedDeviceTracker object on the specified class name.

Method Summary

Methods

Modifier and Type	Method and Description
void	addedDevice(LocatedDevice device) Default implementation of the LocatedDeviceTrackerCustomizer.addedDevice method.
boolean	addingDevice(LocatedDevice device) Default implementation of the LocatedDeviceTrackerCustomizer.addingDevice method.
void	close() Closes this LocatedDeviceTracker object.
List<LocatedDevice>	getDevices() Gets the list of stored devices.
void	modifiedDevice(LocatedDevice device, String propertyName, Object oldValue, Object newValue) Default implementation of the LocatedDeviceTrackerCustomizer.modifiedDevice method.
void	movedDevice(LocatedDevice device, Position oldPosition, Position newPosition)
void	open() Opens this LocatedDeviceTracker object and begin tracking services.
void	removedDevice(LocatedDevice device) Default implementation of the LocatedDeviceTrackerCustomizer.removedDevice method.
int	size() Returns the number of devices being tracked by this LocatedDeviceTracker object.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static org.slf4j.Logger logger

m_context

protected org.osgi.framework.BundleContext m_context

The bundle context against which this LocatedDeviceTracker object is tracking.

contextMgrTracker

protected org.apache.felix.ipojo.util.Tracker contextMgrTracker

Tracker of technical service used to listen device events.

m_typeFilter

protected LocatedDeviceFilter m_typeFilter

the filter specifying type criteria for the devices to track.

m_propFilter

protected LocatedDeviceFilter m_propFilter

the filter specifying prop matching criteria for the devices to track.

m_customizer

protected LocatedDeviceTrackerCustomizer m_customizer

The LocatedDeviceTrackerCustomizer object for this tracker.

Constructor Detail

LocatedDeviceTracker

public LocatedDeviceTracker(org.osgi.framework.BundleContext context,
                    Class<? extends GenericDevice> clazz,
                    LocatedDeviceTrackerCustomizer customizer,
                    String... mandatoryProperties)

Creates a LocatedDeviceTracker object on the specified class name. Services registered under the specified class name will be tracked by this LocatedDeviceTracker object.

Parameters:

context - the BundleContext object against which the tracking is done.

clazz - the Class name of the services to be tracked.

customizer - the customizer object to call when services are added, modified, or removed in this LocatedDeviceTracker object. If customizer is null, then this LocatedDeviceTracker object will be used as the TrackerCustomizer object and the LocatedDeviceTracker object will call the TrackerCustomizer methods on itself.

Method Detail

open

public void open()

Opens this LocatedDeviceTracker object and begin tracking services.

Services which match the search criteria specified when this LocatedDeviceTracker object was created are now tracked by this LocatedDeviceTracker object.

close

public void close()

Closes this LocatedDeviceTracker object.

This method should be called when this LocatedDeviceTracker object should end the tracking of services.

addingDevice

public boolean addingDevice(LocatedDevice device)

Default implementation of the LocatedDeviceTrackerCustomizer.addingDevice method.

Specified by:

addingDevice in interface LocatedDeviceTrackerCustomizer

Parameters:

device - the device being added to the Tracker object.

Returns:

The service object to be tracked for the DeviceReference object or null if the DeviceReference object should not be tracked.

addedDevice

public void addedDevice(LocatedDevice device)

Default implementation of the LocatedDeviceTrackerCustomizer.addedDevice method.

Specified by:

addedDevice in interface LocatedDeviceTrackerCustomizer

Parameters:

device - the added device

modifiedDevice

public void modifiedDevice(LocatedDevice device,
                  String propertyName,
                  Object oldValue,
                  Object newValue)

Default implementation of the LocatedDeviceTrackerCustomizer.modifiedDevice method.

Specified by:

modifiedDevice in interface LocatedDeviceTrackerCustomizer

Parameters:

device - the changed device

propertyName - name of the property that has changed

oldValue - previous value of the property

newValue - new value of the property

movedDevice

public void movedDevice(LocatedDevice device,
               Position oldPosition,
               Position newPosition)

Specified by:

movedDevice in interface LocatedDeviceTrackerCustomizer

removedDevice

public void removedDevice(LocatedDevice device)

Default implementation of the LocatedDeviceTrackerCustomizer.removedDevice method.

Specified by:

removedDevice in interface LocatedDeviceTrackerCustomizer

Parameters:

device - the removed device.

getDevices

public List<LocatedDevice> getDevices()

Gets the list of stored devices.

Returns:

the list containing devices

size

public int size()

Returns the number of devices being tracked by this LocatedDeviceTracker object.

Returns:

the Number of devices being tracked.