GigaSpaces XAP 9.5 API

net.jini.core.lookup
Class ServiceEvent

java.lang.Object
  extended by java.util.EventObject
      extended by net.jini.core.event.RemoteEvent
          extended by net.jini.core.lookup.ServiceEvent
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
RegistrarEvent

public abstract class ServiceEvent
extends RemoteEvent

This class is used for remote events sent by the lookup service. It extends RemoteEvent with methods to obtain the service ID of the matched item, the transition that triggered the event, and the new state of the item.

Sequence numbers for a given event ID are strictly increasing. If there is no gap between two sequence numbers, no events have been missed; if there is a gap, events might (but might not) have been missed. For example, a gap might occur if the lookup service crashes, even if no events are lost due to the crash.

Since:
1.0
Author:
Sun Microsystems, Inc.
See Also:
Serialized Form

Field Summary
protected  ServiceID serviceID
          ServiceID of the item that triggered the event.
protected  int transition
          One of ServiceRegistrar.TRANSITION_*MATCH_*MATCH.
 
Fields inherited from class net.jini.core.event.RemoteEvent
eventID, handback, seqNum, source
 
Constructor Summary
ServiceEvent(Object source, long eventID, long seqNo, MarshalledObject handback, ServiceID serviceID, int transition)
          Simple constructor.
 
Method Summary
 ServiceID getServiceID()
          Returns the serviceID of the item that triggered the event.
abstract  ServiceItem getServiceItem()
          Returns the new state of the item, or null if the item was deleted from the lookup service.
 int getTransition()
          Returns the singleton transition that triggered the event.
 String toString()
          Returns a String representation of this ServiceEvent.
 
Methods inherited from class net.jini.core.event.RemoteEvent
getID, getRegistrationObject, getSequenceNumber
 
Methods inherited from class java.util.EventObject
getSource
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

serviceID

protected ServiceID serviceID
ServiceID of the item that triggered the event.


transition

protected int transition
One of ServiceRegistrar.TRANSITION_*MATCH_*MATCH.

Constructor Detail

ServiceEvent

public ServiceEvent(Object source,
                    long eventID,
                    long seqNo,
                    MarshalledObject handback,
                    ServiceID serviceID,
                    int transition)
Simple constructor.

Parameters:
source - the source of this ServiceEvent
eventID - the registration eventID
seqNo - the sequence number of this event
handback - the client handback
serviceID - the serviceID of the item that triggered the event
transition - the transition that triggered the event
Method Detail

getServiceID

public ServiceID getServiceID()
Returns the serviceID of the item that triggered the event.

Returns:
a ServiceID object representing the service ID value

getTransition

public int getTransition()
Returns the singleton transition that triggered the event.

Returns:
an int representing the transition value

toString

public String toString()
Returns a String representation of this ServiceEvent.

Overrides:
toString in class EventObject
Returns:
a String representation of this object

getServiceItem

public abstract ServiceItem getServiceItem()
Returns the new state of the item, or null if the item was deleted from the lookup service.

Returns:
a ServiceItem object representing the service item value

GigaSpaces XAP 9.5 API

Copyright © GigaSpaces.