body - 请求内容解析

请求内容解析

功能说明

解析客户端发送的 JSON、Form-urlencoded、Text、二进制 等内容格式。

所支持的解析格式可扩展可自定义。默认支持格式：JSON、Form-urlencoded、Text

演示

import { Context, mapping, Body, $body } from 'zenweb';

export class Controller {
  @mapping({ path: '/', method: 'POST' })
  post(body: Body) {
    console.log(body.type); // POST body 内容类型
    console.log(body.data); // POST Body 内容解析完成后的数据
  }

  @mapping({ path: '/', method: 'POST' })
  async post() {
    console.log(await getAge()); // 类型转换&校验
  }
}

async function getAge() {
  return (await $body.get({ age: '!int' })).age;
}

依赖模块

• @zenweb/inject
• @zenweb/helper

配置项

| 配置项 | 类型 | 默认值 | 功能 | | ----- | --- | ----- | ---- | | encoding | string | 'utf-8' | 客户端未指定情况下，文本内容字符集的默认编码 | limit | number | 1024 * 1024 | 提交内容尺寸限制，默认：1MB | inflate | boolean | true | 是否支持 http 压缩传输的内容 | textTypes | string[] | ['text/*', 'json', '+json', 'xml', '+xml', 'urlencoded'] | 可以被解析成 Text 格式的 mimetype | parses | BodyParserClass[] | [JSONParser, URLEncodedParser] | 内容解析器

Core 挂载项

无

Context 挂载项

无

可注入对象

• singleton

  • BodyOption

• request

  • RawBody
  • TextBody
  • Body
  • ObjectBody
  • BodyHelper

全局模式

| 方法 | 功能 | | ----- | ---- | | $getRawBody() | 取得当前请求原始请求内容 | $getTextBody() | 取得当前请求文本内容，经过文字编码转换 | $getObjectBody() | 取得当前请求数据对象 | $body | BodyHelper 对象快捷方式

其他扩展格式解析

xml