com.gigaspaces.events

Class AbstractDataEventSession

java.lang.Object

com.gigaspaces.events.AbstractDataEventSession

All Implemented Interfaces:

DataEventSession, EventSession

Direct Known Subclasses:

DefaultDataEventSession, DurableUnicastDelegatorSession

public abstract class AbstractDataEventSession
extends Object
implements DataEventSession

the super class of all DataEventSession implementations.
it supplies an automatic renew service for the listeners.

Since:

6.0

Version:

1.0

Author:

asy ronen

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDataEventSession(IJSpace space, EventSessionConfig config)

Method Summary

Modifier and Type	Method and Description
EventRegistration	addListener(Object template, long lease, NotifyInfo notifyInfo)
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 notifyType) Data event registration with custom lease is deprecated - use DataEventSession.addListener(Object, net.jini.core.event.RemoteEventListener, NotifyActionType, java.rmi.MarshalledObject, com.j_spaces.core.client.INotifyDelegatorFilter) instead.
EventRegistration	addListener(Object template, RemoteEventListener listener, long lease, NotifyActionType actionTypes) Data event registration with custom lease is deprecated - use DataEventSession.addListener(Object, net.jini.core.event.RemoteEventListener, NotifyActionType) instead.
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 notifyType, MarshalledObject handback, INotifyDelegatorFilter filter) Registers a listener with a space using a POJO template
protected abstract EventRegistration	addListenerInternal(Object template, long lease, NotifyInfo notifyInfo)
void	close() closes the session and deregister all listeners.
NotifyInfo	createNotifyInfo(RemoteEventListener listener, NotifyActionType notifyType)
protected IDirectSpaceProxy	getNotificationsSpace()
EventSessionConfig	getSessionConfig() Retrieves the bounded configuration object.
IJSpace	getSpace()
void	removeListener(EventRegistration registration) Unregisters the listener from the space.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDataEventSession

protected AbstractDataEventSession(IJSpace space,
                                   EventSessionConfig config)

Method Detail

getSpace

public IJSpace getSpace()

Specified by:

getSpace in interface EventSession

Returns:

the space that the session is attached to.

getNotificationsSpace

protected IDirectSpaceProxy getNotificationsSpace()

getSessionConfig

public EventSessionConfig getSessionConfig()

Description copied from interface: EventSession

Retrieves the bounded configuration object.

Specified by:

getSessionConfig in interface EventSession

Returns:

the EventSessionConfig object.

close

public void close()
           throws RemoteException

Description copied from interface: EventSession

closes the session and deregister all listeners.

Specified by:

close in interface EventSession

Throws:

RemoteException - if the remove space failed to remove the notification registration.

addListener

public EventRegistration addListener(Object template,
                                     RemoteEventListener listener)
                              throws RemoteException

Description copied from interface: DataEventSession

Registers a listener with a space using a POJO template. Equals to addListener( template, listener, Lease.FOREVER, NotifyActionType.NOTIFY_ALL)

Specified by:

addListener in interface DataEventSession

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

public EventRegistration addListener(Object template,
                                     RemoteEventListener listener,
                                     NotifyActionType actionTypes)
                              throws RemoteException

Description copied from interface: DataEventSession

Registers a listener with a space using a POJO template

Specified by:

addListener in interface DataEventSession

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

public EventRegistration addListener(Object template,
                                     RemoteEventListener listener,
                                     long lease,
                                     NotifyActionType actionTypes)
                              throws RemoteException

Description copied from interface: DataEventSession

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

Specified by:

addListener in interface DataEventSession

Throws:

RemoteException

addListener

public EventRegistration addListener(Object template,
                                     RemoteEventListener listener,
                                     NotifyActionType notifyType,
                                     MarshalledObject handback,
                                     INotifyDelegatorFilter filter)
                              throws RemoteException

Description copied from interface: DataEventSession

Registers a listener with a space using a POJO template

Specified by:

addListener in interface DataEventSession

Parameters:

template - the template to be match with.

listener - the listener

notifyType - 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

public EventRegistration addListener(Object template,
                                     RemoteEventListener listener,
                                     long lease,
                                     MarshalledObject handback,
                                     INotifyDelegatorFilter filter,
                                     NotifyActionType notifyType)
                              throws RemoteException

Description copied from interface: DataEventSession

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

Specified by:

addListener in interface DataEventSession

Throws:

RemoteException

addListener

public EventRegistration addListener(Object template,
                                     long lease,
                                     NotifyInfo notifyInfo)
                              throws RemoteException

Throws:

RemoteException

addListenerInternal

protected abstract EventRegistration addListenerInternal(Object template,
                                                         long lease,
                                                         NotifyInfo notifyInfo)
                                                  throws RemoteException

Throws:

RemoteException

createNotifyInfo

public NotifyInfo createNotifyInfo(RemoteEventListener listener,
                                   NotifyActionType notifyType)

removeListener

public void removeListener(EventRegistration registration)
                    throws RemoteException

Description copied from interface: DataEventSession

Unregisters the listener from the space.

Specified by:

removeListener in interface DataEventSession

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.