dojo.data研究笔记

最近研究了一些，也翻译了一些，贴出来和大家分享。dojo的更多内容可以上： www.dojocn.cn 上查看。

一下内容是原创，转载请注明：

dojo.data 是什么?


dojo.data 是一个统一的数据访问层,它没有数据库驱动的概念,只是一个统一的数据格式.

所有的数据被表现成一个 item 的 子item 或者 attribute , 由于这样,数据就能够被统一的方式访问.



为了直接拿来就可以用,dojo.data提供了一个基础的 JsonItemStore 去读一个特定格式的JSON 数据.

DojoX 这个项目(或者说是模块)提供了更多的 stores (比如:XmlStore , CsvStore , OmplStore),这些stores可以解决服务器提供的对应的这些格式的数据.



此外,dojo.data是一个其他用户可以重写的API,这个概念类似java中的接口,因此,你可以编写一个定制数据格式的dojo.data的一个子集.

当你的定制好自己的特定格式,而且按照dojo.data的规范来做,widgets 就可以直接知道你的datastore,并且其他的程序可以读取你的数据,而不用了解你的特定格式.



dojo.data的最终目标是提供一个易用灵活的API集,就像interfaces.使datastore按照统一的格式被定制或者重写.

按照标准接口写的store就能够被多样的广泛的应用程序或者widget等等使用.

本质上,API隐藏了特定格式的数据,这些格式在JSON,XML,Csv或者其他数据格式,并且提供了一个一致的读item的attribute的方法,并且,用户可以根据实际的使用情况定制最优化的方法读取数据.(这一句翻译的不好)



你可以理解dojo.data是dojo.xhrGet()(这个封装了XMLHttp发送请求到服务器)上的一层,他们都是不用刷新页面的异步操作.但是xhrGet将能够读取任何MIME类型的数据并且一下子都返回,然后就依靠store去翻译这些数据成需要的格式,从而形成一般的读取模型.



综上:dojo.data提供了一套统一的读取数据的方法,它的目的就是提供一个标准,大家按照这个标准来开发读取数据的方法.

dojo.data对页面组件关系非常密切,比如Tree和Combox都使用了store做为数据源.所以学好这个对灵活使用widget很有帮助



=========================================================================================================================

dojo.data 术语


dojo.data 术语类似关系型数据库术语,下面比较和对比了dojo.data术语和关系型数据库的术语:



dojo:datastore

db:cursor

描述:js对象通过dojo.data APIs从data source读取数据并且使 data item可用



dojo术语:data sorece

db术语:table

描述:这是保存原始数据的地方,比如:一个CsvStore数据源可能是.csv格式的文件,通常,data source是一个文件或者是个数据库服务器,或者是一个webservice或其他



dojo术语:item

db术语:row

描述:data item有很多属性,这些属性都有值



dojo术语:attribute

db术语:column

描述:一个item的域或者属性.



dojo术语:value

db术语:-

描述:属性的内容



dojo术语:reference

db术语:-

描述:一个item指向另一个item的值



dojo术语:identity

db术语:primary key

描述:主键



dojo术语:query

db术语:Where字句

描述:读取数据的条件.注意:非常建议所有的store使用attribute的name/value成对的结构,作为查询的格式连接stores.



internal data representation:一个私有的数据结构,datastore用它来缓存数据到客户端,比如XML DOM节点,匿名JSON对象或者数组



dojo术语:request

db术语:Sql Select

描述:一个用来筛选item的参数,包括query,筛选attributes ,大小写的限制和回调函数



=============================================================================================================================

www.dojocn.cn 转载请注明

dojo.data 设计和编程接口


在直接学习dojo.data的API之间，在研究API之前的基本概念必须先探究一下，因为一些设计上的决定被选择,但却没有解释为什么选择它们，可能会使这个设计看上去很奇怪。因此，在研究api细节之前，先完整的阅读这些概念：



概念1：数据访问被分成分离的APIs，store可以有选择的实现这些API

数据访问被破坏成分离的APIs，因为不是所有的服务和数据回传都需要所有的访问或者函数。因此不是所有的datastore能够实现比如read,write,identify,notifications这样的函数（注意这里的函数是js的function,在这里可以想像成java的接口）。

