You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by sv...@apache.org on 2020/11/15 15:18:40 UTC
svn commit: r1883444 [4/10] - in /httpcomponents/site: ./
httpcomponents-asyncclient-4.0.x/ httpcomponents-asyncclient-4.1.x/
httpcomponents-client-4.3.x/ httpcomponents-client-4.5.x/
httpcomponents-client-5.0.x/ httpcomponents-core-4.4.x/ httpcomponen...
Modified: httpcomponents/site/httpcomponents-client-5.0.x/index.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.0.x/index.html?rev=1883444&r1=1883443&r2=1883444&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.0.x/index.html (original)
+++ httpcomponents/site/httpcomponents-client-5.0.x/index.html Sun Nov 15 15:18:39 2020
@@ -1,252 +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 2020-11-13 ( $Revision: 1070709 $ ) -->
-<!-- $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="20201113" />
- <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="http://hc.apache.org/" id="bannerRight">
- <img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents" />
- </a>
- <div class="clear">
- <hr/>
- </div>
- </div>
- <div id="breadcrumbs">
-
-
- <div class="xleft">
- <span id="publishDate">Last Published: 2020-11-13</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="http://hc.apache.org/index.html" class="externalLink" 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="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 5.0</strong>
- <ul>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/quickstart.html" title="Quick Start">Quick Start</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/examples.html" title="Examples (Classic)">Examples (Classic)</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/examples-async.html" title="Examples (Async)">Examples (Async)</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/examples-reactive.html" title="Examples (Reactive)">Examples (Reactive)</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/logging.html" title="Logging Guide">Logging Guide</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/android.html" title="Android">Android</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/related-projects.html" title="Related">Related</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/download.html" title="Download">Download</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/project-info.html" title="Project Info">Project Info</a>
- </li>
- </ul>
- </li>
- <li class="collapsed">
- <a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1 BETA">HttpCore 5.1 BETA</a>
- </li>
- <li class="collapsed">
- <a href="../httpcomponents-core-5.0.x/index.html" title="HttpCore 5.0">HttpCore 5.0</a>
- </li>
- <li class="collapsed">
- <a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5">HttpClient 4.5</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">
- <section>
-<h2><a name="HttpClient_Overview"></a>HttpClient Overview</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></section><section>
-<h2><a name="Documentation">Documentation</a></h2>
-<ol style="list-style-type: decimal">
-<li><a href="./examples.html">HttpClient Examples</a> - a set of examples demonstrating some of the more complex behavior. </li>
-<li>Project reports
-<ul>
-<li><a href="./httpclient5/project-reports.html">HttpClient</a></li>
-<li><a href="./httpclient5-fluent/project-reports.html">HC Fluent</a></li>
-<li><a href="./httpclient5-cache/project-reports.html">HttpClient Cache</a></li>
-<li><a href="./httpclient5-win/project-reports.html">HttpClient Windows extensions</a></li></ul></li></ol></section><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></section><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://tools.ietf.org/html/rfc7230">RFC 7230</a> - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing</li>
-<li><a class="externalLink" href="http://tools.ietf.org/html/rfc7231">RFC 7231</a> - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</li>
-<li><a class="externalLink" href="http://tools.ietf.org/html/rfc7235">RFC 7235</a> - Hypertext Transfer Protocol (HTTP/1.1): Authentication</li>
-<li><a class="externalLink" href="http://tools.ietf.org/html/rfc1945">RFC 1945</a> - Hypertext Transfer Protocol -- HTTP/1.0</li>
-<li><a class="externalLink" href="http://tools.ietf.org/html/rfc2817">RFC 2817</a> - Upgrading to TLS Within HTTP/1.1</li>
-<li><a class="externalLink" href="http://tools.ietf.org/html/rfc2818">RFC 2818</a> - HTTP Over TLS</li>
-<li><a class="externalLink" href="http://tools.ietf.org/html/rfc6265">RFC 6265</a> - HTTP State Management Mechanism (Cookies)</li>
-<li><a class="externalLink" href="http://tools.ietf.org/html/rfc2396">RFC 2396</a> - Uniform Resource Identifiers (URI): Generic Syntax</li></ul></section>
- </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-2020
- <a href="https://www.apache.org/">The Apache Software Foundation</a>.
- All Rights Reserved.
-
- </div>
- <div class="clear">
- <hr/>
- </div>
- </div>
- </body>
+<!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 2020-11-15 ( $Revision: 1070709 $ ) -->
+<!-- $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="20201115" />
+ <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="http://hc.apache.org/" id="bannerRight">
+ <img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2020-11-15</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="http://hc.apache.org/index.html" class="externalLink" 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="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 5.0</strong>
+ <ul>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/quickstart.html" title="Quick Start">Quick Start</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/examples.html" title="Examples (Classic)">Examples (Classic)</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/examples-async.html" title="Examples (Async)">Examples (Async)</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/examples-reactive.html" title="Examples (Reactive)">Examples (Reactive)</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/logging.html" title="Logging Guide">Logging Guide</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/android.html" title="Android">Android</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/related-projects.html" title="Related">Related</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/project-info.html" title="Project Info">Project Info</a>
+ </li>
+ </ul>
+ </li>
+ <li class="collapsed">
+ <a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1 BETA">HttpCore 5.1 BETA</a>
+ </li>
+ <li class="collapsed">
+ <a href="../httpcomponents-core-5.0.x/index.html" title="HttpCore 5.0">HttpCore 5.0</a>
+ </li>
+ <li class="collapsed">
+ <a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5">HttpClient 4.5</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">
+ <section>
+<h2><a name="HttpClient_Overview"></a>HttpClient Overview</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></section><section>
+<h2><a name="Documentation">Documentation</a></h2>
+<ol style="list-style-type: decimal">
+<li><a href="./examples.html">HttpClient Examples</a> - a set of examples demonstrating some of the more complex behavior. </li>
+<li>Project reports
+<ul>
+<li><a href="./httpclient5/project-reports.html">HttpClient</a></li>
+<li><a href="./httpclient5-fluent/project-reports.html">HC Fluent</a></li>
+<li><a href="./httpclient5-cache/project-reports.html">HttpClient Cache</a></li>
+<li><a href="./httpclient5-win/project-reports.html">HttpClient Windows extensions</a></li></ul></li></ol></section><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></section><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://tools.ietf.org/html/rfc7230">RFC 7230</a> - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc7231">RFC 7231</a> - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc7235">RFC 7235</a> - Hypertext Transfer Protocol (HTTP/1.1): Authentication</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc1945">RFC 1945</a> - Hypertext Transfer Protocol -- HTTP/1.0</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc2817">RFC 2817</a> - Upgrading to TLS Within HTTP/1.1</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc2818">RFC 2818</a> - HTTP Over TLS</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc6265">RFC 6265</a> - HTTP State Management Mechanism (Cookies)</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc2396">RFC 2396</a> - Uniform Resource Identifiers (URI): Generic Syntax</li></ul></section>
+ </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-2020
+ <a href="https://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
</html>
\ No newline at end of file
Modified: httpcomponents/site/httpcomponents-client-5.0.x/logging.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.0.x/logging.html?rev=1883444&r1=1883443&r2=1883444&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.0.x/logging.html (original)
+++ httpcomponents/site/httpcomponents-client-5.0.x/logging.html Sun Nov 15 15:18:39 2020
@@ -1,310 +1,306 @@
-<!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 2020-11-13 ( $Revision: 1070709 $ ) -->
-<!-- $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="20201113" />
- <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="http://hc.apache.org/" id="bannerRight">
- <img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents" />
- </a>
- <div class="clear">
- <hr/>
- </div>
- </div>
- <div id="breadcrumbs">
-
-
- <div class="xleft">
- <span id="publishDate">Last Published: 2020-11-13</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="http://hc.apache.org/index.html" class="externalLink" 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="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-5.0.x/index.html" title="HttpClient 5.0">HttpClient 5.0</a>
- <ul>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/quickstart.html" title="Quick Start">Quick Start</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/examples.html" title="Examples (Classic)">Examples (Classic)</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/examples-async.html" title="Examples (Async)">Examples (Async)</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/examples-reactive.html" title="Examples (Reactive)">Examples (Reactive)</a>
- </li>
- <li class="none">
- <strong>Logging Guide</strong>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/android.html" title="Android">Android</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/related-projects.html" title="Related">Related</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/download.html" title="Download">Download</a>
- </li>
- <li class="none">
- <a href="../httpcomponents-client-5.0.x/project-info.html" title="Project Info">Project Info</a>
- </li>
- </ul>
- </li>
- <li class="collapsed">
- <a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1 BETA">HttpCore 5.1 BETA</a>
- </li>
- <li class="collapsed">
- <a href="../httpcomponents-core-5.0.x/index.html" title="HttpCore 5.0">HttpCore 5.0</a>
- </li>
- <li class="collapsed">
- <a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5">HttpClient 4.5</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">
- <section>
-<h2><a name="Logging_Practices"></a>Logging Practices</h2>
-<p>Being a library HttpClient is not to dictate which logging framework the user has to use. Therefore HttpClient utilizes the logging facade provided by the <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/api.html">Apache Log4j 2</a> package. <code>Log4j 2</code> provides a simple and generalized <a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-api/apidocs/index.html?org/apache/logging/log4j/package-summary.html">log interface</a> to various logging packages. By using <code>Log4j</code>, HttpClient can be configured for a variety of different logging behaviours. That means the user will have to make a choice which logging implementation to use. By default <code>Log4j 2</code> supports the following logging implementation:</p>
-<ul>
-<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/">Log4J 2</a></li>
-<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-to-slf4j/index.html">SLF4J</a></li>
-<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-api/apidocs/org/apache/logging/log4j/simple/SimpleLogger.html"> SimpleLog</a> (internal to <code>Log4J 2</code>)</li>
-<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-jul/index.html"> java.util.logging</a>
-<p>By implementing some simple interfaces <code>Log4J 2</code> can be extended to support basically any other custom logging framework. <code>Log4J 2</code> tries to automatically discover the logging framework to use. If it fails to select the expected one, you must configure <code>Log4J 2</code> by hand. Please refer to the <code>Log4J 2</code> 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><section>
-<h3><a name="Understanding_Logger_Names">Understanding Logger Names</a></h3>
-<p>Most logging implementations use a hierarchical scheme for matching logger names with logging configuration. In this scheme, the logger name hierarchy is represented by <code>'.'</code> characters in the logger name, in a fashion very similar to the hierarchy used for Java package names. For example, <code>org.apache.logging.appender</code> and <code>org.apache.logging.filter</code> both have <code>org.apache.logging</code> as their parent. In most cases, applications name their loggers by passing the current class's name to <code>LogManager.getLogger(...)</code>. </p></section><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 logger named according to the class's fully qualified name. For example the class <code>DefaultHttpClient</code> has a logger named <code>org.apache.http.impl.client.DefaultHttpClient</code>. Since all classes follow this convention it is possible to configure context logging for all classes using the single logger named <code>org.apache.hc.client5.http</code>.</p></section><section>
-<h3><a name="Wire_Logging">Wire Logging</a></h3>
-<p>The wire logger is used to log all data transmitted to and from servers when executing HTTP requests. The wire logger uses the <code>org.apache.hc.client5.http.wire</code> logger name. This logger should only be enabled to debug problems, as it will produce an extremely large amount of log data.</p></section><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, use the <code>org.apache.hc.client5.http.headers</code> logger for capturing HTTP headers only.</p></section><section>
-<h3><a name="Configuration_Examples">Configuration Examples</a></h3>
-<p><code>Log4j 2</code> can delegate to a variety of logging implementations for processing the actual output. Below are configuration examples for <code>Log4j 2</code>, <code>Commons Logging</code>, and <code>java.util.logging</code>.</p><section>
-<h4><a name="Log4j_2_Examples">Log4j 2 Examples</a></h4>
-<p>The simplest way to <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/configuration.html">configure</a> <code>Log4j 2</code> is via a <code>log4j2.xml</code> file. <code>Log4j 2</code> will <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/configuration.html#AutomaticConfiguration">automatically</a> configure itself using a file named <code>log4j2.xml</code> when it's present at the root of the application classpath. Below are some <code>Log4j</code> configuration examples.</p>
-<p><b>Note:</b> The <code>Log4j 2</code> implementation a.k.a "core" is not included in the <code>HttpClient</code> distribution. You can include it in your project using <a class="externalLink" href="https://logging.apache.org/log4j/2.x/maven-artifacts.html">Maven, Ivy, Gradle, or SBT</a>. </p>
-<ul>
-<li>Enable header wire + context logging - <b>Best for Debugging</b>
-<div>
-<pre><Configuration>
- <Appenders>
- <Console name="STDOUT">
- <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
- </Console>
- </Appenders>
- <Loggers>
- <Logger name="org.apache.hc.client5.http" level="DEBUG">
- <AppenderRef ref="Console"/>
- </Logger>
- <Logger name="org.apache.hc.client5.http.wire" level="DEBUG">
- <AppenderRef ref="Console"/>
- </Logger>
- <Root level="INFO">
- <AppenderRef ref="STDOUT" />
- </Root>
- </Loggers>
-</Configuration>
-</pre></div></li>
-<li>Enable full wire + context logging
-<div>
-<pre><Configuration>
- <Appenders>
- <Console name="STDOUT">
- <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
- </Console>
- </Appenders>
- <Loggers>
- <Logger name="org.apache.hc.client5.http" level="DEBUG">
- <AppenderRef ref="Console"/>
- </Logger>
- <Root level="INFO">
- <AppenderRef ref="STDOUT" />
- </Root>
- </Loggers>
-</Configuration>
-</pre></div></li>
-<li>Enable context logging for connection management
-<div>
-<pre><Configuration>
- <Appenders>
- <Console name="STDOUT">
- <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
- </Console>
- </Appenders>
- <Loggers>
- <Logger name="org.apache.hc.client5.http.impl.io" level="DEBUG">
- <AppenderRef ref="Console"/>
- </Logger>
- <Logger name="org.apache.hc.client5.http.impl.nio" level="DEBUG">
- <AppenderRef ref="Console"/>
- </Logger>
- <Root level="INFO">
- <AppenderRef ref="STDOUT" />
- </Root>
- </Loggers>
-</Configuration>
-</pre></div></li>
-<li>Enable context logging for connection management / request execution
-<div>
-<pre><Configuration>
- <Appenders>
- <Console name="STDOUT">
- <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
- </Console>
- </Appenders>
- <Loggers>
- <Logger name="org.apache.hc.client5.http.impl" level="DEBUG">
- <AppenderRef ref="Console"/>
- </Logger>
- <Root level="INFO">
- <AppenderRef ref="STDOUT" />
- </Root>
- </Loggers>
-</Configuration>
-</pre></div></li></ul>
-<p>The <code>Log4J 2</code> manual is the best reference for how to configure <code>Log4J 2</code>. It is available at <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/"> https://logging.apache.org/log4j/2.x/manual/</a>.</p></section></section></section>
- </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-2020
- <a href="https://www.apache.org/">The Apache Software Foundation</a>.
- All Rights Reserved.
-
- </div>
- <div class="clear">
- <hr/>
- </div>
- </div>
- </body>
+<!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 2020-11-15 ( $Revision: 1070709 $ ) -->
+<!-- $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="20201115" />
+ <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="http://hc.apache.org/" id="bannerRight">
+ <img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2020-11-15</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="http://hc.apache.org/index.html" class="externalLink" 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="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-5.0.x/index.html" title="HttpClient 5.0">HttpClient 5.0</a>
+ <ul>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/quickstart.html" title="Quick Start">Quick Start</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/examples.html" title="Examples (Classic)">Examples (Classic)</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/examples-async.html" title="Examples (Async)">Examples (Async)</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/examples-reactive.html" title="Examples (Reactive)">Examples (Reactive)</a>
+ </li>
+ <li class="none">
+ <strong>Logging Guide</strong>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/android.html" title="Android">Android</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/related-projects.html" title="Related">Related</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../httpcomponents-client-5.0.x/project-info.html" title="Project Info">Project Info</a>
+ </li>
+ </ul>
+ </li>
+ <li class="collapsed">
+ <a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1 BETA">HttpCore 5.1 BETA</a>
+ </li>
+ <li class="collapsed">
+ <a href="../httpcomponents-core-5.0.x/index.html" title="HttpCore 5.0">HttpCore 5.0</a>
+ </li>
+ <li class="collapsed">
+ <a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5">HttpClient 4.5</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">
+ <section>
+<h2><a name="Logging_Practices"></a>Logging Practices</h2>
+<p>Being a library HttpClient is not to dictate which logging framework the user has to use. Therefore HttpClient utilizes the logging facade provided by the <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/api.html">Apache Log4j 2</a> package. <code>Log4j 2</code> provides a simple and generalized <a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-api/apidocs/index.html?org/apache/logging/log4j/package-summary.html">log interface</a> to various logging packages. By using <code>Log4j</code>, HttpClient can be configured for a variety of different logging behaviours. That means the user will have to make a choice which logging implementation to use. By default <code>Log4j 2</code> supports the following logging implementation:</p>
+<ul>
+<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/">Log4J 2</a></li>
+<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-to-slf4j/index.html">SLF4J</a></li>
+<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-api/apidocs/org/apache/logging/log4j/simple/SimpleLogger.html"> SimpleLog</a> (internal to <code>Log4J 2</code>)</li>
+<li><a class="externalLink" href="https://logging.apache.org/log4j/2.x/log4j-jul/index.html"> java.util.logging</a>
+<p>By implementing some simple interfaces <code>Log4J 2</code> can be extended to support basically any other custom logging framework. <code>Log4J 2</code> tries to automatically discover the logging framework to use. If it fails to select the expected one, you must configure <code>Log4J 2</code> by hand. Please refer to the <code>Log4J 2</code> 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><section>
+<h3><a name="Understanding_Logger_Names">Understanding Logger Names</a></h3>
+<p>Most logging implementations use a hierarchical scheme for matching logger names with logging configuration. In this scheme, the logger name hierarchy is represented by <code>'.'</code> characters in the logger name, in a fashion very similar to the hierarchy used for Java package names. For example, <code>org.apache.logging.appender</code> and <code>org.apache.logging.filter</code> both have <code>org.apache.logging</code> as their parent. In most cases, applications name their loggers by passing the current class's name to <code>LogManager.getLogger(...)</code>. </p></section><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 logger named according to the class's fully qualified name. For example the class <code>DefaultHttpClient</code> has a logger named <code>org.apache.http.impl.client.DefaultHttpClient</code>. Since all classes follow this convention it is possible to configure context logging for all classes using the single logger named <code>org.apache.hc.client5.http</code>.</p></section><section>
+<h3><a name="Wire_Logging">Wire Logging</a></h3>
+<p>The wire logger is used to log all data transmitted to and from servers when executing HTTP requests. The wire logger uses the <code>org.apache.hc.client5.http.wire</code> logger name. This logger should only be enabled to debug problems, as it will produce an extremely large amount of log data.</p></section><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, use the <code>org.apache.hc.client5.http.headers</code> logger for capturing HTTP headers only.</p></section><section>
+<h3><a name="Configuration_Examples">Configuration Examples</a></h3>
+<p><code>Log4j 2</code> can delegate to a variety of logging implementations for processing the actual output. Below are configuration examples for <code>Log4j 2</code>, <code>Commons Logging</code>, and <code>java.util.logging</code>.</p><section>
+<h4><a name="Log4j_2_Examples">Log4j 2 Examples</a></h4>
+<p>The simplest way to <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/configuration.html">configure</a> <code>Log4j 2</code> is via a <code>log4j2.xml</code> file. <code>Log4j 2</code> will <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/configuration.html#AutomaticConfiguration">automatically</a> configure itself using a file named <code>log4j2.xml</code> when it's present at the root of the application classpath. Below are some <code>Log4j</code> configuration examples.</p>
+<p><b>Note:</b> The <code>Log4j 2</code> implementation a.k.a "core" is not included in the <code>HttpClient</code> distribution. You can include it in your project using <a class="externalLink" href="https://logging.apache.org/log4j/2.x/maven-artifacts.html">Maven, Ivy, Gradle, or SBT</a>. </p>
+<ul>
+<li>Enable header wire + context logging - <b>Best for Debugging</b>
+<div>
+<pre><Configuration>
+ <Appenders>
+ <Console name="STDOUT">
+ <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
+ </Console>
+ </Appenders>
+ <Loggers>
+ <Logger name="org.apache.hc.client5.http" level="DEBUG">
+ <AppenderRef ref="Console"/>
+ </Logger>
+ <Logger name="org.apache.hc.client5.http.wire" level="DEBUG">
+ <AppenderRef ref="Console"/>
+ </Logger>
+ <Root level="INFO">
+ <AppenderRef ref="STDOUT" />
+ </Root>
+ </Loggers>
+</Configuration></pre></div></li>
+<li>Enable full wire + context logging
+<div>
+<pre><Configuration>
+ <Appenders>
+ <Console name="STDOUT">
+ <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
+ </Console>
+ </Appenders>
+ <Loggers>
+ <Logger name="org.apache.hc.client5.http" level="DEBUG">
+ <AppenderRef ref="Console"/>
+ </Logger>
+ <Root level="INFO">
+ <AppenderRef ref="STDOUT" />
+ </Root>
+ </Loggers>
+</Configuration></pre></div></li>
+<li>Enable context logging for connection management
+<div>
+<pre><Configuration>
+ <Appenders>
+ <Console name="STDOUT">
+ <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
+ </Console>
+ </Appenders>
+ <Loggers>
+ <Logger name="org.apache.hc.client5.http.impl.io" level="DEBUG">
+ <AppenderRef ref="Console"/>
+ </Logger>
+ <Logger name="org.apache.hc.client5.http.impl.nio" level="DEBUG">
+ <AppenderRef ref="Console"/>
+ </Logger>
+ <Root level="INFO">
+ <AppenderRef ref="STDOUT" />
+ </Root>
+ </Loggers>
+</Configuration></pre></div></li>
+<li>Enable context logging for connection management / request execution
+<div>
+<pre><Configuration>
+ <Appenders>
+ <Console name="STDOUT">
+ <PatternLayout pattern="%d %-5level [%logger] %msg%n%xThrowable" />
+ </Console>
+ </Appenders>
+ <Loggers>
+ <Logger name="org.apache.hc.client5.http.impl" level="DEBUG">
+ <AppenderRef ref="Console"/>
+ </Logger>
+ <Root level="INFO">
+ <AppenderRef ref="STDOUT" />
+ </Root>
+ </Loggers>
+</Configuration></pre></div></li></ul>
+<p>The <code>Log4J 2</code> manual is the best reference for how to configure <code>Log4J 2</code>. It is available at <a class="externalLink" href="https://logging.apache.org/log4j/2.x/manual/"> https://logging.apache.org/log4j/2.x/manual/</a>.</p></section></section></section>
+ </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-2020
+ <a href="https://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
</html>
\ No newline at end of file