depends.org.apache.http.impl.conn

类 DefaultClientConnection

java.lang.Object

depends.org.apache.http.impl.AbstractHttpClientConnection

depends.org.apache.http.impl.SocketHttpClientConnection

depends.org.apache.http.impl.conn.DefaultClientConnection

所有已实现的接口:

OperatedClientConnection, HttpClientConnection, HttpConnection, HttpInetConnection, HttpContext, java.io.Closeable, java.lang.AutoCloseable

@NotThreadSafe
public class DefaultClientConnection
extends SocketHttpClientConnection
implements OperatedClientConnection, HttpContext

Default implementation of an operated client connection.

The following parameters can be used to customize the behavior of this class:

• CoreProtocolPNames.STRICT_TRANSFER_ENCODING
• CoreProtocolPNames.HTTP_ELEMENT_CHARSET
• CoreConnectionPNames.SOCKET_BUFFER_SIZE
• CoreConnectionPNames.MAX_LINE_LENGTH
• CoreConnectionPNames.MAX_HEADER_COUNT

从以下版本开始:

4.0

字段概要

从接口继承的字段 depends.org.apache.http.protocol.HttpContext

RESERVED_PREFIX

构造器概要

构造器

构造器和说明
DefaultClientConnection()

方法概要

方法

限定符和类型	方法和说明
void	close() Closes this connection gracefully.
protected HttpMessageParser<HttpResponse>	createResponseParser(SessionInputBuffer buffer, HttpResponseFactory responseFactory, HttpParams params) Creates an instance of HttpMessageParser to be used for parsing HTTP responses received over this connection.
protected SessionInputBuffer	createSessionInputBuffer(java.net.Socket socket, int buffersize, HttpParams params) Creates an instance of SocketInputBuffer to be used for receiving data from the given Socket.
protected SessionOutputBuffer	createSessionOutputBuffer(java.net.Socket socket, int buffersize, HttpParams params) Creates an instance of SessionOutputBuffer to be used for sending data to the given Socket.
java.lang.Object	getAttribute(java.lang.String id) Obtains attribute with the given name.
java.net.Socket	getSocket() Obtains the socket for this connection.
HttpHost	getTargetHost() Obtains the target host for this connection.
boolean	isSecure() Indicates whether this connection is secure.
void	openCompleted(boolean secure, HttpParams params) Signals that the connection has been successfully open.
void	opening(java.net.Socket sock, HttpHost target) Signals that this connection is in the process of being open.
HttpResponse	receiveResponseHeader() Receives the request line and headers of the next response available from this connection.
java.lang.Object	removeAttribute(java.lang.String id) Removes attribute with the given name from the context.
void	sendRequestHeader(HttpRequest request) Sends the request line and all headers over the connection.
void	setAttribute(java.lang.String id, java.lang.Object obj) Sets value of the attribute with the given name.
void	shutdown() Force-closes this connection.
void	update(java.net.Socket sock, HttpHost target, boolean secure, HttpParams params) Updates this connection.

从类继承的方法 depends.org.apache.http.impl.SocketHttpClientConnection

assertNotOpen, assertOpen, bind, getLocalAddress, getLocalPort, getRemoteAddress, getRemotePort, getSocketTimeout, isOpen, setSocketTimeout, toString

从类继承的方法 depends.org.apache.http.impl.AbstractHttpClientConnection

createConnectionMetrics, createEntityDeserializer, createEntitySerializer, createHttpResponseFactory, createRequestWriter, doFlush, flush, getMetrics, init, isEof, isResponseAvailable, isStale, receiveResponseEntity, sendRequestEntity

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

从接口继承的方法 depends.org.apache.http.HttpClientConnection

flush, isResponseAvailable, receiveResponseEntity, sendRequestEntity

从接口继承的方法 depends.org.apache.http.HttpInetConnection

getLocalAddress, getLocalPort, getRemoteAddress, getRemotePort

从接口继承的方法 depends.org.apache.http.HttpConnection

getMetrics, getSocketTimeout, isOpen, isStale, setSocketTimeout

构造器详细资料

DefaultClientConnection

public DefaultClientConnection()

方法详细资料

getTargetHost

public final HttpHost getTargetHost()

从接口复制的说明: OperatedClientConnection

