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.
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:
| connectionStaleCheckingEnabled | +The 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 |