content: /*
  * Conditions Of Use
  *
  * This software was developed by employees of the National Institute of
  * Standards and Technology (NIST), an agency of the Federal Government.
  * Pursuant to title 15 Untied States Code Section 105, works of NIST
  * employees are not subject to copyright protection in the United States
  * and are considered to be in the public domain.  As a result, a formal
  * license is not needed to use the software.
  *
  * This software is provided by NIST as a service and is expressly
  * provided "AS IS."  NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
  * OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
  * AND DATA ACCURACY.  NIST does not warrant or make any representations
  * regarding the use of the software or the results thereof, including but
  * not limited to the correctness, accuracy, reliability or usefulness of
  * the software.
  *
  * Permission to use this software is contingent upon your acceptance
  * of the terms of this agreement
  *
  * .
  *
  */
  package gov2.nist.core.net;
  
  import java.io.IOException;
  import java.net.DatagramSocket;
  import java.net.InetAddress;
  import java.net.ServerSocket;
  import java.net.Socket;
  import java.net.SocketException;
  
  // Added by Daniel J. Martinez Manzano <dani@dif.um.es>
  import javax.net.ssl.SSLServerSocket;
  import javax.net.ssl.SSLSocket;
  
  
  /**
   * basic interface to the network layer
   *
   * @author m.andrews
   *
   */
  public interface NetworkLayer {
  
      /**
       * Creates a server with the specified port, listen backlog, and local IP address to bind to.
       * comparable to "new java.net.ServerSocket(port,backlog,bindAddress);"
       *
       * @param port
       * @param backlog
       * @param bindAddress
       * @return the server socket
       */
      public ServerSocket createServerSocket(int port, int backlog,
              InetAddress bindAddress) throws IOException;
  
      /**
       * Creates an SSL server with the specified port, listen backlog, and local IP address to bind to.
       * Added by Daniel J. Martinez Manzano <dani@dif.um.es>
       *
       * @param port
       * @param backlog
       * @param bindAddress
       * @return the server socket
       */
      public SSLServerSocket createSSLServerSocket(int port, int backlog,
              InetAddress bindAddress) throws IOException;
  
      /**
       * Creates a stream socket and connects it to the specified port number at the specified IP address.
       * comparable to "new java.net.Socket(address, port);"
       *
       * @param address
       * @param port
       * @return the socket
       */
      public Socket createSocket(InetAddress address, int port) throws IOException;
  
      /**
       * Creates a stream socket and connects it to the specified port number at the specified IP address.
       * comparable to "new java.net.Socket(address, port,localaddress);"
       *
       * @param address
       * @param port
       * @param localAddress
       * @return the socket
       */
      public Socket createSocket(InetAddress address, int port, InetAddress localAddress) throws IOException;
  
      /**
       * Creates a new Socket, binds it to myAddress:myPort and connects it to
       * address:port.
       *
       * @param address the InetAddress that we'd like to connect to.
       * @param port the port that we'd like to connect to
       * @param myAddress the address that we are supposed to bind on or null
       *        for the "any" address.
       * @param myPort the port that we are supposed to bind on or 0 for a random
       * one.
       *
       * @return a new Socket, bound on myAddress:myPort and connected to
       * address:port.
       * @throws IOException if binding or connecting the socket fail for a reason
       * (exception relayed from the correspoonding Socket methods)
       */
      public Socket createSocket(InetAddress address, int port,
                      InetAddress myAddress, int myPort)
          throws IOException;
  
      /**
       * Creates a stream SSL socket and connects it to the specified port number at the specified IP address.
       * Added by Daniel J. Martinez Manzano <dani@dif.um.es>
       *
       * @param address
       * @param port
       * @return the socket
       */
      public SSLSocket createSSLSocket(InetAddress address, int port) throws IOException;
  
      /**
       * Creates a stream SSL socket and connects it to the specified port number at the specified IP address.
       * Added by Daniel J. Martinez Manzano <dani@dif.um.es>
       *
       * @param address
       * @param port
       * @param localAddress -- my address.
       * @return the socket
       */
      public SSLSocket createSSLSocket(InetAddress address, int port, InetAddress localAddress) throws IOException;
  
      /**
       * Constructs a datagram socket and binds it to any available port on the local host machine.
       * comparable to "new java.net.DatagramSocket();"
       *
       * @return the datagram socket
       */
      public DatagramSocket createDatagramSocket() throws SocketException;
  
      /**
       * Creates a datagram socket, bound to the specified local address.
       * comparable to "new java.net.DatagramSocket(port,laddr);"
       *
       * @param port
       * @param laddr
       * @return the datagram socket
       */
      public DatagramSocket createDatagramSocket(int port, InetAddress laddr)
              throws SocketException;
  
  }
  