## org.apache.catalina.net
Interface ServerSocketFactory

All Known Implementing Classes:
  CoyoteServerSocketFactory, CoyoteServerSocketFactory, DefaultServerSocketFactory

public interface ServerSocketFactory

Interface that describes the common characteristics of factory classes that create server sockets which may be required by a Connector. A concrete implementation of this interface will be assigned to a Connector via the `setFactory()` method.

Author:
  db@eng.sun.com, Harish Prabandham, Craig R. McClanahan

Method Summary
`java.net.ServerSocket` `createSocket(int port)` Returns a server socket which uses all network interfaces on the host, and is bound to a the specified port.
`java.net.ServerSocket` `createSocket(int port, int backlog)` Returns a server socket which uses all network interfaces on the host, is bound to a the specified port, and uses the specified connection backlog.
`java.net.ServerSocket` `createSocket(int port, int backlog, java.net.InetAddress ifAddress)` Returns a server socket which uses only the specified network interface on the local host, is bound to a the specified port, and uses the specified connection backlog.

Method Detail

### createSocket

    public java.net.ServerSocket createSocket(int port)
                                       throws java.io.IOException,
                                              java.security.KeyStoreException,
                                              java.security.NoSuchAlgorithmException,
                                              java.security.cert.CertificateException,
                                              java.security.UnrecoverableKeyException,
                                              java.security.KeyManagementException

  Returns a server socket which uses all network interfaces on the host, and is bound to a the specified port. The socket is configured with the socket options (such as accept timeout) given to this factory.

  Parameters:
    `port` - the port to listen to
  Throws:
    `java.io.IOException` - input/output or network error
    `java.security.KeyStoreException` - error instantiating the KeyStore from file (SSL only)
    `java.security.NoSuchAlgorithmException` - KeyStore algorithm unsupported by current provider (SSL only)
    `java.security.cert.CertificateException` - general certificate error (SSL only)
    `java.security.UnrecoverableKeyException` - internal KeyStore problem with the certificate (SSL only)
    `java.security.KeyManagementException` - problem in the key management layer (SSL only)

### createSocket

    public java.net.ServerSocket createSocket(int port,
                                              int backlog)
                                       throws java.io.IOException,
                                              java.security.KeyStoreException,
                                              java.security.NoSuchAlgorithmException,
                                              java.security.cert.CertificateException,
                                              java.security.UnrecoverableKeyException,
                                              java.security.KeyManagementException

  Returns a server socket which uses all network interfaces on the host, is bound to a the specified port, and uses the specified connection backlog. The socket is configured with the socket options (such as accept timeout) given to this factory.

  Parameters:
    `port` - the port to listen to
    `backlog` - how many connections are queued
  Throws:
    `java.io.IOException` - input/output or network error
    `java.security.KeyStoreException` - error instantiating the KeyStore from file (SSL only)
    `java.security.NoSuchAlgorithmException` - KeyStore algorithm unsupported by current provider (SSL only)
    `java.security.cert.CertificateException` - general certificate error (SSL only)
    `java.security.UnrecoverableKeyException` - internal KeyStore problem with the certificate (SSL only)
    `java.security.KeyManagementException` - problem in the key management layer (SSL only)

### createSocket

    public java.net.ServerSocket createSocket(int port,
                                              int backlog,
                                              java.net.InetAddress ifAddress)
                                       throws java.io.IOException,
                                              java.security.KeyStoreException,
                                              java.security.NoSuchAlgorithmException,
                                              java.security.cert.CertificateException,
                                              java.security.UnrecoverableKeyException,
                                              java.security.KeyManagementException

  Returns a server socket which uses only the specified network interface on the local host, is bound to a the specified port, and uses the specified connection backlog. The socket is configured with the socket options (such as accept timeout) given to this factory.

  Parameters:
    `port` - the port to listen to
    `backlog` - how many connections are queued
    `ifAddress` - the network interface address to use
  Throws:
    `java.io.IOException` - input/output or network error
    `java.security.KeyStoreException` - error instantiating the KeyStore from file (SSL only)
    `java.security.NoSuchAlgorithmException` - KeyStore algorithm unsupported by current provider (SSL only)
    `java.security.cert.CertificateException` - general certificate error (SSL only)
    `java.security.UnrecoverableKeyException` - internal KeyStore problem with the certificate (SSL only)
    `java.security.KeyManagementException` - problem in the key management layer (SSL only)

Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.