You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by js...@apache.org on 2003/02/01 13:56:23 UTC
cvs commit: jakarta-commons/httpclient/xdocs features.xml index.xml testwebapp.xml
jsdever 2003/02/01 04:56:23
Modified: httpclient/xdocs features.xml index.xml testwebapp.xml
Log:
Update features to give httpclient more credit.
Revision Changes Path
1.7 +67 -41 jakarta-commons/httpclient/xdocs/features.xml
Index: features.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/features.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- features.xml 26 Jan 2003 16:36:24 -0000 1.6
+++ features.xml 1 Feb 2003 12:56:23 -0000 1.7
@@ -13,47 +13,73 @@
<section name="Features">
<p>
- <em>HttpClient</em> provides...
+ <ul>
+ <li>Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1
+ </li>
+ <li>HTTP-based methods, GET, POST, PUT, DELETE, HEAD, and OPTIONS
+ in an extensible framework.
+ </li>
+ <li>Supports encryption with HTTPS (HTTP over SSL) protocol.
+ </li>
+ <li>Connections through HTTP proxies.
+ </li>
+ <li>Authentication using Basic, an the encrypting NTLM (NT Lan Manager) methods.
+ </li>
+ <li>Multi-Part form POST for uploading large files.
+ </li>
+ <li>Pluggable secure sockets implementations, making it easier to use third party solutions
+ </li>
+ <li>Automatic Cookie handling for reading Set-Cookie: headers from the server and sending
+ them back out in a Cookie: hader when appropriate.
+ </li>
+ <li>Request output streams to avoid buffering any content body by streaming
+ directly to the socket to the server.
+ </li>
+ <li>Response input streams to efficiently read the response body by streaming
+ directly from the socket to the server.
+ </li>
+ <li>Persistent connections using KeepAlive in HTTP/1.0 and persistance in HTTP/1.1
+ </li>
+ <li>Direct access to the response code and headers sent by the server.
+ </li>
+ <li>The ability to set connection timeouts.
+ </li>
+ <li>HttpMethods implement the Command Pattern to allow for parallel requests
+ and efficient re-use of connections.
+ </li>
+ <li>Source code is freely available under the Apache Source License.
+ </li>
+ </ul>
+ </p>
+ </section>
+
+
+ <section name="Standards Compliance">
+ <p>
+ <em>HttpClient</em> implements the following specifications
+ endorsed by the Internet Engineering Task Force (IETF)
+ and the internet at large:
+ <ul>
+ <li><a href="http://www.ietf.org/rfc/rfc1945.txt">RFC1945</a>
+ Hypertext Transfer Protocol -- HTTP/1.0
+ </li>
+ <li><a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a>
+ Hypertext Transfer Protocol -- HTTP/1.1
+ </li>
+ <li><a href="http://www.ietf.org/rfc/rfc2617.txt">RFC2617</a>
+ HTTP Authentication: Basic and Digest Access Authentication
+ </li>
+ <li><a href="http://www.ietf.org/rfc/rfc2109.txt">RFC2109</a>
+ HTTP State Management Mechanism
+ </li>
+ <li><a href="http://www.ietf.org/rfc/rfc2396.txt">RFC2396</a>
+ Uniform Resource Identifiers (URI): Generic Syntax
+ </li>
+ <li><a href="http://www.ietf.org/rfc/rfc1867.txt">RFC1867</a>
+ Form-based File Upload in HTML
+ </li>
+ </ul>
</p>
- <ul>
- <li>
- an extensible framework for implementing HTTP-based methods,
- including built-in support for the GET, POST, PUT, DELETE, HEAD,
- and OPTIONS methods.
- </li>
- <br/> 
- <li>
- unconditional suppport for the client side of the HTTP/1.0 protocol, as defined in
- <a href="http://www.w3.org/Protocols/rfc1945/rfc1945.txt">RFC 1945
- (<i>Hypertext Transfer Protocol - HTTP/1.0</i>)</a>.
- </li>
- <br/> 
- <li>
- unconditional suppport for the client side of the HTTP/1.1 protocol, as defined in
- <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616
- (<i>Hypertext Transfer Protocol - HTTP/1.1</i>)</a>.
- </li>
- <br/> 
- <li>
- support for HTTP Cookies, as defined in
- <a href="http://www.w3.org/Protocols/rfc2109/rfc2109.txt">RFC 2109
- (<i>HTTP State Management System</i>)</a>.
- </li>
- <br/> 
- <li>
- support for Basic Digest and NTLM authentication, as defined in
- <a href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617
- (<i>HTTP Authentication: Basic and Digest Access Authentication</i>)</a>.
- </li>
- <br/> 
- <li>
- support for HTTPS (HTTP over SSL).
- </li>
- <br/> 
- <li>
- support for HTTP proxies.
- </li>
- </ul>
</section>
</body>
1.7 +9 -26 jakarta-commons/httpclient/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/index.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- index.xml 26 Jan 2003 16:36:24 -0000 1.6
+++ index.xml 1 Feb 2003 12:56:23 -0000 1.7
@@ -12,29 +12,7 @@
<body>
<section name="Introduction">
- <p>
- The scope of the <em>HttpClient</em> component is a pure java
- implementation of the HTTP protocol as defined by the following
- and related specifications:
- <ul>
- <li><a href="http://www.ietf.org/rfc/rfc1945.txt">RFC1945</a>
- Hypertext Transfer Protocol -- HTTP/1.0
- </li>
- <li><a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a>
- Hypertext Transfer Protocol -- HTTP/1.1
- </li>
- <li><a href="http://www.ietf.org/rfc/rfc2617.txt">RFC2617</a>
- HTTP Authentication: Basic and Digest Access Authentication
- </li>
- <li><a href="http://www.ietf.org/rfc/rfc2109.txt">RFC2109</a>
- HTTP State Management Mechanism
- </li>
- </ul>
- </p>
- <p> The original source was donated by the Jakarta Slide project. </p>
- </section>
- <section name="The HttpClient Component">
<p>
The Hyper-Text Transfer Protocol (HTTP) is perhaps the most
significant protocol used on the Internet today.
@@ -44,14 +22,14 @@
number of applications that may require HTTP support.
</p>
<p>
- Although the
- <tt><a href="http://java.sun.com/j2se/1.4.1/docs/api/java/net/package-summary.html">java.net</a></tt>
+ Although the <tt>java.net</tt>
package provides basic support for accessing resources via HTTP,
it doesn't provide the full flexibility or functionality needed
by many applications. The Jakarta Commons <em>HttpClient</em> component seeks to fill this void
by providing an efficient, up-to-date, and feature-rich package
implementing the client side of the most recent HTTP standards
- and recommendations.
+ and recommendations. See the <a href="features.html">Features</a> page
+ for more details on standards compliance and capabilities.
</p>
<p>
Designed for extension while providing robust support for the
@@ -59,6 +37,11 @@
to anyone building HTTP-aware client applications such as web
browsers, web service clients, or systems that leverage or extend
the HTTP protocol for distributed communication.
+ </p>
+ <p>
+ Based on the Http-client library a WebDAV API was developed (Jakarta slide).
+ There are plans to implement JSR 147 (a standard Delta-V API) based on this
+ implementation (currently not finally confirmed).
</p>
</section>
1.2 +2 -2 jakarta-commons/httpclient/xdocs/testwebapp.xml
Index: testwebapp.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/testwebapp.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- testwebapp.xml 30 Jan 2003 23:29:39 -0000 1.1
+++ testwebapp.xml 1 Feb 2003 12:56:23 -0000 1.2
@@ -175,7 +175,7 @@
<li>httpclient.test.webappContext</li>
</ul>
<p>run the webapp tests using Ant:<br/>
- ant test-localhost
+ <code>ant test-local</code>
</p>
<p>You should receive BUILD SUCCESSFUL message if all test cases succeeded</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org