olegk 2003/06/27 14:17:37
Modified: httpclient/src/java/org/apache/commons/httpclient
HttpMethodBase.java
Log:
Javadocs corrections
Contributed by Gary Gregory <[EMAIL PROTECTED]> & Oleg Kalnichevski
Revision Changes Path
1.157 +17 -18
jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethodBase.java
Index: HttpMethodBase.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethodBase.java,v
retrieving revision 1.156
retrieving revision 1.157
diff -u -r1.156 -r1.157
--- HttpMethodBase.java 23 Jun 2003 23:41:39 -0000 1.156
+++ HttpMethodBase.java 27 Jun 2003 21:17:36 -0000 1.157
@@ -135,6 +135,7 @@
* @author Michael Becke
* @author <a href="mailto:[EMAIL PROTECTED]">Oleg Kalnichevski</a>
* @author <a href="mailto:[EMAIL PROTECTED]">Mike Bowler</a>
+ * @author <a href="mailto:[EMAIL PROTECTED]">Gary Gregory</a>
*
* @version $Revision$ $Date$
*/
@@ -231,10 +232,10 @@
/** Whether or not I should automatically process authentication. */
private boolean doAuthentication = true;
- /** Whether or not I should use the HTTP/1.1 protocol. */
+ /** Whether or not I should use the HTTP/1.1 protocol. The default is
<tt>true</tt>. */
private boolean http11 = true;
- /** True if we're in strict mode. */
+ /** True if we're in strict mode. The default is <tt>false</tt>. */
private boolean strictMode = false;
/** Whether or not I have been executed. */
@@ -257,7 +258,7 @@
/** true if we are finished with the connection */
private boolean doneWithConnection = false;
- /** Number of milliseconds to wait for 100-contunue response */
+ /** Number of milliseconds to wait for 100-contunue response. */
private static final int RESPONSE_WAIT_TIME_MS = 3000;
// ----------------------------------------------------------- Constructors
@@ -416,7 +417,7 @@
/**
* Access to flag to determine if client should use
- * HTTP/1.1 protocol.
+ * HTTP/1.1 protocol. The default is <tt>true</tt>.
*
* @return <tt>true</tt> if I should use the HTTP/1.1 protocol
*/
@@ -809,13 +810,12 @@
}
/**
- * Turns strict mode on or off. In strict mode (the default) we following
- * the letter of RFC 2616, the Http 1.1 specification. If strict mode is
- * turned off we attempt to violate the specification in the same way that
- * most Http user agent's do (and many HTTP servers expect. NOTE:
- * StrictMode is currently experimental and its functionlaity may change
- * in the future.
- *
+ * Defines how strictly HttpClient follows the HTTP protocol specification
+ * (RFC 2616 and other relevant RFCs). In the strict mode HttpClient precisely
+ * implements the requirements of the specification, whereas in non-strict mode
+ * it attempts to mimic the exact behaviour of commonly used HTTP agents,
+ * which many HTTP servers expect.
+ *
* @param strictMode true for strict mode, false otherwise
*/
public void setStrictMode(boolean strictMode) {
@@ -823,9 +823,8 @@
}
/**
- * Returns the value of strictMode. NOTE: StrictMode is currently
- * experimental and its functionlaity may change in the future.
- *
+ * Returns the value of strictMode.
+ *
* @return true if strict mode is enabled.
*/
public boolean isStrictMode() {
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
