Interface SocketFactory

src/sunlabs/brazil/util/SocketFactory.java:111–145

This interface is used as a heap to control the allocation of sockets. An instance of this interface can be passed to methods that allocate sockets. In this way, the actual, underlying type of socket allocated can be replaced (for instance, with an SSL socket or an firewall-tunnelling socket),

 * @version		2.2
 */
public interface SocketFactory
{
    /**
     * The default socket factory.  It just creates a standard
     * <code>Socket</code> to the specified host and port, and is exactly
     * equivalent to calling <code>new Socket(host, port)</code>.
     */
    public final SocketFactory defaultFactory = new DefaultSocketFactory();

    /**
     * Creates a new <code>Socket</code> that talks to the specified port
     * on the named host.
     * <p>
     * The implementation may choose any way it wants to provide a
     * socket-like object (essentially any mechanism that supports
     * bidirectional communication).  The returned <code>Socket</code> (or
     * subclass of <code>Socket</code>) might not be based on TCP/IP, or it
     * might involve running a TCP/IP stack over some other protocol, or it
     * might actually redirect all connections via some other proxy machine,
     * etc.
     *
     * @param	host
     *		The host name.
     *
     * @param	port
     *		The port number.
     *
     * @return	An object that provides socket-like communication.
     *
     * @throws	IOException
     *		If there is some problem establishing the socket to the
     *		specified port on the named host.
     */
    public Socket newSocket(String host, int port) throws IOException;
}

class DefaultSocketFactory
    implements SocketFactory