【nodejs】让nodejs像后端mvc框架(asp.net mvc)一样处理请求--参数自动映射篇(6/8)

文章目录

前情概要

路由、action的扫描、发现、注册搞定之后,后来我发现在我们的action里面获取参数往往都是通过request对象来一个一个获取。同样的一行代码我们不厌其烦的重复写了无数次。遂想着那我们能不能像后端程序一样做得更自动化一些呢? 所以,接下来我们再来完成一个比较重要的功能,那就是参数的自动绑定。

参数的自动绑定实现思路

依靠ts的装饰器特性,我们能做在方法上,在类上,在方法的参数上,在类的属性成员上通通可以加上装饰器来存放一些额外的数据。那理论上我们在编码阶段就可以通过一定的手段把这个标记加载我们需要处理的方法、类、参数等上面,等到运行时的时候可以根据这些额外的参数来帮我们做一些重复性的工作。

  1. 在需要使用到的方法参数、类、属性上增加我们的特定标识,标记当前参数需要自动解析,并记录一些诸如类型拉、名称啦等的一些额外属性。
  2. 在action的调用阶段,根据规则先把参数解析好。在传递进去。
  3. 完事儿,这就是我们的参数自动绑定功能。

参数的自动绑定实现---装饰器实现

部分代码,只贴了fromquery,其他几个formbody,fromheader之类的基本一样,都是调用makeActionParameterDescriptor方法

/**
 *  指示当前参数从request对象的query中解析
 * 
 * @export
 * @param {(target?: any) => Function} type 
 * @returns {Function} 
 */
export function fromQuery(type: (target?: any) => Function): Function;
/**
 * 指示当前参数从request对象的query中解析
 * 
 * @export
 * @returns {Function} 
 */
