info.pppc.base.plugin.common

Class RmiSemantic

java.lang.Object

info.pppc.base.plugin.common.RmiSemantic

All Implemented Interfaces:

IExtension, IDispatcher, IPlugin, ISemantic

public class RmiSemantic
extends java.lang.Object
implements ISemantic

The rmi semantic plug-in is the new default plug-in for asynchronous and synchronous method calls. It tries to reuse streams whenever possible within a single invocation. Thus, this plug-in is much more efficient and less fragile with respect to timings than the previously used simplex semantic. However, it is less flexible when it comes to reselections of protocol stacks.

Author:

Marcus Handte

Field Summary

Fields

Modifier and Type	Field and Description
static short	PLUGIN_ABILITY The ability of the plug-in. [5][3].

Fields inherited from interface info.pppc.base.system.IExtension

EXTENSION_COMPRESSION, EXTENSION_DISCOVERY, EXTENSION_ENCRYPTION, EXTENSION_ROUTING, EXTENSION_SEMANTIC, EXTENSION_SERIALIZATION, EXTENSION_TRANSCEIVER

Constructor Summary

Constructors

Constructor and Description
RmiSemantic() Creates a new semantic plug-in that provides a reliable remote method invocation semantic.

Method Summary

Methods

Modifier and Type	Method and Description
void	deliverIncoming(IStreamConnector connector, ISession session) Delivers an incoming invocation and executes it if necessary.
PluginDescription	getPluginDescription() Returns the plug-in description of this plug-in.
void	performOutgoing(Invocation invocation, ISession session) Delivers an outgoing invocation and modifies the original invocation to contain the results of the remote invocation after this method returns.
boolean	prepareSession(PluginDescription d, NFCollection c, ISession s) Tests whether the specified requirements can be fulfilled by the plug-in and prepares a session for the specified requirements.
void	setSemanticManager(ISemanticManager manager) Sets the plug-in manager that is used to retrieve remote plug-in descriptions.
void	start() Called to start the plug-in.
void	stop() Called to stop the plug-in.
java.lang.String	toString() Returns a string representation of the plug-ins internal structure.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

PLUGIN_ABILITY

public static final short PLUGIN_ABILITY

The ability of the plug-in. [5][3].

See Also:

Constant Field Values

Constructor Detail

RmiSemantic

public RmiSemantic()

Creates a new semantic plug-in that provides a reliable remote method invocation semantic.

Method Detail

setSemanticManager

public void setSemanticManager(ISemanticManager manager)

Sets the plug-in manager that is used to retrieve remote plug-in descriptions.

Specified by:

setSemanticManager in interface ISemantic

Parameters:

manager - The semantic plug-in manager.

getPluginDescription

public PluginDescription getPluginDescription()

Returns the plug-in description of this plug-in. There will be only one instance of the plug-in description per instance of this plug-in.

Specified by:

getPluginDescription in interface IPlugin

Returns:

The plug-in description of this plug-in.

start

public void start()

Called to start the plug-in. This method initializes the plug-in and enables the creation of connectors. All open calls will fail before this method has been called.

Specified by:

start in interface IPlugin

stop

public void stop()

Called to stop the plug-in. After this method has been called, all open calls will fail.

Specified by:

stop in interface IPlugin

prepareSession

public boolean prepareSession(PluginDescription d,
                     NFCollection c,
                     ISession s)

Tests whether the specified requirements can be fulfilled by the plug-in and prepares a session for the specified requirements.

Specified by:

prepareSession in interface ISemantic

Parameters:

d - The plug-in description of the remote semantic plug-in.

c - The requirements of the session.

s - The session to adjust.

Returns:

True if the session has been prepared, false if this is not possible.

performOutgoing

public void performOutgoing(Invocation invocation,
                   ISession session)

Delivers an outgoing invocation and modifies the original invocation to contain the results of the remote invocation after this method returns.

Specified by:

performOutgoing in interface ISemantic

Parameters:

invocation - The invocation that should be delivered.

session - The session data that can be used to request a new connection.

deliverIncoming

public void deliverIncoming(IStreamConnector connector,
                   ISession session)

Delivers an incoming invocation and executes it if necessary.

Specified by:

deliverIncoming in interface IDispatcher

Parameters:

connector - The connector used to retrieve the invocation.

session - The session data of the connector.

toString

public java.lang.String toString()

Returns a string representation of the plug-ins internal structure. The string representation contains the currently running remote invocations.

Overrides:

toString in class java.lang.Object

Returns:

A string representation of the plug-ins internal data structures.