Interface HttpSocketPool
public interface HttpSocketPool
This interface represents a cache of idle sockets. Once a request has
been handled, the now-idle socket can be remembered and reused later in
case another HTTP request is made to the same remote host. Currently, the
only instance of this interface is used by the
HttpRequest
class.- Version:
- 2.2
- Author:
- Colin Stevens (colin.stevens@sun.com)
-
Method Summary
Modifier and TypeMethodDescriptionvoid
close
(HttpSocket hs, boolean reuse) Releases anHttpSocket
to this pool when it is not in use any more.Returns anHttpSocket
that can be used to communicate with the specified port on the named host.
-
Method Details
-
get
Returns anHttpSocket
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 theHttpSocket
isn't needed anymore.- Parameters:
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.- Returns:
- The
HttpSocket
.
-
close
Releases anHttpSocket
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.- Parameters:
hs
- TheHttpSocket
to release.reuse
-true
if the specifiedHttpSocket
should be put back into the idle pool,false
if it should be released immediately.
-