Obtains the target host for this connection. If the connection is to a proxy but not tunnelled, this is the proxy. If the connection is tunnelled through a proxy, this is the target of the tunnel.
The return value is well-defined only while the connection is open. It may change even while the connection is open, because of an update.

指定者:

getTargetHost 在接口中 OperatedClientConnection

返回:

the host to which this connection is opened

isSecure

public final boolean isSecure()

从接口复制的说明: OperatedClientConnection

Indicates whether this connection is secure. The return value is well-defined only while the connection is open. It may change even while the connection is open, because of an update.

指定者:

isSecure 在接口中 OperatedClientConnection

返回:

true if this connection is secure, false otherwise

getSocket

public final java.net.Socket getSocket()

从接口复制的说明: OperatedClientConnection

Obtains the socket for this connection. The return value is well-defined only while the connection is open. It may change even while the connection is open, because of an update.

指定者:

getSocket 在接口中 OperatedClientConnection

覆盖:

getSocket 在类中 SocketHttpClientConnection

返回:

the socket for communicating with the target host

opening

public void opening(java.net.Socket sock,
           HttpHost target)
             throws java.io.IOException

从接口复制的说明: OperatedClientConnection

Signals that this connection is in the process of being open.

By calling this method, the connection can be re-initialized with a new Socket instance before OperatedClientConnection.openCompleted(boolean, depends.org.apache.http.params.HttpParams) is called. This enabled the connection to close that socket if shutdown is called before it is fully open. Closing an unconnected socket will interrupt a thread that is blocked on the connect. Otherwise, that thread will either time out on the connect, or it returns successfully and then opens this connection which was just shut down.

This method can be called multiple times if the connection is layered over another protocol. Note: This method will not close the previously used socket. It is the caller's responsibility to close that socket if it is no longer required.

The caller must invoke OperatedClientConnection.openCompleted(boolean, depends.org.apache.http.params.HttpParams) in order to complete the process.

指定者:

opening 在接口中 OperatedClientConnection

参数:

sock - the unconnected socket which is about to be connected.

target - the target host of this connection

抛出:

java.io.IOException

openCompleted

public void openCompleted(boolean secure,
                 HttpParams params)
                   throws java.io.IOException

从接口复制的说明: OperatedClientConnection

Signals that the connection has been successfully open. An attempt to call this method on an open connection will cause an exception.

指定者:

openCompleted 在接口中 OperatedClientConnection

参数:

secure - true if this connection is secure, for example if an SSLSocket is used, or false if it is not secure

params - parameters for this connection. The parameters will be used when creating dependent objects, for example to determine buffer sizes.

抛出:

java.io.IOException

shutdown

public void shutdown()
              throws java.io.IOException

Force-closes this connection. If the connection is still in the process of being open (the method opening was already called but openCompleted was not), the associated socket that is being connected to a remote address will be closed. That will interrupt a thread that is blocked on connecting the socket. If the connection is not yet open, this will prevent the connection from being opened.

指定者:

shutdown 在接口中 HttpConnection

覆盖:

shutdown 在类中 SocketHttpClientConnection

抛出:

java.io.IOException - in case of a problem

close

public void close()
           throws java.io.IOException

从接口复制的说明: HttpConnection

Closes this connection gracefully. This method will attempt to flush the internal output buffer prior to closing the underlying socket. This method MUST NOT be called from a different thread to force shutdown of the connection. Use shutdown instead.

指定者:

close 在接口中 HttpConnection

指定者:

close 在接口中 java.io.Closeable

指定者:

close 在接口中 java.lang.AutoCloseable

覆盖:

close 在类中 SocketHttpClientConnection

抛出:

java.io.IOException

createSessionInputBuffer

protected SessionInputBuffer createSessionInputBuffer(java.net.Socket socket,
                                          int buffersize,
                                          HttpParams params)
                                               throws java.io.IOException

从类复制的说明: SocketHttpClientConnection

Creates an instance of SocketInputBuffer to be used for receiving data from the given Socket.

This method can be overridden in a super class in order to provide a custom implementation of SessionInputBuffer interface.

覆盖:

createSessionInputBuffer 在类中 SocketHttpClientConnection

参数:

socket - the socket.

buffersize - the buffer size.

params - HTTP parameters.

返回:

session input buffer.

抛出:

java.io.IOException - in case of an I/O error.

另请参阅:

SocketInputBuffer.SocketInputBuffer(Socket, int, HttpParams)

