Angular Module声明和获取重载实例代码


Posted in Javascript onSeptember 14, 2016

module是angular中重要的模块组织方式,它提供了将一组内聚的业务组件(controller、service、filter、directive…)封装在一起的能力。这样做可以将代码按照业务领域问题分module的封装,然后利用module的依赖注入其关联的模块内容,使得我们能够更好的”分离关注点“,达到更好的”高内聚低耦合“。”高内聚低耦合“是来自面向对象设计原则。内聚是指模块或者对象内部的完整性,一组紧密联系的逻辑应该被封装在同一模块、对象等代码单元中,而不是分散在各处;耦合则指模块、对象等代码单元之间的依赖程度,如果一个模块的修改,会影响到另一个模块,则说明这两模块之间是相互依赖紧耦合的。

同时module也是我们angular代码的入口,首先需要声明module,然后才能定义angular中的其他组件元素,如controller、service、filter、directive、config代码块、run代码块等。

关于module的定义为:angular.module(‘com.ngbook.demo', [])。关于module函数可以传递3个参数,它们分别为:

  1. name:模块定义的名称,它应该是一个唯一的必选参数,它会在后边被其他模块注入或者是在ngAPP指令中声明应用程序主模块;
  2. requires:模块的依赖,它是声明本模块需要依赖的其他模块的参数。特别注意:如果在这里没有声明模块的依赖,则我们是无法在模块中使用依赖模块的任何组件的;它是个可选参数。
  3. configFn: 模块的启动配置函数,在angular config阶段会调用该函数,对模块中的组件进行实例化对象实例之前的特定配置,如我们常见的对$routeProvider配置应用程序的路由信息。它等同于”module.config“函数,建议用”module.config“函数替换它。这也是个可选参数。

对于angular.module方法,我们常用的方式有有种,分别为angular.module(‘com.ngbook.demo', [可选依赖])和angular.module(‘com.ngbook.demo')。请注意它是完全不同的方式,一个是声明创建module,而另外一个则是获取已经声明了的module。在应用程序中,对module的声明应该有且只有一次;对于获取module,则可以有多次。推荐将angular组件独立分离在不同的文件中,module文件中声明module,其他组件则引入module,需要注意的是在打包或者script方式引入的时候,我们需要首先加载module声明文件,然后才能加载其他组件模块。

在angular中文社区群中,有时会听见某些同学问关于”ng:areq“的错误:

 [ng:areq] Argument 'DemoCtrl' is not a function, got undefined!

这往往是因为忘记定义controller或者是声明了多次module,多次声明module会导致前边的module定义信息被清空,所以程序就会找不到已定义的组件。这我们也能从angular源码中了解到(来自loader.js):

function setupModuleLoader(window) {
      ...
      function ensure(obj, name, factory) {
        return obj[name] || (obj[name] = factory());
      }
      var angular = ensure(window, 'angular', Object);
      return ensure(angular, 'module', function() {
        var modules = {};
        return function module(name, requires, configFn) {
          var assertNotHasOwnProperty = function(name, context) {
            if (name === 'hasOwnProperty') {
              throw ngMinErr('badname', 'hasOwnProperty is not a valid {0} name', context);
            }
          };

          assertNotHasOwnProperty(name, 'module');
          if (requires && modules.hasOwnProperty(name)) {
            modules[name] = null;
          }
          return ensure(modules, name, function() {
            if (!requires) {
              throw $injectorMinErr('nomod', "Module '{0}' is not available! You either misspelled " +
                "the module name or forgot to load it. If registering a module ensure that you " +
                "specify the dependencies as the second argument.", name);
            }
            var invokeQueue = [];
            var runBlocks = [];
            var config = invokeLater('$injector', 'invoke');
            var moduleInstance = {
              _invokeQueue: invokeQueue,
              _runBlocks: runBlocks,
              requires: requires,
              name: name,
              provider: invokeLater('$provide', 'provider'),
              factory: invokeLater('$provide', 'factory'),
              service: invokeLater('$provide', 'service'),
              value: invokeLater('$provide', 'value'),
              constant: invokeLater('$provide', 'constant', 'unshift'),
              animation: invokeLater('$animateProvider', 'register'),
              filter: invokeLater('$filterProvider', 'register'),
              controller: invokeLater('$controllerProvider', 'register'),
              directive: invokeLater('$compileProvider', 'directive'),
              config: config,
              run: function(block) {
                runBlocks.push(block);
                return this;
              }
            };
            if (configFn) {
              config(configFn);
            }
            return moduleInstance;

            function invokeLater(provider, method, insertMethod) {
              return function() {
                invokeQueue[insertMethod || 'push']([provider, method, arguments]);
                return moduleInstance;
              };
            }
          });
        };
      });
    }

在代码中,我们能了解到angular在启动时,会设置全局的angular对象,然后在angular对象上发布module这个API。关于module API代码,能清晰的看见第一行谓语句,module名称不能以hasOwnProperty命名,否则会抛出”badname“的错误信息。紧接着,如果传入了name参数,其表示是声明module,则会删除已有的module信息,将其置为null。

从moduleInstance的定义,我们能够看出,angular.module为我们公开的API有:invokeQueue、runBlocks、requires、name、provider、factory、servic、value、constant、animation、filter、controller、directive、config、run。其中invokeQueue和runBlocks是按名约定的私有属性,请不要随意使用,其他API都是我们常用的angular组件定义方法,从invokeLater代码中能看到这类angular组件定义的返回依然是moduleInstance实例,这就形成了流畅API,推荐使用链式定义这些组件,而不是声明一个全局的module变量。

最后,如果传入了第三个参数configFn,则会将它配置到config信息中,当angular进入config阶段时,它们将会依次执行,进行对angular应用或者angular组件如service等的实例化前的配置。

以上就是对Angular Module声明和获取重载的资料整理,后续继续补充相关资料,谢谢大家对本站的支持!

Javascript 相关文章推荐
驱动事件的addEvent.js代码
Mar 27 Javascript
jQuery EasyUI API 中文文档 - Draggable 可拖拽
Sep 29 Javascript
分页栏的web标准实现
Nov 01 Javascript
浅析JavaScript中的delete运算符
Nov 30 Javascript
IE8下Jquery获取select选中的值post到后台报错问题
Jul 02 Javascript
在JavaScript中构建ArrayList示例代码
Sep 17 Javascript
Backbone.js 0.9.2 源码注释中文翻译版
Jun 25 Javascript
基于Bootstrap里面的Button dropdown打造自定义select
May 30 Javascript
vue-router 源码实现前端路由的两种方式
Jul 02 Javascript
详解如何提升JSON.stringify()的性能
Jun 12 Javascript
用Vue.js在浏览器中实现裁剪图像功能
Jun 18 Javascript
Vue 实现拨打电话操作
Nov 16 Javascript
javascript经典特效分享 手风琴、轮播图、图片滑动
Sep 14 #Javascript
Angular 应用技巧总结
Sep 14 #Javascript
AngularJS 所有版本下载地址
Sep 14 #Javascript
JS组件系列之使用HTML标签的data属性初始化JS组件
Sep 14 #Javascript
Angularjs 制作购物车功能实例代码
Sep 14 #Javascript
一步一步封装自己的HtmlHelper组件BootstrapHelper(三)
Sep 14 #Javascript
Angular ng-repeat 对象和数组遍历实例
Sep 14 #Javascript
You might like
PHP中使用file_get_contents post数据代码例子
2015/02/13 PHP
PHP通过串口实现发送短信
2015/07/08 PHP
JavaScript 组件之旅(三):用 Ant 构建组件
2009/10/28 Javascript
jQuery源码分析之Event事件分析
2010/06/07 Javascript
jquery简单的拖动效果实现原理及示例
2013/07/26 Javascript
jquery 使用简明教程
2014/03/05 Javascript
js遍历子节点子元素附属性及方法
2014/08/19 Javascript
AngularJS页面访问时出现页面闪烁问题的解决
2016/03/06 Javascript
NodeJS的Promise的用法解析
2016/05/05 NodeJs
javascript运算符——位运算符全面介绍
2016/07/14 Javascript
基于jQuery实现表格的排序
2016/12/02 Javascript
jquery代码规范让代码越来越好看
2017/02/03 Javascript
JS简单获取当前年月日星期的方法示例
2017/02/07 Javascript
正则表达式基本语法及表单验证操作详解【基于JS】
2017/04/07 Javascript
浅谈node中的exports与module.exports的关系
2017/08/01 Javascript
javaScript实现游戏倒计时功能
2018/11/17 Javascript
jquery操作select常见方法大全【7种情况】
2019/05/28 jQuery
js根据后缀判断文件文件类型的代码
2020/05/09 Javascript
原生JS实现九宫格抽奖
2020/09/13 Javascript
解决vant框架做H5时踩过的坑(下拉刷新、上拉加载等)
2020/11/11 Javascript
python实现的防DDoS脚本
2011/02/08 Python
Python中使用PyHook监听鼠标和键盘事件实例
2014/07/18 Python
Python实现的检测网站挂马程序
2014/11/30 Python
Python Socket编程详细介绍
2017/03/23 Python
Python 反转字符串(reverse)的方法小结
2018/02/20 Python
python爬虫基本知识
2018/03/05 Python
关于Keras Dense层整理
2020/05/21 Python
OpenCV+python实现膨胀和腐蚀的示例
2020/12/21 Python
Rentalcars.com中国:世界上最大的在线汽车租赁服务
2019/08/22 全球购物
运动会入场词100字
2014/02/06 职场文书
农业生产宣传标语
2014/10/08 职场文书
财务总监岗位职责范本
2015/04/03 职场文书
2015年高三毕业班班主任工作总结
2015/10/22 职场文书
4种非常实用的python内置数据结构
2021/04/28 Python
Spring mvc是如何实现与数据库的前后端的连接操作的?
2021/06/30 Java/Android
yolov5返回坐标的方法实例
2022/03/17 Python