为 Angular 1.x 添加依赖注入 Decorator

最近在研究从 Angular 1.x 切换到 Angular 2,因为目前 Angular 2 正处于 RC 阶段还会有比较多的变化,暂时还是使用 1.x 。 为了以后能比较方便的迁移,所以虽然用的是 1.x 但是在写法上还是希望更接近于 2.0 的写法,也就有了以下我想要实现的功能:使用 decorator 来处理 angular 1.x 的依赖注入。

在设计、实现的时候我尽量只使用 ES6 和 ES7 的新特性,因为在试用 Angular 2 的时候发现 Typescript 编译确实是太慢了,而且 Typescript 的静态类型检查虽然是我喜欢的但是使用起来对开发效率影响比较大,综合平衡后决定未来还是基于 ES 标准开发就好了,不打算切换到 Typescript 或者其它 XType。

Angular 1.x 依赖注入的现状和问题

使用过 Angular 的朋友都知道依赖注入是 Angular 中非常重要的特性,在 1.x 时代有3种方式可以实现依赖注入:

方式一:

angular.module('app', [])
    .controller('mainCtrl', [
        '$scope',
        function($scope) { ... }
    ])

方式二:

function mainCtrl($scope) { ... }
mainCtrl.$inject = ['$scope'];
angular.module('app', [])
    .controller('mainCtrl', mainCtrl);

方式三:

angular.module('app', [])
    .controller(
        'mainCtrl', 
        function($scope) { ... }
    );

方式1、2都需要写两次需要注入的服务并且配置服务名称和编写入参时的顺序必需一致,比较影响开发效率而且容易出错。而方式3在框架内部是通过分析函数的入参名称来确定需要注入的服务,使用起来非常方便但是如果对JS代码进行压缩处理后,框架就无法得知真正需要注入的服务了。

所以,目前这三种依赖注入的方式都存在一些问题。不过基本方式三和 ng-annotate 还是可以比较完美的解决依赖注入的问题,简单来说 ng-annotate 就是通过自动构建工具在压缩JS代码前将方式三转换成方式二,而这一切都是由构建工具自动完成我们在开发的时候并不用关心。

废话了这么多只是为了说明本文希望解决的问题:其实很简单,就是希望在依赖注入的时候只写一次需要注入的服务!虽然使用 ng-annotate 已经可以实现,但是我希望用最新的标准来处理这个问题,以便未来更方便的向 Angular2 过渡,这种方式就是使用 Decorator。

使用 Decorator 解决 angular 1.x 的依赖注入问题

Decorator 是 ES7 的一个提案,目前通过 Babel 或者 Typescropt 已经可以提前享用。尝试过 Angular2 的朋友应该知道在 Angular2 中就引入了很多的 Decorator,例如:

import { Component } from '@angular/core';

@Component({
...
})
export class MainComponent {
...
}

这里的 Component 就是一个 Decorator, 使用过 Python 的朋友应该也非常熟悉这种语法。简单来说 Decorator 就是一个模板,可以在编译阶段对被装饰的类或类成员进行修改(目前通过Babel使用的时候貌似还是在Runtime阶段起使用)。

在使用 Decorator 解决依赖注入问题的时候我首先想到的就是 ng-annotate 的方案,在 Decorator 里去分析被装饰类构造函数的入参列表,然后为被装饰类添加$inject属性,代码如下:

function inject() {
    return function(target) {
        let services = angular.injector.$$annotate(target);
        target.$inject = services;
    }
}

@inject()
class MainComponent {
    constructor($scope) {
        ...
    }
}

其中angular.injector.$$annotate(target)就是 angular 中解析入参名称列表的函数,之前还花了好长时间自己去实现,后来一想 angular 既然可以自动发现需要注入的服务肯定有完整的入参分析,果然就在源码的 src/auto/injector.js 里找到了。这种方式在没有压缩JS代码的情况下测试运行没有问题,$inject属性正确添加。但是,在压缩JS代码后就出现没有找到aProvider这样的错误了,阅读 Babel 转译后的代码也没有发现 MainComponent.$inject = [...] 这行代码,所以我认为在 Babel 中 Decorator 其实是在 Runtime 中执行而不是在编译的时候执行(难道我对编译和运行时的理解有错?还是提案里不是说的在编译时执行?)。

