depends.org.apache.http

接口 HttpConnection

所有超级接口:

java.lang.AutoCloseable, java.io.Closeable

所有已知子接口:

HttpClientConnection, HttpInetConnection, HttpRoutedConnection, HttpServerConnection, ManagedClientConnection, ManagedHttpClientConnection, NHttpClientConnection, NHttpClientIOTarget, NHttpConnection, NHttpServerConnection, NHttpServerIOTarget, OperatedClientConnection

所有已知实现类:

AbstractClientConnAdapter, AbstractHttpClientConnection, AbstractHttpServerConnection, AbstractPooledConnAdapter, BHttpConnectionBase, DefaultBHttpClientConnection, DefaultBHttpServerConnection, DefaultClientConnection, DefaultHttpClientConnection, DefaultHttpServerConnection, DefaultManagedHttpClientConnection, DefaultNHttpClientConnection, DefaultNHttpServerConnection, NHttpConnectionBase, SocketHttpClientConnection, SocketHttpServerConnection

public interface HttpConnection
extends java.io.Closeable

A generic HTTP connection, useful on client and server side.

从以下版本开始:

4.0

方法概要

方法

限定符和类型	方法和说明
void	close() Closes this connection gracefully.
HttpConnectionMetrics	getMetrics() Returns a collection of connection metrics.
int	getSocketTimeout() Returns the socket timeout value.
boolean	isOpen() Checks if this connection is open.
boolean	isStale() Checks whether this connection has gone down.
void	setSocketTimeout(int timeout) Sets the socket timeout value.
void	shutdown() Force-closes this connection.

方法详细资料

close

void close()
           throws java.io.IOException

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 在接口中 java.lang.AutoCloseable

指定者:

close 在接口中 java.io.Closeable

抛出:

java.io.IOException

isOpen

boolean isOpen()

Checks if this connection is open.

返回:

true if it is open, false if it is closed.

isStale

boolean isStale()

Checks whether this connection has gone down. Network connections may get closed during some time of inactivity for several reasons. The next time a read is attempted on such a connection it will throw an IOException. This method tries to alleviate this inconvenience by trying to find out if a connection is still usable. Implementations may do that by attempting a read with a very small timeout. Thus this method may block for a small amount of time before returning a result. It is therefore an expensive operation.

返回:

true if attempts to use this connection are likely to succeed, or false if they are likely to fail and this connection should be closed

setSocketTimeout

void setSocketTimeout(int timeout)

Sets the socket timeout value.

参数:

timeout - timeout value in milliseconds

getSocketTimeout

int getSocketTimeout()

Returns the socket timeout value.

返回:

positive value in milliseconds if a timeout is set, 0 if timeout is disabled or -1 if timeout is undefined.

shutdown

void shutdown()
              throws java.io.IOException

Force-closes this connection. This is the only method of a connection which may be called from a different thread to terminate the connection. This method will not attempt to flush the transmitter's internal buffer prior to closing the underlying socket.

抛出:

java.io.IOException

getMetrics

HttpConnectionMetrics getMetrics()

Returns a collection of connection metrics.

返回:

HttpConnectionMetrics