为了能够简单的就知道这个store提供什么特性，每一个store必须提供getFeatures()这个函数，这个函数报告出这个store使用了哪些APIs。

下面是基础的APIs定义：

dojo.data.api.Read:能够从一个dataitems里读取子items和attribute。而且可以查询，排序，过滤数据。



dojo.data.api.Write:能够生成、删除、更新dataitems和attribute。不是所有的服务都允许修改数据项的。实际上，大多数公共的服务，比如：Flikr,Delicious还有googleMaps都只是提供读取服务。



dojo.data.api.Identity:能够通过唯一标识定位查找一个数据项，不是所有的数据服务有唯一标识的。



dojo.data.api.Notification:能够将发生在store上的数据修改事件通知给监听器。基础的功能是那些生成、删除、更新一个数据项的事件。对于像定期将数据更新的事件通知backend服务有显著的用处。



将来的一些特性：

下面的特性是一些dojo开发团体将会定义的额外的特性，这些都还没有完全明确，并且还在开发中。因此，他们没有被提供在当前版本的开发包中。注意啊，下面的列表可能随时变化。

dojo.data.api.Schema

dojo.data.api.Attribution

dojo.data.api.Versioning

dojo.data.api.Derivation

  www.dojocn.cn 转载请注明

概念二：数据项和数据项的属性经常通过store的函数来访问，修改，创建和删除，而从来不直接访问。

这个概念就是防止dojo.data在最初的时候表现出来混乱，下面的例子显示了这个概念：

---------------------------------------------------------------------------------

var store = new some.data.Store();

var items;

.......

//假设这时items已经通过store.fetch()得到了数据，成为了array

//为了列举出这个数组的值，你要这样做：

for(var i=0;i<items.length;i++){

   var item=items[i];

   console.log("For attribute 'foo' value was:["+store.getValue(item,"foo")+"]");

}

----------------------------------------------------------------------------------

为什么不像下面这样做呢?

var value=item["foo"];

var value=item.foo;

var value=item.getValue("foo");



为什么这是dojo.data必须要求的呢？下面是原因：

1、访问效率。通过store的函数访问,store可以隐藏item的内部结构,无论在什么特殊形式下的数据格式,item都能保持一个格式.比如:

item可能是一个XML元素,这种情况下,当调用store.getValue()时store将使用DOM的API来访问数据;另外一种情况下,如果item是个一个javascript结构,那么store将通过javascript的访问符号来访问数据.从最终用户的角度来看,这个访问都是一样的:store.getValue(item,"attribute"),因此提供了一个统一的感观去访问多样的类型数据.通过减少item的加载次数,也提高了访问item的效率,因为你不用每次都转换格式了.



2、store可以使用非常简洁的内部结构。这大大减少了程序员记忆每种数据格式的工作量。



3、能够提供懒加载的模式

=======================================================================================





The Read API
Dojo.data 中最基础的API（或者说是接口）就是Read API. 所有的Store都必须实现这个接口，因为所有的store都需要获取和处理item(数据项)。针对处理数据项，Read API被设计的非常灵活。Read API提供如下的功能：

l         查看datastore都实现了那些接口，具有什么功能。通过getFeatures()方法。

l         查看一个item所包含的所有属性而不需要了解这个item的格式。getAttributes(item)方法

n         比如：一个item记录着一个学生的信息。通过getAttribuets()方法，你能得到这个学生包括哪些信息，比如：姓名，学号，等等。

l         获取item的属性的值，而不用知道item的格式。

n         Item的保存格式有很多中，有json或者csv或者数据库中保存。通过getValue方法，你就能得到一个item的属性的值，转换数据格式交给store来做。

l         查看所有的items的属性，看看有没有指定的值。

l         验证一个js Object是不是store产生的item.

l         查看一个item是不是被完全加载了，还是仅仅是一个需要被加载的根(stub). isItemLoaded()

l         加载一个stub item ,这个方法就是懒加载的时候使用的。loadItem()

l         通过一些查询条件来查询items

l         给一些items排序

l         为一个查询结果分页。（我觉得对非数据库型的查询也许会有用一些，至少能使操作方便一些吧）

l         通过通配符( * 和 ? )来过滤查询结果

  www.dojocn.cn 转载请注明

