转载地址：http://blog.csdn.net/eengel/article/details/13021687

介绍

同样是de打头，我经常被dojo define和dojo declare弄晕。单词长的像，表面意思似乎也很像。翻译成中文叫“定义”和“声明”，可也不是Java中说的那样。那Dojo中是怎么安排这两个词的呢（Dojo 1.7.3）？

 

Define

先看define。作用是定义一个模块（module）。这个模块可以被require引用，引用了之后就可以使用define里面的东西。一个模块想当然，里面干什么事情，不一定全部自己实现。就像人要coding，除了脑子，也不能没有电脑、键盘。因此，define的第一个参数就是将要用到的其他模块引进来。第二个参数描述这个模块具体干什么，并且给第一个参数中的模块分别起一个朗朗上口的名字。就像下面这段代码描述的样子。

 

util.js

[javascript]  view plain  copy  

1. define([ "dojo/dom"], function(dom) {  
2.     return {  
3.         setRed: function(id){  
4.             dom.byId(id).style.color = "red";  
5.         }  
6.     };  
7. });  

这是一个工具模块，其中一个功能就是把网页上id对应的DOM节点变成红色。当我们要使用它的时候，就可以用require了。

 

test.jsp

[html]  view plain  copy  

1. <script>  
2.     require(  
3.         [ "dojo/ready", "test/util" ],  
4.         function(ready, util) {  
5.             ready(function() {  
6.                 var id = "selected_text";  
7.                 util.setRed(id);  
8.             });  
9.         });  
10. </script>  

Declare

可以看到，上面的模块util作为工具模块，可以在被引用后任意调用其功能。这是无状态的，就好象是一个singleton的对象。但如果我们想定义“类”一样的东西，有状态，可以创建多个对象，就需要在define里用declare。最典型的例子就是dijit下面的诸多UI小控件。

举个很简单的例子，我希望基于dijit.Dialog，创建一个有特殊功能的dialog，每次打开后能把上面的一段text标记为红色。

 

RedTextDialog.js

[javascript]  view plain  copy  

1. define([ "dojo/_base/declare", "dijit/Dialog", "dijit/_WidgetBase",  
2.         "dijit/_TemplatedMixin", "test/util" ], function(declare,  
3.         Dialog, _WidgetBase, _TemplatedMixin, util) {  
4.     return declare("test.RedTextDialog", [ Dialog, _WidgetBase, _TemplatedMixin ], {  
5.         title: "Dialog with Red Text",  
6.           
7.         onDownloadEnd : function() {  
8.             var id = "selected_text";  
9.             util.setRed(id);  
10.         }  
11.     });  
12. });  

RedTextDialog可以重写dijit.Dialog所有的方法，也可以自创方法、变量，实现自己想要的任意功能。接下来可以用require使用它。

[html]  view plain  copy  

1. <script>  
2.     require(  
3.         [ "dojo/ready", "test/RedTextDialog" ],  
4.         function(ready, RedTextDialog) {  
5.             ready(function() {  
6.                 var dialog = new RedTextDialog();  
7.                 dialog.show();  
8.             });  
9.         });  
10. </script>  

可以看到，每次使用RedTextDialog时，都可以创建一个新的对象实例，因此可以做到互相之间没有关系。

目录结构

为了在test.jsp中调用上述js文件，需要在test.jsp声明js文件的位置。

[javascript]  view plain  copy  

1. <script>  
2.     dojoConfig = {  
3.         isDebug : false,  
4.         parseOnLoad : true,  
5.         async : true,  
6.         packages : [   
7.             {  
8.                 name : "test",  
9.                 location : "../../js/test"  
10.             }  
11.         ]  
12.     };  
13. </script>  

最后，约定俗成地，一般define类似util的singleton模块，js文件的名字第一个字母小写；而类似RedTextDialog的类模块，第一个字母大写。