info.pppc.base.system.plugin

Interface ISemanticManager

All Superinterfaces:

IOperator, IPluginManager

All Known Subinterfaces:

IRoutingManager

All Known Implementing Classes:

PluginManager

public interface ISemanticManager
extends IPluginManager

The semantic manager is the interface that enables semantic plug-ins to access the internals of the invocation broker. Furthermore, it enables them to request the negotiation and creation of new connections to remote systems.

Author:

Marcus Handte

Method Summary

Methods

Modifier and Type	Method and Description
ISession	createSession(SystemID target, short ability) Creates a session to communicate with the specified target.
void	dispatchSynchronous(Invocation invocation, ISession session) Delivers the specified invocation originating from the specified session.
IStreamConnector	openSession(ISession session) Opens connector with the specified session properties.
ISession	prepareSession(ISession session, NFCollection requirements) Requests a new session that can be used to create a connection to the specified device with the specified non-functional properties.

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

getDeviceDescription, getDevices, getPluginDescriptions

Methods inherited from interface info.pppc.base.system.operation.IOperator

performOperation, performOperation

Method Detail

prepareSession

ISession prepareSession(ISession session,
                      NFCollection requirements)

Requests a new session that can be used to create a connection to the specified device with the specified non-functional properties.

Parameters:

session - The original session that has been prepared in the prepare method of the semantic plug-in.

requirements - The requirements towards the connection.

Returns:

A session that fulfills all requirements.

openSession

IStreamConnector openSession(ISession session)
                             throws java.io.IOException

Opens connector with the specified session properties.

Parameters:

session - The session that specifies the connector's properties.

Returns:

The connector with the specified session properties.

Throws:

java.io.IOException - Thrown if the connector cannot be created.

dispatchSynchronous

void dispatchSynchronous(Invocation invocation,
                       ISession session)

Delivers the specified invocation originating from the specified session.

Parameters:

invocation - The invocation to deliver.

session - The session of the invocation.

createSession

ISession createSession(SystemID target,
                     short ability)

Creates a session to communicate with the specified target.

Parameters:

target - The target of the call.

ability - The ability of the calling plug-in.

Returns:

The session object.