org.apache.commons.httpclient.contrib.ssl
Class EasySSLProtocolSocketFactory

public class EasySSLProtocolSocketFactory
implements SecureProtocolSocketFactory

EasySSLProtocolSocketFactory can be used to creats SSL Socket s 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);

     HttpClient client = new HttpClient();
     client.getHostConfiguration().setHost("localhost", 443, easyhttps);
     // use relative url only
     GetMethod httpget = new GetMethod("/");
     client.executeMethod(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);
     

SinceNot specified.
VersionNot specified.
Author<a href="mailto:oleg -at- ural.ru">Oleg Kalnichevski</a> <p> DISCLAIMER: HttpClient developers DO NOT actively support this component. The component is provided as a reference material, which may be inappropriate for use without additional customiza
Wiki javadoc Use textile entry format.
Add your comments here.
Constructor Summary
EasySSLProtocolSocketFactory()
Constructor for EasySSLProtocolSocketFactory.
Method Summary
Socket createSocket( String host, int port, InetAddress clientHost, int clientPort )
No description provided.
Socket createSocket( String host, int port, InetAddress localAddress, int localPort, HttpConnectionParams params )
Attempts to get a new socket connection to the given host within the given time limit.
Socket createSocket( String host, int port )
No description provided.
Socket createSocket( Socket socket, String host, int port, boolean autoClose )
No description provided.
boolean equals( Object obj )
No description provided.
int hashCode()
No description provided.
EasySSLProtocolSocketFactory
public EasySSLProtocolSocketFactory ( )
Constructor for EasySSLProtocolSocketFactory.
Wiki javadoc Use textile entry format.
Add your comments here.
createSocket
public Socket createSocket ( String host, int port, InetAddress clientHost, int clientPort )
No description provided.
Implements method in ProtocolSocketFactory
Parameters
TypeNameDescription
String host No description provided.
int port No description provided.
InetAddress clientHost No description provided.
int clientPort No description provided.
Exceptions
IOException No description provided.
UnknownHostException No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
createSocket
public Socket createSocket ( String host, int port, InetAddress localAddress, int localPort, HttpConnectionParams params )
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

Implements method in ProtocolSocketFactory
Parameters
TypeNameDescription
String host the host name/IP
int port the port on the host
InetAddress localAddress No description provided.
int localPort No description provided.
HttpConnectionParams params Http connection parameters
Exceptions
IOException if an I/O error occurs while creating the socket
UnknownHostException if the IP address of the host cannot be determined
ConnectTimeoutException No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
createSocket
public Socket createSocket ( String host, int port )
No description provided.
Implements method in ProtocolSocketFactory
Parameters
TypeNameDescription
String host No description provided.
int port No description provided.
Exceptions
IOException No description provided.
UnknownHostException No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
createSocket
public Socket createSocket ( Socket socket, String host, int port, boolean autoClose )
No description provided.
Implements method in SecureProtocolSocketFactory
Parameters
TypeNameDescription
Socket socket No description provided.
String host No description provided.
int port No description provided.
boolean autoClose No description provided.
Exceptions
IOException No description provided.
UnknownHostException No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
equals
public boolean equals ( Object obj )
No description provided.
Overrides method in Object
Parameters
TypeNameDescription
Object obj No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
hashCode
public int hashCode ( )
No description provided.
Overrides method in Object
Wiki javadoc Use textile entry format.
Add your comments here.