@umajs-express/arg-decorator v1.2.0-beta1

内置参数装饰器（ArgDecorator）

Umajs-express 提供了 createArgDecorator 可以很方便的创建参数装饰器，并且框架还提供了如下装饰器直接使用。

使用

安装 npm install -S @umajs-express/arg-decorator

示例

import { ToNumber, Body } from '@umajs-express/arg-decorator';

// url参数类型修饰校验
@Path('/saveUser')
saveUser(@ToNumber('age') age :number) {
    return Result.send(`This router queryParms is ${userId} ${age}`);
}

// POST参数类型修饰校验
@Path({value:'/post',method:RequestMethod.POST})
saveUser(@Body.ToNumber('age') age: number){
    return Result.send(`This Post body info is ${JSON.stringify(userInfo)}`);
}

当接口访问localhost:port//saveUser?age=str时，controller方法将终止执行，并默认返回客户端提示信息

{
    "code": 0,
    "msg": "age 参数必须为数据类型。入参值str"
}

API

自定义校验提示内容

框架默认修饰器提示信息可以通过配置文件src/config/argDecorator.config.ts进行覆盖。通过Result模块用户可以自定义校验失败时返回的数据格式或者方式，比如json,或者状态码。

import { Result } from '@umajs-express/core';

export default {
    Require: {
        err({key, ctx, tip, val}) {
            return Result.send(tip || `请求${key} 参数不能为空。入参值为${val}`,403);
        },
    },
    ToNumber: {
        err({key, ctx, tip, val}) {
            return Result.json({
                code: 0,
                msg: tip || `请求${key} 参数必须为数字类型。入参值为${val}`,
            });
        },
    },
};