| 
 |   | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
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.
| Method Summary | |
|  void | close(HttpSocket hs,
      boolean reuse)Releases an HttpSocketto this pool when it is not
 in use any more. | 
|  HttpSocket | get(String host,
    int port,
    boolean reuse)Returns an HttpSocketthat can be used to communicate
 with the specified port on the named host. | 
| Method Detail | 
public HttpSocket get(String host,
                      int port,
                      boolean reuse)
               throws 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.
IOException - if there is a problem connecting to the specified port on
		the named host.  The IOExceptions (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.
InterruptedIOException - if the connection times out or this thread is interrupted by
		Thread.interrupt.
public 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.| 
 | Version 2.1, Generated 12/30/04 Copyright (c) 2001-2004, Sun Microsystems. | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||