commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jsde...@apache.org
Subject cvs commit: jakarta-commons/httpclient/xdocs features.xml index.xml testwebapp.xml
Date Sat, 01 Feb 2003 12:56:23 GMT
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/>&#xA0;
  -        <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/>&#xA0;
  -        <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/>&#xA0;
  -        <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/>&#xA0;
  -        <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/>&#xA0;
  -        <li>
  -          support for HTTPS (HTTP over SSL).
  -        </li>
  -        <br/>&#xA0;
  -        <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


Mime
View raw message