| <!-- |
| ==================================================================== |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| http://www.apache.org/licenses/LICENSE-2.0 |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| ==================================================================== |
| This software consists of voluntary contributions made by many |
| individuals on behalf of the Apache Software Foundation. For more |
| information on the Apache Software Foundation, please see |
| <http://www.apache.org />. |
| --> |
| Apache HttpComponents Client |
| ============================ |
| |
| Welcome to the HttpClient component of the Apache HttpComponents project. |
| |
| [](https://github.com/apache/httpcomponents-client/actions) |
| [](https://maven-badges.herokuapp.com/maven-central/org.apache.httpcomponents.client5/httpclient5) |
| [](https://opensource.org/licenses/Apache-2.0) |
| |
| Building Instructions |
| --------------------- |
| |
| For building from source instructions please refer to [BUILDING.txt](./BUILDING.txt). |
| |
| Dependencies |
| ------------ |
| |
| HttpClient main module requires Java 8 compatible runtime and |
| depends on the following external libraries: |
| |
| * [Apache HttpComponents HttpCore](https://github.com/apache/httpcomponents-core) |
| * [SLF4J API](http://www.slf4j.org/) |
| |
| Other dependencies are optional. |
| |
| (for detailed information on external dependencies please see [pom.xml](./pom.xml)) |
| |
| Protocol conformance |
| -------------------- |
| |
| - [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110) - HTTP Semantics |
| - [RFC 9111](https://datatracker.ietf.org/doc/html/rfc9111) - HTTP Caching |
| - [RFC 9112](https://datatracker.ietf.org/doc/html/rfc9112) - Hypertext Transfer Protocol Version 1.1 (HTTP/1.1) |
| - [RFC 9113](https://datatracker.ietf.org/doc/html/rfc9113) - Hypertext Transfer Protocol Version 2 (HTTP/2) |
| - [RFC 7541](https://datatracker.ietf.org/doc/html/rfc7541) - HPACK: Header Compression for HTTP/2 |
| - [RFC 1945](https://datatracker.ietf.org/doc/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0 |
| - [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986) - Uniform Resource Identifier (URI): Generic Syntax |
| - [RFC 6265](https://datatracker.ietf.org/doc/html/rfc6265) - HTTP State Management Mechanism (Cookies) |
| - [RFC 7616](https://datatracker.ietf.org/doc/html/rfc7616) - HTTP Digest Access Authentication |
| - [RFC 7617](https://datatracker.ietf.org/doc/html/rfc7617) - HTTP 'Basic' Authentication Scheme |
| - [RFC 5861](https://datatracker.ietf.org/doc/html/rfc5861) - HTTP Cache-Control Extensions for Stale Content |
| - [RFC 2817](https://datatracker.ietf.org/doc/html/rfc2817) - Upgrading to TLS Within HTTP/1.1 |
| - [RFC 9218](https://datatracker.ietf.org/doc/html/rfc9218) - Extensible Prioritization Scheme for HTTP |
| - [RFC 7804](https://datatracker.ietf.org/doc/html/rfc7804) - Salted Challenge Response HTTP Authentication Mechanism |
| |
| Licensing |
| --------- |
| |
| Apache HttpComponents Client is licensed under the Apache License 2.0. |
| See the files [LICENSE.txt](./LICENSE.txt) and [NOTICE.txt](./NOTICE.txt) for more information. |
| |
| Contact |
| ------- |
| |
| - For general information visit the main project site at |
| https://hc.apache.org/ |
| - For current status information visit the status page at |
| https://hc.apache.org/status.html |
| - If you want to contribute visit |
| https://hc.apache.org/get-involved.html |
| |
| Cryptographic Software Notice |
| ----------------------------- |
| |
| This distribution may include software that has been designed for use |
| with cryptographic software. The country in which you currently reside |
| may have restrictions on the import, possession, use, and/or re-export |
| to another country, of encryption software. BEFORE using any encryption |
| software, please check your country's laws, regulations and policies |
| concerning the import, possession, or use, and re-export of encryption |
| software, to see if this is permitted. See https://www.wassenaar.org/ |
| for more information. |
| |
| The U.S. Government Department of Commerce, Bureau of Industry and |
| Security (BIS), has classified this software as Export Commodity |
| Control Number (ECCN) 5D002.C.1, which includes information security |
| software using or performing cryptographic functions with asymmetric |
| algorithms. The form and manner of this Apache Software Foundation |
| distribution makes it eligible for export under the License Exception |
| ENC Technology Software Unrestricted (TSU) exception (see the BIS |
| Export Administration Regulations, Section 740.13) for both object |
| code and source code. |
| |
| The following provides more details on the included software that |
| may be subject to export controls on cryptographic software: |
| |
| > Apache HttpComponents Client interfaces with the |
| > Java Secure Socket Extension (JSSE) API to provide |
| > - HTTPS support |
| > |
| > Apache HttpComponents Client does not include any |
| > implementation of JSSE. |
