com.prosyst.mprm.net.connection

Interface NetService

All Superinterfaces:

Connection, org.mbs.services.io.ConnectionNotifier

public interface NetService
extends Connection, org.mbs.services.io.ConnectionNotifier

Represents a Net service supported by the remote host of a point-to-point connection. A net service is an abstraction for a higher level communication service which runs over the connection framework. An example of net services are mPower RPC service and mPower Event service.
Many net services can be used simultaneously over a single point-to-point connection. For example implementations of System RPC, mPRM RPC and Event Service shares the same point-to-point connections using different net services. The Net service is uniquely identifed in the scope of a p-2-p connection by its name.

Method Summary

Modifier and Type	Method and Description
MultiplexedConnection	getConnection(int id) Returns existing multiplexed connection with the supplied Id or null if there is no active connection with such id.
MultiplexedConnection[]	getConnections() Returns all currently opened multiplexed connections with the remote host in the scope of this Net service.
P2PConnection	getPoint2PointConnection() Returns the underlying point-to-point connection which this Net service runs on.
java.lang.String	getServiceName() Returns the name of the Net service.
MultiplexedConnection	openConnection() Opens and returns a multiplexed connection to the Net service represented by this NetService instance.

Methods inherited from interface javax.microedition.io.Connection

close

Methods inherited from interface org.mbs.services.io.ConnectionNotifier

addConnectionListener, removeConnectionListener

Method Detail

getServiceName

java.lang.String getServiceName()

Returns the name of the Net service.

Returns:

the name of the net service

getPoint2PointConnection

P2PConnection getPoint2PointConnection()

Returns the underlying point-to-point connection which this Net service runs on.

Returns:

the P2PConnection object representing the point-2-point of this Net service.

openConnection

MultiplexedConnection openConnection()
                              throws java.io.IOException

Opens and returns a multiplexed connection to the Net service represented by this NetService instance.

Returns:

newly opened multiplexed connection for exchanging data with the remote Net service.

Throws:

java.io.IOException - if the connection could not be opened for some reason.

getConnection

MultiplexedConnection getConnection(int id)
                             throws java.io.IOException

Returns existing multiplexed connection with the supplied Id or null if there is no active connection with such id.

Parameters:

id - the identifier of the multiplexed connection

Returns:

MutliplexedConnection with the supplied id.

Throws:

java.io.IOException - if error occured while returning the connection.

getConnections

MultiplexedConnection[] getConnections()
                                throws java.io.IOException

Returns all currently opened multiplexed connections with the remote host in the scope of this Net service.

Returns:

an array of multiplexed connections.

Throws:

java.io.IOException - if error occured while returning the connections.