info.pppc.base.plugin.common

Class ObjectSerializer

java.lang.Object

info.pppc.base.plugin.common.ObjectSerializer

All Implemented Interfaces:

IExtension, IModifier, IPlugin

public class ObjectSerializer
extends java.lang.Object
implements IModifier

The object serializer is a modifier that provides object input and output streams that support the object output and input interface of base. As such the streams provided by this modifier can be used to marshall and unmarshall invocations. The implementation of this plug-in is intended for all J2ME configurations starting from CLDC.

Author:

Marcus Handte

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ObjectSerializer.StreamConnector The stream connector provides object input and output streams depending on the implementation of the underlying stream connector.

Field Summary

Fields

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

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
ObjectSerializer() Creates a new simple serializer.

Method Summary

Methods

Modifier and Type	Method and Description
PluginDescription	getPluginDescription() Returns the plug-in description of this plug-in.
IStreamConnector	openSession(IStreamConnector connector, ISession session) Determines whether the serializer is in a valid state.
boolean	prepareSession(PluginDescription description, NFCollection collection, ISession session) Negotiates the session properties of a connection with a remote target.
void	setPluginManager(IPluginManager 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.

Methods inherited from class java.lang.Object

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

Field Detail

PLUGIN_ABILITY

public static final short PLUGIN_ABILITY

The ability of the plug-in. [4][0].

See Also:

Constant Field Values

Constructor Detail

ObjectSerializer

public ObjectSerializer()

Creates a new simple serializer.

Method Detail

prepareSession

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

Negotiates the session properties of a connection with a remote target. Since this plug-in has only one mode of operation, negotiation is not necessary.

Specified by:

prepareSession in interface IModifier

Parameters:

collection - The non-functional parameters.

session - The session data used to create a connector.

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

Returns:

Always true, since this plug-in does not deal with nonfunctional parameters.

openSession

public IStreamConnector openSession(IStreamConnector connector,
                           ISession session)

Determines whether the serializer is in a valid state. If the serializer has been started and initialized properly, the result of a call to this method will be a new stream connector that supports object input and output streams.

Specified by:

openSession in interface IModifier

Parameters:

connector - The connector used to create the serializer connector.

session - The session data used to communicate with a remote serializer.

Returns:

A stream connector that is connected to the specified stream connector. The resulting stream connector will provide object input and output streams that support the base object input and output interface.

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

setPluginManager

public void setPluginManager(IPluginManager manager)

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

Specified by:

setPluginManager in interface IModifier

Parameters:

manager - The 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.