info.pppc.base.system.plugin

Interface ISemantic

All Superinterfaces:

IDispatcher, IExtension, IPlugin

All Known Implementing Classes:

ExchangeSemantic, RmiSemantic, ServerHandshakeSemantic, StreamSemantic

public interface ISemantic
extends IPlugin, IDispatcher

This is the interface that must be implemented by semantic plug-ins. Semantic plug-ins implement communication abstractions such as RPCs, streams or event-based communication. As such, they are responsible for distributing and processing invocations to the right set of systems. To do this, they may request communication stacks.

Author:

Marcus Handte

Field Summary

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

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

Method Summary

Methods

Modifier and Type	Method and Description
void	performOutgoing(Invocation invocation, ISession session) Tells the semantic plug-in to perform the specified invocation under the specified session context.
boolean	prepareSession(PluginDescription d, NFCollection c, ISession s) Prepares a session to communicate with the specified target under the specified requirements.
void	setSemanticManager(ISemanticManager manager) Sets the plug-in manager of this plug-in.

Methods inherited from interface info.pppc.base.system.plugin.IPlugin

getPluginDescription, start, stop

Methods inherited from interface info.pppc.base.system.plugin.IDispatcher

deliverIncoming

Method Detail

prepareSession

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

Prepares a session to communicate with the specified target under the specified requirements.

Parameters:

s - The session that can be used to negotiate session specific data and to store local information used to initiate the communication.

c - The non-functional requirements.

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

Returns:

False if the specified context cannot be fulfilled.

setSemanticManager

void setSemanticManager(ISemanticManager manager)

Sets the plug-in manager of this plug-in. The plug-in manager enables a plug-in to perform operations. The semantic plug-in manager provides a synchronized table that provides wait methods and check calls. This method is guaranteed to be called before the start method is invoked the first time.

Parameters:

manager - The manager of the plug-in.

performOutgoing

void performOutgoing(Invocation invocation,
                   ISession session)

Tells the semantic plug-in to perform the specified invocation under the specified session context.

Parameters:

invocation - The invocation to perform.

session - The session that can be used to request further sessions.