tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From craig...@apache.org
Subject cvs commit: jakarta-tomcat-4.0/catalina/src/share/org/apache/catalina ServerSocketFactory.java
Date Wed, 17 Oct 2001 04:01:29 GMT
craigmcc    01/10/16 21:01:29

  Added:       catalina/src/share/org/apache/catalina
                        ServerSocketFactory.java
  Log:
  Actually add the new ServerSocketFactory.java interface.
  
  Revision  Changes    Path
  1.1                  jakarta-tomcat-4.0/catalina/src/share/org/apache/catalina/ServerSocketFactory.java
  
  Index: ServerSocketFactory.java
  ===================================================================
  /*
   * ====================================================================
   *
   * The Apache Software License, Version 1.1
   *
   * Copyright (c) 1999 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution, if
   *    any, must include the following acknowlegement:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowlegement may appear in the software itself,
   *    if and wherever such third-party acknowlegements normally appear.
   *
   * 4. The names "The Jakarta Project", "Tomcat", and "Apache Software
   *    Foundation" must not be used to endorse or promote products derived
   *    from this software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache"
   *    nor may "Apache" appear in their names without prior written
   *    permission of the Apache Group.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   *
   * [Additional notices, if required by prior licensing conditions]
   *
   */
  
  
  package org.apache.catalina;
  
  
  import java.io.IOException;
  import java.net.InetAddress;
  import java.net.ServerSocket;
  import java.security.KeyStoreException;
  import java.security.NoSuchAlgorithmException;
  import java.security.cert.CertificateException;
  import java.security.UnrecoverableKeyException;
  import java.security.KeyManagementException;
  
  
  /**
   * 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 <code>setFactory()</code> method.
   *
   * @author db@eng.sun.com
   * @author Harish Prabandham
   * @author Craig R. McClanahan
   */
  public interface ServerSocketFactory {
  
  
      // --------------------------------------------------------- Public Methods
  
  
      /**
       * 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.
       *
       * @param port the port to listen to
       *
       * @exception IOException                input/output or network error
       * @exception KeyStoreException          error instantiating the
       *                                       KeyStore from file (SSL only)
       * @exception NoSuchAlgorithmException   KeyStore algorithm unsupported
       *                                       by current provider (SSL only)
       * @exception CertificateException       general certificate error (SSL only)
       * @exception UnrecoverableKeyException  internal KeyStore problem with
       *                                       the certificate (SSL only)
       * @exception KeyManagementException     problem in the key management
       *                                       layer (SSL only)
       */
      public ServerSocket createSocket (int port)
      throws IOException, KeyStoreException, NoSuchAlgorithmException,
             CertificateException, UnrecoverableKeyException,
             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.
       *
       * @param port the port to listen to
       * @param backlog how many connections are queued
       *
       * @exception IOException                input/output or network error
       * @exception KeyStoreException          error instantiating the
       *                                       KeyStore from file (SSL only)
       * @exception NoSuchAlgorithmException   KeyStore algorithm unsupported
       *                                       by current provider (SSL only)
       * @exception CertificateException       general certificate error (SSL only)
       * @exception UnrecoverableKeyException  internal KeyStore problem with
       *                                       the certificate (SSL only)
       * @exception KeyManagementException     problem in the key management
       *                                       layer (SSL only)
       */
      public ServerSocket createSocket (int port, int backlog)
      throws IOException, KeyStoreException, NoSuchAlgorithmException,
             CertificateException, UnrecoverableKeyException,
             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.
       *
       * @param port the port to listen to
       * @param backlog how many connections are queued
       * @param ifAddress the network interface address to use
       *
       * @exception IOException                input/output or network error
       * @exception KeyStoreException          error instantiating the
       *                                       KeyStore from file (SSL only)
       * @exception NoSuchAlgorithmException   KeyStore algorithm unsupported
       *                                       by current provider (SSL only)
       * @exception CertificateException       general certificate error (SSL only)
       * @exception UnrecoverableKeyException  internal KeyStore problem with
       *                                       the certificate (SSL only)
       * @exception KeyManagementException     problem in the key management
       *                                       layer (SSL only)
       */
      public ServerSocket createSocket (int port, int backlog,
                                        InetAddress ifAddress)
      throws IOException, KeyStoreException, NoSuchAlgorithmException,
             CertificateException, UnrecoverableKeyException,
             KeyManagementException;
  
  
  }
  
  
  

Mime
View raw message