• Stars
    star
    176
  • Rank 216,987 (Top 5 %)
  • Language
    C
  • License
    Apache License 2.0
  • Created almost 5 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A high-performance, high-stability, cross-platform HTTP client.

C/C++ CI issues forks stars license

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

http-client

本项目是一个高稳定性与高性能的 HTTP 客户端,可在多平台使用,拥有极简的 API 接口。

整体架构如下:

http-client架构

解析一下整个架构:

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

  • 接着就是 client 管理器,通过池化技术实现了 client pool,在使用的时候从池中取出 client,用完就放回,用户基本不需要直接接触 client 实例,实现了基本的 HTTP 方法,如 GET/POST 等,还实现了 url 解析器,解析用户传入的 url,生成合适的参数递交给拦截器。

  • 实现工作队列,进行异步处理,在 CPU 支持多核的情况下,根据 CPU 的最大支持线程数量创建多个线程处理,将所有来自上层的请求按顺序放入工作队列,并行处理。

  • 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 列表的处理、日志库错误代码软件随机数发生器 等。

版本

发布版本 描述
[v1.0.0] 初次发布,完成基本架构的及其稳定性验证

文档说明

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

测试代码 & 文档

参与开发

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

安装 cmake 及编译器

sudo apt-get install -y cmake gcc g++

编译

编写好相关的功能后进行编译并测试,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,同时把它推荐给更多有需要的朋友。

感谢参与贡献的开发者

More Repositories

1

mqttclient

A high-performance, high-stability, cross-platform MQTT client, developed based on the socket API, can be used on embedded devices (FreeRTOS / LiteOS / RT-Thread / TencentOS tiny), Linux, Windows, Mac, with a very concise The API interface realizes the quality of service of QOS2 with very few resources, and seamlessly connects the mbedtls encryption library.
C
625
star
2

ButtonDrive

纯C语言实现的一个按键驱动,可移植性强,支持单双击、连按、连按释放、长按;采用回调处理按键事件(自定义消抖时间),使用只需3步,1:创建按键,2:按键事件与回调处理函数链接映射。然后周期检查按键。
C
325
star
3

cmd-parser

一个非常简单好用的命令解析器,占用资源极少极少,采用哈希算法超快匹配命令!
C
306
star
4

DoraOS

DoraOS 是我个人所写的RTOS内核,结合FreeRTOS、uCOS, RT-Thread, LiteOS 的特性所写,取其精华,去其糟粕,本项目将持续维护,欢迎大家fork与star。
C
142
star
5

TencentOS-Demo

这是在野火stm32f103开发板上移植的TencentOS tiny 例程,带图文教程与视频教程
C
106
star
6

kawaii-mqtt

基于socket API的MQTT客户端,以极少的资源实现qos2服务质量,并且实现mbedtls支持,此仓库是专门为RT-Thread做的软件包,原始仓库位于:https://github.com/jiejieTop/mqttclient
C
64
star
7

libuv-learning-code

libuv系列教程的配套代码,从0到深度了解libuv的框架与使用。
C
28
star
8

stm32_kfifo

基于Linux的kfifo移植到STM32
C
26
star
9

salof

Synchronous Asynchronous Log Output Framework(同步异步日志输出框架)
C
19
star
10

wx-mqtt

MQTT客户端-微信小程序源码,使用ColorUI!
JavaScript
17
star
11

freertos-mqttclient

a demo of mqttclient on freertos platform,https://github.com/jiejieTop/mqttclient
C
17
star
12

STM32F1_Demo

STM32F1_DEMO is a project demo based on the EmbedFire stm32Ba Dao development version.
C
16
star
13

LwIP_2.1.2_Comment

LwIP 2.1.2 版本的源码中文注释
C
14
star
14

xiexiren_ppt

谢希仁老师的计算机网络PPT讲义
13
star
15

Serial

基于C#的串口调试助手
C#
7
star
16

rtpkg_button

rtt packages button drive
C
6
star
17

online-mqtt-tool

一个在线mqtt代码生成工具,https://jiejietop.github.io/online-mqtt-tool
JavaScript
5
star
18

doralib

Easy to use C++ library
C++
5
star
19

i.mx6ul_board

This is an linux demo code for the i.mx6ul development board.
C
5
star
20

LwIP_Demo

LwIP-Demo
C
4
star
21

linux_learn

This is my repository for learning Linux.
C
4
star
22

RT-Thread_Demo

RT-Thread在STM32F1的移植Demo
C
3
star
23

Qt-Demo

This is my demo of learning Qt 5.12
C++
3
star
24

book

这是一个存放计算机相关书籍的仓库
3
star
25

mqttclient-demo

多个开发板中的MQTT客户端demo程序,支持多个平台。
Batchfile
3
star
26

http_server

my http server source!
C
2
star
27

c-plus-plus

record my c++ learning
C++
2
star
28

linux-script-tools

some linux script tools
Shell
2
star
29

WeChat_APP

WeChat APP learning
JavaScript
2
star
30

cross-compiling-scripts

some scripts tocross-compiling the base library.
Shell
2
star
31

Fire_LiteOS

华为LiteOS在野火开发板上的移植实验
C
2
star
32

cmake

学习cmake
CMake
2
star
33

RT_Thread_PPT

RT_Thread_PPT
1
star
34

LiteOS_Demo

LiteOS_Demo
C
1
star
35

linux-network

this is the network programming code under linux
Makefile
1
star
36

kawaii-http

C
1
star
37

gokit3-board-mqttclient

机智云gokit3开发板的mqttclient demo,使用TencentOS tiny的AT框架,RAM占用不足15k。
C
1
star
38

Balance-car

平衡直立车设计
1
star
39

pyqt5

这是一个pyqt5的终端监控小工程
Python
1
star
40

FreeRTOS-Demo

FreeRTOS在野火stm32上的移植
C
1
star