com.prosyst.mprm.net.connection

Interface ConnectionManager

All Known Subinterfaces:

BackendConnectionManager

public interface ConnectionManager

Represents the access point to the common mPRM connection framework functionality. The ConnectionManager instance holds all active point-to-point network connections between this host and other backend hosts or/and Remote Access clients.

Method Summary

Modifier and Type	Method and Description
void	addConnectionOpenListener(P2PConnectionOpenListener listener) Adds a listener instance will be notified when a new point-to-point connection has been opened.
P2PConnection[]	getConnections() Returns all active connections managed by this ConnectionManager instance.
P2PConnection	openConnection(java.lang.String url) Returns the point-to-point connection between the current host and the host specified by the supplied url.
void	removeConnectionOpenListener(P2PConnectionOpenListener listener) Removes the supplied listener instance from the list of registered listeners.
void	setNetService(java.lang.String netServiceName, ServiceConnectionAcceptor acceptor) Registers a Net service with a given name and associated with this net service connection acceptor.

Method Detail

setNetService

void setNetService(java.lang.String netServiceName,
                   ServiceConnectionAcceptor acceptor)

Registers a Net service with a given name and associated with this net service connection acceptor.

Parameters:

netServiceName - the identifier of the Net service

acceptor - Net service specific instance which will handle connection request in the scope of this Net service.

openConnection

P2PConnection openConnection(java.lang.String url)
                      throws java.io.IOException

Returns the point-to-point connection between the current host and the host specified by the supplied url. If such connection already exists this method returns it. Otherwise it attempts to open it.

Parameters:

url - the URL of the remote host.

Returns:

the P2PConnection instance representing the point-to-point connection with the supplied host.

Throws:

java.io.IOException - if the connection does not exist and cannot be established.

getConnections

P2PConnection[] getConnections()

Returns all active connections managed by this ConnectionManager instance.

Returns:

array of P2PConnection objects.

addConnectionOpenListener

void addConnectionOpenListener(P2PConnectionOpenListener listener)

Adds a listener instance will be notified when a new point-to-point connection has been opened. The connection could be open either by invoking openConnection(String url) or if a remote host has been initiated the connection to this host. The listener will be notified in both cases.

Parameters:

listener - the listener instance

removeConnectionOpenListener

void removeConnectionOpenListener(P2PConnectionOpenListener listener)

Removes the supplied listener instance from the list of registered listeners. If there is no such listener, this method does nothing.

Parameters:

listener - the listener instance being removed.