Dojo Data Store —— 统一数据接口

1、本文已经首发于InfoQ中文站，版权所有，原文为?Dojo Data Store 统一数据访问接口?，如需转载，请务必附带本声明，谢谢。InfoQ中文站是一个面向中高端技术人员的在线独立社区，为Java、.NET、Ruby、SOA、敏捷、架构等领域提供及时而有深度的资讯、高端技术大会如QCon、线下技术交流活动QClub、免费迷你书下载如?架构师?等。无论在传统的桌面应用还是在主流的互联网应用中，数据始终占据着软件应用中的核心地位。当下已经是一个让人们耳熟能详的词汇，而由此带来的数据的开放与共享，引领我们走入了海量数据时代。在今天的互联网上，数据的交互几乎成为了我们的终极诉求，可随之而来的数据

2、多样性，信息的分布式存储及松耦合，以及数据量的几何级规模的膨胀也带来了数据组织上的难度的增大，与此同时，伴随着Ajax, RIA及面向效劳的网络应用的开展，其所要求的客户端数据处理逻辑的复杂性不断增加，使得开发难度不断加大。出于简化数据处理逻辑，增加应用的可维护及可扩展性的需求，目前流行的JavaScript框架也根本都会具有各自的数据处理模块或接口。本文的目的就是为了介绍Dojo的数据处理模块。作为Dojo的数据处理中间层，其主要的职责就是解析及管理由数据源传入的各种类型的数据，通过统一的数据访问与处理接口与数据展现层(Dojo Widget)进行通讯，便于各个Widget的管理与程序的移植

3、。Dojo Data中的数据管理在面向效劳应用大行其道的今天，协调数据的多样性是开发互联网应用中不可防止的首要问题。我们常见的数据格式包括Json, XML, Csv等，作为数据处理的中间层，能够让用户以统一的接口连接不同的数据源是一个根本需求。在模块中，预定义了不同的DataStore用于访问管理不同数据格式的数据源，而所有的DataStore都会实现相同的数据访问接口，这样就可以成功实现数据提供层与数据展现层之间的松耦合。表1中列出了Dojo中局部已实现的各种不同的DataStore。表1. Dojo中局部已实现的DataStoreDataStore描述用于JSON数据的只读的DataSt

4、ore用于JSON数据的可读写的DataStore用于CVS数据的只读的DataStore用于OPMLOutline Processor Markup Language数据的只读的DataStore用于HTML table数据的只读的DataStore用于XML数据的可读写的DataStore用于读取提供的数据的只读的DataStore。是一个很好的web service相关的DataStore的例如用于读取由效劳器端提供的JSON数据的只读的DataStore尽管读取的数据源多种多样，但在DataStore中，通过统一数据访问接口，对数据的组织管理是一致的。每条数据项都被作为一个item对象

5、，其中包含了一定的键(attribute)值(value)对用以对应数据条目中的各个属性值。下面以一段简单的JSON数据片段为例，来介绍这种对应关系：identifier: 'id',label: 'name',items: "id": "AF", "name":"Africa", "type":"continent","population":"900 million", "area"

6、;: "30,221,532 sq km" , "id": "AS", "name":"Asia", "type":"continent","population":"1 billion", "area": "25,428,192 sq km" 在这段JSON数据中共有两条数据项item，分别都包含有"id", "name", "

7、;type", "population"与"area"五个属性字段。Dojo.data 组织架构为了符合各种应用中对数据中间层的不同需求包对数据访问处理接口进行了一定程度的划分，包括 read，write，identify，notifaction 等。各种DataStore可以根据其应用需求实现特定的接口。表主要接口主要接口描述提供读取数据项或者其属性值的功能，同时也支持对数据集的搜索，排序，和过滤。提供创立，删除，更新数据项功能。提供基于唯一的标示符来定位和查询数据项的功能。提供当 datastore的数据项改变等事件发生时通知侦听器的功能。

8、最根本的事件包括数据的创立，修改和删除等。这也是的一项很重要的功能，通过此接口可以将数据展现层与数据中间层更好的别离开来。Dojo.data API简介Read数据的获取是数据中间层的核心接口为异步获取异构数据提供了很大的便利性和灵活性。在Read接口中，主要是通过异步方式进行数据的获取，同时也提供了数据的排序、分页、简单查询等根本功能的支持。fetch: function(/* Object */ keywordArgs)fetch方法可以说是包的核心方法，它主要采用异步方法来获取数据。该方法接收一个键值对对象参数，用户可以通过对此参数中各个属性进行指定以获取特定的数据集合，如分页，简单查询

