Class EasySSLProtocolSocketFactory

  • All Implemented Interfaces:
    ProtocolSocketFactory, SecureProtocolSocketFactory

    @Deprecated
    public class EasySSLProtocolSocketFactory
    extends java.lang.Object
    implements SecureProtocolSocketFactory
    Deprecated.
    As of 6.3.0.3 (Package Version 5.7.0), with no replacement.

    EasySSLProtocolSocketFactory can be used to creats SSL Sockets that accept self-signed certificates.

    This socket factory SHOULD NOT be used for productive systems due to security reasons, unless it is a concious decision and you are perfectly aware of security implications of accepting self-signed certificates

    Example of using custom protocol socket factory for a specific host:

         Protocol easyhttps = new Protocol("https", new EasySSLProtocolSocketFactory(), 443);
    
         URI uri = new URI("https://localhost/", true);
         // use relative url only
         GetMethod httpget = new GetMethod(uri.getPathQuery());
         HostConfiguration hc = new HostConfiguration();
         hc.setHost(uri.getHost(), uri.getPort(), easyhttps);
         HttpClient client = new HttpClient();
         client.executeMethod(hc, httpget);
         

    Example of using custom protocol socket factory per default instead of the standard one:

         Protocol easyhttps = new Protocol("https", new EasySSLProtocolSocketFactory(), 443);
         Protocol.registerProtocol("https", easyhttps);
    
         HttpClient client = new HttpClient();
         GetMethod httpget = new GetMethod("https://localhost/");
         client.executeMethod(httpget);
         
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      java.net.Socket createSocket​(java.lang.String host, int port)
      Deprecated.
      Gets a new socket connection to the given host.
      java.net.Socket createSocket​(java.lang.String host, int port, java.net.InetAddress clientHost, int clientPort)
      Deprecated.
      Gets a new socket connection to the given host.
      java.net.Socket createSocket​(java.lang.String host, int port, java.net.InetAddress localAddress, int localPort, HttpConnectionParams params)
      Deprecated.
      Attempts to get a new socket connection to the given host within the given time limit.
      java.net.Socket createSocket​(java.net.Socket socket, java.lang.String host, int port, boolean autoClose)
      Deprecated.
      Returns a socket connected to the given host that is layered over an existing socket.
      boolean equals​(java.lang.Object obj)
      Deprecated.
       
      int hashCode()
      Deprecated.
       
      • Methods inherited from class java.lang.Object

        getClass, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • EasySSLProtocolSocketFactory

        public EasySSLProtocolSocketFactory​(boolean allowExpired)
        Deprecated.
    • Method Detail

      • createSocket

        public java.net.Socket createSocket​(java.lang.String host,
                                            int port,
                                            java.net.InetAddress clientHost,
                                            int clientPort)
                                     throws java.io.IOException
        Deprecated.
        Description copied from interface: ProtocolSocketFactory
        Gets a new socket connection to the given host.
        Specified by:
        createSocket in interface ProtocolSocketFactory
        Parameters:
        host - the host name/IP
        port - the port on the host
        clientHost - the local host name/IP to bind the socket to
        clientPort - the port on the local machine
        Returns:
        Socket a new socket
        Throws:
        java.io.IOException - if an I/O error occurs while creating the socket
        java.net.UnknownHostException - if the IP address of the host cannot be determined
        See Also:
        ProtocolSocketFactory.createSocket(String,int,java.net.InetAddress,int)
      • createSocket

        public java.net.Socket createSocket​(java.lang.String host,
                                            int port,
                                            java.net.InetAddress localAddress,
                                            int localPort,
                                            HttpConnectionParams params)
                                     throws java.io.IOException
        Deprecated.
        Attempts to get a new socket connection to the given host within the given time limit.

        To circumvent the limitations of older JREs that do not support connect timeout a controller thread is executed. The controller thread attempts to create a new socket within the given limit of time. If socket constructor does not return until the timeout expires, the controller terminates and throws an ConnectTimeoutException

        Specified by:
        createSocket in interface ProtocolSocketFactory
        Parameters:
        host - the host name/IP
        port - the port on the host
        localAddress - the local host name/IP to bind the socket to
        localPort - the port on the local machine
        params - Http connection parameters
        Returns:
        Socket a new socket
        Throws:
        java.io.IOException - if an I/O error occurs while creating the socket
        java.net.UnknownHostException - if the IP address of the host cannot be determined
      • createSocket

        public java.net.Socket createSocket​(java.lang.String host,
                                            int port)
                                     throws java.io.IOException
        Deprecated.
        Description copied from interface: ProtocolSocketFactory
        Gets a new socket connection to the given host.
        Specified by:
        createSocket in interface ProtocolSocketFactory
        Parameters:
        host - the host name/IP
        port - the port on the host
        Returns:
        Socket a new socket
        Throws:
        java.io.IOException - if an I/O error occurs while creating the socket
        java.net.UnknownHostException - if the IP address of the host cannot be determined
        See Also:
        ProtocolSocketFactory.createSocket(String,int)
      • createSocket

        public java.net.Socket createSocket​(java.net.Socket socket,
                                            java.lang.String host,
                                            int port,
                                            boolean autoClose)
                                     throws java.io.IOException
        Deprecated.
        Description copied from interface: SecureProtocolSocketFactory
        Returns a socket connected to the given host that is layered over an existing socket. Used primarily for creating secure sockets through proxies.
        Specified by:
        createSocket in interface SecureProtocolSocketFactory
        Parameters:
        socket - the existing socket
        host - the host name/IP
        port - the port on the host
        autoClose - a flag for closing the underling socket when the created socket is closed
        Returns:
        Socket a new socket
        Throws:
        java.io.IOException - if an I/O error occurs while creating the socket
        java.net.UnknownHostException - if the IP address of the host cannot be determined
        See Also:
        SecureProtocolSocketFactory.createSocket(java.net.Socket,String,int,boolean)
      • equals

        public boolean equals​(java.lang.Object obj)
        Deprecated.
        Overrides:
        equals in class java.lang.Object
      • hashCode

        public int hashCode()
        Deprecated.
        Overrides:
        hashCode in class java.lang.Object