http2

Http2 library implemented in lua language.

Introduction

High performance http2 protocol server and client library based on cfadmin.

Api - Http2 Client

using local httpc = require "lua-http2.httpc".

1. function httpc:new(opt) httpc-class end

Use the new method creates an httpc request object.

2. function httpc:connect() boolean end

Use the connect method of the httpc object to connect to the server; return true for success, return false and string for failure.

3. function httpc:request(url, method, headers, args, timeout) response end

Use the request method of the httpc object to request Server.

• url - http2 path. (e.g /api);

• method - http2 method. (e.g GET、POST);

• headers - http2 headers. (e.g {["content-type"] = "application/json"})

• body|args - http2 args or body. (e.g table = {{"a",1}, {"b",2}}、"a=1&b=2"、"{}")

• timeout - request timeout. (timeout MUST > 0)

Api - Http2 Server

using local httpd = require "lua-http2.httpd".

1. function httpd:new(opt) httpd-class end

Use the new method creates an httpd server object.

2. function httpd:route(path, callback(req, resp)) end

Use the route method to register an http2 route callback.

req - is the request context of the client.

resp - can include 'response content' and 'response header'`.

3. function httpd:static(folder) end

Specify the folder parameter as the static file lookup directory.

4. function httpd:listen(ip, port) end

Start listening to the specified IP and Port.

5. function httpd:log(filepath) end

Write the request log to the file specified in filepath.

6. function httpd:nolog() end

Turn off print and write any request records.

7. function httpd:run() end

All code after this method is not executed.

Code sample

Next, we will introduce the examples and use methods of 'client' and 'server' respectively.

Server

Server code example

require"utils"localhttpd=require"lua-http2.httpd"localh2=httpd:new()
-- 注册路由h2:route("/", function (req, resp)
var_dump(req)
resp['body'] ="Loging."end)
-- 静态文件路由h2:static("static")
-- -- 关闭请求日志-- h2:nolog()h2:listen("localhost", 80)
h2:run()

[candy@MacBookPro:~/Documents/cfadmin] $ ./cfadmin
[2021/04/19 20:24:19] [INFO] h2 listen: 0.0.0.0:80
[2021/04/19 20:24:19] [INFO] h2 Web Server Running...
{
["headers"] = {
["host"] = "127.0.0.1",
[":scheme"] = "http",
["origin"] = "127.0.0.1",
["accept"] = "*/*",
["user-agent"] = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36",
[":path"] = "/",
[":authority"] = "127.0.0.1",
[":method"] = "GET",
["accept-encoding"] = "gzip, deflate, identity",
},
}
[2021/04/19 20:24:28] - 127.0.0.1 - 127.0.0.1 - / - GET - 200 - req_time: 0.000029/Sec

Client

Client code example

require"utils"localhttpc=require"lua-http2.httpc"-- 创建对象localhc=httpc:new { domain="http://127.0.0.1/" }
-- 连接到服务器ifnothc:connect() thenreturnprint("连接失败")
end-- 发送请求localopt, errinfo=hc:request("/", "GET")
ifnotoptthenreturnprint(false, errinfo)
endvar_dump(opt)

[candy@MacBookPro:~/Documents/cfadmin] $ ./cfadmin
{
["headers"] = {
["content-type"] = "text/html; charset=utf-8",
["server"] = "cfadmin/0.1",
["date"] = "Mon, 19 Apr 2021 20:24:28 GMT",
[":status"] = "200",
},
["body"] = "Loging.",
}