9、过滤，排序等。以下是局部主要的参数属性介绍：onBegin与onComplete: fetch方法是采用异步的方式来进行数据的获取，用户可以通过onBegin与onComplete这两个参数指定fetch方法的数据获取回调函数，onBegin在数据返回前会被调用一次，传入两个参数，分别为应返回数据集的条目数及此次fetch的request对象；而onComplete方法是作为数据返回的回调函数，数据集作为第一个参数传入给该回调函数。start与count: 通常来说几乎所有的实际应用都会要求分页返回数据以提供更好的用户体验，start和count这两个属性就是为支持分页功能而实现的。start

10、用于指定返回数据的起始索引由0开始，而count那么用于设置返回的数据条目数。query: 除了分页以外，按需返回特定的数据集也是一项重要功能，在中，这一功能那么是通过query属性提供支持的。query的值一般可设置为一个键值对对象，“键应被设置为数据条目中的某项属性，而“值那么为条件指定。提供了精确匹配与模糊匹配通配符：*为任意字符，?为单个字符两种方式对数据进行过滤，可以根据具体情况选择使用。sort：由于可能出现多个Widget使用同一个DataStore，数据集并不会以特定的序列进行存储，当需要进行排序时，可以通过sort属性进行指定，DataStore那么会相应的返回符合条件的数据

11、集。sort 参数不仅指定了要排序的字段，而且还必须指定排序的顺序即升序还是降序。 dataStore.fetch(/ 设置获取数据的起始位置start: 0,/ 设置获取数据的条目数count: 25,/ 设置模糊过滤条件query: 'name': *,/ 数据排序设定sort: attribute: 'name', descending: false ,/ 设置开始数据获取的回调函数onBegin: function(size, requestObj).,/ 设置数据获取完成后的回调函数onComplete: function(items, request

12、Obj).,/ 设置数据获取失败后的回调函数onError: function(error, requestObj).);getValue: function(/*item*/item, /*attribute-name-string*/attribute, /*value?*/ defaultValue) 用于获取某个给定的数据项的某个属性值，如果该条数据不含有指定的属性，那么返回一个指定的默认值。item参数为给定的数据项，attribute参数为指定的属性字段，defaultValue为可选参数。 var value = dataStore.getValue(item, 'nam

13、e', 'no name');getAttributes: function(/* item */ item) 获取给定数据项的所有属性字段，返回值为一个数组。Write接口主要提供了数据的更新功能API，包括创立、删除、更新数据。同 Read 接口类似，Write API 的设计目标也是屏蔽底层数据存储格式的差异，为用户提供统一的数据访问 API。借助这些 API，用户可以专注于业务层面的逻辑实现，而无需花费太多精力去关注底层数据的存储格式。newItem: function(/*Object?*/ keywordArgs, /*Object?*/ parentInf

14、o) 在DataStore中新创立一个数据项。第一个参数为一个键值对对象，用于设定新创立的数据项，第二个参数为可选参数，当用户想将新创立的数据项作为某个已存在的数据项的子，那么可以通过这个参数进行设定。具体应用请参照下面的小例如： var euItem = "id": "EU", "name":"Europe", "type":"continent", "children": / 新建数据项dataStore.newItem(euItem);/ 新建子数据

15、项dataStore.newItem("id": "GM", "name":"Germany", "type":"country", parent: euItem, attribute: "children");deleteItem: function(/*item*/ item) 在DataStore中删除指定的数据项。setValue: function(/*item*/ item, /*string*/ attribute, /*almost any

16、thing*/value) 更新某条给定数据项的某个属性值。Notification当DataStore中有数据更新时，相应的Notification中定义的监听函数就会被调用。使用过Dojo的读者可 能都会注意到，在Widget中一般不会有new、delete等其他JavaScript库控件中常见的API。这是因为Dojo data的设计是力求将数据层与表现层进行分割，对数据的操作都集中在数据层进行控制，而数据集的改变也能够自动的在应用控件上进行反映，这一功能就是当DataStore在进行数据更新操作时，通过Notification接口的通知作用实现的。onNew: function(/*i

17、tem*/ newItem, /*object?*/ parentInfo) 当DataStore中创立新数据项操作成功后被自动调用。newItem参数就是新创立的数据项对象，parentInfo是可选参数，用于描述新创立数据项的父数据项。onDelete: function(/*item*/ deletedItem) 当DataStore中删除某项数据项后被自动调用。deletedItem参数就是被删除的数据项对象。onSet: function(/*item*/ item, /*attribute-name-string*/ attribute, /*object | array*/ ol

18、dValue, /*object | array*/ newValue) 在DataStore的某项数据项被更新后进行调用。四个参数分别为数据项对象，被更新数据项属性，该数据的原有值以及更新后的值。Identify很多数据源都会为数据提供唯一的标识符接口那么提供了基于唯一标识符进行数据获取定位的API支持。fetchItemByIdentity: function(/*object*/ keywordArgs) 同Read接口中的fetch方法类似，此方法也是一个异步方法，用户需要在参数对象中指定数据项获取后的回调处理函数。keywordArgs参数是一个键值对对象，主要需要包括两个属性，一个

