Http 服务器

skynet 从 v0.5.0 开始提供了简单的 http 服务器的支持。skynet.httpd 是一个独立于 skynet 的，用于 http 协议解析的库，它本身依赖 socket api 的注入。使用它，你需要把读写 socket 的 API 封装好，注入到里面就可以工作。

skynet.sockethelper 模块将 skynet 的 Socket API 封装成 skynet.httpd 可以接受的形式：阻塞读写指定的字节数、网络错误以异常形式抛出。

下面是一个简单的范例：

-- examples/simpleweb.lualocal skynet = require "skynet"local socket = require "socket"local httpd = require "http.httpd"local sockethelper = require "http.sockethelper"local urllib = require "http.url"local table = tablelocal string = stringlocal mode = ...if mode == "agent" thenlocal function response(id, ...)    local ok, err = httpd.write_response(sockethelper.writefunc(id), ...)    if not ok then        -- if err == sockethelper.socket_error , that means socket closed.        skynet.error(string.format("fd = %d, %s", id, err))    endendskynet.start(function()    skynet.dispatch("lua", function (_,_,id)        socket.start(id)  -- 开始接收一个 socket        -- limit request body size to 8192 (you can pass nil to unlimit)        -- 一般的业务不需要处理大量上行数据，为了防止攻击，做了一个 8K 限制。这个限制可以去掉。        local code, url, method, header, body = httpd.read_request(sockethelper.readfunc(id), 8192)        if code then            if code ~= 200 then  -- 如果协议解析有问题，就回应一个错误码 code 。                response(id, code)            else                -- 这是一个示范的回应过程，你可以根据你的实际需要，解析 url, method 和 header 做出回应。                local tmp = {}                if header.host then                    table.insert(tmp, string.format("host: %s", header.host))                end                local path, query = urllib.parse(url)                table.insert(tmp, string.format("path: %s", path))                if query then                    local q = urllib.parse_query(query)                    for k, v in pairs(q) do                        table.insert(tmp, string.format("query: %s= %s", k,v))                    end                end                response(id, code, table.concat(tmp,"\n"))            end        else            -- 如果抛出的异常是 sockethelper.socket_error 表示是客户端网络断开了。            if url == sockethelper.socket_error then                skynet.error("socket closed")            else                skynet.error(url)            end        end        socket.close(id)    end)end)elseskynet.start(function()    local agent = {}    for i= 1, 20 do        -- 启动 20 个代理服务用于处理 http 请求        agent[i] = skynet.newservice(SERVICE_NAME, "agent")      end    local balance = 1    -- 监听一个 web 端口    local id = socket.listen("0.0.0.0", 8001)      socket.start(id , function(id, addr)          -- 当一个 http 请求到达的时候, 把 socket id 分发到事先准备好的代理中去处理。        skynet.error(string.format("%s connected, pass it to agent :%08x", addr, agent[balance]))        skynet.send(agent[balance], "lua", id)        balance = balance + 1        if balance > #agent then            balance = 1        end    end)end)end

这个 httpd 模块最初是用于服务器内部管理，以及和其它平台对接。所以只提供了最简单的功能。如果是重度的业务要使用，可以考虑再其上做进一步的开发。

httpc

skynet 提供了一个非常简单的 http 客户端模块。你可以用:

httpc.request(method, host, uri, recvheader, header, content)

来提交一个 http 请求，其中

• method 是 "GET" "POST" 等。
• host 为目标机的地址
• uri 为请求的 URI
• recvheader 可以是 nil 或一张空表，用于接收回应的 http 协议头。
• header 是自定义的 http 请求头。注：如果 header 中没有给出 host ，那么将用前面的 host 参数自动补上。
• content 为请求的内容。

它返回状态码和内容。如果网络出错，则抛出 error 。

httpc.dns(server, port)

可以用来设置一个异步查询 dns 的服务器地址。如果你不给出地址，那么将从 /etc/resolv.conf 查找地址。如果你没有调用它设置异步 dns 查询，那么 skynet 将在网络底层做同步查询。这很有可能阻塞住整个 skynet 的网络消息处理（不仅仅阻塞单个 skynet 服务）。

另外，httpc 还提供了简单的 httpc.get 以及 httpc.post 的封装，具体可以参考源代码。

如果有https的需求，可使用 lua-webclient 它是libcurl multi interface的简单封装，支持单线程，非阻塞的大量http、https请求。

httpc 可以通过设置 httpc.timeout 的值来控制超时时间。时间单位为 1/100 秒。