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 相关文章推荐
jquery图片放大功能简单实现
Aug 01 Javascript
JQuery中使用Ajax赋值给全局变量异常的解决方法
Jan 10 Javascript
js生成验证码并直接在前端判断
May 15 Javascript
javascript带回调函数的异步脚本载入方法实例分析
Jul 02 Javascript
JQuery中attr属性和jQuery.data()学习笔记【必看】
May 18 Javascript
json传值以及ajax接收详解
May 24 Javascript
JavaScript事件详细讲解
Jun 27 Javascript
详解handlebars+require基本使用方法
Dec 21 Javascript
JavaScript纯色二维码变成彩色二维码
Jul 23 Javascript
Webpack执行命令参数详解
Jun 17 Javascript
爬虫利器Puppeteer实战
Jan 09 Javascript
JavaScript 中的执行上下文和执行栈实例讲解
Feb 25 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
PL-880隐藏功能
2021/03/01 无线电
php计算函数执行时间的方法
2015/03/20 PHP
yii2超好用的日期组件和时间组件
2016/05/05 PHP
Prototype Date对象 学习
2009/07/12 Javascript
jquery 插件学习(五)
2012/08/06 Javascript
JavaScript通过事件代理高亮显示表格行的方法
2015/05/27 Javascript
Javascript 字符串模板的简单实现
2016/02/13 Javascript
JavaScript 拖拽实例代码
2016/09/21 Javascript
JavaScript实现购物车基本功能
2017/07/21 Javascript
Vue.js如何实现路由懒加载浅析
2017/08/14 Javascript
Vue-Router进阶之滚动行为详解
2017/09/13 Javascript
angular内置provider之$compileProvider详解
2017/09/27 Javascript
vue.js开发实现全局调用的MessageBox组件实例代码
2017/11/22 Javascript
vue组件中的数据传递方法
2018/05/14 Javascript
原生js实现淘宝放大镜效果
2020/10/28 Javascript
VsCode里的Vue模板的实现
2020/08/12 Javascript
如何手动实现一个 JavaScript 模块执行器
2020/10/16 Javascript
node.js如何操作MySQL数据库
2020/10/29 Javascript
[02:04]2016国际邀请赛中国区预选赛VG.R晋级之路
2016/07/01 DOTA
python 转换 Javascript %u 字符串为python unicode的代码
2016/09/06 Python
基于python3 类的属性、方法、封装、继承实例讲解
2017/09/19 Python
Python 实现的 Google 批量翻译功能
2019/08/26 Python
Python3.7 基于 pycryptodome 的AES加密解密、RSA加密解密、加签验签
2019/12/04 Python
python爬虫开发之urllib模块详细使用方法与实例全解
2020/03/09 Python
Django 删除upload_to文件的步骤
2020/03/30 Python
python+playwright微软自动化工具的使用
2021/02/02 Python
浅谈Html5中视频 音频标签 进度条的问题
2016/07/26 HTML / CSS
献爱心倡议书
2014/04/14 职场文书
小组口号大全
2014/06/09 职场文书
城管执法人员个人对照检查材料思想汇报
2014/09/29 职场文书
师德先进个人事迹材料
2014/12/19 职场文书
个人总结格式范文
2015/03/09 职场文书
2015年后备干部工作总结
2015/05/15 职场文书
医学生自荐信范文(2016精选篇)
2016/01/28 职场文书
当你焦虑迷茫时,请读读这6句话
2019/07/24 职场文书
MySQL系列之七 MySQL存储引擎
2021/07/02 MySQL