info.pppc.base.system.plugin

Interface IModifier

All Superinterfaces:

IExtension, IPlugin

All Known Implementing Classes:

ObjectSerializer, SecureModifier

public interface IModifier
extends IPlugin

A modifier is a plug-in that changes the stream type provided by another plug-in. The modifier interface must be implemented by several different types of plug-ins. These include serialization, compression and encryption plug-ins.

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
IStreamConnector	openSession(IStreamConnector child, ISession context) Connects a streaming connector to the specified connector.
boolean	prepareSession(PluginDescription description, NFCollection collection, ISession session) Prepares a session to communicate with the specified target under the specified requirements.
void	setPluginManager(IPluginManager manager) Sets the plug-in manager of this plug-in.

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

getPluginDescription, start, stop

Method Detail

setPluginManager

void setPluginManager(IPluginManager manager)

Sets the plug-in manager of this plug-in. The plug-in manager enables a plug-in to request a communication stack and to perform operations. This method is guaranteed to be called before the start method is invoked the first time.

Parameters:

manager - The manager of the plug-in.

openSession

IStreamConnector openSession(IStreamConnector child,
                           ISession context)
                             throws java.io.IOException

Connects a streaming connector to the specified connector.

Parameters:

child - The child connector that the new connector must connect to.

context - The communication context that provides session data created by the remote plug-in.

Returns:

The connector that is connected to the specified child.

Throws:

java.io.IOException - Thrown if the connector could not be created.

prepareSession

boolean prepareSession(PluginDescription description,
                     NFCollection collection,
                     ISession session)

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

Parameters:

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

collection - The non-functional requirements.

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

Returns:

False if the specified context cannot be fulfilled.