Dojo中AMD模块化和本地变量的命名规范

客户端Web应用开发的健壮性已经变得越来越强,有很多工具可以用来增强终端客户的沉浸感和交互性的用户体验。随着用户数量的激增,高效编写代码的重要性尤为突出。采用dojo以及其他AMD兼容的工具,使编写良好模块化的前端代码变得简单容易。当采用AMD的开发模式,开发人员可以容易的编写出模块化的前端代码,但是需要面临两方面的问题,如:一、合理命名模块;二、对引用某模块的本地变量确定相应的命名规范。

首先,复习一下AMD技术的一些专业术语:

简单地说,包的概念就是模块的集合,例如:dojo,dijit和gridx。然而,不同于模块目录中的各个简单集合,包本质上还包括一些额外的特性,能够显著增强模块的可移植性和易用性。

包主要有三个配置选项,包括:name,包的名称;location,包的位置,可以是对baseUrl的相对路径,也可以是绝对路径;main,它是一个可选参数默认值为”main”,用于发现和正确的加载模块用户尝试引用的包。例如:代码中写到require “dojo”,实际上会加载的文件是”dojo/main.js”。

管理模块是至关重要的,因为每个包的依赖数量必须限制在一定范围内。如果有一个包依赖于其他所有的包,那么这个包将很难被拿出来单独使用。模块也需要通过一种有意义的方式进行打包,例如:对于同一个包,不要即包含数学符号PI的运算模块,也包含表单控件的显示模块。

模块

一个模块可以使一个类、一个函数、一个包含属性和方法的对象,也可以仅仅是一段可运行的代码。模块的功能是强大的,可以使程序的低耦合度降低,并且易于重用。

模块的名称是自动从它的文件路径名中提取出来的,例如:一个模块的文件路径为art/shapes.js,那么它将通过名称”art/shapes”被模块引用。更多关于模块命名、定义和引用的详细信息请参见AMD API specification一文。

Dojo的加载器使得模块的重定向过程变得简单,模块的重用工作只需要复制模块的文件到目标路径即可。例如:将模块文件art/shapes.js移动到模块geometry中变成geometry/shapes.js,引用该模块只需要调用新的模块标示”geometry/shapes”。如上所示,将模块在不同的包之间移动变得容易,也使得解耦合和代码重用变得简单易行。

Dojo加载器允许模块与本地变量名之间建立映射关系,选择变量名称和打包代码对于开发人员来说是极其重要的决定。以下将通过两三分钟的介绍,探索这个领域的更多细节,使dojo开发者从中受益。

应该如何命名模块?

进行模块开发时,采用合适的命名规范会提高开发的效率,能够保证模块的API直观清晰,同时也能减少模块名称的额外记忆负担。此外,它还能够使开发人员的时间花在更有意义的工作上,例如:项目优化和缺陷修复。当决定如何命名模块的时候,开发人员需要考虑诸如“是否为类构造函数类型”,“是否为一个混入类型(mixin)”,这些东西可以改变模块推荐的命名规范。

如果一个模块为类的构造函数类型,如:widget,它应该按照大写开头驼峰式命名格式(UpperCamelCase)来命名;如果是一个混入类型(mixin),应该依照下划线(_UnderscoreMixin)格式;如果都不是,应依照小写开头的驼峰(lowerCamelCase)命名格式,典型的例子为单体。

除了模块的合理命名外,利用require的回调函数引用模块时,对该模块映射的变量进行标准的命名方式也是一个好的习惯。在dojo开发中,这项工作被称为”首选参数别名(Preferred Arg Alias)”,其中一部分被推荐在 dojo.XX AMD modules spreadsheet文中。这篇文章强调绝大部分模块的命名必须准确和有意义,模块的首选参数别名与模块名称相似,即使无法准确描述,也必须将模块用一个有意义的方式打包。我们正努力改善这一点,关于这一点的工作可以在” 1.x to 2.0 migration document”一文中找到。选择一致的本地变量名称的好处如下:
  • 对构造函数(constructions)、混入(mixin)和单体(Singletone)维持推荐的命名规范
  • 为源模块提供一个很容易相关的名称
  • 选择一致的本地变量名可以更容易地复用dojo的例子和教程
