GigaSpaces XAP 9.7.2 API

com.gigaspaces.events
Interface DataEventSession

All Superinterfaces:
EventSession

public interface DataEventSession
extends EventSession

The common interface that is used when working with data events.
listeners can be registered using the addListener() methods and receive
an EventRegistration that will be used to unregister using the removeListener().

Since:
6.0
Version:
1.0
Author:
asy ronen
See Also:
EventSession

Method Summary
 EventRegistration addListener(Object template, RemoteEventListener listener)
          Registers a listener with a space using a POJO template.
 EventRegistration addListener(Object template, RemoteEventListener listener, long lease, MarshalledObject handback, INotifyDelegatorFilter filter, NotifyActionType actionTypes)
          Deprecated. Since 9.7
 EventRegistration addListener(Object template, RemoteEventListener listener, long lease, NotifyActionType actionTypes)
          Deprecated. Since 9.7
 EventRegistration addListener(Object template, RemoteEventListener listener, NotifyActionType actionTypes)
          Registers a listener with a space using a POJO template
 EventRegistration addListener(Object template, RemoteEventListener listener, NotifyActionType actionTypes, MarshalledObject handback, INotifyDelegatorFilter filter)
          Registers a listener with a space using a POJO template
 void removeListener(EventRegistration registration)
          Unregisters the listener from the space.
 
Methods inherited from interface com.gigaspaces.events.EventSession
close, getSessionConfig, getSpace, getTransaction
 

Method Detail

addListener

EventRegistration addListener(Object template,
                              RemoteEventListener listener)
                              throws RemoteException
Registers a listener with a space using a POJO template. Equals to addListener( template, listener, Lease.FOREVER, NotifyActionType.NOTIFY_ALL)

Parameters:
template - the template to be match with.
listener - the listener
Returns:
the EventRegistration object.
Throws:
RemoteException - if the space has failed to perform the registration

addListener

EventRegistration addListener(Object template,
                              RemoteEventListener listener,
                              NotifyActionType actionTypes)
                              throws RemoteException
Registers a listener with a space using a POJO template

Parameters:
template - the template to be match with.
listener - the listener
actionTypes - the type of actions you wish to receive notification on.
Returns:
the EventRegistration object.
Throws:
RemoteException - if the space has failed to perform the registration

addListener

EventRegistration addListener(Object template,
                              RemoteEventListener listener,
                              NotifyActionType actionTypes,
                              MarshalledObject handback,
                              INotifyDelegatorFilter filter)
                              throws RemoteException
Registers a listener with a space using a POJO template

Parameters:
template - the template to be match with.
listener - the listener
actionTypes - the type of actions you wish to receive notification on.
handback - an object that will be passed back to the listener when notified.
filter - a server-side filter to filter out notifications.
Returns:
the EventRegistration object.
Throws:
RemoteException - if the space has failed to perform the registration

addListener

@Deprecated
EventRegistration addListener(Object template,
                                         RemoteEventListener listener,
                                         long lease,
                                         NotifyActionType actionTypes)
                              throws RemoteException
Deprecated. Since 9.7

Data event registration with custom lease is deprecated - use addListener(Object, net.jini.core.event.RemoteEventListener, NotifyActionType) instead.

Throws:
RemoteException

addListener

@Deprecated
EventRegistration addListener(Object template,
                                         RemoteEventListener listener,
                                         long lease,
                                         MarshalledObject handback,
                                         INotifyDelegatorFilter filter,
                                         NotifyActionType actionTypes)
                              throws RemoteException
Deprecated. Since 9.7

Data event registration with custom lease is deprecated - use addListener(Object, net.jini.core.event.RemoteEventListener, NotifyActionType, java.rmi.MarshalledObject, com.j_spaces.core.client.INotifyDelegatorFilter) instead.

Throws:
RemoteException

removeListener

void removeListener(EventRegistration registration)
                    throws RemoteException,
                           UnknownLeaseException
Unregisters the listener from the space.

Parameters:
registration - the registration object received from the server when the listener was added.
Throws:
RemoteException - if the space has failed to unregister the listener.
UnknownLeaseException - if the lease of the registration is invalid.

GigaSpaces XAP 9.7.2 API

Copyright © GigaSpaces.