/usr/share/doc/libcommons-httpclient-java/docs/proposal.html is in libcommons-httpclient-java-doc 3.1-14.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>HttpClient - Proposal</title><style type="text/css" media="all">
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Commons Documentation Team"></meta><meta name="email" content="httpcomponents-dev@jakarta.apache.org"></meta><meta name="author" content="Remy Maucherat"></meta><meta name="email" content="remy@apache.org"></meta><meta name="author" content="Jeff Dever"></meta><meta name="email" content="jsdever@apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://jakarta.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src=""></img></a><a href="http://jakarta.apache.org/httpcomponents/httpclient-3.x/" id="projectLogo"><img alt="HttpClient" src="./images/httpclient_logo.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 18 August 2007
<span class="separator">|</span> Doc for 3.1
</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuOverview"><h5>Overview</h5><ul><li class="none"><a href="features.html">Features</a></li><li class="none"><a href="news.html">News</a></li><li class="none"><a href="status.html">Status</a></li><li class="none"><a href="downloads.html">Download</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-httpclient/" class="externalLink" title="External Link">Wiki</a></li><li class="expanded"><a href="userguide.html">User Guide</a><ul><li class="none"><a href="authentication.html">Authentication Guide</a></li><li class="none"><a href="charencodings.html">Character Encodings</a></li><li class="none"><a href="cookies.html">Cookies</a></li><li class="none"><a href="exception-handling.html">Exception Handling</a></li><li class="none"><a href="logging.html">Logging Guide</a></li><li class="none"><a href="methods.html">Methods</a></li><li class="none"><a href="performance.html">Optimization Guide</a></li><li class="none"><a href="preference-api.html">Preference Architecture</a></li><li class="none"><a href="redirects.html">Redirects Handling</a></li><li class="none"><a href="http://svn.apache.org/viewvc/jakarta/httpcomponents/oac.hc3x/trunk/src/examples/" class="externalLink" title="External Link">Sample Code</a></li><li class="none"><a href="sslguide.html">SSL Guide</a></li><li class="none"><a href="threading.html">Threading</a></li><li class="none"><a href="troubleshooting.html">Trouble Shooting</a></li><li class="none"><a href="tutorial.html">Tutorial</a></li></ul></li><li class="none"><a href="developerguide.html">Developer Guide</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="development-process.html">Development Process</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/mavenlogo_builtby_w.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Rationale"></a><h2>Rationale</h2>
<p>HTTP is the main protocol used today on the internet. Although the JDK
includes basic support for building HTTP-aware client applications, it
doesn't provide the flexibility or ease of use needed for many projects.
</p>
<p>A Commons package would give committers an opportunity to coordinate
their efforts to create and maintain a efficient, feature-rich package
under the ASF license.</p>
</div><div class="section"><a name="Scope_of_the_Package"></a><h2>Scope of the Package</h2>
<p>The package shall create and maintain a Java library implementing the client
side of the HTTP/1.1 protocol, as defined in RFC 2616 and RFC 2617.
</p>
<p>
The package should :
<ul>
<li>Have an API which should be as simple to use as possible</li>
<li>Be as easy to extend as possible</li>
<li>Provide unconditional support for HTTP/1.1</li>
</ul>
The package is quite different from the HTTP client provided as part of the JDK
(java.net.HttpURLConnection), as it focuses on the HTTP methods being sent
(instead of making that transparent to the user), and generally allows more
interaction with the lower level connection. The JDK client is also not very
intuitive to use.
</p>
<p>
The package is used by the Slide project to build a WebDAV client
library supporting WebDAV level 2.
</p>
</div><div class="section"><a name="Interaction_With_Other_Packages"></a><h2>Interaction With Other Packages</h2>
<p><em>HttpClient</em> relies on:
</p>
<ul>
<li>Java Development Kit (Version 1.1 or later; 1.3 or later recommended)
</li>
</ul>
</div><div class="section"><a name="Initial_Source_of_the_Package"></a><h2>Initial Source of the Package</h2>
<p>The initial codebase exists in the jakarta-slide cvs tree under the
org.apache.webdav.lib package. It would be moved to commons under
the http subdirectory.
</p>
<p>The proposed package name for the new component is
org.apache.commons.httpclient.
</p>
</div><div class="section"><a name="Required_Jakarta-Commons_Resources"></a><h2>Required Jakarta-Commons Resources</h2>
<ul>
<li>CVS Repository - New directory <code>httpclient</code> in the
<code>jakarta-commons</code> CVS repository.</li>
<li>Initial Committers - The list is provided below. Some of the proposed
committers are not currently jakarta-commons committers, but are committers
on the jakarta-slide project, and contributed to this component.</li>
<li>Mailing List - Discussions will take place on the general
<em>jakarta-commons@jakarta.apache.org</em> mailing list. To help list
subscribers identify messages of interest, it is suggested that the
message subject of messages about this component be prefixed with
[httpclient].</li>
<li>Bugzilla - New component "HttpClient" under the "Commons" product
category, with appropriate version identifiers as needed.</li>
<li>Jyve FAQ - New category "commons-httpclient" (when available).</li>
</ul>
</div><div class="section"><a name="Initial_Committers"></a><h2>Initial Committers</h2>
<p>The initial committers on the <em>HttpClient</em> component shall be:</p>
<ul>
<li>Remy Maucherat</li>
<li>B.C.Holmes</li>
<li>Sung-Gu Park</li>
<li>Juergen Pill</li>
<li>Costin Manolache</li>
</ul>
</div><div class="section"><a name="Proposal_ChangeLog"></a><h2>Proposal ChangeLog</h2>
<p>2002/07/19 - Replace uses of <em>HTTP Client</em> with <em>HttpClient</em>
for consistency.
</p>
</div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2001-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
|