一些例子：
1、  查看一个store支持那些APIs

var store = new some.Datastore();

var features = store.getFeatures();

for(var i in features){

    console.log("Store supports feature: " + i);

}



2、  测试一个对象是不是一个item

var store = new some.Datastore();

if(store.isItem(someObject)){

    console.log("Object was an item.");

}else{

    console.log("Object was NOT an item.");

}



3、  列举一个item的所有属性

var store = new some.Datastore();

...

//Assume that someItem is an item we got from a load.

var attributes = store.getAttributes(someItem);

for(var i = 0; i < attributes.length; i++){

    console.log("Item has attribute; " + attributes[i]);

}



4、  测试一个item是否包含特定的属性

var store = new some.Datastore();

...

//Assume that someItem is an item we got from a load.

var attributes = store.getAttributes(someItem);

for(var i = 0; i < attributes.length; i++){

    console.log("Item has attribute; " + attributes[i]);

}



5、  得到一个item的label


       var store = new some.Datastore();

...

//Assume that someItem is an item we got from a load.

var label = store.getLabel(someItem);

console.log("item has label: " + label);



//其实一个item的label也是一个item的属性，只不过是一个特殊的属性。在json的开始部分：label:”name” 这个就声明了，item的name属性就是item的label，所以通过getLabel就得到了name属性，也就等同于getValue(item,”name”);



6、得到一个store的所有数据

var pantryStore = new dojo.data.JsonItemStore({url: "pantry_items.json" } );



//Define the onComplete callback to write COMPLETED to the page when the fetch has finished returning items.

var done = function(items, request){

    document.appendChild(document.createTextNode("COMPLETED"));

}



//Define the callback that appends a textnode into the document each time an item is returned.

gotItem = function(item, request) {

    document.appendChild(document.createTextNode(pantryStore.getValue(item, "name"));

    document.appendChild(document.createElement("br"));

}



//Define a simple error handler.

var gotError = function(error, request){

    alert("The request to the store failed. " +  error);

}



//Invoke the search

pantryStore.fetch({onComplete: done, onItem: gotItem, onError: gotError});   

//这里onComplete和onItem同时使用的时候onComplete的items参数是null,这点请注意。



6、  通过一个标识得到一个item

var pantryStore = new dojo.data.JsonItemStore({url: "pantry_items.json" } );

   var pepperItem = pantryStore.getItemByIdentity("pepper");

   if (pepperItem !== null){

        alert('Pepper is in aisle ' + pantryStore.getValue(pepperItem,"aisle");  

   }

       //这个标识在json的开头部分有声明, identifier: 'name' ，也就是说item的name属性是标识。



7、  通过条件获取数据

jsonItemStore.fetch({

        queryOptions: {ignoreCase: true},  //忽略大小写

        query: { name: "*pepper*", aisle: "Spices" }, //name 和 aisle是属性的名称

        onComplete:

                ...  

   });

8、  嵌套定义item

一个item可以包括多个子item就像一棵树一样。使用reference可以关联子节点。通过getValues()方法可以得到孩子节点的数组。



9、  分页

    var store = new dojo.data.JsonItemStore({url: "pantryStore.json" });

    var pageSize = 10;

    var request = null;

    var outOfItems = false;



    var onNext = function(){

       if(!outOfItems){

           request.start += pageSize;

           store.fetch(request);

       }

    };



    var onPrevious = function(){

       if (request.start > 0){

          request.start -= pageSize;

          store.fetch(request);

       }

    }

    var itemsLoaded = function(items, request){

       if (items.length < pageSize){

       

          outOfItems = true;

       }else{

          outOfItems = false;

       }

       ...

    }



request = store.fetch({onComplete: itemsLoaded, start: 0; count: pageSize});



10、              排序

var store = new dojo.data.JsonItemStore({url: "pantryStore.json"});



var sortKeys = [

    {attribute: "aisle", descending: true},

    {attribute: "name", descending: false}

];



store.fetch({

       sort: sortKeys;

       onComplete:

           ...

});

//When onComplete is called, the array of items passed into it

//should be sorted according to the denoted sort array.

转载自：http://www.cnblogs.com/amushen/archive/2007/07/18/822186.html