Node.js HTTP 解析器 llhttp 的使用

开发 前端
llhttp 是 Node.js 的 HTTP 1.1 解析器,用于替代早期的http_parser,性能上有了非常大的提升,最近打算在 No.js 里引入 llhttp 来处理 HTTP 协议的解析,本文简单介绍一下如何使用。

[[427068]]

llhttp 是 Node.js 的 HTTP 1.1 解析器,用于替代早期的http_parser,性能上有了非常大的提升,最近打算在 No.js 里引入 llhttp 来处理 HTTP 协议的解析,本文简单介绍一下如何使用。

llhttp 项目是 Node.js 中的子项目,地址在:

https://github.com/nodejs/llhttp。

使用步骤如下:

1. 安装 npx:npm i npx -g

2. 执行 ts 生成 c 代码:npx ts-node bin/generate.ts,或者执行 make generate

3. 这时候build 目录下生成了 llhttp.h 和 llhttp.c,再加上 native 下的 c 代码,就是 llhttp 的全部代码,我们可以把他复制到自己的项目中使用

下面看看如何使用。llhttp 使用回调钩子的设计思想,初始化解析器的时候,我们可以设置解析类型,是请求或响应报文,然后设置解析状态的回调,比如解析道 URL 时回调,解析到 header 时回调。接着传入报文执行 llhttp_execute 就可以,下面是解析请求报文的例子。

  1. #include <stdio.h> 
  2. #include <string.h> 
  3. #include "llhttp.h" 
  4. #define MAX_LEN 2048 
  5. int on_message_begin(llhttp_t* parser){ 
  6.     printf("parse start\n"); 
  7.     return 0; 
  8.  
  9. int on_url(llhttp_t* parser, const charat, size_t length){ 
  10.     char url[MAX_LEN]; 
  11.     strncpy(url, at, length); 
  12.     url[length] = '\0'
  13.     printf("on_url: %s\n", url); 
  14.     return 0; 
  15.  
  16. int on_header_field(llhttp_t* parser, const charat, size_t length){ 
  17.     char header_field[MAX_LEN]; 
  18.     strncpy(header_field, at, length); 
  19.     header_field[length] = '\0'
  20.     printf("head field: %s\n", header_field); 
  21.     return 0; 
  22.  
  23. int on_header_value(llhttp_t* parser, const charat, size_t length){ 
  24.     char header_value[MAX_LEN]; 
  25.     strncpy(header_value, at, length); 
  26.     header_value[length] = '\0'
  27.     printf("head value: %s\n", header_value); 
  28.     return 0; 
  29.  
  30. int on_headers_complete(llhttp_t* parser){ 
  31.     printf("on_headers_complete, major: %d, major: %d, keep-alive: %d, upgrade: %d\n", parser->http_major, parser->http_minor, llhttp_should_keep_alive(parser), parser->upgrade); 
  32.     return 0; 
  33.  
  34. int on_body(llhttp_t* parser, const charat, size_t length){ 
  35.     char body[MAX_LEN]; 
  36.     strncpy(body, at, length); 
  37.     body[length] = '\0'
  38.     printf("on_body: %s\n", body); 
  39.     return 0; 
  40.  
  41. int on_message_complete(llhttp_t* parser){ 
  42.     printf("on_message_complete\n"); 
  43.     return 0; 
  44.  
  45. int main(){ 
  46.     llhttp_t parser; 
  47.     llhttp_settings_t settings; 
  48.     llhttp_settings_init(&settings); 
  49.     llhttp_init(&parser, HTTP_REQUEST, &settings); 
  50.  
  51.     settings.on_message_begin = on_message_begin; 
  52.     settings.on_url = on_url; 
  53.     settings.on_header_field = on_header_field; 
  54.     settings.on_header_value = on_header_value; 
  55.     settings.on_headers_complete = on_headers_complete; 
  56.     settings.on_body = on_body; 
  57.     settings.on_message_complete = on_message_complete; 
  58.  
  59.     const char* request = "POST /index.html HTTP/1.1\r\nconnection:close\r\ncontent-length: 1\r\n\r\n1\r\n\r\n"
  60.     int request_len = strlen(request); 
  61.  
  62.     enum llhttp_errno err = llhttp_execute(&parser, request, request_len); 
  63.      
  64.     if (err != HPE_OK) { 
  65.         fprintf(stderr, "Parse error: %s %s\n", llhttp_errno_name(err), 
  66.         parser.reason); 
  67.     } 
  68.  
  69.  
  70.     return 0; 

接着看解析响应的例子。

  1. #include <stdio.h> 
  2. #include <string.h> 
  3. #include "llhttp.h" 
  4. #define MAX_LEN 2048 
  5. int on_message_begin(llhttp_t* parser){ 
  6.     printf("parse start\n"); 
  7.     return 0; 
  8.  
  9. int on_url(llhttp_t* parser, const charat, size_t length){ 
  10.     char url[MAX_LEN]; 
  11.     strncpy(url, at, length); 
  12.     url[length] = '\0'
  13.     printf("on_url: %s\n", url); 
  14.     return 0; 
  15.  
  16. int on_status(llhttp_t* parser, const charat, size_t length){ 
  17.     char status[MAX_LEN]; 
  18.     strncpy(status, at, length); 
  19.     status[length] = '\0'
  20.     printf("on_status: %s\n", status); 
  21.     return 0; 
  22.  
  23. int on_header_field(llhttp_t* parser, const charat, size_t length){ 
  24.     char header_field[MAX_LEN]; 
  25.     strncpy(header_field, at, length); 
  26.     header_field[length] = '\0'
  27.     printf("head field: %s\n", header_field); 
  28.     return 0; 
  29.  
  30. int on_header_value(llhttp_t* parser, const charat, size_t length){ 
  31.     char header_value[MAX_LEN]; 
  32.     strncpy(header_value, at, length); 
  33.     header_value[length] = '\0'
  34.     printf("head value: %s\n", header_value); 
  35.     return 0; 
  36.  
  37. int on_headers_complete(llhttp_t* parser){ 
  38.     printf("on_headers_complete, major: %d, major: %d, keep-alive: %d, upgrade: %d\n", parser->http_major, parser->http_minor, llhttp_should_keep_alive(parser), parser->upgrade); 
  39.     return 0; 
  40.  
  41. int on_body(llhttp_t* parser, const charat, size_t length){ 
  42.     char body[MAX_LEN]; 
  43.     strncpy(body, at, length); 
  44.     body[length] = '\0'
  45.     printf("on_body: %s\n", body); 
  46.     return 0; 
  47.  
  48. int on_message_complete(llhttp_t* parser){ 
  49.     printf("on_message_complete\n"); 
  50.     return 0; 
  51.  
  52. int main(){ 
  53.     llhttp_t parser; 
  54.     llhttp_settings_t settings; 
  55.     llhttp_settings_init(&settings); 
  56.     llhttp_init(&parser, HTTP_RESPONSE, &settings); 
  57.  
  58.     settings.on_message_begin = on_message_begin; 
  59.     settings.on_url = on_url; 
  60.     settings.on_status = on_status; 
  61.     settings.on_header_field = on_header_field; 
  62.     settings.on_header_value = on_header_value; 
  63.     settings.on_headers_complete = on_headers_complete; 
  64.     settings.on_body = on_body; 
  65.     settings.on_message_complete = on_message_complete; 
  66.  
  67.     const char* reponse = "HTTP/1.1 200 OK\r\nServer: nginx\r\ncontent-length: 11\r\n\r\nhello:world\r\n\r\n"
  68.     int reponse_len = strlen(reponse); 
  69.  
  70.     enum llhttp_errno err = llhttp_execute(&parser, reponse, reponse_len); 
  71.      
  72.     if (err != HPE_OK) { 
  73.         fprintf(stderr, "Parse error: %s %s\n", llhttp_errno_name(err), 
  74.         parser.reason); 
  75.     } 
  76.  
  77.  
  78.     return 0; 

llhttp 目前支持以下钩子回调。

  1. struct llhttp_settings_s { 
  2.   /* Possible return values 0, -1, `HPE_PAUSED` */ 
  3.   llhttp_cb      on_message_begin; 
  4.  
  5.   /* Possible return values 0, -1, HPE_USER */ 
  6.   llhttp_data_cb on_url; 
  7.   llhttp_data_cb on_status; 
  8.   llhttp_data_cb on_header_field; 
  9.   llhttp_data_cb on_header_value; 
  10.  
  11.   /* Possible return values
  12.    * 0  - Proceed normally 
  13.    * 1  - Assume that request/response has no body, and proceed to parsing the 
  14.    *      next message 
  15.    * 2  - Assume absence of body (as above) and make `llhttp_execute()` return 
  16.    *      `HPE_PAUSED_UPGRADE` 
  17.    * -1 - Error 
  18.    * `HPE_PAUSED` 
  19.    */ 
  20.   llhttp_cb      on_headers_complete; 
  21.  
  22.   /* Possible return values 0, -1, HPE_USER */ 
  23.   llhttp_data_cb on_body; 
  24.  
  25.   /* Possible return values 0, -1, `HPE_PAUSED` */ 
  26.   llhttp_cb      on_message_complete; 
  27.  
  28.   /* When on_chunk_header is called, the current chunk length is stored 
  29.    * in parser->content_length. 
  30.    * Possible return values 0, -1, `HPE_PAUSED` 
  31.    */ 
  32.   llhttp_cb      on_chunk_header; 
  33.   llhttp_cb      on_chunk_complete; 
  34.  
  35.   /* Information-only callbacks, return value is ignored */ 
  36.   llhttp_cb      on_url_complete; 
  37.   llhttp_cb      on_status_complete; 
  38.   llhttp_cb      on_header_field_complete; 
  39.   llhttp_cb      on_header_value_complete;}; 

我们也可以以静态库或动态库的方式使用 llhttp。执行 make all 就会在 build 目录下生成静态和动态库,我们把头文件 llhttp.h 和 静态库或动态库复制到自己项目里使用就可以,编译的时候加上 -lllhttp -L.。

 

总结:llhttp 的使用上还算比较简单清晰,如果我们项目里需要解析 HTTP 协议的话可以试试,使用 demo 可以参考 https://github.com/theanarkh/llhttp-demo。

 

责任编辑:武晓燕 来源: 编程杂技
相关推荐

2023-06-30 23:25:46

HTTP模块内存

2017-08-17 13:56:30

JavascriptNode.jsHttp

2014-11-04 09:54:00

Node.jsWeb

2022-08-28 16:30:34

Node.jsDocker指令

2020-12-08 06:28:47

Node.js异步迭代器

2014-09-12 10:35:09

Node.jsHTTP 206

2023-01-10 14:11:26

2013-11-01 09:34:56

Node.js技术

2016-09-18 16:04:24

HTTPNode应用

2015-03-10 10:59:18

Node.js开发指南基础介绍

2021-03-04 23:12:57

Node.js异步迭代器开发

2020-02-25 12:27:59

Node.jsWeb开发前端

2017-04-24 08:31:26

Node.jsExpress.jsHTTP

2020-05-29 15:33:28

Node.js框架JavaScript

2021-01-14 10:48:34

Docker CompNode.js开发

2021-11-11 11:13:20

js Npm基础

2021-10-23 06:42:46

Node.js 抓取堆快照.js

2012-02-03 09:25:39

Node.js

2021-12-25 22:29:57

Node.js 微任务处理事件循环

2021-03-03 06:39:05

Nodejs前端开发
点赞
收藏

51CTO技术栈公众号