export function fromQuery(): Function {
    var thatArg = arguments;
    return function (target: Object, propertyKey: string, parameterIndex: number) {
        makeActionParameterDescriptor('query', thatArg, target, propertyKey, parameterIndex);
    }
}
function makeActionParameterDescriptor(parameterFromType: parameterFromType, thatArg: IArguments, target: Object, propertyKey: string, parameterIndex: number) {
    //非声明在属性和参数上
    if (!propertyKey) return;

    var paramType = undefined;
    var val = new ActionParamDescriptor();
    val.parameterName = propertyKey;
    val.target = target;
    val.parameterIndex = parameterIndex;
    val.parameterFromType = parameterFromType;
    val.parameterTypeType = 'simple'

    if (typeof parameterIndex === 'undefined') {
        //声明在类的属性上
        val.localtionType = 'classProperty'

    } else {
        //声明在action的参数上
        val.localtionType = 'methodParameter'
        val.actionMethodName = propertyKey;
        val.parameterName = getArgs((target as any)[propertyKey])[parameterIndex];

    }
    //复杂类型
    if (thatArg.length > 0) {

        val.parameterTypeType = 'complex'
        val.parameterType = thatArg[0](target);
    }

    SetActionParamDescriptor(val);
}
function getArgs(func: Object) {
    //匹配函数括号里的参数  
    var method = func.toString();
    method = method.length > 500 ? method.substring(0, 500) : method;
    method = method.replace("\r|\n|\\s", "")
    var args = method.match(/.*?\(.*?\)/i);
    if (args == null) throw Error('can not match method parameters');
    method = args[0];
    method = method.replace(/.*?\(|\)/, "").replace(')', '');
    //分解参数成数组  
    var arr = method.split(",").map(function (arg) {
        //去空格和内联注释  
        return arg.replace(/\/\*.*\*\//, "").trim();
    }).filter(function (args) {
        //确保没有undefineds  
        return args;
    });
    return arr
}

ActionParamDescriptor 对象结构

export declare type parameterFromType = 'query' | 'body' | 'form' | 'header' | 'cookie' | 'auto'
export class ActionParamDescriptor {
    /**
     * action参数的action名称
     * 
     * @type {string}
     * @memberof ActionParamDescriptor
     */
    actionMethodName: string
    /**
     * 参数名称
     * 
     * @type {string}
     * @memberof ActionParamDescriptor
     */
    parameterName: string
    /**
     * 参数所在类
     * 
     * @type {Object}
     * @memberof ActionParamDescriptor
     */
    target: Object
    /**
     * 参数类型的类别
     * 
     * @type {('complex' | 'simple')}
     * @memberof ActionParamDescriptor
     */
    parameterTypeType: 'complex' | 'simple'
    /**
     * 参数对象的类型(class)对象
     * 
     * @type {Function}
     * @memberof ActionParamDescriptor
     */
    parameterType: Function
    /**
     * 参数所在参数类别的顺序
     * 
     * @type {(number | undefined)}
     * @memberof ActionParamDescriptor
     */
    parameterIndex: number | undefined

    /**
     * 当前参数属性属于什么类型
     * 
     * @type {('classProperty'|'methodParameter')}
     * @memberof ActionParamDescriptor
     */
    localtionType: 'classProperty' | 'methodParameter'
    /**
     * 标记参数应该从什么地方解析
     * 
     * @type {parameterFromType}
     * @memberof ActionParamDescriptor
     */
    parameterFromType: parameterFromType
}

参数的自动绑定实现---基本使用方法

可以在action上标记某一个参数从什么地方(query、form、body、cookie、header)进行解析, 也可以标记某个参数是一个复杂的查询参数,可以指定这个参数的类型。 当然复杂的查询class的每一个属性都可以指定解析来源,当然也必须使用装饰器来修饰一下,不然我们就没法知道有这个属性需要进行解析啦。

import { BaseController, post, fromQuery, fromBody, fromCookie, fromHeader, property } from "../src/index"
export class demoActionBodyParams {
    id: string;
    name: string;
    pageSize: number;
    body: {
        req_bb: string
    }
}
export class demoActionQueryParams {
    @property()
    id: string;
    @property()
    name: string;
    @property()
    pageSize: number;
    @fromCookie()
    cookieName: string;
    @fromHeader()
    headerName: string;
    @fromBody()
    body: any;
}
export class demoController extends BaseController {
    @post()
    demoAction(@fromQuery(type => demoActionQueryParams) query: demoActionQueryParams,
        @fromQuery() p2: string,
        @fromBody() req_body: demoActionBodyParams) {
        return { query, p2, req_body }
    }
}

参数的自动绑定实现---参数的说明元数据保存

reflect-metadata 目前来说也还是ts的一个实验性特性。可以用来辅助我们保存一些额外的数据。或者也可以理解成它是一个系统级别的静态字典。 那我们把对参数的一些特别设置都通过reflect-metadata保存下来,其实这里我们自己使用一个对象来保存也是可以的。

const request_params_auto_bind_MetadataKey = Symbol("request_params_auto_bind_MetadataKey");
export function SetActionParamDescriptor(val: ActionParamDescriptor) {
    (val as any).targetName = val.target.constructor.name
    if (val.parameterType) (val as any).parameterTypeName = val.parameterType.name
    console.log('SetActionParamDescriptor', JSON.stringify(val));
    var arr: ActionParamDescriptor[] = [];
    if (val.localtionType === 'methodParameter') {
        arr = Reflect.getMetadata(request_params_auto_bind_MetadataKey, val.target, val.actionMethodName) || [];
        arr.push(val);
        Reflect.defineMetadata(request_params_auto_bind_MetadataKey, arr, val.target, val.actionMethodName);
    } else {
        arr = Reflect.getMetadata(request_params_auto_bind_MetadataKey, val.target) || [];
        arr.push(val);
        Reflect.defineMetadata(request_params_auto_bind_MetadataKey, arr, val.target);
    }
}

参数的自动绑定实现---参数的自动解析和对象生成

嗯,大概是一些杂乱无章的代码(^_^)。 主要思路:

  1. 获得当前action的参数描述对象
  2. 根据参数描述对象中的配置来解析参数
  3. 就这么简单,完事儿
//开始参数的自动解析操作
 var agrs = bindActionParameter(desc.ControllerType, desc.ControllerTypeName, desc.ActionType, desc.ActionName, req)
 
 function bindActionParameter(controllerType: Function, controllerName: string, actionType: Object, actionName: string, req: core.Request) {
//获得当前action的所有参数描述对象
    var arr = Reflect.getMetadata(request_params_auto_bind_MetadataKey, controllerType.prototype, actionName) || [] as ActionParamDescriptor[];

    var args = [arr.length];
    for (let index = 0; index < arr.length; index++) {
        args[arr[index].parameterIndex as number] = getParameterValue(req, arr[index], arr[index])//循环挨个进行解析
    }
    return args;
}
function bindClassParameter(req: core.Request, target: any, methodParmeterdesc: ActionParamDescriptor): any {
    var arr = Reflect.getMetadata(request_params_auto_bind_MetadataKey, target.prototype) as ActionParamDescriptor[];
    var obj = new target();
    for (let index = 0; index < arr.length; index++) {
        var desc = arr[index];
        obj[desc.parameterName] = getParameterValue(req, desc, methodParmeterdesc);
    }
    return obj;
}
function getParameterValue(req: core.Request, desc: ActionParamDescriptor, methodParmeterdesc: ActionParamDescriptor): any {
    //判断当前action的参数是基本类型参数,还是复杂类型参数。如果是复杂类型就走class绑定逻辑。
    if (desc.parameterTypeType === 'simple' || (desc.localtionType === 'methodParameter' && desc.parameterFromType === 'body')) {
        return getparameterInRequest(desc.parameterFromType, desc.parameterName, req, methodParmeterdesc);
    } else if (desc.parameterTypeType === 'complex') {
        return bindClassParameter(req, desc.parameterType, methodParmeterdesc)
    }
    else throw Error('not support parameter type ' + desc.parameterTypeType)
}
//根据参数的不同配置进行不同解析。
function getparameterInRequest(fromType: parameterFromType, parameterName: string, req: core.Request, methodParmeterdesc: ActionParamDescriptor): any {
    switch (fromType) {
        case 'query':
            return getCompatibleParam(req.query, parameterName)
        case 'body':
            return req.body
        case 'header':
            return getCompatibleParam(req.headers, parameterName)
        case 'cookie':
            return getCompatibleParam(req.cookies, parameterName)
        case 'form':
            return getCompatibleParam(req.body, parameterName)
        case 'auto':
            return getparameterInRequest(methodParmeterdesc.parameterFromType, parameterName, req, methodParmeterdesc);
    }
    return undefined;
}
//忽略参数的大小写问题。
function getCompatibleParam(obj: any, propertyName: string) {
    var lower = propertyName.toLowerCase();
    for (const key in obj) {
        if (obj.hasOwnProperty(key) && key.toLowerCase() == lower) {
            return obj[key];
        }
    }
}

需要说明的是,在这里有一个问题没有解决。当参数指定类型为body的时候,我们没有对参数进行更多的解析。也就意味着我申明的对象只有2个属性,提交的body有3个属性,最终在action里面的这个参数能拿到3个属性。一直犹豫是否要做这里是否要做filter。 从后端的角度来说是毫无疑问的,不可能我一个class只声明了2个属性,而到运行时的时候能取出来3个属性。这是不可能的。 但从前端的角度来讲,这也许是一个比较好的特性。某些时候更省事情。比较接口部分参数透传的时候之类的。

参数的自动解析大致就到这里了,嗯,这部分代码可能有点小逻辑。又加上没有注释有点难理解。不过我觉得这样挺好的,哈哈哈

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏前端黑板报

(转)ES6新特性概览

ES6(ECMAScript 6)是即将到来的新版本JavaScript语言的标准,代号harmony(和谐之意,显然没有跟上我国的步伐,我们已经进入中国梦版本...

2085
来自专栏JackieZheng

并发和多线程-八面玲珑的synchronized

上篇《并发和多线程-说说面试常考平时少用的volatile》主要介绍的是volatile的可见性、原子性等特性,同时也通过一些实例简单与synchronized...

1113
来自专栏我是攻城师

Apache Pig学习笔记之内置函数(三)

4144
来自专栏swag code

XML中节点类型

该 Node 接口是整个文档对象模型的主要数据类型。它表示该文档树中的单个节点。当实现 Node 接口的所有对象公开处理子节点的方法时,不是实现 Node 接口...

1246
来自专栏Python中文社区

Python源码剖析之整数对象

專 欄 ❈ 松直,Python中文社区专栏作者 专栏地址: http://www.zhihu.com/people/songzhili?utm_source...

2438
来自专栏Jimoer

在Java的反射中,Class.forName和ClassLoader的区别

最近在面试过程中有被问到,在Java反射中Class.forName()加载类和使用ClassLoader加载类的区别。当时没有想出来后来自己研究了一下就写下来...

1352
来自专栏飞雪无情的博客

从Java到Golang快速入门

Golang从09年发布,中间经历了多个版本的演进,已经渐渐趋于成熟,并且出现了很多优秀的开源项目,比如我们熟知的docker,etcd,kubernetes等...

953
来自专栏绿巨人专栏

TypeScript中的怪语法

4115
来自专栏me的随笔

Python知识梳理

我们可以使用type()函数类获取对象的类型,Python3中内置数据类型包括:None,int,float,complex,str,list,dict,tup...

1272
来自专栏余林丰

MyBatis之ObjectFactory

关于在MyBatis中的ObjectFactory有什么用,在官方文档中有这样的描述(大多数网上的博客都是直接引用这一描述):MyBatis 每次创建结果对象的...

2548

扫码关注云+社区