org.eclipse.ecf.osgi.services.discovery
Interface DiscoveredServiceNotification

All Known Implementing Classes:

DiscoveredServiceNotificationImpl

Deprecated. This interface is deprecated because at the time of ECF 3.0/Galileo release, it seems likely that this class will be moved, or renamed, or undergo major changes after the release of ECF 3.0. This deprecation is therefore intended as a notice to consumers about these upcoming changes in the RFC119 specification, and the consequent changes to these OSGi-defined classes.

public interface DiscoveredServiceNotification

Interface for notification on discovered services.

DiscoveredServiceNotification objects are immutable.

Version:

$Revision: 1.2 $

Field Summary

static int	AVAILABLE Deprecated. Notification indicating that a service matching the listening criteria has been discovered.
static int	MODIFIED Deprecated. Notification indicating that the properties of a previously discovered service have changed.
static int	MODIFIED_ENDMATCH Deprecated. Notification indicating that the properties of a previously discovered service have changed and the new properties no longer match the listener's filter.
static int	UNAVAILABLE Deprecated. Notification indicating that a previously discovered service is no longer known to Discovery.

Method Summary

java.util.Collection	getFilters() Deprecated. Returns filters of the DiscoveredServiceTracker object matching with the properties of the ServiceEndpointDescription and thus caused the notification.
java.util.Collection	getInterfaces() Deprecated. Returns interface name criteria of the DiscoveredServiceTracker object matching with the interfaces of the ServiceEndpointDescription and thus caused the notification.
ServiceEndpointDescription	getServiceEndpointDescription() Deprecated. Returns information currently known to Discovery regarding the service endpoint.
int	getType() Deprecated. Returns the type of notification.

Field Detail

AVAILABLE

static final int AVAILABLE

Deprecated.

Notification indicating that a service matching the listening criteria has been discovered.

The value of AVAILABLE is 0x00000001.

See Also:

Constant Field Values

MODIFIED

static final int MODIFIED

Deprecated.

Notification indicating that the properties of a previously discovered service have changed.

The value of MODIFIED is 0x00000002.

See Also:

Constant Field Values

UNAVAILABLE

static final int UNAVAILABLE

Deprecated.

Notification indicating that a previously discovered service is no longer known to Discovery.

The value of UNAVAILABLE is 0x00000004.

See Also:

Constant Field Values

MODIFIED_ENDMATCH

static final int MODIFIED_ENDMATCH

Deprecated.

Notification indicating that the properties of a previously discovered service have changed and the new properties no longer match the listener's filter.

The value of MODIFIED_ENDMATCH is 0x00000008.

See Also:

Constant Field Values

Method Detail

getServiceEndpointDescription

ServiceEndpointDescription getServiceEndpointDescription()

Deprecated.

Returns information currently known to Discovery regarding the service endpoint.

Returns:

metadata of the service Discovery notifies about. Is never null.

getType

int getType()

Deprecated.

Returns the type of notification. The type values are:

• AVAILABLE
• MODIFIED
• MODIFIED_ENDMATCH
• UNAVAILABLE

Returns:

Type of notification regarding known service metadata.

getInterfaces

java.util.Collection getInterfaces()

Deprecated.

Returns interface name criteria of the DiscoveredServiceTracker object matching with the interfaces of the ServiceEndpointDescription and thus caused the notification.

Returns:

Collection (<String>) of matching interface name criteria of the DiscoveredServiceTracker object being notified, or an empty collection if notification hasn't been caused by a matching interface name criteria.

getFilters

java.util.Collection getFilters()

Deprecated.

Returns filters of the DiscoveredServiceTracker object matching with the properties of the ServiceEndpointDescription and thus caused the notification.

Returns:

Collection (<String>) of matching filters of the DiscoveredServiceTracker object being notified, or an empty collection if notification hasn't been caused by a matching filter criteria.