Index: src/java/org/apache/commons/httpclient/HttpConnection.java =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpConnection.java,v retrieving revision 1.67.2.4 diff -u -r1.67.2.4 HttpConnection.java --- src/java/org/apache/commons/httpclient/HttpConnection.java 10 Sep 2003 21:34:11 -0000 1.67.2.4 +++ src/java/org/apache/commons/httpclient/HttpConnection.java 22 Oct 2003 02:20:27 -0000 @@ -471,6 +471,11 @@ /** * Sets whether or not isStale() will be called when testing if this connection is open. * + *

Setting this flag to false will increase performance when reusing + * connections, but it will also make them less reliable. Stale checking ensures that + * connections are viable before they are used. When set to false some + * method executions will result in IOExceptions and they will have to be retried.

+ * * @param staleCheckEnabled true to enable isStale() * * @see #isStale() Index: xdocs/threading.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/threading.xml,v retrieving revision 1.1.2.1 diff -u -r1.1.2.1 threading.xml --- xdocs/threading.xml 21 Aug 2003 16:07:31 -0000 1.1.2.1 +++ xdocs/threading.xml 22 Oct 2003 02:20:29 -0000 @@ -13,7 +13,7 @@ multi-threaded environment. It is broken down into the following main sections:

Please see the MultiThreadedExample for a concrete example.

@@ -39,9 +39,15 @@ to the method and as a result it must also be returned. More on this below in Connection Release.

-

The MultiThreadedHttpConnectionManager supports the following options for - customizing the number of active connections:

+

The MultiThreadedHttpConnectionManager supports the following options:

+ + + +
connectionStaleCheckingEnabledThe connectionStaleCheckingEnabled flag to set on all created connections. This value + should be left true except in special circumstances. Consult the + HttpConnection + docs for more detail.
maxConnectionsPerHost The maximum number of connections that will be created for any particular