19、是要进行指定获取的数据项标识符identify，另一个那么是回调处理函数onItem。在指定identify的数据项获取成功后，onItem回调函数那么会被自动调用，以处理后续操作。 dataStore.fetchItemByIdentity(/ 指定要进行获取的数据项的ididentity: "AS",/ 设定数据返回后的回调函数onItem: function(item),/ 设定错误回调函数onError: function(error);getIdentity: function(/*item */ item) 此方法用于获取给定数据项的标识符。DataStore应

20、用一般来说，Dijit中的各个小部件都提供了对DataStore的支持，当我们在使用某个Widget来进行数据展现时，通常我们只需要根据数据源的格式类型来选择好DataStore，然后在Widget声明中对DataStore进行指定就可以了。下面我们就通过DataGrid及ComboBox作为数据展现UI，基于不同的数据格式为它们设置不同的DataStore。以下是一份JSON数据：data = identifier: 'id',label: 'name',items: "id": "AF", "name&quo

21、t;:"Africa", "type":"continent","population":"900 million", "area": "30,221,532 sq km" , "id": "AS", "name":"Asia", "type":"continent","population":"1 bill

22、ion", "area": "25,428,192 sq km" , "id": "OC", "name":"Oceania", "type":"continent","population":"21 million", "area": "15,928,294 sq km" , "id": "EU", &qu

23、ot;name":"Europe", "type":"continent","population":"56 million", "area": "25,928,294 sq km" , "id": "NA", "name":"North America", "type":"continent","population

24、":"100 million", "area": "90,928,294 sq km" , "id": "SA", "name":"South America", "type":"continent","population":"102 million", "area": "78,928,294 sq km" , "i

25、d": "AN", "name":"Antarctica", "type":"continent","population":"998", "area": "102,928,294 sq km" ;在这里，我们采用比拟简单的dojo.data.ItemFileReadStore：var jsonStore = new dojo.data.ItemFileReadStore(data: data);ItemF

26、ileReadStore比拟适合于处理数据量较小的数据源，数据源可以是一个JSON文件或者象本例一样直接指定到客户端内存中的一组数据。当你使用更加大型的JSON数据集时，可以使用JsonRestStore，采用Rest效劳来进行数据提供。接下来，我们来声明一个DataGrid。在这里DataStore是通过store属性进行设置的。<table jsid="grid" store="jsonStore" query="name:*'" dojoType="dojox.grid.DataGrid" cl

27、ass="grid"><thead><tr><th field="name" width="auto">Name</th><th field="population" width="auto">Population</th><th field="area" width="auto">Area</th></tr></thead><

28、;/table>生成的DataGrid如下列图所示：由于Dojo中对数据展现层与数据中间层的松耦合，同样一份数据源可以在不进行任何处理的情况下为多个Widget提供数据，而且由于数据的过滤、排序、分页都是根据数据获取请求按需返回的，使用相同 DataStore的多个Widget间也不会产生冲突。下面我们就以同样的DataStore，为一个提供数据：<input dojoType="dijit.form.ComboBox" store="jsonStore" searchAttr="name"></input&g

29、t;在很多实际应用中，可能会使用不同的数据源，下面，我们采用不同的数据格式，以XmlStore来替换ItemFileReadStore。首先将JSON数据转换为XML数据格式：<continents><continent><name>Africa</name><population>900 million</population><area>30,221,532 sq km</area></continent><continent><name>Asia</n

30、ame><population>1 billion</population><area>25,428,192 sq km</area></continent><continent><name>Oceania</name><population>21 million</population><area>15,928,294 sq km</area></continent><continent><name>Euro

31、pe</name><population>56 million</population><area>25,928,294 sq km</area></continent><continent><name>North America</name><population>100 million</population><area>90,928,294 sq km</area></continent><continent><name>South America</name><population>102 million</population><area>78,928,294 sq km</area></continent><continent><name>Antarctica</name><population>998</population><area&