org.apache.http.conn.socket

Interface LayeredConnectionSocketFactory

All Superinterfaces:

ConnectionSocketFactory

All Known Implementing Classes:

SSLConnectionSocketFactory, SSLSocketFactory

public interface LayeredConnectionSocketFactory
extends ConnectionSocketFactory

Extended ConnectionSocketFactory interface for layered sockets such as SSL/TLS.

Since:

4.3

Method Summary

Methods

Modifier and Type	Method and Description
java.net.Socket	createLayeredSocket(java.net.Socket socket, java.lang.String target, int port, HttpContext context) Returns a socket connected to the given host that is layered over an existing socket.

Methods inherited from interface org.apache.http.conn.socket.ConnectionSocketFactory

connectSocket, createSocket

Method Detail

createLayeredSocket

java.net.Socket createLayeredSocket(java.net.Socket socket,
                                  java.lang.String target,
                                  int port,
                                  HttpContext context)
                                    throws java.io.IOException,
                                           java.net.UnknownHostException

Returns a socket connected to the given host that is layered over an existing socket. Used primarily for creating secure sockets through proxies.

Parameters:

socket - the existing socket

target - the name of the target host.

port - the port to connect to on the target host.

context - the actual HTTP context.

Returns:

Socket a new socket

Throws:

java.io.IOException - if an I/O error occurs while creating the socket

java.net.UnknownHostException