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 2021/05/12 08:01:11 UTC
svn commit: r1889789 [3/4] - in /httpcomponents/site: ./
httpcomponents-asyncclient-4.1.x/ httpcomponents-client-4.5.x/
httpcomponents-client-5.0.x/ httpcomponents-client-5.0.x/migration-guide/
httpcomponents-client-5.1.x/ httpcomponents-client-5.1.x/m...
Added: httpcomponents/site/httpcomponents-client-5.1.x/migration-guide/preparation.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.1.x/migration-guide/preparation.html?rev=1889789&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.1.x/migration-guide/preparation.html (added)
+++ httpcomponents/site/httpcomponents-client-5.1.x/migration-guide/preparation.html Wed May 12 08:01:10 2021
@@ -0,0 +1,226 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-5.1.x/migration-guide/preparation.md
+ | Rendered using Apache Maven Fluido Skin 1.9
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <title>Apache HttpComponents – Migration from Apache HttpClient 4.x APIs</title>
+ <link rel="stylesheet" href="../../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../../css/site.css" />
+ <link rel="stylesheet" href="../../css/print.css" media="print" />
+ <script src="../../js/apache-maven-fluido-1.9.min.js"></script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="http://www.apache.org/" id="bannerLeft"><img src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache"/></a></div>
+ <div class="pull-right"><a href="http://hc.apache.org/" id="bannerRight"><img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents"/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
+</li>
+ <li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
+ <li class="active ">Migration from Apache HttpClient 4.x APIs <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.1.x/migration-guide/preparation.md"><img src="../../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">HttpComponents</li>
+ <li><a href="../../index.html" title="Home"><span class="none"></span>Home</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../../downloads.cgi" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="../../mail.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li>
+ <li><a href="http://wiki.apache.org/HttpComponents/" class="externalLink" title="Wiki (external)"><span class="none"></span>Wiki (external)</a></li>
+ <li><a href="http://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Overview</li>
+ <li><a href="../../index.html" title="About"><span class="none"></span>About</a></li>
+ <li><a href="../../news.html" title="News"><span class="none"></span>News</a></li>
+ <li><a href="../../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
+ <li class="nav-header">Components</li>
+ <li><a href="../../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-right"></span>HttpClient 5.1</a></li>
+ <li><a href="../../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
+ <li><a href="../../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
+ <li><a href="../../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
+ <li><a href="../../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient 4.1"><span class="icon-chevron-right"></span>HttpAsyncClient 4.1</a></li>
+ <li class="nav-header">Legacy</li>
+ <li><a href="../../httpclient-legacy/index.html" title="Commons HttpClient"><span class="none"></span>Commons HttpClient</a></li>
+ <li class="nav-header">Project</li>
+ <li><a href="../../status.html" title="Status"><span class="none"></span>Status</a></li>
+ <li><a href="../../charter.html" title="Charter"><span class="none"></span>Charter</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org" class="externalLink" title="ASF Home Page"><span class="none"></span>ASF Home Page</a></li>
+ <li><a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsor Apache"><span class="none"></span>Sponsor Apache</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"><img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /></a>
+<a href="http://maven.apache.org/" title="Maven" class="builtBy"><img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<h1>Migration from Apache HttpClient 4.x APIs</h1>
+<p>It is strongly encouraged to follow the best practices and common use patterns in programming with Apache HttpClient 4.x. They remain largely unchanged between 4.x and 5.x release series. Correctly written code will be easier to port to 5.0 APIs and from the classic I/O model to the async I/O model.</p><section>
+<h2><a name="Preparation_steps"></a>Preparation steps</h2>
+<ol style="list-style-type: decimal">
+
+<li>
+
+<p>Make sure there are no references to deprecated functions or classes</p>
+</li>
+<li>
+
+<p>HttpClient uses tries to use sensible defaults but it is generally recommended to adjust SSL/TLS parameters and timeout settings for the specific application context.</p>
+</li>
+<li>
+
+<p>Explicitly specify TLSv1.2 in order to disable older, less secure versions of the SSL/TLS protocol. Please note HttpClient 4.5 disables all SSL versions by default.</p>
+</li>
+<li>
+
+<p>Set finite socket and connect timeouts.</p>
+</li>
+<li>
+
+<p>Set finite connection total time to live (TTL).</p>
+</li>
+<li>
+
+<p>Favor <code>standard</code> and <code>standard-strict</code> cookie policies.</p>
+</li>
+<li>
+
+<p>IMPORTANT: Always re-use <code>CloseableHttpClient</code> instances. They are expensive to create, but they are also fully thread safe, so multiple threads can use the same instance of <code>CloseableHttpClient</code> to execute multiple requests concurrently taking full advantage of persistent connection re-use and connection pooling.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">CloseableHttpClient client = HttpClients.custom()
+ .setSSLSocketFactory(new SSLConnectionSocketFactory(
+ SSLContexts.createSystemDefault(),
+ new String[] { "TLSv1.2" },
+ null,
+ SSLConnectionSocketFactory.getDefaultHostnameVerifier()))
+ .setConnectionTimeToLive(1, TimeUnit.MINUTES)
+ .setDefaultSocketConfig(SocketConfig.custom()
+ .setSoTimeout(5000)
+ .build())
+ .setDefaultRequestConfig(RequestConfig.custom()
+ .setConnectTimeout(5000)
+ .setSocketTimeout(5000)
+ .setCookieSpec(CookieSpecs.STANDARD_STRICT)
+ .build())
+ .build();
+</pre></div></div>
+</li>
+<li>
+
+<p>Cookie store and credentials providers can be shared by multiple execution threads. They can still be shared by multiple message exchnages without being set at <code>CloseableHttpClient</code> construction time.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">CookieStore cookieStore = new BasicCookieStore();
+CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
+</pre></div></div>
+</li>
+<li>
+
+<p>While <code>CloseableHttpClient</code> should have the default configuration applicable to all all messages exchanges one can use <code>HttpContext</code> to customize individual request execution parameters.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">HttpClientContext clientContext = HttpClientContext.create();
+clientContext.setCookieStore(cookieStore);
+clientContext.setCredentialsProvider(credentialsProvider);
+clientContext.setRequestConfig(RequestConfig.custom()
+ .setConnectTimeout(10000)
+ .setSocketTimeout(10000)
+ .setCookieSpec(CookieSpecs.STANDARD)
+ .build());
+</pre></div></div>
+</li>
+<li>
+
+<p>Always set content type and content encoding on the entity and let HttpClient generate request headers automatically.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">JsonFactory jsonFactory = new JsonFactory();
+ObjectMapper objectMapper = new ObjectMapper(jsonFactory);
+
+HttpPost httpPost = new HttpPost("https://httpbin.org/post");
+List<NameValuePair> requestData = Arrays.asList(
+ new BasicNameValuePair("name1", "value1"),
+ new BasicNameValuePair("name2", "value2"));
+
+EntityTemplate requestEntity = new EntityTemplate(outstream -> {
+ objectMapper.writeValue(outstream, requestData);
+ outstream.flush();
+
+});
+requestEntity.setContentType(ContentType.APPLICATION_JSON.toString());
+httpPost.setEntity(requestEntity);
+</pre></div></div>
+</li>
+<li>
+
+<p>Consume response content directly from the content stream and convert it to a higher level object without converting it to an intermediate string or byte array.</p>
+</li>
+<li>
+
+<p>Favor HTTP response handlers for response processing, thus making connection release automatic.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">JsonNode responseData = client.execute(httpPost, response -> {
+ if (response.getStatusLine().getStatusCode() >= 300) {
+ throw new ClientProtocolException(Objects.toString(response.getStatusLine()));
+ }
+ final HttpEntity responseEntity = response.getEntity();
+ if (responseEntity == null) {
+ return null;
+ }
+ try (InputStream inputStream = responseEntity.getContent()) {
+ return objectMapper.readTree(inputStream);
+ }
+});
+System.out.println(responseData);
+</pre></div></div>
+</li>
+<li><code>CloseableHttpClient</code> instances should be closed when no longer needed or about to go out of score.
+
+<div class="source">
+<div class="source"><pre class="prettyprint">client.close();
+</pre></div></div>
+</li>
+</ol></section>
+ </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2005–2021
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Modified: httpcomponents/site/httpcomponents-client-5.1.x/quickstart.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.1.x/quickstart.html?rev=1889789&r1=1889788&r2=1889789&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.1.x/quickstart.html (original)
+++ httpcomponents/site/httpcomponents-client-5.1.x/quickstart.html Wed May 12 08:01:10 2021
@@ -25,7 +25,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2021-05-05<span class="divider">|</span>
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
</li>
<li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
<li class="active ">HttpClient Quick Start <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.1.x/quickstart.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
@@ -49,18 +49,17 @@
<li><a href="../news.html" title="News"><span class="none"></span>News</a></li>
<li><a href="../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
<li class="nav-header">Components</li>
- <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1 BETA"><span class="icon-chevron-down"></span>HttpClient 5.1 BETA</a>
+ <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-down"></span>HttpClient 5.1</a>
<ul class="nav nav-list">
<li class="active"><a href="#"><span class="none"></span>Quick Start</a></li>
<li><a href="../httpcomponents-client-5.1.x/examples.html" title="Examples (Classic)"><span class="none"></span>Examples (Classic)</a></li>
<li><a href="../httpcomponents-client-5.1.x/examples-async.html" title="Examples (Async)"><span class="none"></span>Examples (Async)</a></li>
<li><a href="../httpcomponents-client-5.1.x/examples-reactive.html" title="Examples (Reactive)"><span class="none"></span>Examples (Reactive)</a></li>
- <li><a href="../httpcomponents-client-5.0.x/logging.html" title="Logging Guide"><span class="none"></span>Logging Guide</a></li>
- <li><a href="../httpcomponents-client-5.0.x/android.html" title="Android"><span class="none"></span>Android</a></li>
- <li><a href="../httpcomponents-client-5.0.x/related-projects.html" title="Related"><span class="none"></span>Related</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/logging.html" title="Logging Guide"><span class="none"></span>Logging Guide</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/android.html" title="Android"><span class="none"></span>Android</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/related-projects.html" title="Related"><span class="none"></span>Related</a></li>
<li><a href="../httpcomponents-client-5.1.x/download.html" title="Download"><span class="none"></span>Download</a></li>
</ul></li>
- <li><a href="../httpcomponents-client-5.0.x/index.html" title="HttpClient 5.0"><span class="icon-chevron-right"></span>HttpClient 5.0</a></li>
<li><a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
<li><a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
<li><a href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
@@ -114,11 +113,11 @@
<li>
-<p>Download ‘Binary’ package of the latest HttpClient 4.5 release or configure dependency on <code>HttpClient</code> and <code>Fluent HC</code> modules using a dependency manager of your choice as described <a href="download.html">here</a>.</p>
+<p>Download ‘Binary’ package of the latest HttpClient 5.1 release or configure dependency on <code>HttpClient</code> and <code>Fluent HC</code> modules using a dependency manager of your choice as described <a href="download.html">here</a>.</p>
</li>
<li>
-<p>HttpClient 5.0 requires Java 1.7 or newer.</p>
+<p>HttpClient 5.1 requires Java 1.7 or newer.</p>
</li>
<li>
@@ -159,7 +158,7 @@
</pre></div></div>
</li>
</ul>
-<p>Source can be found here <a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/QuickStart.java">here</a></p>
+<p>Source can be found here <a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/5.1.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/QuickStart.java">here</a></p>
<ul>
<li>The same requests can be executed using a simpler, albeit less flexible, fluent API.
@@ -176,7 +175,7 @@ Request.Post("http://targethost/log
</pre></div></div>
</li>
</ul>
-<p>Source can be downloaded <a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5-fluent/src/test/java/org/apache/hc/client5/http/examples/fluent/FluentQuickStart.java">here</a></p>
+<p>Source can be downloaded <a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/5.1.x/httpclient5-fluent/src/test/java/org/apache/hc/client5/http/examples/fluent/FluentQuickStart.java">here</a></p>
<ul>
<li>The below code fragment illustrates the execution of HTTP requests using HttpClient async API.
@@ -279,7 +278,7 @@ Request.Post("http://targethost/log
</pre></div></div>
</li>
</ul>
-<p>Source can be downloaded <a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncQuickStart.java">here</a></p>
+<p>Source can be downloaded <a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/5.1.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncQuickStart.java">here</a></p>
</main>
</div>
</div>
Added: httpcomponents/site/httpcomponents-client-5.1.x/related-projects.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.1.x/related-projects.html?rev=1889789&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.1.x/related-projects.html (added)
+++ httpcomponents/site/httpcomponents-client-5.1.x/related-projects.html Wed May 12 08:01:10 2021
@@ -0,0 +1,131 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-5.1.x/related-projects.md
+ | Rendered using Apache Maven Fluido Skin 1.9
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <title>Apache HttpComponents – Related projects</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <script src="../js/apache-maven-fluido-1.9.min.js"></script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="http://www.apache.org/" id="bannerLeft"><img src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache"/></a></div>
+ <div class="pull-right"><a href="http://hc.apache.org/" id="bannerRight"><img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents"/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
+</li>
+ <li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
+ <li class="active ">Related projects <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.1.x/related-projects.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">HttpComponents</li>
+ <li><a href="../index.html" title="Home"><span class="none"></span>Home</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../downloads.cgi" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="../mail.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li>
+ <li><a href="http://wiki.apache.org/HttpComponents/" class="externalLink" title="Wiki (external)"><span class="none"></span>Wiki (external)</a></li>
+ <li><a href="http://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Overview</li>
+ <li><a href="../index.html" title="About"><span class="none"></span>About</a></li>
+ <li><a href="../news.html" title="News"><span class="none"></span>News</a></li>
+ <li><a href="../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
+ <li class="nav-header">Components</li>
+ <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-down"></span>HttpClient 5.1</a>
+ <ul class="nav nav-list">
+ <li><a href="../httpcomponents-client-5.1.x/quickstart.html" title="Quick Start"><span class="none"></span>Quick Start</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/examples.html" title="Examples (Classic)"><span class="none"></span>Examples (Classic)</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/examples-async.html" title="Examples (Async)"><span class="none"></span>Examples (Async)</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/examples-reactive.html" title="Examples (Reactive)"><span class="none"></span>Examples (Reactive)</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/logging.html" title="Logging Guide"><span class="none"></span>Logging Guide</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/android.html" title="Android"><span class="none"></span>Android</a></li>
+ <li class="active"><a href="#"><span class="none"></span>Related</a></li>
+ <li><a href="../httpcomponents-client-5.1.x/download.html" title="Download"><span class="none"></span>Download</a></li>
+ </ul></li>
+ <li><a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
+ <li><a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
+ <li><a href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
+ <li><a href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient 4.1"><span class="icon-chevron-right"></span>HttpAsyncClient 4.1</a></li>
+ <li class="nav-header">Legacy</li>
+ <li><a href="../httpclient-legacy/index.html" title="Commons HttpClient"><span class="none"></span>Commons HttpClient</a></li>
+ <li class="nav-header">Project</li>
+ <li><a href="../status.html" title="Status"><span class="none"></span>Status</a></li>
+ <li><a href="../charter.html" title="Charter"><span class="none"></span>Charter</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org" class="externalLink" title="ASF Home Page"><span class="none"></span>ASF Home Page</a></li>
+ <li><a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsor Apache"><span class="none"></span>Sponsor Apache</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"><img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /></a>
+<a href="http://maven.apache.org/" title="Maven" class="builtBy"><img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<!--
+ 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.
+-->
+<h1>Related projects</h1><section>
+<h2><a name="Asynchronous_JSON_message_processors"></a>Asynchronous JSON message processors</h2>
+<p><a class="externalLink" href="https://ok2c.github.io/httpcomponents-jackson/">Asynchronous JSON message processors</a> library is a companion project for HttpClient 5.0 developed outside the Apache Software Foundation.</p>
+<p>The library provides a number of asynchronous message consumers and producers for efficient, reactive processing of HTTP messages with enclosed JSON content using <a class="externalLink" href="https://github.com/FasterXML/jackson">Jackson JSON processor</a>.</p></section><section>
+<h2><a name="Android_extensions"></a>Android extensions</h2>
+<p><a class="externalLink" href="https://ok2c.github.io/httpclient-android-ext/">Android extensions for Apache HttpClient 5.x</a> is a third party library that provides extra functionality simplifying application of Apache HttpClient on Google Android platform.</p></section>
+ </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2005–2021
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Added: httpcomponents/site/httpcomponents-client-5.2.x/download.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.2.x/download.html?rev=1889789&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.2.x/download.html (added)
+++ httpcomponents/site/httpcomponents-client-5.2.x/download.html Wed May 12 08:01:10 2021
@@ -0,0 +1,127 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-5.2.x/download.md
+ | Rendered using Apache Maven Fluido Skin 1.9
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <title>Apache HttpComponents – HttpClient Downloads</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <script src="../js/apache-maven-fluido-1.9.min.js"></script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="http://www.apache.org/" id="bannerLeft"><img src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache"/></a></div>
+ <div class="pull-right"><a href="http://hc.apache.org/" id="bannerRight"><img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents"/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
+</li>
+ <li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
+ <li class="active ">HttpClient Downloads <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.2.x/download.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">HttpComponents</li>
+ <li><a href="../index.html" title="Home"><span class="none"></span>Home</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../downloads.cgi" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="../mail.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li>
+ <li><a href="http://wiki.apache.org/HttpComponents/" class="externalLink" title="Wiki (external)"><span class="none"></span>Wiki (external)</a></li>
+ <li><a href="http://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Overview</li>
+ <li><a href="../index.html" title="About"><span class="none"></span>About</a></li>
+ <li><a href="../news.html" title="News"><span class="none"></span>News</a></li>
+ <li><a href="../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
+ <li class="nav-header">Components</li>
+ <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-right"></span>HttpClient 5.1</a></li>
+ <li><a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
+ <li><a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
+ <li><a href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
+ <li><a href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient 4.1"><span class="icon-chevron-right"></span>HttpAsyncClient 4.1</a></li>
+ <li class="nav-header">Legacy</li>
+ <li><a href="../httpclient-legacy/index.html" title="Commons HttpClient"><span class="none"></span>Commons HttpClient</a></li>
+ <li class="nav-header">Project</li>
+ <li><a href="../status.html" title="Status"><span class="none"></span>Status</a></li>
+ <li><a href="../charter.html" title="Charter"><span class="none"></span>Charter</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org" class="externalLink" title="ASF Home Page"><span class="none"></span>ASF Home Page</a></li>
+ <li><a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsor Apache"><span class="none"></span>Sponsor Apache</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"><img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /></a>
+<a href="http://maven.apache.org/" title="Maven" class="builtBy"><img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<!--
+ 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.
+-->
+<h1>HttpClient Downloads</h1>
+<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-5.2.x.txt">Release Notes</a> - <a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a></p><section>
+<h2><a name="Dependency_management"></a>Dependency management</h2>
+<p>If you are using a dependency manager for your project such as <a class="externalLink" href="https://maven.apache.org">Apache Maven</a>, <a class="externalLink" href="https://gradle.org/">Gradle</a> or <a class="externalLink" href="https://ant.apache.org/projects/ivy.html">Apache Ivy</a>, you can create a dependency on HttpClient modules by using this information:</p>
+<ul>
+
+<li><a class="externalLink" href="https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5">HttpClient</a></li>
+<li><a class="externalLink" href="https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-fluent">HttpClient Fluent</a></li>
+<li><a class="externalLink" href="https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-cache">HttpClient Cache</a></li>
+<li><a class="externalLink" href="https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-win">HttpClient Windows extensions</a></li>
+</ul></section>
+ </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2005–2021
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Added: httpcomponents/site/httpcomponents-client-5.2.x/examples-async.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.2.x/examples-async.html?rev=1889789&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.2.x/examples-async.html (added)
+++ httpcomponents/site/httpcomponents-client-5.2.x/examples-async.html Wed May 12 08:01:10 2021
@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-5.2.x/examples-async.md
+ | Rendered using Apache Maven Fluido Skin 1.9
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <title>Apache HttpComponents – HttpClient Examples (Async)</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <script src="../js/apache-maven-fluido-1.9.min.js"></script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="http://www.apache.org/" id="bannerLeft"><img src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache"/></a></div>
+ <div class="pull-right"><a href="http://hc.apache.org/" id="bannerRight"><img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents"/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
+</li>
+ <li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
+ <li class="active ">HttpClient Examples (Async) <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.2.x/examples-async.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">HttpComponents</li>
+ <li><a href="../index.html" title="Home"><span class="none"></span>Home</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../downloads.cgi" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="../mail.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li>
+ <li><a href="http://wiki.apache.org/HttpComponents/" class="externalLink" title="Wiki (external)"><span class="none"></span>Wiki (external)</a></li>
+ <li><a href="http://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Overview</li>
+ <li><a href="../index.html" title="About"><span class="none"></span>About</a></li>
+ <li><a href="../news.html" title="News"><span class="none"></span>News</a></li>
+ <li><a href="../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
+ <li class="nav-header">Components</li>
+ <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-right"></span>HttpClient 5.1</a></li>
+ <li><a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
+ <li><a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
+ <li><a href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
+ <li><a href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient 4.1"><span class="icon-chevron-right"></span>HttpAsyncClient 4.1</a></li>
+ <li class="nav-header">Legacy</li>
+ <li><a href="../httpclient-legacy/index.html" title="Commons HttpClient"><span class="none"></span>Commons HttpClient</a></li>
+ <li class="nav-header">Project</li>
+ <li><a href="../status.html" title="Status"><span class="none"></span>Status</a></li>
+ <li><a href="../charter.html" title="Charter"><span class="none"></span>Charter</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org" class="externalLink" title="ASF Home Page"><span class="none"></span>ASF Home Page</a></li>
+ <li><a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsor Apache"><span class="none"></span>Sponsor Apache</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"><img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /></a>
+<a href="http://maven.apache.org/" title="Maven" class="builtBy"><img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<!--
+ 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.
+-->
+<h1>HttpClient Examples (Async)</h1>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java">Asynchronous HTTP exchange</a></li>
+</ul>
+<p>This example demonstrates a basic asynchronous HTTP request / response exchange. Response content is buffered in memory for simplicity.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.java">Asynchronous HTTP exchange with content streaming</a></li>
+</ul>
+<p>This example demonstrates an asynchronous HTTP request / response exchange with a full content streaming.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientTlsAlpn.java">HTTP/2 ALPN support</a></li>
+</ul>
+<p>This example demonstrates how to avoid the illegal reflective access operation warning when running with Oracle JRE 9 or newer.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.java">Pipelined HTTP/1.1 exchanges</a></li>
+</ul>
+<p>This example demonstrates a pipelined execution of multiple HTTP/1.1 request / response exchanges. Response content is buffered in memory for simplicity.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2Multiplexing.java">Multiplexed HTTP/2 exchanges</a></li>
+</ul>
+<p>This example demonstrates a multiplexed execution of multiple HTTP/2 request / response exchanges. Response content is buffered in memory for simplicity.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientInterceptors.java">Request execution interceptors</a></li>
+</ul>
+<p>This example demonstrates how to insert custom request interceptor and an execution interceptor to the request execution chain.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.java">Message trailers</a></li>
+</ul>
+<p>This example demonstrates how to use a custom execution interceptor to add trailers to all outgoing request enclosing an entity..</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.java">Multiplexed HTTP/2 exchanges</a></li>
+</ul>
+<p>This example demonstrates handling of HTTP/2 message exchanges pushed by the server.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientAuthentication.java">Client authentication</a></li>
+</ul>
+<p>This example demonstrates execution of an HTTP request against a target site that requires user authentication.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.java">Custom SSL context</a></li>
+</ul>
+<p>This example demonstrates how to create secure connections with a custom SSL context.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.java">Connection eviction</a></li>
+</ul>
+<p>This example demonstrates how to evict expired and idle connections from the connection pool.</p>
+ </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2005–2021
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Added: httpcomponents/site/httpcomponents-client-5.2.x/examples-reactive.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.2.x/examples-reactive.html?rev=1889789&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.2.x/examples-reactive.html (added)
+++ httpcomponents/site/httpcomponents-client-5.2.x/examples-reactive.html Wed May 12 08:01:10 2021
@@ -0,0 +1,121 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-5.2.x/examples-reactive.md
+ | Rendered using Apache Maven Fluido Skin 1.9
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <title>Apache HttpComponents – HttpClient Examples (Async)</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <script src="../js/apache-maven-fluido-1.9.min.js"></script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="http://www.apache.org/" id="bannerLeft"><img src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache"/></a></div>
+ <div class="pull-right"><a href="http://hc.apache.org/" id="bannerRight"><img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents"/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
+</li>
+ <li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
+ <li class="active ">HttpClient Examples (Async) <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.2.x/examples-reactive.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">HttpComponents</li>
+ <li><a href="../index.html" title="Home"><span class="none"></span>Home</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../downloads.cgi" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="../mail.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li>
+ <li><a href="http://wiki.apache.org/HttpComponents/" class="externalLink" title="Wiki (external)"><span class="none"></span>Wiki (external)</a></li>
+ <li><a href="http://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Overview</li>
+ <li><a href="../index.html" title="About"><span class="none"></span>About</a></li>
+ <li><a href="../news.html" title="News"><span class="none"></span>News</a></li>
+ <li><a href="../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
+ <li class="nav-header">Components</li>
+ <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-right"></span>HttpClient 5.1</a></li>
+ <li><a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
+ <li><a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
+ <li><a href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
+ <li><a href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient 4.1"><span class="icon-chevron-right"></span>HttpAsyncClient 4.1</a></li>
+ <li class="nav-header">Legacy</li>
+ <li><a href="../httpclient-legacy/index.html" title="Commons HttpClient"><span class="none"></span>Commons HttpClient</a></li>
+ <li class="nav-header">Project</li>
+ <li><a href="../status.html" title="Status"><span class="none"></span>Status</a></li>
+ <li><a href="../charter.html" title="Charter"><span class="none"></span>Charter</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org" class="externalLink" title="ASF Home Page"><span class="none"></span>ASF Home Page</a></li>
+ <li><a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsor Apache"><span class="none"></span>Sponsor Apache</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"><img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /></a>
+<a href="http://maven.apache.org/" title="Maven" class="builtBy"><img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<!--
+ 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.
+-->
+<h1>HttpClient Examples (Async)</h1>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java">HTTP exchange with Reactive Streams</a></li>
+</ul>
+<p>This example demonstrates a reactive, full-duplex HTTP/1.1 message exchange using RxJava.</p>
+ </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2005–2021
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Added: httpcomponents/site/httpcomponents-client-5.2.x/examples.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.2.x/examples.html?rev=1889789&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.2.x/examples.html (added)
+++ httpcomponents/site/httpcomponents-client-5.2.x/examples.html Wed May 12 08:01:10 2021
@@ -0,0 +1,201 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-5.2.x/examples.md
+ | Rendered using Apache Maven Fluido Skin 1.9
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <title>Apache HttpComponents – HttpClient Examples (Classic)</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <script src="../js/apache-maven-fluido-1.9.min.js"></script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="http://www.apache.org/" id="bannerLeft"><img src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache"/></a></div>
+ <div class="pull-right"><a href="http://hc.apache.org/" id="bannerRight"><img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents"/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
+</li>
+ <li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
+ <li class="active ">HttpClient Examples (Classic) <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.2.x/examples.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">HttpComponents</li>
+ <li><a href="../index.html" title="Home"><span class="none"></span>Home</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../downloads.cgi" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="../mail.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li>
+ <li><a href="http://wiki.apache.org/HttpComponents/" class="externalLink" title="Wiki (external)"><span class="none"></span>Wiki (external)</a></li>
+ <li><a href="http://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Overview</li>
+ <li><a href="../index.html" title="About"><span class="none"></span>About</a></li>
+ <li><a href="../news.html" title="News"><span class="none"></span>News</a></li>
+ <li><a href="../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
+ <li class="nav-header">Components</li>
+ <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-right"></span>HttpClient 5.1</a></li>
+ <li><a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
+ <li><a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
+ <li><a href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
+ <li><a href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient 4.1"><span class="icon-chevron-right"></span>HttpAsyncClient 4.1</a></li>
+ <li class="nav-header">Legacy</li>
+ <li><a href="../httpclient-legacy/index.html" title="Commons HttpClient"><span class="none"></span>Commons HttpClient</a></li>
+ <li class="nav-header">Project</li>
+ <li><a href="../status.html" title="Status"><span class="none"></span>Status</a></li>
+ <li><a href="../charter.html" title="Charter"><span class="none"></span>Charter</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org" class="externalLink" title="ASF Home Page"><span class="none"></span>ASF Home Page</a></li>
+ <li><a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsor Apache"><span class="none"></span>Sponsor Apache</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"><img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /></a>
+<a href="http://maven.apache.org/" title="Maven" class="builtBy"><img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<!--
+ 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.
+-->
+<h1>HttpClient Examples (Classic)</h1>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientWithResponseHandler.java">Response handling</a></li>
+</ul>
+<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>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java">Manual connection release</a></li>
+</ul>
+<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>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConfiguration.java">HttpClient configuration</a></li>
+</ul>
+<p>This example demonstrates how to customize and configure the most common aspects of HTTP request execution and connection management.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientInterceptors.java">Request execution interceptors</a></li>
+</ul>
+<p>This example demonstrates how to insert custom request interceptor and an execution interceptor to the request execution chain.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAbortMethod.java">Abort method</a></li>
+</ul>
+<p>This example demonstrates how to abort an HTTP request before its normal completion.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAuthentication.java">Client authentication</a></li>
+</ul>
+<p>This example uses HttpClient to execute an HTTP request against a target site that requires user authentication.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientExecuteProxy.java">Request via a proxy</a></li>
+</ul>
+<p>This example demonstrates how to send an HTTP request via a proxy.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientProxyAuthentication.java">Proxy authentication</a></li>
+</ul>
+<p>A simple example showing execution of an HTTP request over a secure connection tunneled through an authenticating proxy.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.java">Chunk encoded POST</a></li>
+</ul>
+<p>This example shows how to stream out a request entity using chunk encoding.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomContext.java">Custom execution context</a></li>
+</ul>
+<p>This example demonstrates the use of a local HTTP context populated custom attributes.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientFormLogin.java">Form based logon</a></li>
+</ul>
+<p>This example demonstrates how HttpClient can be used to perform form-based logon.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.java">Threaded request execution</a></li>
+</ul>
+<p>An example that executes HTTP requests from multiple worker threads.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomSSL.java">Custom SSL context</a></li>
+</ul>
+<p>This example demonstrates how to create secure connections with a custom SSL context.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.java">Preemptive BASIC authentication</a></li>
+</ul>
+<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>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.java">Preemptive DIGEST authentication</a></li>
+</ul>
+<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>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ProxyTunnelDemo.java">Proxy tunnel</a></li>
+</ul>
+<p>This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy for an arbitrary protocol.</p>
+<ul>
+
+<li><a class="externalLink" href="https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultipartFormPost.java">Multipart encoded request entity</a></li>
+</ul>
+<p>This example shows how to execute requests enclosing a multipart encoded entity.</p>
+ </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2005–2021
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Added: httpcomponents/site/httpcomponents-client-5.2.x/index.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-client-5.2.x/index.html?rev=1889789&view=auto
==============================================================================
--- httpcomponents/site/httpcomponents-client-5.2.x/index.html (added)
+++ httpcomponents/site/httpcomponents-client-5.2.x/index.html Wed May 12 08:01:10 2021
@@ -0,0 +1,182 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.2 from src/site/markdown/httpcomponents-client-5.2.x/index.md
+ | Rendered using Apache Maven Fluido Skin 1.9
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.2" />
+ <title>Apache HttpComponents – HttpClient Overview</title>
+ <link rel="stylesheet" href="../css/apache-maven-fluido-1.9.min.css" />
+ <link rel="stylesheet" href="../css/site.css" />
+ <link rel="stylesheet" href="../css/print.css" media="print" />
+ <script src="../js/apache-maven-fluido-1.9.min.js"></script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="http://www.apache.org/" id="bannerLeft"><img src="http://www.apache.org/images/asf_logo_wide.gif" alt="Apache"/></a></div>
+ <div class="pull-right"><a href="http://hc.apache.org/" id="bannerRight"><img src="http://hc.apache.org/images/logos/httpcomponents.png" alt="HttpComponents"/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li id="publishDate">Last Published: 2021-05-12<span class="divider">|</span>
+</li>
+ <li class=""><a href="http://hc.apache.org/index.html" class="externalLink" title="HttpComponents">HttpComponents</a><span class="divider">/</span></li>
+ <li class="active ">HttpClient Overview <a href="https://github.com/apache/httpcomponents-website/tree/master/src/site/markdown/httpcomponents-client-5.2.x/index.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li class="pull-right"><a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="nav-header">HttpComponents</li>
+ <li><a href="../index.html" title="Home"><span class="none"></span>Home</a></li>
+ <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../downloads.cgi" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="../mail.html" title="Mailing Lists"><span class="none"></span>Mailing Lists</a></li>
+ <li><a href="http://wiki.apache.org/HttpComponents/" class="externalLink" title="Wiki (external)"><span class="none"></span>Wiki (external)</a></li>
+ <li><a href="http://www.apache.org/security/" class="externalLink" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Overview</li>
+ <li><a href="../index.html" title="About"><span class="none"></span>About</a></li>
+ <li><a href="../news.html" title="News"><span class="none"></span>News</a></li>
+ <li><a href="../get-involved.html" title="Get Involved"><span class="none"></span>Get Involved</a></li>
+ <li class="nav-header">Components</li>
+ <li><a href="../httpcomponents-client-5.1.x/index.html" title="HttpClient 5.1"><span class="icon-chevron-right"></span>HttpClient 5.1</a></li>
+ <li><a href="../httpcomponents-core-5.1.x/index.html" title="HttpCore 5.1"><span class="icon-chevron-right"></span>HttpCore 5.1</a></li>
+ <li><a href="../httpcomponents-client-4.5.x/index.html" title="HttpClient 4.5"><span class="icon-chevron-right"></span>HttpClient 4.5</a></li>
+ <li><a href="../httpcomponents-core-4.4.x/index.html" title="HttpCore 4.4"><span class="icon-chevron-right"></span>HttpCore 4.4</a></li>
+ <li><a href="../httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient 4.1"><span class="icon-chevron-right"></span>HttpAsyncClient 4.1</a></li>
+ <li class="nav-header">Legacy</li>
+ <li><a href="../httpclient-legacy/index.html" title="Commons HttpClient"><span class="none"></span>Commons HttpClient</a></li>
+ <li class="nav-header">Project</li>
+ <li><a href="../status.html" title="Status"><span class="none"></span>Status</a></li>
+ <li><a href="../charter.html" title="Charter"><span class="none"></span>Charter</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org" class="externalLink" title="ASF Home Page"><span class="none"></span>ASF Home Page</a></li>
+ <li><a href="http://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsor Apache"><span class="none"></span>Sponsor Apache</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy"><img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" /></a>
+<a href="http://maven.apache.org/" title="Maven" class="builtBy"><img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<!--
+ 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.
+-->
+<h1>HttpClient Overview</h1>
+<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>
+<h2><a name="Documentation"></a>Documentation</h2>
+<ol style="list-style-type: decimal">
+
+<li><a href="quickstart.html">Quick Start</a> - contains simple, complete examples of request execution with the classic, fluent and async APIs.</li>
+<li>Examples demonstrating some common as well as more complex use cases
+<ul>
+
+<li><a href="examples.html">HttpClient (classic APIs)</a></li>
+<li><a href="examples-async.html">HttpClient (async APIs)</a></li>
+<li><a href="examples-reactive.html">HttpClient (reactive APIs)</a></li>
+</ul>
+</li>
+<li>
+
+<p>Javadocs</p>
+<ul>
+
+<li><a href="./current/httpclient5/apidocs/">HttpClient</a></li>
+<li><a href="./current/httpclient5-fluent/apidocs/">HC Fluent</a></li>
+<li><a href="./current/httpclient5-cache/apidocs/">HttpClient Cache</a></li>
+<li><a href="./current/httpclient5-win/apidocs/">HttpClient Windows extensions</a></li>
+</ul>
+</li>
+<li>
+
+<p>API compatibility reports</p>
+<ul>
+
+<li><a href="./current/httpclient5/clirr-report.html">HttpClient</a></li>
+<li><a href="./current/httpclient5-fluent/clirr-report.html">HC Fluent</a></li>
+<li><a href="./current/httpclient5-cache/clirr-report.html">HttpClient Cache</a></li>
+<li><a href="./current/httpclient5-win/clirr-report.html">HttpClient Windows extensions</a></li>
+</ul>
+</li>
+</ol></section><section>
+<h2><a name="Features"></a>Features</h2>
+<ul>
+
+<li>Standards based, pure Java, implementation of HTTP versions 1.0, 1.1, 2.0</li>
+<li>Supports encryption with HTTPS (HTTP over SSL) protocol.</li>
+<li>Pluggable socket factories and TLS strategies.</li>
+<li>Transparent message exchanges through HTTP/1.1 and HTTP/1.0 proxies.</li>
+<li>Tunneled HTTPS connections through HTTP/1.1 and HTTP/1.0 proxies, via the CONNECT method.</li>
+<li>Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO, Kerberos authentication schemes.</li>
+<li>HTTP state management and cookie support.</li>
+<li>Flexible connection management and pooling.</li>
+<li>Support for HTTP response caching.</li>
+<li>Source code is freely available under the Apache License.</li>
+</ul></section><section>
+<h2><a name="Standards_Compliance"></a>Standards Compliance</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/rfc7540">RFC 7540</a> - Hypertext Transfer Protocol Version 2 (HTTP/2)</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc7541">RFC 7541</a> - HPACK: Header Compression for HTTP/2</li>
+<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/rfc1945">RFC 1945</a> - Hypertext Transfer Protocol – HTTP/1.0</li>
+<li><a class="externalLink" href="http://tools.ietf.org/html/rfc3986">RFC 3986</a> - Uniform Resource Identifier (URI): Generic Syntax</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>
+</ul></section>
+ </main>
+ </div>
+ </div>
+ <hr/>
+ <footer>
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <p>© 2005–2021
+<a href="https://www.apache.org/">The Apache Software Foundation</a>
+</p>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file