Package org.apache.commons.httpclient.protocol

Interface ProtocolSocketFactory

All Known Subinterfaces:

SecureProtocolSocketFactory

All Known Implementing Classes:

DefaultProtocolSocketFactory, EasySSLProtocolSocketFactory, SSLProtocolSocketFactory

@Deprecated
public interface ProtocolSocketFactory

Deprecated.

Jakarta Commons HttpClient 3.x is deprecated in the Jenkins project. It is not recommended to use it in any new code. Instead, use HTTP client API plugins as a dependency in your code. E.g. Apache HttpComponents Client API 4.x Plugin or Async HTTP Client Plugin.

A factory for creating Sockets.

Both Object.equals() and Object.hashCode() should be overridden appropriately. Protocol socket factories are used to uniquely identify Protocols and HostConfigurations, and equals() and hashCode() are required for the correct operation of some connection managers.

Since:

2.0

See Also:

Protocol

Method Summary

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 localAddress, int localPort)	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. Gets a new socket connection to the given host.

Method Detail

createSocket

java.net.Socket createSocket(java.lang.String host,
                             int port,
                             java.net.InetAddress localAddress,
                             int localPort)
                      throws java.io.IOException,
                             java.net.UnknownHostException

Deprecated.

Gets a new socket connection to the given host.

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

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

java.net.Socket createSocket(java.lang.String host,
                             int port,
                             java.net.InetAddress localAddress,
                             int localPort,
                             HttpConnectionParams params)
                      throws java.io.IOException,
                             java.net.UnknownHostException,
                             ConnectTimeoutException

Deprecated.

Gets a new socket connection to the given host.

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

ConnectTimeoutException - if socket cannot be connected within the given time limit

Since:

3.0

createSocket

java.net.Socket createSocket(java.lang.String host,
                             int port)
                      throws java.io.IOException,
                             java.net.UnknownHostException

Deprecated.

Gets a new socket connection to the given host.

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