File Doc Category Size Date Package
ClientConnectionOperator.java API Doc Android 1.5 API 4427 Wed May 06 22:41:10 BST 2009 org.apache.http.conn

ClientConnectionOperator

public interface ClientConnectionOperator

Interface for opening {@link OperatedClientConnection connections}. This interface encapsulates the logic to create sockets and to open or update the connection with the new socket. Implementations will most likely make use of {@link SocketFactory socket factories}.
The methods in this interface allow the creation of plain and layered sockets. Creating a tunnelled connection through a proxy, however, is not within the scope of the operator.

author: Roland Weber
version: $Revision: 645850 $ $Date: 2008-04-08 04:08:52 -0700 (Tue, 08 Apr 2008) $
since: 4.0

Fields Summary
Constructors Summary
Methods Summary
public org.apache.http.conn.OperatedClientConnection createConnection()
Creates a new connection that can be operated.
return
a new, unopened connection for use with this operator
public void openConnection(org.apache.http.conn.OperatedClientConnection conn, org.apache.http.HttpHost target, java.net.InetAddress local, org.apache.http.protocol.HttpContext context, org.apache.http.params.HttpParams params)
Opens a connection to the given target host.
param
conn the connection to open
param
target the target host to connect to
param
local the local address to route from, or null for the default
param
context the context for the connection
param
params the parameters for the connection
throws
IOException in case of a problem
public void updateSecureConnection(org.apache.http.conn.OperatedClientConnection conn, org.apache.http.HttpHost target, org.apache.http.protocol.HttpContext context, org.apache.http.params.HttpParams params)
Updates a connection with a layered secure connection. The typical use of this method is to update a tunnelled plain connection (HTTP) to a secure TLS/SSL connection (HTTPS).
param
conn the open connection to update
param
target the target host for the updated connection. The connection must already be open or tunnelled to the host and port, but the scheme of the target will be used to create a layered connection.
param
context the context for the connection
param
params the parameters for the updated connection
throws
IOException in case of a problem