Files
marqdo-cli/stdlib/net/http.mq.md
T

6.5 KiB

import
import
utf8
../text/utf8.mq.md

切片字节

(字节, 起, 止)

结果 = []

下标 = 起

  • 下标 < 止 and 下标 < 长度(字节)

    结果 = list.append(结果, 字节[下标])

    下标 = 下标 + 1

结果

找子串

(字节, 子, 起点)

结果 = 0 - 1

下标 = 起点

  • 下标 + 长度(子) <= 长度(字节) and 结果 < 0

    偏移 = 0

    匹配 = true

    • 偏移 < 长度(子) and 匹配

      1. 字节[下标 + 偏移] != 子[偏移]

        匹配 = false

      2. true

        忽略 = 0

      偏移 = 偏移 + 1

    1. 匹配

      结果 = 下标

    2. true

      忽略 = 0

    下标 = 下标 + 1

结果

找字符

(字节, 值, 起点)

结果 = 0 - 1

下标 = 起点

  • 下标 < 长度(字节) and 结果 < 0

    1. 字节[下标] == 值

      结果 = 下标

    2. true

      忽略 = 0

    下标 = 下标 + 1

结果

十六进制值

(字节)

数值 = 0

下标 = 0

  • 下标 < 长度(字节)

    值 = 字节[下标]

    1. 值 >= 48 and 值 <= 57

      数值 = 数值 * 16 + 值 - 48

    2. 值 >= 65 and 值 <= 70

      数值 = 数值 * 16 + 值 - 55

    3. 值 >= 97 and 值 <= 102

      数值 = 数值 * 16 + 值 - 87

    4. true

      忽略 = 0

    下标 = 下标 + 1

数值

文本字节

(文本)

把 UTF-8 文本编码为字节列表,上限 8 MiB。

内存 = memory.new(128, 128)

字节数 = utf8.编码(文本, 内存, 0)

结果 = []

下标 = 0

  • 下标 < 字节数

    结果 = list.append(结果, 内存[下标])

    下标 = 下标 + 1

结果

字节文本

(字节)

把字节列表按 UTF-8 解码为文本,上限 8 MiB。

长度值 = 长度(字节)

  1. 长度值 == 0

    {ok: true, value: ""}

页 = (长度值 + 65535) // 65536

内存 = memory.new(页, 页)

下标 = 0

  • 下标 < 长度值

    内存[下标] = 字节[下标]

    下标 = 下标 + 1

utf8.解码(内存, 0, 长度值)

解码分块字节

(体)

结果 = []

位置 = 0

错误 = ""

  • 位置 < 长度(体) and 错误 == ""

    行尾 = 找子串(体, [13, 10], 位置)

    1. 行尾 < 0

      错误 = "http.chunked"

    2. true

    大小 = 十六进制值(切片字节(体, 位置, 行尾))

    1. 大小 == 0

      位置 = 长度(体)

    2. 位置 + 大小 + 4 > 长度(体)

      错误 = "http.chunked"

    3. true

      结果 = list.concat(结果, 切片字节(体, 行尾 + 2, 行尾 + 2 + 大小))

      位置 = 行尾 + 2 + 大小 + 2

  1. 错误 != ""

    {ok: false, code: 错误, message: "分块长度无效"}

{ok: true, value: 结果}

解析响应字节

(字节)

解析 HTTP/1.1 响应字节。头部按 ASCII 解析,正文保持原始字节;chunked 长度以字节计。成功返回 {ok:true, value:{status, reason, headers, body}}。

头部结束 = 找子串(字节, [13, 10, 13, 10], 0)

  1. 头部结束 < 0

    {ok: false, code: "http.invalid", message: "缺少头部结束"}

头部 = 切片字节(字节, 0, 头部结束)

体 = 切片字节(字节, 头部结束 + 4, 长度(字节))

行列表 = []

行起 = 0

下一行 = 找子串(头部, [13, 10], 0)

  • 下一行 >= 0

    行列表 = list.append(行列表, 切片字节(头部, 行起, 下一行))

    行起 = 下一行 + 2

    下一行 = 找子串(头部, [13, 10], 行起)

行列表 = list.append(行列表, 切片字节(头部, 行起, 长度(头部)))

  1. 长度(行列表) == 0

    {ok: false, code: "http.invalid", message: "缺少状态行"}

状态行 = 字节文本(行列表[0])

  1. not 状态行.ok

    {ok: false, code: "http.invalid", message: "状态行不是 ASCII"}

状态字节 = 行列表[0]

第一空格 = 找字符(状态字节, 32, 0)

第二空格 = 找字符(状态字节, 32, 第一空格 + 1)

  1. 第一空格 < 0 or 第二空格 < 0

    {ok: false, code: "http.invalid", message: "状态行格式无效"}

状态文本 = 字节文本(切片字节(状态字节, 第一空格 + 1, 第二空格))

  1. not 状态文本.ok

    {ok: false, code: "http.invalid", message: "状态码不是 ASCII"}

状态 = 整数(状态文本.value)

原因 = 字节文本(切片字节(状态字节, 第二空格 + 1, 长度(状态字节)))

  1. not 原因.ok

    {ok: false, code: "http.invalid", message: "原因短语不是 ASCII"}

头 = {}

行号 = 1

  • 行号 < 长度(行列表)

    行 = 行列表[行号]

    冒号 = 找字符(行, 58, 0)

    1. 冒号 >= 0

      名 = 字节文本(切片字节(行, 0, 冒号))

      值 = 字节文本(切片字节(行, 冒号 + 2, 长度(行)))

      1. 名.ok and 值.ok

        头 = map.set(头, 名.value, 值.value)

      2. true

        忽略 = 0

    2. true

      忽略 = 0

    行号 = 行号 + 1

传输 = map.get(头, "Transfer-Encoding")

解码后 = 体

  1. 传输 == "chunked"

分块 = 解码分块字节(体)

  1. not 分块.ok

    分块

解码后 = 分块.value

  1. true

    忽略 = 0

{ok: true, value: {status: 状态, reason: 原因.value, headers: 头, body: 解码后}}

解析响应

(文本)

兼容文本 API:按字节解析后,把正文按 UTF-8 解码。

响应 = 解析响应字节(文本字节(文本))

  1. not 响应.ok

    {状态: 0, 原因: "", 头: {}, 体: ""}

正文 = 字节文本(响应.value.body)

  1. not 正文.ok

    {状态: 响应.value.status, 原因: 响应.value.reason, 头: 响应.value.headers, 体: ""}

{状态: 响应.value.status, 原因: 响应.value.reason, 头: 响应.value.headers, 体: 正文.value}

构建请求字节

(方法, 路径, 头列表, 体字节)

构建 HTTP/1.1 请求字节。方法、路径、头名/值按 UTF-8 编码;正文使用 传入的字节列表。

结果 = 文本字节(方法 + " " + 路径 + " HTTP/1.1" + "\r\n")

下标 = 0

  • 下标 < 长度(头列表)

    头 = 头列表[下标]

    结果 = list.concat(结果, 文本字节(文本(头[0]) + ": " + 文本(头[1]) + "\r\n"))

    下标 = 下标 + 1

结果 = list.concat(结果, [13, 10])

list.concat(结果, 体字节)

构建请求

(方法, 路径, 头列表, 体文本)

兼容文本 API,正文按 UTF-8 编码。

请求 = 构建请求字节(方法, 路径, 头列表, 文本字节(体文本))

文本结果 = 字节文本(请求)

  1. not 文本结果.ok

    ""

文本结果.value