模块的本地变量名可以很直接地引用到包含的模块。有时候一个模块标示无法通过一个理想的本地变量来命名。例如,如果这个名称是一个javascript中的保留字array,推荐做法是增加一个后缀名变成arrayUtil。或者,如果模块名包含连字符,例如”dojo/domo-construct”,推荐的做法是命名为正确的javascript变量domConstruct。这些本地变量仅在局部引用这些返回的模块依赖项,因此可以被任意命名,但是按照一致性格式可以有效地简化AMD方法。

结论

采用适当方式命名模块并将其映射到调用函数的传入参数上,以及采用有意义的方式进行打包,能够使代码更有可移植性并且易于维护和理解。想更深入了解AMD技术,可在SitePen组织的Dojo workshop中找到帮助。对于已有的一些旧代码,需要迁移到新版本的dojo中,或重新编写,或调试,都可以在SitePen的网站中找到支持和帮助。

附上原文链接: [http://www.sitepen.com/blog/2012/12/07/amd-module-and-local-variable-naming-conventions/]

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


我有一个网格,可以根据更大的树结构编辑小块数据.为了更容易知道用户保存了什么,我希望当用户第一次看到网格时,网格处于不可编辑状态.当用户准备好后,他们可以单击编辑按钮,这将使网格的某些部分可编辑.然后,有一个保存或取消按钮可以保存更改或还原.在大多数情况下它是有效的.但
我即将开始开发一款教育性的视频游戏.我已经决定以一种我可以轻松打包为Web,Mobiles和可能的Standalone版本的方式来实现这一目标.我不想使用Flash.因此,我确信(无论如何我会听取建议)使用JavaScript和SVG.我正在对这个问题进行大量研究,但我很难把各个部分放在一起.我知道Raphae
我正在使用带有Grails2.3.9的Dojo1.9.DojoNumberTextBox小部件–我在表单中使用–将固定格式(JavaScript基本格式)的实数值(例如:12.56)设置为HTML表单输入字段(但根据浏览器区域设置显示/编辑它们,所以用户总是看到格式正确的数字).另一方面,Grails期望输入字段根据浏览器
1.引言鉴于个人需求的转变,本系列将记录自学arcgisapiforjavaScript的学习历程,本篇将从最开始的arcgisapiforjavaScript部署开始,个人声明:博文不在传道受业解惑,旨在方便日后复习查阅。由于是自学,文章中可能会出现一些纰漏,请留言指出,不必留有情面哦!2.下载ArcGISforDe
我正在阅读使用dojo’sdeclare进行类创建的语法.描述令人困惑:Thedeclarefunctionisdefinedinthedojo/_base/declaremodule.declareacceptsthreearguments:className,superClass,andproperties.ClassNameTheclassNameargumentrepresentsthenameofthec
我的团队由更多的java人员和JavaScript经验丰富组成.我知道这个问题曾多次被问到,但为了弄清楚我的事实,我需要澄清一些事情,因为我在客户端技术方面的经验非常有限.我们决定使用GWT而不是纯JavaScript框架构建我们的解决方案(假设有更多的Java经验).这些是支持我的决定的事实.>
路由dojo/framework/srcouting/README.mdcommitb682b06ace25eea86d190e56dd81042565b35ed1Dojo应用程序的路由路由FeaturesRoute配置路径参数RouterHistoryManagersHashHistoryStateHistoryMemoryHistoryOutletEventRouterContextInjectionOutl
请原谅我的无知,因为我对jquery并不熟悉.是否有dojo.connect()的等价物?我找到了这个解决方案:http:/hink-robot.com/2009/06/hitch-object-oriented-event-handlers-with-jquery/但是没有断开功能!你知道jquery的其他解决方案吗?有jquery.connect但这个插件在我的测试中不起作用.
与java类一样,在dojo里也可以定义constructor 构造函数,在创建一个实例时可以对需要的属性进行初始化。//定义一个类mqsy_yjvar mqsy_yj=declare(null,{     //thedefaultusername    username: "yanjun",          //theconstructor   
我一直在寻找一些最佳实践,并想知道Dojo是否具有框架特定的最佳实践,还是最好只使用通用的Javascript标准?特别是我主要是寻找一些功能和类评论的指导方针?解决方法:对于初学者来说,这是项目的风格指南:DojoStyleGuide
我有’05/17/2010’的价值我想通过使用dojo.date.locale将其作为“2010年5月17日”.我尝试过使用dojo.date.locale.parse,如下所示:x='05/17/2010'varx=dojo.date.locale.parse(x,{datePattern:"MM/dd/yyyy",selector:"date"});alert(x)这并没有给我所需的日期
我正在尝试创建一个包含函数的dojo类,这些函数又调用此类中的其他函数,如下所示:dojo.provide("my.drawing");dojo.declare("my.drawing",null,{constructor:function(/*Object*/args){dojo.safeMixin(this,args);this.container=args[0];
我知道你可以使用jQuery.noConflict为jQuery做这件事.有没有办法与Dojo做类似的事情?解决方法:我相信你可以.有关在页面上运行多个版本的Dojo,请参阅thispage.它很繁琐,但似乎是你正在寻找的东西.一般来说,Dojo和jQuery都非常小心,不会破坏彼此或其他任何人的变量名.
我有一个EnhancedGrid,用户经常使用复杂的过滤器.有没有办法允许用户保存或标记过滤器,以便将来可以轻松地重新应用它?我知道我可以通过编程方式设置过滤器,但我无法预测用户想要的过滤器.谢谢!编辑:自己做了一些进展…使用grid.getFilter()返回过滤器的JSON表示,然后使用json.strin
我有这个代码:dojo.declare("City",null,{constructor:function(cityid,cityinfo){}});dojo.declare("TPolyline",GPolyline,{constructor:function(points,color){},initialize:function(map){});应该是什
我遇到的问题是我的所有javascript错误似乎来自dojo.xd.js或子模块.我正在使用chrome调试器和许多dijit功能,如dijit.declaration和dojo.parser.这有点烦人,因为它很难找到简单的错误或滑倒.我希望我可以添加一个选项,允许我的调试器在我的非dojo代码中显示选项会发生的位置.我是
我正在使用DojoToolkit数字/解析函数来处理格式化和使用ICU模式语法解析字符串.有没有人知道有可能采取任意ICU模式字符串并以某种方式使用Dojo(或其他)库将其分解为它的部分(例如,对于数字模式,它可以被分解为小数位数,数千个分组等…).我希望这样做,而不需要让我的代码密切了
我有两个看似相关的问题,访问在不同的地方定义的javascript函数.我遇到的第一个问题是调用我在firgbug或safari控制台中定义的函数.我定义了一个名为getRed的函数,如下所示:functiongetRed(row,col){//dosomethingstuffandreturntheredvalueasa
我想添加一个在Ajax调用中指定的外部样式表.我已经找到了一种方法来使用jQuery(参见下面的示例),但是我需要使该方法适应dojoJavaScript框架.JQuery示例$('head').append('<linkrel="stylesheet"type="text/css"href="lightbox_stylesheet.css">');谢谢.解决方法:一旦你
我正在尝试使用dojo.connect将onMouseDown事件连接到图像,如:dojo.connect(dojo.byId("workpic"),"onMouseDown",workpicDown);functionworkpicDown(){alert("mousedown");}类似的代码几行后,我将onMouse*事件连接到dojo.body确实完全正常工作.但是当我点击图像时