org.objectweb.jonathan.protocols.ip.api
Interface TcpIpConnectionMgr

All Known Implementing Classes:

IPv4ConnectionFactory, JConnectionMgr

public interface TcpIpConnectionMgr

This interface defines a type for Tcp/Ip connection managers.

Method Summary

String	getCanonicalHostName(String hostname) Returns the canonical host name of the provided host.
IpConnection	newCltConnection(String host, int port, IpSession session) Returns a new client connection.
TcpIpSrvConnectionFactory	newSrvConnectionFactory(int port) Returns a new server connection factory encapsulating a server socket on the provided port.

Method Detail

newCltConnection

public IpConnection newCltConnection(String host,
                                     int port,
                                     IpSession session)
                              throws org.objectweb.jonathan.apis.kernel.JonathanException

Returns a new client connection.

This method is called by a protocol. The protocol provides a session (i.e. an object representing an abstract communication channel) and expects a connection (i.e. a communication resource). The returned connection must have been built using the provided session, or be a connection associated with a session having the same destination as the provided session.

Parameters:

host - the host name of the distant server;

port - the port number of a server socket on that host;

session - a TcpIp session

Returns:

a connection for that session.

Throws:

org.objectweb.jonathan.apis.kernel.JonathanException - if an error occurs.

newSrvConnectionFactory

public TcpIpSrvConnectionFactory newSrvConnectionFactory(int port)
                                                  throws org.objectweb.jonathan.apis.kernel.JonathanException

Returns a new server connection factory encapsulating a server socket on the provided port. If port = 0, an anonymous server socket is opened.

Parameters:

port - the expected port of the server socket;

Returns:

a server connection factory.

Throws:

org.objectweb.jonathan.apis.kernel.JonathanException - if an error occurs.

getCanonicalHostName

public String getCanonicalHostName(String hostname)

Returns the canonical host name of the provided host. The purpose of this method is to help checking the equality of two host names. Two names corresponding to the same host should have the same (the "sameness" being defined by the equals method on type String) canonical names.

Parameters:

hostname - a host name

Returns:

the corresponding canonical host name.