C1 Wijmo DataSoruce

Wijmo DataSoruce
综述：
Wijdatasource 类被用于给 wijwidgets 提供数据。Wijdatasource 需要配合 datareader 和 proxy 使用。Wijdatasource 类、datareader 类和 proxy 类在 jquery.wijmo.wijdatasource.js 文件中实现。
1.下面分别提供显示前端和后端数据的例子：
显示前端数据
可以使用以下代码去读取前端数据：

// array to read
var testArray = ["c++", "java", "php", "coldfusion", "javascript", "asp", "ruby", "python", "c", "scala", "groovy", "haskell", "perl"];
// create datareader of array
var myReader = new wijarrayreader([{name: 'label'}, {name: 'value'}, {name: 'selected',defaultValue: false}]);
// create datasource
var datasource = new wijdatasource({
    reader: myReader,
    data: testArray,
    loaded: function (data){
                // get items by data.items
                var items = data.items;
            }
});
// load datasource, loaded event will be fired after loading.
datasource.load();
复制代码

显示后台数据：
可以使用以下代码去读取后台数据

// define a proxy
var proxy = new wijhttpproxy({
            url: "http://ws.geonames.org/searchJSON",
            dataType: "jsonp",
            data: {
                featureClass: "P",
                style: "full",
                maxRows: 12,
                name_startsWith: 'ab'
            },
            key: 'geonames'
        });
// define a reader
var myReader = new wijarrayreader([
    {
        name: 'label',
        mapping: function (item){
            return item.name + (item.adminName1 ? ", " + item.adminName1 : "") + ", " + item.countryName
        }
    },
    {name: 'value',mapping: 'name'}]);
// create datasource
var datasource = new wijdatasource({
    reader: myReader,
    proxy: proxy,
    loaded: function (data){
        // read items.
        var items = data.items;
    }
});
// trigger load.
datasource.load();
复制代码

文件，例如 JavaScript 和 CSS 文件。使用Wijdatasource 我们需要添加一下引用：
<script src="jquery-1.7.1.js" type="text/javascript"></script>
3.字段
data：
wijdatasource  处理的数据集
Type：Object
Default：null
例子：

var datasource = new wijdatasource({
    reader: myReader,
    data: testArray,
    loaded: function (data){
                // get items by data.items
                var items = data.items;
            }
});
复制代码

proxy ：
wijdatasource  的 proxy。wijdatasource  会调用 proxy 字段的 request 方法。在 proxy 字段中，你可以发送 request 到远程服务器来获得 data，这种方式是无刷新的 Ajax 模式。之后我们就可以通过wijdatasource  的reader 来处理返回的纯数据了。
Type：Object
Default：null
示例：

// create datasource
var datasource = new wijdatasource({
    reader: myReader,
    proxy: proxy,
    loaded: function (data){
        // read items.
        var items = data.items;
    }
});
复制代码

Reader：
Wijdatasource 使用 的reader。Wijdatasource 使用 reader 的read方法从Array中读取原始数据。Field 包含 name，mapping，和默认值 defaultValue 属性 which define the rule of mapping.如果 Wijdatasource 下没有定义 reader，就直接返回原始数据。
Type：Object
Default：null
示例：

var datasource = new wijdatasource({
    reader: myReader,
    data: testArray,
    loaded: function (data){
                // get items by data.items
                var items = data.items;
            }
});
复制代码

4.事件：
Loaded：
Wijdatasource 在加载数据结束时触发该事件
参数：
    Datasource：触发该事件的 wijdatasource 。
    Data：load 方法传递来的数据。
示例：

var datasource = new wijdatasource({loaded: function(e, data) { }})
复制代码

loading：
Wijdatasource 在加载数据之前触发该事件
    Datasource：触发该事件的 wijdatasource 。
    Data：load 方法传递来的数据。
5.方法：
Load
Load（data,forceLocalReload）
触发Wijdatasource 的加载数据。
参数：
    data：传递给 Loading 和Loaded 事件的数据。
    forceLocalReload：正常情况下，数据值加载一遍，如果你需要反复加载数据，需要设置forceLocalReload 为 true。
示例：

var datasource = new wijdatasource({
    reader: myReader,
    proxy: proxy,
    loaded: function (data){
        // read items.
        var items = data.items;
    }
});
// trigger loading without parameters.
datasource.load();
复制代码

read
触发Wijdatasource 下 DataReader 的数据读取过程，如果存在 DataReader 的话。
示例：

var datasource = new wijdatasource({
    reader: myReader,
    data: testArray
});
// trigger reading.
datasource.read();
//get the result
var mappingData = datasource.items;
复制代码

属性：
Items
原始数据的容器。在数据加载之后可以获得该属性。
Type：Array
Default：[]
示例：

var datasource = new wijdatasource({
    reader: myReader,
    proxy: proxy,
    loaded: function (data){
        // read items.
        var items = data.items;
    }
});
// trigger loading.
datasource.load();
复制代码