- All Superinterfaces:
- All Known Subinterfaces:
- HttpClientConnection, HttpInetConnection, HttpServerConnection
- All Known Implementing Classes:
- AbstractHttpClientConnection, AbstractHttpServerConnection, BHttpConnectionBase, DefaultBHttpClientConnection, DefaultBHttpServerConnection, DefaultHttpClientConnection, DefaultHttpServerConnection, SocketHttpClientConnection, SocketHttpServerConnection
public interface HttpConnection
- extends Closeable
A generic HTTP connection, useful on client and server side.
- 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
- Specified by:
close in interface
- Checks if this connection is open.
- true if it is open, false if it is closed.
- 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
void setSocketTimeout(int timeout)
- Sets the socket timeout value.
timeout - timeout value in milliseconds
- Returns the socket timeout value.
- positive value in milliseconds if a timeout is set,
0 if timeout is disabled or
timeout is undefined.
- 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.
- Returns a collection of connection metrics.
Copyright © 2005–2018 The Apache Software Foundation. All rights reserved.