__     __   __                       __ _               __ 
   / /_   / /_ / /_ ____          _____ / /(♥)___   ____   / /_
  / __ \ / __// __// __ \ ______ / ___// // // _ \ / __ \ / __/
 / / / // /_ / /_ / /_/ //_____// /__ / // //  __// / / // /_  
/_/ /_/ \__/ \__// .___/        \___//_//_/ \___//_/ /_/ \__/  
                /_/                                                                   

http-client

本项目是一个开发一个高稳定性与高性能的 HTTP 客户端，可在多平台使用。

整体架构如下：

解析一下整个架构：

• 最上方是对外的API接口。

• 接着就是client管理器，实现了client pool，在使用的时候从池中取出client，用完就放回，用户基本不需要直接解除client实例，实现了基本的HTTP方法，如GET/POST等，还实现了url解析器，解析用户传入的url。

• 预留了工作队列接口（即将实现）。

• intercept是拦截器，比如实现HTTP请求、HTTP应答等，还要依赖HTTP报文的结构，主要的处理工作是通过上层传入的参数去设置网络信息（host、port等），与服务器建立连接、重连，发起HTTP请求、解析来自服务器的响应报文，自动处理重定向及其他操作，而保证这些操作能完成的需要基础组件，通用的字符串处理、事件的回调处理、HTTP的通用信息等，最下方的read and write则是与network打交道的。

• network是网络组件，它可以自动选择数据通道，如果是加密方式则通过tls进行数据传输，而tls可以选择mbedtls作为加密后端也可以选择openssl作为加密后端；也可以是tcp直连方式，最终都是通过tcp传输的，此外还实现了本地的routing（或者叫dns缓存吧）。

• platform是平台抽象层，封装了不同系统的东西，比如socke或者AT，线程、时间、互斥锁、内存管理，这些是与系统打交道的，也是跨平台必要的封装。

• 最右边的则是通用的内容，list的处理、日志库、错误处理、软件随机数发生器等。

文档说明

欢迎各位朋友参与进来开发，所有的功能实现都有详细的文档介绍，大家可以选择开发计划中的项目进行开发、探讨、提交PR，也欢迎大家提交功能需求，本项目将由 杰杰 持续维护。

• 开发计划

• 平台抽象层—内存管理

• 平台抽象层—时间管理

• 平台抽象层—线程管理

• 平台抽象层—互斥锁

• 平台抽象层—socket

• 平台抽象层—tcp直连

• 平台抽象层—tls加密传输

• 路由

• network网卡

• 基础组件功能

• 通用组件功能

• HTTP回调事件

• url解析器

• HTTP报文处理

• HTTP请求

• HTTP响应

• 拦截器

• http-client

• 如何提交PR？

测试代码 & 文档

• url解析测试

• get方法测试

• post方法测试

• 重定向测试

• 获取文件测试

参与开发

• 平台：任何linux平台，目前先暂时开发linux平台的，后续适配其他平台。

安装cmake

sudo apt-get install -y cmake

编译

编写好相关的功能后进行编译并测试，main 函数入口在 test/test.c 文件中。

./build.sh

产生的可执行文件在 ./build/bin/http-client 路径下。

运行

 ./build/bin/http-client

观察测试结果，满足要求后提交PR。

如何提交PR？

问题

欢迎以 GitHub Issues 的形式提交功能需求、问题和bug报告等。

版权和许可

http-client 遵循 Apache License v2.0 开源协议。鼓励代码共享和尊重原作者的著作权，可以自由的使用、修改源代码，也可以将修改后的代码作为开源或闭源软件发布。

Star & Fork

后续我还会提供更多开源项目。也非常欢迎大家设计、开发更多实用插件和功能，一起来完善 http-client。如果觉得这个开源项目很赞，可以点击项目主页 右上角的 Star & Fork ，同时把它推荐给更多有需要的朋友。