com.prosyst.mprm.net.connection

Interface MultiplexedConnection

All Superinterfaces:

Connection, org.mbs.services.io.ConnectionNotifier, InputConnection, OutputConnection, StreamConnection

public interface MultiplexedConnection
extends StreamConnection, org.mbs.services.io.ConnectionNotifier

Represent a lightweight full-duplex stream based connection between to mPRM hosts, which exists over an active point-to-point connection. Every multiplexed connection is opened in the scope of a Net service. The net service determines the remote module which is resposible for process the request for opeing of this connection. Net service name plays the similar role as the port number plays in the TCP protocol. Many multiplexed connections could be active simultaneously over a single point-to-point connection and to a single Net service.

Method Summary

Modifier and Type	Method and Description
int	getConnectionId() Returns the unique identifier of this connection in the scope of the P2PConnection and the NetService.
NetService	getNetService() Returns the underlying Net service.
P2PConnection	getPoint2PointConnection() Returns the underlying point-to-point connection.
boolean	isOriginator() Returns true if this multiplexed connection was initiated by the local host or false if it is accepted from the remote host.
void	setDataListener(DataReceiveListener listener) Sets the listener which will be notified when some data becomes available for reading on this connection.

Methods inherited from interface javax.microedition.io.InputConnection

openDataInputStream, openInputStream

Methods inherited from interface javax.microedition.io.OutputConnection

openDataOutputStream, openOutputStream

Methods inherited from interface javax.microedition.io.Connection

close

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

addConnectionListener, removeConnectionListener

Method Detail

getConnectionId

int getConnectionId()

Returns the unique identifier of this connection in the scope of the P2PConnection and the NetService.

Returns:

the identifier number.

isOriginator

boolean isOriginator()

Returns true if this multiplexed connection was initiated by the local host or false if it is accepted from the remote host. Note, that this could be different than the getPoint2PointConnection().isOriginator().

Returns:

if the localhost is the originator of the connection.

getPoint2PointConnection

P2PConnection getPoint2PointConnection()

Returns the underlying point-to-point connection.

Returns:

the P2PConnection object.

getNetService

NetService getNetService()

Returns the underlying Net service.

Returns:

the NetService object.

setDataListener

void setDataListener(DataReceiveListener listener)

Sets the listener which will be notified when some data becomes available for reading on this connection. Setting DataReceiveListener allows asynchronous reading from the connection.

Parameters:

listener - the listener instance.