其实在 Github 中已经有人为 Angular 1.x 的依赖注入提供了 Decorator 的实现,大概的实现方式是:

function inject(...services) {
    return function(target) {
        target.$inject = services;
    }
}

@inject('$scope', '$http')
class MainComponent {
    constructor($scope, $http) {
        ...
    }
}

但是这种实现方式还是需要写两次要注入的服务并且入参的顺序与配置的顺序还必须一致,无非是将MainComponent.$inject = []改成了@inject(...),并不是我希望能达到的目的。但是基于这个思路我想到了第二种实现方案,通过 decorator 的入参获取到需要注入的服务,然后在 decorator 中去修改被装饰类的构造函数,在实例化被装饰类时自动将注入的服务添加为实例的属性。

如何在 decorator 中去修改被装饰类的 constructor 呢?这就需要使用到 ES6 的一个新 API Proxy 了,具体实现如下:

function inject(...services) {
    return function(target, property, descriptor) {
        var p = new Proxy(target, {
            construct: function(target, args) {
                for(let i in services) {
                    target.prototype[services[i]] = args[i];
                }
                return new target(...args);
            }
        });
        p.$inject = services;

        return p;
    }
}

@inject('$scope', '$http')
class MainComponent {
    constructor() {
        this.$http.get(url).then(data => {
            this.$scope.data = data;
        })
    }
}

在 decorator 中我创建了一个 Proxy 实例来拦截被装饰类的实例化行为,将需要注入的服务自动添加为被装饰类的实例属性,从而在被装饰类的实例中可以直接使用而不用关心依赖注入的细节(在 constructor 中不用再关心第一个入参对应的是那个服务,第二个参数对应的是那个服务...)。当然,这只是一个最基础的实现还可以更完善一些,例如:添加 $scope as scope 语法修改服务实例属性名称等。

而 Proxy 在 ES6 的文档中有详细说明,它可以提供一种拦截机制从而去改变被拦截对象的一些行为,配套的还有一个 Reflect 可以在修改被拦截对象后获取对象原始的行为。

以上就是本文的全部,使用 decorator 可以实现很多有意思的功能,而从 Angular 1.x 向 2.0 迁移在 Angular 团队内部也在做很多的努力。不过我的真正目的还是脱离框架去实现一些常用功能模块,以便将来不管是用什么框架都能使用的到,最近在开发前后端的时候都在往这个方向努力。在当前各个语言都拥有完善的包管理器的情况下,个人觉得一个大而全的框架已经不是我需要的了!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,794评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,050评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,587评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,861评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,901评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,898评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,832评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,617评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,077评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,349评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,483评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,199评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,824评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,442评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,632评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,474评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,393评论 2 352

推荐阅读更多精彩内容

  • Angular算是将后端开发工程化引入前端的先驱之一,而Dependency injection依赖注入(后面简称...
    点融黑帮阅读 2,250评论 0 5
  • 1、angularjs的几大特性是什么? 双向数据绑定、依赖注入、模板、指令、MVC/MVVM 2、列举几种常见的...
    秀才JaneBook阅读 1,541评论 0 22
  • 目录 Angular 4 依赖注入教程之一 依赖注入简介 Angular 4 依赖注入教程之二 组件服务注入 An...
    semlinker阅读 4,588评论 0 1
  • 版本:Angular 5.0.0-alpha 依赖注入是重要的应用设计模式。它使用得非常广泛,以至于几乎每个人都称...
    soojade阅读 2,990评论 0 3
  • 今天下起了雪,干燥了一个冬季,却在阳春三月下了一整天雪,为何这样?春暖花开,这场大雪过后应该不会再有这样大的雪了。...
    合唱团阅读 1,201评论 0 1