lua web快速开发指南(4) - 详细了解httpd库的作用

ChristmasBoy 发布于2019-08-05 17:19 / 2923人阅读

摘要：库是基于协议实现而来内置了高性能的协议解析器与解析库库默认情况下就能工作的很好但是在一些需求较为极端的场景还是需要微调一下参数常用的内置方法介绍设置每个连接到最大空闲连接等待时间超过这个数值将主动断开连接默认值为秒设置的最大长度超过这个值将

httpd库是基于HTTP 1.1协议实现而来, 内置了高性能的http协议解析器与urldecode解析库.

httpd库默认情况下就能工作的很好, 但是在一些需求较为极端的场景还是需要微调一下参数.

httpd常用的内置方法介绍 1. httpd:timeout(number)

设置每个连接到最大空闲(idle)连接等待时间, 超过这个数值httpd将主动断开连接. (默认值为:30秒)

2. httpd:max_path_size(number)

设置Path的最大长度, 超过这个值httpd将会返回414. (默认值为: 1024)

3. httpd:max_header_size(number)

设置Header最大长度, 超过这个值httpd将会返回431. (默认值为: 65535)

4. httpd:max_body_size(number)

设置Body的最大长度, 超过这个值将会返回413. (默认为 1024 * 1024)

5. httpd:before(function)

before方法决定API与USE路由回调在触发之前的行为, 默认情况下允许所有路由通过.

before方法一般用来设置与修改用户验证路由行为(例如头部验证), 这提供了开发者基于before函数设计中间件的机会.

当开发者设置了function后(即是是一个空函数), 需要利用http库来决定行为.

6. httpd:group(type, prefix, handles)

group方法提供了一种批量注册路由的方式, 为一组同一组路由提供简单便方便在注册方法.

第一个参数type为需要批量注册的路由类型; 初始化httpd对象后, 使用app.USE或app.API进行传值;

第二个参数prefix为string类型的头部; 例如:/api、/admin;

第三个参数为一组路由处理函数或处理类数组; 类型为: {route = "/login", class = class};

注意: 此方法仅支持批量注册API与USE路由, 不可同时注册不同类型路由;

7. httpd:static(folder, ttl)

listen方法用于告诉httpd对象监听指定端口.

第一个参数ip暂未被httpd使用(但是必须设置), 默认监听所有网卡的"0.0.0.0"地址与指定的端口号;

backlog为用户最大连接等待队列, 合理的设置能减少连接被重置的情况(默认值为128).

8. httpd:run()

在httpd库所有参数与路由设置完毕之后, 调用run方法开启监听模式.

httpd的请求日志

日志格式为: [年/月/日时:分:秒] - [ip] - [x-real-ip] - [path] - [method] - [http code] - [request handle timeline]

httpd的中间件

httpd库提供了before方法, 为开发人员自定义"中间件"行为提供了可能. 具体使用方法请参考http库.

http content

每个http请求都会在调用before与用户注册的路由时为其传入一个content, 这个Content是客户端请求的所有参数.

args : 支持标准get或者post的参数, 对a[1]=1&a[2]=2将会不会解析为数组类型; 支持multipart/form-data的参数传递方式;

header: 原始header key-value表, 框架层不会进行header进行内容解析. (一般情况下没这个必要);

body : 目前body支持这些类型: multipart/form-data、application/x-www-form-urlencoded、application/json、application/xml;

json/xml: 在body为json类型的时候, content的json属性为true; 在body为xml类型的时候, content的xml属性为true.

file : 当客户端使用multipart/form-data传递数据时将会有这个属性; 这个属性是数组类型;

继续学习

一下章我们一起学习如何利用template库构建httpd模板引擎

idc机房托管专线服务 web快速开发工具快速了解ca证书 erlang 使用httpd搭建web服务器 web服务器作用

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/59543.html

lua web快速开发指南(2) - cf的运行机制简介与基于httpd库的开发环境搭建

摘要：从本章开始假设大家都熟悉语法运行流程在上一章节学会了如何安装后本章节就会介绍到运行机制与的搭建是一个非常典型的基于协程的事件驱动开发框架在封装成后可以依赖事件循环执行一套稳定运行时环境而本身提供了强大的数据结构可以根据需要自行构建所谓的所以从本章开始假设大家都熟悉lua语法. 运行流程在上一章节学会了如何安装cf后, 本章节就会介绍cf到运行机制与httpd的server搭建! c...

Batkid 2019-08-05 17:19 评论0 收藏0
lua web快速开发指南(1) - 初识cf框架

摘要：作者水果糖的小铺子是什么全称为一个基于事件驱动与协程的高性能网络框架目前主要面向开发内部主要实现了包括与协议的利用轻量级协程可以很轻松保持成千上万的长连接内置了丰富的开发库与常见的第三方协议目前在快速开发业务原型上有不可比拟的优势的代码与封作者: 水果糖的小铺子(CandyMi) cf是什么? cf全称为: CoreFramework. 一个基于Reactor事件驱动与协程的lua高...

Cheng_Gang 2019-08-05 17:17 评论0 收藏0
lua web快速开发指南(3) - 初识httpd库路由

摘要：本章假设您已经知道如何快速搭建并且知道的启动流程与运行流程知晓如何创建与启动回顾上一章节我们利用内置库快速实现了一套静态文件其中包括静态文件目录指定与端口设置并且在启动后可以在看到测试页面什么是路由与路由表路由用于描述资源到处理函数之间本章假设您已经知道httpd server如何快速搭建, 并且知道cf的启动流程与运行流程, 知晓httpd如何创建与启动. 回顾上一章节 -- sc...

zr_hebo 2019-08-05 17:19 评论0 收藏0
lua web快速开发指南(6) - Cache、DB介绍

摘要：数据库与缓存的基本概念数据库与缓存是服务端开发人员的必学知识点数据库数据库是一种信息记录存取的虚拟标记地点的集合统称比如现实生活中我们经常会用到文件柜书桌等等数据存取容器在对容器进行数据存取的时候我们会为每一层打上一个标签表示一种分类项而这数据库与缓存的基本概念数据库与缓存是服务端开发人员的必学知识点. 数据库数据库是一种信息记录、存取的虚拟标记地点的集合统称. 比如现实生活中,...

daryl 2019-08-01 14:01 评论0 收藏0
lua web快速开发指南(6) - Cache、DB介绍

摘要：数据库与缓存的基本概念数据库与缓存是服务端开发人员的必学知识点数据库数据库是一种信息记录存取的虚拟标记地点的集合统称比如现实生活中我们经常会用到文件柜书桌等等数据存取容器在对容器进行数据存取的时候我们会为每一层打上一个标签表示一种分类项而这数据库与缓存的基本概念数据库与缓存是服务端开发人员的必学知识点. 数据库数据库是一种信息记录、存取的虚拟标记地点的集合统称. 比如现实生活中,...

Yi_Zhi_Yu 2019-07-24 16:29 评论0 收藏0