[prev in list] [next in list] [prev in thread] [next in thread]
List: httpcomponents-commits
Subject: svn commit: r1683683 [1/2] - in /httpcomponents/site: httpcomponents-client-4.4.x/ httpcomponents-cl
From: olegk () apache ! org
Date: 2015-06-05 9:11:27
Message-ID: 20150605091128.14903AC0981 () hades ! apache ! org
[Download RAW message or body]
Author: olegk
Date: Fri Jun 5 09:11:27 2015
New Revision: 1683683
URL: http://svn.apache.org/r1683683
Log:
Updated project website for HttpClient 4.5 release
Added:
httpcomponents/site/httpcomponents-client-4.5.x/download.html (with props)
httpcomponents/site/httpcomponents-client-4.5.x/examples.html (with props)
httpcomponents/site/httpcomponents-client-4.5.x/index.html (with props)
httpcomponents/site/httpcomponents-client-4.5.x/logging.html (with props)
httpcomponents/site/httpcomponents-client-4.5.x/ntlm.html (with props)
httpcomponents/site/httpcomponents-client-4.5.x/primer.html (with props)
httpcomponents/site/httpcomponents-client-4.5.x/quickstart.html (with props)
Modified:
httpcomponents/site/httpcomponents-client-4.4.x/index.html
Modified: httpcomponents/site/httpcomponents-client-4.4.x/index.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.4.x/index.html?rev=1683683&r1=1683682&r2=1683683&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.4.x/index.html (original)
+++ httpcomponents/site/httpcomponents-client-4.4.x/index.html Fri Jun 5 09:11:27 \
2015 @@ -208,8 +208,7 @@
<li><a class="externalLink" href="http://www.ietf.org/rfc/rfc1945.txt">RFC 1945</a> \
Hypertext Transfer Protocol -- HTTP/1.0</li> <li><a class="externalLink" \
href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> Hypertext Transfer Protocol \
-- HTTP/1.1</li> <li><a class="externalLink" \
href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617</a> HTTP Authentication: Basic \
and Digest Access Authentication</li>
-<li><a class="externalLink" href="http://www.ietf.org/rfc/rfc2109.txt">RFC 2109</a> \
HTTP State Management Mechanism (Cookies)</li>
-<li><a class="externalLink" href="http://www.ietf.org/rfc/rfc2965.txt">RFC 2965</a> \
HTTP State Management Mechanism (Cookies v2)</li></ul></div> +<li><a \
class="externalLink" href="http://tools.ietf.org/html/rfc6265">RFC 6265</a> HTTP \
State Management Mechanism (Cookies)</li></ul></div> </div>
</div>
<div class="clear">
Added: httpcomponents/site/httpcomponents-client-4.5.x/download.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/download.html?rev=1683683&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/download.html (added)
+++ httpcomponents/site/httpcomponents-client-4.5.x/download.html Fri Jun 5 09:11:27 \
2015 @@ -0,0 +1,215 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" \
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<!-- Generated by Apache \
Maven Doxia at 2015-06-05 ( $Revision$ ) --> +<!-- $HeadURL: \
https://svn.apache.org/repos/asf/httpcomponents/maven-skin/trunk/src/main/resources/META-INF/maven/site.vm \
$ --> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Apache HttpComponents - HttpComponents HttpClient Download Page</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20150605" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://www.apache.org/" id="bannerLeft">
+ <img \
src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache" /> + \
</a> + <a href=".././" id="bannerRight">
+ <img \
src="../images/logos/httpcomponents.png" alt="HttpComponents" /> + \
</a> + <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2015-06-05</span>
+ | <span id="projectVersion">Version: 1-SNAPSHOT</span>
+ </div>
+ <div class="xright"> <a href="http://www.apache.org/" \
class="externalLink" title="Apache">Apache</a> + |
+ <a href="../index.html" \
title="HttpComponents">HttpComponents</a> +
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>HttpComponents</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" \
class="externalLink" title="License">License</a> + </li>
+ <li class="none">
+ <a href="../downloads.cgi" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../mail.html" title="Mailing Lists">Mailing \
Lists</a> + </li>
+ <li class="none">
+ <a href="../dev-docs.html" title="Developer \
documents">Developer documents</a> + </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/HttpComponents/" \
class="externalLink" title="Wiki (external)">Wiki (external)</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/security/" \
class="externalLink" title="Security">Security</a> + </li>
+ </ul>
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="About">About</a>
+ </li>
+ <li class="none">
+ <a href="../news.html" title="News">News</a>
+ </li>
+ <li class="none">
+ <a href="../poweredby.html" title="Powered by">Powered \
by</a> + </li>
+ <li class="none">
+ <a href="../get-involved.html" title="Get Involved">Get \
Involved</a> + </li>
+ </ul>
+ <h5>Components</h5>
+ <ul>
+ \
<li class="expanded"> + <a \
href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5">HttpClient \
4.5</a> + <ul>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/quickstart.html" \
title="Quick Start">Quick Start</a> + </li>
+ <li class="none">
+ <a \
href="../httpcomponents-client-4.5.x/tutorial/html/index.html" \
title="Tutorial">Tutorial</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/examples.html" \
title="Examples">Examples</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/primer.html" \
title="Programming Primer">Programming Primer</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/ntlm.html" \
title="NTLM Guide">NTLM Guide</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/logging.html" \
title="Logging Guide">Logging Guide</a> + </li>
+ <li class="none">
+ <strong>Download</strong>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/project-info.html" \
title="Project Info">Project Info</a> + </li>
+ </ul>
+ </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.4.x/index.html" title="HttpClient 4.4">HttpClient \
4.4</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.3.x/index.html" title="HttpClient 4.3">HttpClient \
4.3</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4">HttpCore 4.4</a> \
+ </li> + \
<li class="collapsed"> + <a \
href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient \
4.1">HttpAsyncClient 4.1</a> + </li>
+ </ul>
+ <h5>Legacy</h5>
+ <ul>
+ <li class="none">
+ <a href="../httpclient-legacy/index.html" title="Commons \
HttpClient">Commons HttpClient</a> + </li>
+ </ul>
+ <h5>Project</h5>
+ <ul>
+ <li class="none">
+ <a href="../status.html" title="Status">Status</a>
+ </li>
+ <li class="none">
+ <a href="../charter.html" title="Charter">Charter</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ \
<li class="collapsed"> + <a href="../project-info.html" \
title="Project Information">Project Information</a> + </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org" class="externalLink" \
title="ASF Home Page">ASF Home Page</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" \
class="externalLink" title="Foundation">Foundation</a> + </li>
+ <li class="none">
+ <a \
href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" \
title="Sponsor Apache">Sponsor Apache</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" \
class="externalLink" title="Thanks">Thanks</a> + </li>
+ </ul>
+ \
<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" \
class="poweredBy"> + <img class="poweredBy" alt="ApacheCon" \
src="http://www.apache.org/events/current-event-125x125.png" /> + </a>
+ \
<a href="http://maven.apache.org/" title="Maven" class="poweredBy"> + <img \
class="poweredBy" alt="Maven" \
src="http://maven.apache.org/images/logos/maven-feather.png" /> + </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- ==================================================================== \
--><!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more \
contributor license agreements. See the NOTICE file --><!-- distributed with this \
work for additional information --><!-- regarding copyright ownership. The ASF \
licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- \
"License"); you may not use this file except in compliance --><!-- with the License. \
You may obtain a copy of the License at --><!-- --><!-- \
http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by \
applicable law or agreed to in writing, --><!-- software distributed under the \
License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS \
OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- \
specific language governing permissions and limitations --><!-- under the License. \
--><!-- ========================== ========================================== \
--><!-- --><!-- This software consists of voluntary contributions made by many \
--><!-- individuals on behalf of the Apache Software Foundation. For more --><!-- \
information on the Apache Software Foundation, please see --><!-- \
<http://www.apache.org/>. --><div class="section"> +<h2>HttpClient Downloads<a \
name="HttpClient_Downloads"></a></h2> +<p>The latest release available for \
download:</p> +<p><a class="externalLink" \
href="http://hc.apache.org/downloads.cgi">Release packages</a> - <a \
class="externalLink" \
href="http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-4.3.x.txt">Release \
Notes</a> - <a class="externalLink" \
href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a></p></div> +<div \
class="section"> +<h2><a name="Dependency_management">Dependency management</a></h2>
+<p>If you are using a dependency manager for your project such as <a \
class="externalLink" href="http://maven.apache.org">Apache Maven</a> or <a \
class="externalLink" href="http://ant.apache.org/projects/ivy.html">Apache Ivy</a>, \
you can create a dependency on HttpClient modules by using this information:</p> \
+<p><a href="./httpclient/dependency-info.html">HttpClient</a></p> +<p><a \
href="./httpclient-cache/dependency-info.html">HttpClient Cache</a></p> +<p><a \
href="./httpmime/dependency-info.html">HttpMime</a></p> +<p><a \
href="./fluent-hc/dependency-info.html">Fluent HC</a></p></div> + </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+
+<div class="xleft">Apache HttpComponents, Commons HttpClient, Apache, the Apache \
feather logo, and the Apache HttpComponents project logo are trademarks of The Apache \
Software Foundation.</div> +
+<br/>
+
+<div class="xleft">All other marks mentioned may be trademarks or registered \
trademarks of their respective owners.</div> + <div \
class="xright">Copyright © 2005-2015 + \
<a href="http://www.apache.org/">The Apache Software Foundation</a>. + All \
Rights Reserved. +
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/download.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/download.html
------------------------------------------------------------------------------
svn:keywords = Date Revision
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/download.html
------------------------------------------------------------------------------
svn:mime-type = text/html
Added: httpcomponents/site/httpcomponents-client-4.5.x/examples.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/examples.html?rev=1683683&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/examples.html (added)
+++ httpcomponents/site/httpcomponents-client-4.5.x/examples.html Fri Jun 5 09:11:27 \
2015 @@ -0,0 +1,241 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" \
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<!-- Generated by Apache \
Maven Doxia at 2015-06-05 ( $Revision$ ) --> +<!-- $HeadURL: \
https://svn.apache.org/repos/asf/httpcomponents/maven-skin/trunk/src/main/resources/META-INF/maven/site.vm \
$ --> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Apache HttpComponents - HttpComponents HttpClient Examples</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20150605" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://www.apache.org/" id="bannerLeft">
+ <img \
src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache" /> + \
</a> + <a href=".././" id="bannerRight">
+ <img \
src="../images/logos/httpcomponents.png" alt="HttpComponents" /> + \
</a> + <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2015-06-05</span>
+ | <span id="projectVersion">Version: 1-SNAPSHOT</span>
+ </div>
+ <div class="xright"> <a href="http://www.apache.org/" \
class="externalLink" title="Apache">Apache</a> + |
+ <a href="../index.html" \
title="HttpComponents">HttpComponents</a> +
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>HttpComponents</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" \
class="externalLink" title="License">License</a> + </li>
+ <li class="none">
+ <a href="../downloads.cgi" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../mail.html" title="Mailing Lists">Mailing \
Lists</a> + </li>
+ <li class="none">
+ <a href="../dev-docs.html" title="Developer \
documents">Developer documents</a> + </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/HttpComponents/" \
class="externalLink" title="Wiki (external)">Wiki (external)</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/security/" \
class="externalLink" title="Security">Security</a> + </li>
+ </ul>
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="About">About</a>
+ </li>
+ <li class="none">
+ <a href="../news.html" title="News">News</a>
+ </li>
+ <li class="none">
+ <a href="../poweredby.html" title="Powered by">Powered \
by</a> + </li>
+ <li class="none">
+ <a href="../get-involved.html" title="Get Involved">Get \
Involved</a> + </li>
+ </ul>
+ <h5>Components</h5>
+ <ul>
+ \
<li class="expanded"> + <a \
href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5">HttpClient \
4.5</a> + <ul>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/quickstart.html" \
title="Quick Start">Quick Start</a> + </li>
+ <li class="none">
+ <a \
href="../httpcomponents-client-4.5.x/tutorial/html/index.html" \
title="Tutorial">Tutorial</a> + </li>
+ <li class="none">
+ <strong>Examples</strong>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/primer.html" \
title="Programming Primer">Programming Primer</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/ntlm.html" \
title="NTLM Guide">NTLM Guide</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/logging.html" \
title="Logging Guide">Logging Guide</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/download.html" \
title="Download">Download</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/project-info.html" \
title="Project Info">Project Info</a> + </li>
+ </ul>
+ </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.4.x/index.html" title="HttpClient 4.4">HttpClient \
4.4</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.3.x/index.html" title="HttpClient 4.3">HttpClient \
4.3</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4">HttpCore 4.4</a> \
+ </li> + \
<li class="collapsed"> + <a \
href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient \
4.1">HttpAsyncClient 4.1</a> + </li>
+ </ul>
+ <h5>Legacy</h5>
+ <ul>
+ <li class="none">
+ <a href="../httpclient-legacy/index.html" title="Commons \
HttpClient">Commons HttpClient</a> + </li>
+ </ul>
+ <h5>Project</h5>
+ <ul>
+ <li class="none">
+ <a href="../status.html" title="Status">Status</a>
+ </li>
+ <li class="none">
+ <a href="../charter.html" title="Charter">Charter</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ \
<li class="collapsed"> + <a href="../project-info.html" \
title="Project Information">Project Information</a> + </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org" class="externalLink" \
title="ASF Home Page">ASF Home Page</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" \
class="externalLink" title="Foundation">Foundation</a> + </li>
+ <li class="none">
+ <a \
href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" \
title="Sponsor Apache">Sponsor Apache</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" \
class="externalLink" title="Thanks">Thanks</a> + </li>
+ </ul>
+ \
<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" \
class="poweredBy"> + <img class="poweredBy" alt="ApacheCon" \
src="http://www.apache.org/events/current-event-125x125.png" /> + </a>
+ \
<a href="http://maven.apache.org/" title="Maven" class="poweredBy"> + <img \
class="poweredBy" alt="Maven" \
src="http://maven.apache.org/images/logos/maven-feather.png" /> + </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- ==================================================================== \
--><!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more \
contributor license agreements. See the NOTICE file --><!-- distributed with this \
work for additional information --><!-- regarding copyright ownership. The ASF \
licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- \
"License"); you may not use this file except in compliance --><!-- with the License. \
You may obtain a copy of the License at --><!-- --><!-- \
http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by \
applicable law or agreed to in writing, --><!-- software distributed under the \
License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS \
OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- \
specific language governing permissions and limitations --><!-- under the License. \
--><!-- ========================== ========================================== \
--><!-- --><!-- This software consists of voluntary contributions made by many \
--><!-- individuals on behalf of the Apache Software Foundation. For more --><!-- \
information on the Apache Software Foundation, please see --><!-- \
<http://www.apache.org/>. --><div class="section"> +<h2>HttpClient Examples<a \
name="HttpClient_Examples"></a></h2> +<ul>
+<li><a href="./httpclient/examples/org/apache/http/examples/client/ClientWithResponseHandler.java">Response \
handling</a> +<p>This example demonstrates how to process HTTP responses using a \
response handler. This is the recommended way of executing HTTP requests and \
processing HTTP responses. This approach enables the caller to concentrate on the \
process of digesting HTTP responses and to delegate the task of system resource \
deallocation to HttpClient. The use of an HTTP response handler guarantees that the \
underlying HTTP connection will be released back to the connection manager \
automatically in all cases.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientConnectionRelease.java">Manual \
connection release</a> +<p>This example demonstrates how to ensure the release of the \
underlying HTTP connection back to the connection manager in case of a manual \
processing of HTTP responses.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientConfiguration.java">HttpClient \
configuration</a> +<p>This example demonstrates how to customize and configure the \
most common aspects of HTTP request execution and connection management.</p></li> \
+<li><a href="./httpclient/examples/org/apache/http/examples/client/ClientAbortMethod.java">Abort \
method</a> +<p>This example demonstrates how to abort an HTTP request before its \
normal completion.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientAuthentication.java">Client \
authentication</a> +<p>This example uses HttpClient to execute an HTTP request \
against a target site that requires user authentication. </p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientExecuteProxy.java">Request \
via a proxy</a> +<p>This example demonstrates how to send an HTTP request via a \
proxy.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientProxyAuthentication.java">Proxy \
authentication</a> +<p>A simple example showing execution of an HTTP request over a \
secure connection tunneled through an authenticating proxy. </p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientChunkEncodedPost.java">Chunk \
encoded POST</a> +<p>This example shows how to stream out a request entity using \
chunk encoding.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientCustomContext.java">Custom \
execution context</a> +<p>This example demonstrates the use of a local HTTP context \
populated custom attributes.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientFormLogin.java">Form \
based logon</a> +<p>This example demonstrates how HttpClient can be used to perform \
form-based logon.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientMultiThreadedExecution.java">Threaded \
request execution</a> +<p>An example that executes HTTP requests from multiple worker \
threads.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientCustomSSL.java">Custom \
SSL context</a> +<p>This example demonstrates how to create secure connections with a \
custom SSL context.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientPreemptiveBasicAuthentication.java">Preemptive \
BASIC authentication</a> +<p>This example shows how HttpClient can be customized to \
authenticate preemptively using BASIC scheme. Generally, preemptive authentication \
can be considered less secure than a response to an authentication challenge and \
therefore discouraged.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ClientPreemptiveDigestAuthentication.java">Preemptive \
DIGEST authentication</a> +<p>This example shows how HttpClient can be customized to \
authenticate preemptively using DIGEST scheme. Generally, preemptive authentication \
can be considered less secure than a response to an authentication challenge and \
therefore discouraged.</p></li> +<li><a \
href="./httpclient/examples/org/apache/http/examples/client/ProxyTunnelDemo.java">Proxy \
tunnel</a> +<p>This example shows how to use ProxyClient in order to establish a \
tunnel through an HTTP proxy for an arbitrary protocol.</p></li> +<li><a \
href="./httpmime/examples/org/apache/http/examples/entity/mime/ClientMultipartFormPost.java">Multipart \
encoded request entity</a> +<p>This example shows how to execute requests enclosing a \
multipart encoded entity. </p></li> +<li><a \
href="./httpclient-win/examples/org/apache/http/examples/client/win/ClientWinAuth.java">Native \
Windows Negotiate/NTLM</a> +<p>This example shows how to make use of Native Windows \
Negotiate/NTLM authentication when running on Windows OS. </p></li></ul></div> + \
</div> + </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+
+<div class="xleft">Apache HttpComponents, Commons HttpClient, Apache, the Apache \
feather logo, and the Apache HttpComponents project logo are trademarks of The Apache \
Software Foundation.</div> +
+<br/>
+
+<div class="xleft">All other marks mentioned may be trademarks or registered \
trademarks of their respective owners.</div> + <div \
class="xright">Copyright © 2005-2015 + \
<a href="http://www.apache.org/">The Apache Software Foundation</a>. + All \
Rights Reserved. +
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/examples.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/examples.html
------------------------------------------------------------------------------
svn:keywords = Date Revision
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/examples.html
------------------------------------------------------------------------------
svn:mime-type = text/html
Added: httpcomponents/site/httpcomponents-client-4.5.x/index.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/index.html?rev=1683683&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/index.html (added)
+++ httpcomponents/site/httpcomponents-client-4.5.x/index.html Fri Jun 5 09:11:27 \
2015 @@ -0,0 +1,252 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" \
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<!-- Generated by Apache \
Maven Doxia at 2015-06-05 ( $Revision$ ) --> +<!-- $HeadURL: \
https://svn.apache.org/repos/asf/httpcomponents/maven-skin/trunk/src/main/resources/META-INF/maven/site.vm \
$ --> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Apache HttpComponents - HttpComponents HttpClient Overview</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20150605" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://www.apache.org/" id="bannerLeft">
+ <img \
src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache" /> + \
</a> + <a href=".././" id="bannerRight">
+ <img \
src="../images/logos/httpcomponents.png" alt="HttpComponents" /> + \
</a> + <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2015-06-05</span>
+ | <span id="projectVersion">Version: 1-SNAPSHOT</span>
+ </div>
+ <div class="xright"> <a href="http://www.apache.org/" \
class="externalLink" title="Apache">Apache</a> + |
+ <a href="../index.html" \
title="HttpComponents">HttpComponents</a> +
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>HttpComponents</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" \
class="externalLink" title="License">License</a> + </li>
+ <li class="none">
+ <a href="../downloads.cgi" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../mail.html" title="Mailing Lists">Mailing \
Lists</a> + </li>
+ <li class="none">
+ <a href="../dev-docs.html" title="Developer \
documents">Developer documents</a> + </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/HttpComponents/" \
class="externalLink" title="Wiki (external)">Wiki (external)</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/security/" \
class="externalLink" title="Security">Security</a> + </li>
+ </ul>
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="About">About</a>
+ </li>
+ <li class="none">
+ <a href="../news.html" title="News">News</a>
+ </li>
+ <li class="none">
+ <a href="../poweredby.html" title="Powered by">Powered \
by</a> + </li>
+ <li class="none">
+ <a href="../get-involved.html" title="Get Involved">Get \
Involved</a> + </li>
+ </ul>
+ <h5>Components</h5>
+ <ul>
+ \
<li class="expanded"> + <strong>HttpClient 4.5</strong>
+ <ul>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/quickstart.html" \
title="Quick Start">Quick Start</a> + </li>
+ <li class="none">
+ <a \
href="../httpcomponents-client-4.5.x/tutorial/html/index.html" \
title="Tutorial">Tutorial</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/examples.html" \
title="Examples">Examples</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/primer.html" \
title="Programming Primer">Programming Primer</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/ntlm.html" \
title="NTLM Guide">NTLM Guide</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/logging.html" \
title="Logging Guide">Logging Guide</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/download.html" \
title="Download">Download</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/project-info.html" \
title="Project Info">Project Info</a> + </li>
+ </ul>
+ </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.4.x/index.html" title="HttpClient 4.4">HttpClient \
4.4</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.3.x/index.html" title="HttpClient 4.3">HttpClient \
4.3</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4">HttpCore 4.4</a> \
+ </li> + \
<li class="collapsed"> + <a \
href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient \
4.1">HttpAsyncClient 4.1</a> + </li>
+ </ul>
+ <h5>Legacy</h5>
+ <ul>
+ <li class="none">
+ <a href="../httpclient-legacy/index.html" title="Commons \
HttpClient">Commons HttpClient</a> + </li>
+ </ul>
+ <h5>Project</h5>
+ <ul>
+ <li class="none">
+ <a href="../status.html" title="Status">Status</a>
+ </li>
+ <li class="none">
+ <a href="../charter.html" title="Charter">Charter</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ \
<li class="collapsed"> + <a href="../project-info.html" \
title="Project Information">Project Information</a> + </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org" class="externalLink" \
title="ASF Home Page">ASF Home Page</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" \
class="externalLink" title="Foundation">Foundation</a> + </li>
+ <li class="none">
+ <a \
href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" \
title="Sponsor Apache">Sponsor Apache</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" \
class="externalLink" title="Thanks">Thanks</a> + </li>
+ </ul>
+ \
<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" \
class="poweredBy"> + <img class="poweredBy" alt="ApacheCon" \
src="http://www.apache.org/events/current-event-125x125.png" /> + </a>
+ \
<a href="http://maven.apache.org/" title="Maven" class="poweredBy"> + <img \
class="poweredBy" alt="Maven" \
src="http://maven.apache.org/images/logos/maven-feather.png" /> + </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- ==================================================================== \
--><!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more \
contributor license agreements. See the NOTICE file --><!-- distributed with this \
work for additional information --><!-- regarding copyright ownership. The ASF \
licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- \
"License"); you may not use this file except in compliance --><!-- with the License. \
You may obtain a copy of the License at --><!-- --><!-- \
http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by \
applicable law or agreed to in writing, --><!-- software distributed under the \
License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS \
OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- \
specific language governing permissions and limitations --><!-- under the License. \
--><!-- ========================== ========================================== \
--><!-- --><!-- This software consists of voluntary contributions made by many \
--><!-- individuals on behalf of the Apache Software Foundation. For more --><!-- \
information on the Apache Software Foundation, please see --><!-- \
<http://www.apache.org/>. --><div class="section"> +<h2>HttpClient Overview<a \
name="HttpClient_Overview"></a></h2> +<p>The Hyper-Text Transfer Protocol (HTTP) is \
perhaps the most significant protocol used on the Internet today. Web services, \
network-enabled appliances and the growth of network computing continue to expand the \
role of the HTTP protocol beyond user-driven web browsers, while increasing the \
number of applications that require HTTP support.</p> +<p>Although the java.net \
package provides basic functionality for accessing resources via HTTP, it doesn't \
provide the full flexibility or functionality needed by many applications. HttpClient \
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.</p> +<p>Designed for extension while providing robust support for \
the base HTTP protocol, HttpClient may be of interest 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></div> +<div \
class="section"> +<h2><a name="Documentation">Documentation</a></h2>
+<ol style="list-style-type: decimal">
+<li><a href="./quickstart.html">Quick Start</a> - contains a simple, complete \
example of an HTTP GET and POST with parameters.</li> +<li><a \
href="./tutorial/html/index.html">HttpClient Tutorial</a> - gives a detailed \
examination of the HttpClient API, which was written in close accordance with the \
(sometimes not very intuitive) HTTP specification/standard. A copy is also shipped \
with the release. <a href="./tutorial/pdf/httpclient-tutorial.pdf">A PDF version</a> \
is also available</li> +<li><a href="./examples.html">HttpClient Examples</a> - a set \
of examples demonstrating some of the more complex behavior. </li> +<li><a \
href="./primer.html">HttpClient Primer</a> - explains the scope of HttpClient. Note \
that HttpClient is not a browser. It lacks the UI, HTML renderer and a JavaScript \
engine that a browser will possess. </li> +<li>Project reports
+<ul>
+<li><a href="./httpclient/project-reports.html">HttpClient</a></li>
+<li><a href="./fluent-hc/project-reports.html">HC Fluent</a></li>
+<li><a href="./httpmime/project-reports.html">HttpMime</a></li>
+<li><a href="./httpclient-cache/project-reports.html">HttpClient Cache</a></li>
+<li><a href="./httpclient-osgi/project-reports.html">HttpClient \
OSGi</a></li></ul></li></ol></div> +<div class="section">
+<h2><a name="Features">Features</a></h2>
+<ul>
+<li>Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1</li>
+<li>Full implementation of all HTTP methods (GET, POST, PUT, DELETE, HEAD, OPTIONS, \
and TRACE) in an extensible OO framework.</li> +<li>Supports encryption with HTTPS \
(HTTP over SSL) protocol.</li> +<li>Transparent connections through HTTP \
proxies.</li> +<li>Tunneled HTTPS connections through HTTP proxies, via the CONNECT \
method.</li> +<li>Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO, Kerberos \
authentication schemes.</li> +<li>Plug-in mechanism for custom authentication \
schemes.</li> +<li>Pluggable secure socket factories, making it easier to use third \
party solutions</li> +<li>Connection management support for use in multi-threaded \
applications. Supports setting the maximum total connections as well as the maximum \
connections per host. Detects and closes stale connections.</li> +<li>Automatic \
Cookie handling for reading Set-Cookie: headers from the server and sending them back \
out in a Cookie: header when appropriate.</li> +<li>Plug-in mechanism for custom \
cookie policies.</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>Support for HTTP/1.1 response caching.</li>
+<li>Source code is freely available under the Apache License.</li></ul></div>
+<div class="section">
+<h2><a name="Standards_Compliance">Standards Compliance</a></h2>
+<p>HttpClient strives to conform to the following specifications endorsed by the \
Internet Engineering Task Force (IETF) and the internet at large:</p> +<ul>
+<li><a class="externalLink" href="http://www.ietf.org/rfc/rfc1945.txt">RFC 1945</a> \
Hypertext Transfer Protocol -- HTTP/1.0</li> +<li><a class="externalLink" \
href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> Hypertext Transfer Protocol \
-- HTTP/1.1</li> +<li><a class="externalLink" \
href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617</a> HTTP Authentication: Basic \
and Digest Access Authentication</li> +<li><a class="externalLink" \
href="http://tools.ietf.org/html/rfc6265">RFC 6265</a> HTTP State Management \
Mechanism (Cookies)</li></ul></div> + </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+
+<div class="xleft">Apache HttpComponents, Commons HttpClient, Apache, the Apache \
feather logo, and the Apache HttpComponents project logo are trademarks of The Apache \
Software Foundation.</div> +
+<br/>
+
+<div class="xleft">All other marks mentioned may be trademarks or registered \
trademarks of their respective owners.</div> + <div \
class="xright">Copyright © 2005-2015 + \
<a href="http://www.apache.org/">The Apache Software Foundation</a>. + All \
Rights Reserved. +
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/index.html
------------------------------------------------------------------------------
svn:keywords = Date Revision
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/index.html
------------------------------------------------------------------------------
svn:mime-type = text/html
Added: httpcomponents/site/httpcomponents-client-4.5.x/logging.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-4.5.x/logging.html?rev=1683683&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-4.5.x/logging.html (added)
+++ httpcomponents/site/httpcomponents-client-4.5.x/logging.html Fri Jun 5 09:11:27 \
2015 @@ -0,0 +1,356 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" \
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<!-- Generated by Apache \
Maven Doxia at 2015-06-05 ( $Revision$ ) --> +<!-- $HeadURL: \
https://svn.apache.org/repos/asf/httpcomponents/maven-skin/trunk/src/main/resources/META-INF/maven/site.vm \
$ --> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Apache HttpComponents - HttpClient Logging Practices</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20150605" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://www.apache.org/" id="bannerLeft">
+ <img \
src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache" /> + \
</a> + <a href=".././" id="bannerRight">
+ <img \
src="../images/logos/httpcomponents.png" alt="HttpComponents" /> + \
</a> + <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2015-06-05</span>
+ | <span id="projectVersion">Version: 1-SNAPSHOT</span>
+ </div>
+ <div class="xright"> <a href="http://www.apache.org/" \
class="externalLink" title="Apache">Apache</a> + |
+ <a href="../index.html" \
title="HttpComponents">HttpComponents</a> +
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>HttpComponents</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" \
class="externalLink" title="License">License</a> + </li>
+ <li class="none">
+ <a href="../downloads.cgi" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../mail.html" title="Mailing Lists">Mailing \
Lists</a> + </li>
+ <li class="none">
+ <a href="../dev-docs.html" title="Developer \
documents">Developer documents</a> + </li>
+ <li class="none">
+ <a href="http://wiki.apache.org/HttpComponents/" \
class="externalLink" title="Wiki (external)">Wiki (external)</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/security/" \
class="externalLink" title="Security">Security</a> + </li>
+ </ul>
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="About">About</a>
+ </li>
+ <li class="none">
+ <a href="../news.html" title="News">News</a>
+ </li>
+ <li class="none">
+ <a href="../poweredby.html" title="Powered by">Powered \
by</a> + </li>
+ <li class="none">
+ <a href="../get-involved.html" title="Get Involved">Get \
Involved</a> + </li>
+ </ul>
+ <h5>Components</h5>
+ <ul>
+ \
<li class="expanded"> + <a \
href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5">HttpClient \
4.5</a> + <ul>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/quickstart.html" \
title="Quick Start">Quick Start</a> + </li>
+ <li class="none">
+ <a \
href="../httpcomponents-client-4.5.x/tutorial/html/index.html" \
title="Tutorial">Tutorial</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/examples.html" \
title="Examples">Examples</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/primer.html" \
title="Programming Primer">Programming Primer</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/ntlm.html" \
title="NTLM Guide">NTLM Guide</a> + </li>
+ <li class="none">
+ <strong>Logging Guide</strong>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/download.html" \
title="Download">Download</a> + </li>
+ <li class="none">
+ <a href="../httpcomponents-client-4.5.x/project-info.html" \
title="Project Info">Project Info</a> + </li>
+ </ul>
+ </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.4.x/index.html" title="HttpClient 4.4">HttpClient \
4.4</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-client-4.3.x/index.html" title="HttpClient 4.3">HttpClient \
4.3</a> + </li>
+ \
<li class="collapsed"> + <a \
href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4">HttpCore 4.4</a> \
+ </li> + \
<li class="collapsed"> + <a \
href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient \
4.1">HttpAsyncClient 4.1</a> + </li>
+ </ul>
+ <h5>Legacy</h5>
+ <ul>
+ <li class="none">
+ <a href="../httpclient-legacy/index.html" title="Commons \
HttpClient">Commons HttpClient</a> + </li>
+ </ul>
+ <h5>Project</h5>
+ <ul>
+ <li class="none">
+ <a href="../status.html" title="Status">Status</a>
+ </li>
+ <li class="none">
+ <a href="../charter.html" title="Charter">Charter</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ \
<li class="collapsed"> + <a href="../project-info.html" \
title="Project Information">Project Information</a> + </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org" class="externalLink" \
title="ASF Home Page">ASF Home Page</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" \
class="externalLink" title="Foundation">Foundation</a> + </li>
+ <li class="none">
+ <a \
href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" \
title="Sponsor Apache">Sponsor Apache</a> + </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" \
class="externalLink" title="Thanks">Thanks</a> + </li>
+ </ul>
+ \
<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" \
class="poweredBy"> + <img class="poweredBy" alt="ApacheCon" \
src="http://www.apache.org/events/current-event-125x125.png" /> + </a>
+ \
<a href="http://maven.apache.org/" title="Maven" class="poweredBy"> + <img \
class="poweredBy" alt="Maven" \
src="http://maven.apache.org/images/logos/maven-feather.png" /> + </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- ==================================================================== \
--><!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more \
contributor license agreements. See the NOTICE file --><!-- distributed with this \
work for additional information --><!-- regarding copyright ownership. The ASF \
licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- \
"License"); you may not use this file except in compliance --><!-- with the License. \
You may obtain a copy of the License at --><!-- --><!-- \
http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by \
applicable law or agreed to in writing, --><!-- software distributed under the \
License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS \
OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- \
specific language governing permissions and limitations --><!-- under the License. \
--><!-- ========================== ========================================== \
--><!-- --><!-- This software consists of voluntary contributions made by many \
--><!-- individuals on behalf of the Apache Software Foundation. For more --><!-- \
information on the Apache Software Foundation, please see --><!-- \
<http://www.apache.org/>. --><div class="section"> +<h2>Logging Practices<a \
name="Logging_Practices"></a></h2> +<p>Being a library HttpClient is not to dictate \
which logging framework the user has to use. Therefore HttpClient utilizes the \
logging interface provided by the <a class="externalLink" \
href="http://commons.apache.org/logging/">Commons Logging</a> package. <tt>Commons \
Logging</tt> provides a simple and generalized <a class="externalLink" \
href="http://commons.apache.org/logging/commons-logging-1.0.4/docs/apidocs/">log \
interface</a> to various logging packages. By using <tt>Commons Logging</tt>, \
HttpClient can be configured for a variety of different logging behaviours. That \
means the user will have to make a choice which logging framework to use. By default \
<tt>Commons Logging</tt> supports the following logging frameworks:</p> +<ul>
+<li><a class="externalLink" \
href="http://logging.apache.org/log4j/docs/index.html">Log4J</a></li> +<li><a \
class="externalLink" \
href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html"> \
java.util.logging</a></li> +<li><a class="externalLink" \
href="http://commons.apache.org/logging/commons-logging-1.0.4/docs/apidocs/org/apache/commons/logging/impl/SimpleLog.html"> \
SimpleLog</a> (internal to <tt>Commons Logging</tt>) +<p>By implementing some simple \
interfaces <tt>Commons Logging</tt> can be extended to support basically any other \
custom logging framework. <tt>Commons Logging</tt> tries to automatically discover \
the logging framework to use. If it fails to select the expected one, you must \
configure <tt>Commons Logging</tt> by hand. Please refer to the <tt>Commons \
Logging</tt> documentation for more information.</p> +<p>HttpClient performs three \
different kinds of logging: the standard context logging used within each class, HTTP \
header logging and full wire logging. </p></li></ul> +<div class="section">
+<h3><a name="Context_Logging">Context Logging</a></h3>
+<p>Context logging contains information about the internal operation of HttpClient \
as it performs HTTP requests. Each class has its own log named according to the \
class's fully qualified name. For example the class <tt>DefaultHttpClient</tt> has a \
log named <tt>org.apache.http.impl.client.DefaultHttpClient</tt>. Since all classes \
follow this convention it is possible to configure context logging for all classes \
using the single log named <tt>org.apache.http.impl.client</tt>.</p></div> +<div \
class="section"> +<h3><a name="Wire_Logging">Wire Logging</a></h3>
+<p>The wire log is used to log all data transmitted to and from servers when \
executing HTTP requests. The wire log uses the <tt>org.apache.http.wire</tt> logging \
category. This log should only be enabled to debug problems, as it will produce an \
extremely large amount of log data.</p></div> +<div class="section">
+<h3><a name="HTTP_header_Logging">HTTP header Logging</a></h3>
+<p>Because the content of HTTP requests is usually less important for debugging than \
the HTTP headers, the <tt>org.apache.http.headers</tt> logging category for capturing \
HTTP headers only.</p></div> +<div class="section">
+<h3><a name="Configuration_Examples">Configuration Examples</a></h3>
+<p><tt>Commons Logging</tt> can delegate to a variety of loggers for processing the \
actual output. Below are configuration examples for <tt>Commons Logging</tt>, \
<tt>Log4j</tt> and <tt>java.util.logging</tt>.</p> +<div class="section">
+<h4><a name="Commons_Logging_Examples">Commons Logging Examples</a></h4>
+<p><tt>Commons Logging</tt> comes with a basic logger called <tt>SimpleLog</tt>. \
This logger writes all logged messages to <tt>System.err</tt>. The following examples \
show how to configure <tt>Commons Logging</tt> via system properties to use \
<tt>SimpleLog</tt>. It is strongly recommended to configure <tt>Commons Logging</tt> \
system properties through JVM process arguments at the start up.</p> +<ul>
+<li>Enable header wire + context logging - <b>Best for Debugging</b>
+<div>
+<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+-Dorg.apache.commons.logging.simplelog.showdatetime=true
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http=DEBUG
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.wire=ERROR</pre></div></li>
+<li>Enable full wire + context logging
+<div>
+<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+-Dorg.apache.commons.logging.simplelog.showdatetime=true
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http=DEBUG</pre></div></li>
+<li>Enable context logging for connection management
+<div>
+<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+-Dorg.apache.commons.logging.simplelog.showdatetime=true
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.impl.conn=DEBUG</pre></div></li>
+<li>Enable context logging for connection management / request execution
+<div>
+<pre>-Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
+-Dorg.apache.commons.logging.simplelog.showdatetime=true
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.impl.conn=DEBUG
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.impl.client=DEBUG
+-Dorg.apache.commons.logging.simplelog.log.org.apache.http.client=DEBUG</pre></div></li></ul></div>
+<div class="section">
+<h4><a name="Log4j_Examples">Log4j Examples</a></h4>
+<p>The simplest way to configure <tt>Log4j</tt> is via a <tt>log4j.properties</tt> \
file. <tt>Log4j</tt> will automatically read and configure itself using a file named \
<tt>log4j.properties</tt> when it's present at the root of the application classpath. \
Below are some <tt>Log4j</tt> configuration examples.</p> +<p><b>Note:</b> \
<tt>Log4j</tt> is not included in the <tt>HttpClient</tt> distribution. </p> +<ul>
+<li>Enable header wire + context logging - <b>Best for Debugging</b>
+<div>
+<pre>log4j.rootLogger=INFO, stdout
+
+log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%5p [%c] %m%n
+
+log4j.logger.org.apache.http=DEBUG
+log4j.logger.org.apache.http.wire=ERROR</pre></div></li>
+<li>Enable full wire + context logging
+<div>
+<pre>log4j.rootLogger=INFO, stdout
+
+log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%5p [%c] %m%n
+
+log4j.logger.org.apache.http=DEBUG</pre></div></li>
+<li>Enable context logging for connection management
+<div>
+<pre>log4j.rootLogger=INFO, stdout
+
+log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%5p [%c] %m%n
+
+log4j.logger.org.apache.http.impl.conn=DEBUG</pre></div></li>
+<li>Enable context logging for connection management / request execution
+<div>
+<pre>log4j.rootLogger=INFO, stdout
+
+log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%5p [%c] %m%n
+
+log4j.logger.org.apache.http.impl.conn=DEBUG
+log4j.logger.org.apache.http.impl.client=DEBUG
+log4j.logger.org.apache.http.client=DEBUG</pre></div></li></ul>
+<p>Note that the default configuration for Log4J is very inefficient as it causes \
all the logging information to be generated but not actually sent anywhere. The \
<tt>Log4J</tt> manual is the best reference for how to configure <tt>Log4J</tt>. It \
is available at <a class="externalLink" \
href="http://logging.apache.org/log4j/docs/manual.html"> \
http://logging.apache.org/log4j/docs/manual.html</a>.</p></div> +<div \
class="section"> +<h4><a name="java.util.logging_Examples">java.util.logging \
Examples</a></h4> +<p>Since JDK 1.4 there has been a package <a class="externalLink" \
href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html"> \
java.util.logging</a> that provides a logging framework similar to <tt>Log4J</tt>. By \
default it reads a config file from <tt>$JAVA_HOME/jre/lib/logging.properties</tt> \
which looks like this (comments stripped):</p> +<div>
+<pre>handlers=java.util.logging.ConsoleHandler
+.level=INFO
+java.util.logging.FileHandler.pattern = %h/java%u.log
+java.util.logging.FileHandler.limit = 50000
+java.util.logging.FileHandler.count = 1
+java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter
+java.util.logging.ConsoleHandler.level = INFO
+java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
+com.xyz.foo.level = SEVERE</pre></div>
+<p>To customize logging a custom <tt>logging.properties</tt> file should be created \
in the project directory. The location of this file must be passed to the JVM as \
asystem property. This can be done on the command line like so:</p> +<div>
+<pre>$JAVA_HOME/java -Djava.util.logging.config.file=$HOME/myapp/logging.properties
+-classpath $HOME/myapp/target/classes com.myapp.Main</pre></div>
+<p>Alternatively <a class="externalLink" \
href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/LogManager.html#readConfiguration(java.io.InputStream)""> \
LogManager#readConfiguration(InputStream)</a> can be used to pass it the desired \
configuration.</p> +<ul>
+<li>Enable header wire + context logging - <b>Best for Debugging</b>
+<div>
+<pre>.level = INFO
+
+handlers=java.util.logging.ConsoleHandler
+java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
+java.util.logging.ConsoleHandler.level = ALL
+
+org.apache.http.level = FINEST
+org.apache.http.wire.level = SEVERE</pre></div></li>
+<li>Enable full wire + context logging
+<div>
+<pre>.level = INFO
+
+handlers=java.util.logging.ConsoleHandler
+java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
+java.util.logging.ConsoleHandler.level = ALL
+
+org.apache.http.level = FINEST</pre></div></li>
+<li>Enable context logging for connection management
+<div>
+<pre>.level = INFO
+
+handlers=java.util.logging.ConsoleHandler
+java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
+java.util.logging.ConsoleHandler.level = ALL
+
+org.apache.http.impl.conn.level = FINEST</pre></div></li>
+<li>Enable context logging for connection management / request execution
+<div>
+<pre>.level = INFO
+
+handlers=java.util.logging.ConsoleHandler
+java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
+java.util.logging.ConsoleHandler.level = ALL
+
+org.apache.http.impl.conn.level = FINEST
+org.apache.http.impl.client.level = FINEST
+org.apache.http.client.level = FINEST</pre></div></li></ul>
+<p>More detailed information is available from the <a class="externalLink" \
href="http://docs.oracle.com/javase/7/docs/technotes/guides/logging/overview.html"> \
Java Logging documentation</a>.</p></div></div></div> + </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+
+<div class="xleft">Apache HttpComponents, Commons HttpClient, Apache, the Apache \
feather logo, and the Apache HttpComponents project logo are trademarks of The Apache \
Software Foundation.</div> +
+<br/>
+
+<div class="xleft">All other marks mentioned may be trademarks or registered \
trademarks of their respective owners.</div> + <div \
class="xright">Copyright © 2005-2015 + \
<a href="http://www.apache.org/">The Apache Software Foundation</a>. + All \
Rights Reserved. +
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/logging.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/logging.html
------------------------------------------------------------------------------
svn:keywords = Date Revision
Propchange: httpcomponents/site/httpcomponents-client-4.5.x/logging.html
------------------------------------------------------------------------------
svn:mime-type = text/html
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic