public interface HttpSocketPool
HttpRequest
class.Modifier and Type | Method and Description |
---|---|
void |
close(HttpSocket hs,
boolean reuse)
Releases an
HttpSocket to this pool when it is not
in use any more. |
HttpSocket |
get(java.lang.String host,
int port,
boolean reuse)
Returns an
HttpSocket that can be used to communicate
with the specified port on the named host. |
HttpSocket get(java.lang.String host, int port, boolean reuse) throws java.io.IOException
HttpSocket
that can be used to communicate
with the specified port on the named host.
It is this method's responsibility to to fill in all the public
member variables of the HttpSocket
before returning.
For each call to this method, there should eventually be a call to
close
when the HttpSocket
isn't needed
anymore.
host
- The host name.port
- The port number.reuse
- true
to request that this pool attempt to find
and reuse an existing idle connection, false
to request that this pool establish a new connection to
the named host.HttpSocket
.java.io.IOException
- if there is a problem connecting to the specified port on
the named host. The IOException
s (and
subclasses) that might be thrown depend upon how the
socket connection is established. See the socket
documentation for further details. Some subclasses that
might be thrown are as follows:java.io.UnknownHostException
- if the host name cannot be resolved.java.io.ConnectionException
- if the named host is not listening on the specified port.java.io.InterruptedIOException
- if the connection times out or this thread is interrupted by
Thread.interrupt
.void close(HttpSocket hs, boolean reuse)
HttpSocket
to this pool when it is not
in use any more.
It is this method's responsibility to release resources used
by the HttpSocket
, such as closing the underlying socket.
After calling this method, the user should not refer to the specified
HttpSocket
any more.
hs
- The HttpSocket
to release.reuse
- true
if the specified HttpSocket
should be put back into the idle pool, false
if it should be released immediately.