info.pppc.base.plugin.common

Class StreamSemantic

java.lang.Object

info.pppc.base.plugin.common.StreamSemantic

All Implemented Interfaces:

IExtension, IDispatcher, IPlugin, ISemantic

public class StreamSemantic
extends java.lang.Object
implements ISemantic

The stream semantic is a pass-through semantic for stream connectors. It enables applications to access stream connectors directly through the proxies and skeletons. This can be used to pass-by the overhead of base and can be used to limit the amount of buffering, however, if you connectors directly within the application, you will have to handle disconnections within the application.

Author:

Marcus Handte

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	StreamSemantic.StreamConnector Implements a stream connector for internal use during forwarding on the same device.

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

Constructor Summary

Constructors

Constructor and Description
StreamSemantic() Creates a new stream semantic plug-in.

Method Summary

Methods

Modifier and Type	Method and Description
void	deliverIncoming(IStreamConnector connector, ISession session) Called when a remote device wants to initialize a stream.
PluginDescription	getPluginDescription() Returns the description of the plug-in.
void	performOutgoing(Invocation invocation, ISession session) Called when a stream to a remote device should be initialized.
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) Called before the plug-in is started to set the semantic plug-in manager.
void	start() Called to start the plug-in.
void	stop() Called to stop the plug-in.

Methods inherited from class java.lang.Object

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

Constructor Detail

StreamSemantic

public StreamSemantic()

Creates a new stream semantic plug-in.

Method Detail

deliverIncoming

public void deliverIncoming(IStreamConnector connector,
                   ISession session)

Called when a remote device wants to initialize a stream.

Specified by:

deliverIncoming in interface IDispatcher

Parameters:

connector - The stream connector of the remote device.

session - The session of the with remote device.

performOutgoing

public void performOutgoing(Invocation invocation,
                   ISession session)

Called when a stream to a remote device should be initialized.

Specified by:

performOutgoing in interface ISemantic

Parameters:

invocation - The invocation.

session - The session with the remote device.

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.

setSemanticManager

public void setSemanticManager(ISemanticManager manager)

Called before the plug-in is started to set the semantic plug-in manager.

Specified by:

setSemanticManager in interface ISemantic

Parameters:

manager - The semantic plug-in manager.

getPluginDescription

public PluginDescription getPluginDescription()

Returns the description of the plug-in.

Specified by:

getPluginDescription in interface IPlugin

Returns:

The description of the plug-in.

start

public void start()

Called to start the plug-in.

Specified by:

start in interface IPlugin

stop

public void stop()

Called to stop the plug-in.

Specified by:

stop in interface IPlugin