createSessionOutputBuffer

protected SessionOutputBuffer createSessionOutputBuffer(java.net.Socket socket,
                                            int buffersize,
                                            HttpParams params)
                                                 throws java.io.IOException

从类复制的说明: SocketHttpClientConnection

Creates an instance of SessionOutputBuffer to be used for sending data to the given Socket.

This method can be overridden in a super class in order to provide a custom implementation of SocketOutputBuffer interface.

覆盖:

createSessionOutputBuffer 在类中 SocketHttpClientConnection

参数:

socket - the socket.

buffersize - the buffer size.

params - HTTP parameters.

返回:

session output buffer.

抛出:

java.io.IOException - in case of an I/O error.

另请参阅:

SocketOutputBuffer.SocketOutputBuffer(Socket, int, HttpParams)

createResponseParser

protected HttpMessageParser<HttpResponse> createResponseParser(SessionInputBuffer buffer,
                                                   HttpResponseFactory responseFactory,
                                                   HttpParams params)

从类复制的说明: AbstractHttpClientConnection

Creates an instance of HttpMessageParser to be used for parsing HTTP responses received over this connection.

This method can be overridden in a super class in order to provide a different implementation of the HttpMessageParser interface or to pass a different implementation of the LineParser to the the DefaultHttpResponseParser constructor.

覆盖:

createResponseParser 在类中 AbstractHttpClientConnection

参数:

buffer - the session input buffer.

responseFactory - the HTTP response factory.

params - HTTP parameters.

返回:

HTTP message parser.

update

public void update(java.net.Socket sock,
          HttpHost target,
          boolean secure,
          HttpParams params)
            throws java.io.IOException

从接口复制的说明: OperatedClientConnection

Updates this connection. A connection can be updated only while it is open. Updates are used for example when a tunnel has been established, or when a TLS/SSL connection has been layered on top of a plain socket connection.
Note: Updating the connection will not close the previously used socket. It is the caller's responsibility to close that socket if it is no longer required.

指定者:

update 在接口中 OperatedClientConnection

参数:

sock - the new socket for communicating with the target host, or null to continue using the old socket. If null is passed, helper objects that depend on the socket should be re-used. In that case, some changes in the parameters will not take effect.

target - the new target host of this connection

secure - true if this connection is now secure, false if it is not secure

params - new parameters for this connection

抛出:

java.io.IOException

receiveResponseHeader

public HttpResponse receiveResponseHeader()
                                   throws HttpException,
                                          java.io.IOException

从接口复制的说明: HttpClientConnection

Receives the request line and headers of the next response available from this connection. The caller should examine the HttpResponse object to find out if it should try to receive a response entity as well.

指定者:

receiveResponseHeader 在接口中 HttpClientConnection

覆盖:

receiveResponseHeader 在类中 AbstractHttpClientConnection

返回:

a new HttpResponse object with status line and headers initialized.

抛出:

HttpException - in case of HTTP protocol violation

java.io.IOException - in case of an I/O error

sendRequestHeader

public void sendRequestHeader(HttpRequest request)
                       throws HttpException,
                              java.io.IOException

从接口复制的说明: HttpClientConnection

Sends the request line and all headers over the connection.

指定者:

sendRequestHeader 在接口中 HttpClientConnection

覆盖:

sendRequestHeader 在类中 AbstractHttpClientConnection

参数:

request - the request whose headers to send.

抛出:

HttpException - in case of HTTP protocol violation

java.io.IOException - in case of an I/O error

getAttribute

public java.lang.Object getAttribute(java.lang.String id)

从接口复制的说明: HttpContext

Obtains attribute with the given name.

指定者:

getAttribute 在接口中 HttpContext

参数:

id - the attribute name.

返回:

attribute value, or null if not set.

removeAttribute

public java.lang.Object removeAttribute(java.lang.String id)

从接口复制的说明: HttpContext

Removes attribute with the given name from the context.

指定者:

removeAttribute 在接口中 HttpContext

参数:

id - the attribute name.

返回:

attribute value, or null if not set.

setAttribute

public void setAttribute(java.lang.String id,
                java.lang.Object obj)

从接口复制的说明: HttpContext

Sets value of the attribute with the given name.

指定者:

setAttribute 在接口中 HttpContext

参数:

id - the attribute name.

obj - the attribute value.