com.gigaspaces.internal.lrmi.stubs

Class LRMIRemoteEventListener

java.lang.Object

com.gigaspaces.lrmi.RemoteStub<RemoteEventListener>

com.gigaspaces.internal.lrmi.stubs.LRMIRemoteEventListener

All Implemented Interfaces:

ManagedRemoteEventListener, ILRMIProxy, Externalizable, Serializable, Remote, EventListener, RemoteEventListener

Direct Known Subclasses:

LRMINotifyDelegatorListener

public class LRMIRemoteEventListener
extends RemoteStub<RemoteEventListener>
implements ManagedRemoteEventListener

Super class of all Notify stubs. This the dynamic stub creates on the fly when user's registers notify template. No needs to extend from java.rmi.server.UnicastRemoteObject working with LRMI layer(NIO).

NOTE: OneWayRemoteCallAnnotation defines default Annotation condition of one-way method call. By default RemoteEventListener.notify() method is one-way call.

To define one-way method

Since:

5.0

Author:

Igor Goldenberg

See Also:

OneWayRemoteCall, Serialized Form

Constructor Summary

Constructors

Constructor and Description
LRMIRemoteEventListener()
LRMIRemoteEventListener(RemoteEventListener directRefProxy, RemoteEventListener dynamicProxy) constructor to initialize notify remote event listener

Method Summary

Modifier and Type	Method and Description
void	init(GSEventRegistration registration) Recursive initialization of managed listener.
void	notify(RemoteEvent event) Notify the listener about an event.
void	shutdown(GSEventRegistration registration) lifecycle recursive callback for the managed listener.

Methods inherited from class com.gigaspaces.lrmi.RemoteStub

closeProxy, disable, enable, equals, getConnectionUrl, getDynamicProxy, getGeneratedTraffic, getProxy, getReceivedTraffic, getRemoteHostAddress, getRemoteHostName, getRemoteNetworkAddress, getRemoteProcessId, getServicePlatformLogicalVersion, getStubId, hashCode, init, isClosed, isCollocated, isCollocatedStub, isDirect, isRemote, isStub, overrideMethodsMetadata, readExternal, toString, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

LRMIRemoteEventListener

public LRMIRemoteEventListener()

LRMIRemoteEventListener

public LRMIRemoteEventListener(RemoteEventListener directRefProxy,
                               RemoteEventListener dynamicProxy)

constructor to initialize notify remote event listener

Method Detail

shutdown

public void shutdown(GSEventRegistration registration)

Description copied from interface: ManagedRemoteEventListener

lifecycle recursive callback for the managed listener.

Specified by:

shutdown in interface ManagedRemoteEventListener

notify

public void notify(RemoteEvent event)
            throws RemoteException,
                   UnknownEventException

Description copied from interface: RemoteEventListener

Notify the listener about an event.

The call to notify is synchronous to allow the party making the call to know if the call succeeded. However, it is not part of the semantics of the call that the notification return can be delayed while the recipient of the call reacts to the occurrence of the event. Simply put, the best strategy on the part of the recipient is to note the occurrence in some way and then return from the notify method as quickly as possible.

UnknownEventException is thrown when the recipient does not recognize the combination of the event identifier and the event source as something in which it is interested. Throwing this exception has the effect of asking the sender to not send further notifications of this kind of event from this source in the future.

Specified by:

notify in interface RemoteEventListener

Parameters:

event - the remote event that occurred

Throws:

UnknownEventException - the recipient does not recognize the combination of event identifier and event source

RemoteException

init

public void init(GSEventRegistration registration)

Description copied from interface: ManagedRemoteEventListener

Recursive initialization of managed listener.

Specified by:

init in interface ManagedRemoteEventListener