com.prosyst.mprm.net.connection.backend

Interface BackendConnectionManager

All Superinterfaces:

ConnectionManager

public interface BackendConnectionManager
extends ConnectionManager

Available as a service on the mPRM backend host frameworks. This interface provides an additional methods above the ConnectionManager suitable for the server side of the Connection Framework.

Method Summary

Modifier and Type	Method and Description
void	close() Closes all connections and listening bindings of the connection manager.
P2PConnection	getConnectionToHost(java.lang.String hostId) Returns the point-to-point connection to a particular mPRM backend host.
P2PConnection	getConnectionToHostRole(java.lang.String hostRole) Returns a point-to-point connection to a mPRM backend host with specified mPRM Role - CC, RAS, specific Management Server.
P2PConnection	getConnectionToMS(java.lang.String managedContext) Returns a point-to-point connection to a mPRM backend host which participates in a Management Server responsible for managing the supplied context.
void	listen(java.lang.String serverURL) Bounds the the Connection Framework to the supplied local URL where it will listen for incoming network requests.
void	listen(java.lang.String[] serverURLs) Similar to the listen(String serverURL), but binds the the Connection Framework to more than one local ports (tipically often different network protocols).

Methods inherited from interface com.prosyst.mprm.net.connection.ConnectionManager

addConnectionOpenListener, getConnections, openConnection, removeConnectionOpenListener, setNetService

Method Detail

listen

void listen(java.lang.String serverURL)
     throws java.io.IOException

Bounds the the Connection Framework to the supplied local URL where it will listen for incoming network requests.

Parameters:

serverURL - the server side url. For example socket://:11449.

Throws:

java.io.IOException - if the local port specified by the url could not be opened or the network protocol transport specified in the scheme of the URL is not available.

listen

void listen(java.lang.String[] serverURLs)
     throws java.io.IOException

Similar to the listen(String serverURL), but binds the the Connection Framework to more than one local ports (tipically often different network protocols).

Parameters:

serverURLs - an array of the server side urls.

Throws:

java.io.IOException - if the local port specified by the url could not be opened or the network protocol transport specified in the scheme of the URL is not available.

close

void close()

Closes all connections and listening bindings of the connection manager.

getConnectionToHost

P2PConnection getConnectionToHost(java.lang.String hostId)
                           throws java.io.IOException

Returns the point-to-point connection to a particular mPRM backend host.

Parameters:

hostId - the mPRM Backend Host identifier.

Returns:

P2PConnection to the supplied host

Throws:

java.io.IOException

getConnectionToHostRole

P2PConnection getConnectionToHostRole(java.lang.String hostRole)
                               throws java.io.IOException

Returns a point-to-point connection to a mPRM backend host with specified mPRM Role - CC, RAS, specific Management Server.

Parameters:

hostRole - the role identifier.

Returns:

P2PConnection to a host with a supplied role.

Throws:

java.io.IOException

getConnectionToMS

P2PConnection getConnectionToMS(java.lang.String managedContext)
                         throws java.io.IOException

Returns a point-to-point connection to a mPRM backend host which participates in a Management Server responsible for managing the supplied context.

Parameters:

managedContext - the path of the group from the gateways group hierarchy.

Returns:

P2PConnection to a host responsible for managing the supplied context.

Throws:

java.io.IOException