SmartGWT学习整理 2、理解核心中的核心DataSource

SmartGWT学习整理 2、理解核心中的核心DataSource

DataSource之所以重要，是因为它负责所有的与服务器的数据交互，几乎所有的控件都离不开它。
可以这样说，理解了DataSource就掌握了SmartGWT的70%

DataSource支持的数据格式有xml、json、webservise等。他可以将数据按照指定的格式解析为可供控件使用的数据（Record对象），每一条数据就想数据库中的一行记录一样。
举个记录列表的例子来说，http://www.smartclient.com/smartgwt/showcase/#grid_databinding_xml_datasource
showcase中的这个例子就是将xml文件作为数据源，格式为
<List>

<country>
    <continent>North America</continent>
    <countryName>United States</countryName>
    <countryCode>US</countryCode>
    <area>9631420</area>
    <population>298444215</population>
    <gdp>12360000</gdp>
    <independence>1776-07-04</independence>
    <government>federal republic</government>
    <government_desc>2</government_desc>
    <capital>Washington, DC</capital>
    <member_g8>true</member_g8>
    <article>http://en.wikipedia.org/wiki/United_states</article>
</country>
...
...
...
</List>

每条country记录包括了continent、countryName等字段，那么对应的DataSource就是

private static class CountryDS extends DataSource {  
        // The DataSource would normally be defined external to any classes that use it.  
 
        private static CountryDS instance = null;  
          
        public static CountryDS getInstance() {  
            if (instance == null) {  
              instance = new CountryDS("countryDS_XML");  
            }  
            return instance;  
        }  
 
        public CountryDS(String id) {  
            setID(id);  
            setDataFormat(DSDataFormat.XML);  
            setRecordXPath("/List/country");  
            DataSourceField countryCodeField = new DataSourceField("countryCode", FieldType.TEXT,  
                                                                   "Code");  
            DataSourceField countryNameField = new DataSourceField("countryName", FieldType.TEXT,  
                                                                   "Country");  
            DataSourceField capitalField = new DataSourceField("capital", FieldType.TEXT,  
                                                               "Capital");  
            setFields(countryCodeField, countryNameField, capitalField);  
            setDataURL("ds/test_data/country.data.xml");  
        }  
 
    }  

showcase里的这个例子是通过继承DataSource来创建实例，一般也可以直接new DataSource()来创建。
这里用到了DataSource中的几个重要方法，
setDataFormat(DSDataFormat.XML);//这个方法声明了要调用的数据源是xml格式的
setRecordXPath("/List/country"); //声明了解析xml的数据路径，这里就是指在<List>标签下的<country>标签就是需要的数据
然后定义了3个字段DataSourceField
setFields方法设定DataSource中所有的字段。
setDataURL("ds/test_data/country.data.xml"); 这个方法指定了数据源的url地址，DataSource将从这个地址获取数据

数据字段DataSourceField的构造函数DataSourceField(String name, FieldType type, String title)
name是数据内部使用的名字，FieldType是指定数据的类型，title是供控件显示给用户的名字

一般不直接使用DataSourceField，而是使用它的子类，都在com.smartgwt.client.data.fields包下，
例如字符型字段就用DataSourceTextField，布尔型用DataSourceBooleanField等等。

接下来定义一个列表控件(ListGrid)用来展示数据

final ListGrid countryGrid = new ListGrid();  
countryGrid.setWidth(400);  
countryGrid.setHeight(224);  
countryGrid.setShowAllRecords(true);  
countryGrid.setDataSource(CountryDS.getInstance());//将定义好的DataSource传递给列表控件
countryGrid.setAutoFetchData(true); //设定控件在显示的时候自动通过DataSource获取数据，如果设为false的话，那么需要手动通过countryGrid.fetch();方法来获取数据
countryGrid.draw();

这样一个显示国家数据的列表页面就完成了。

接下来再看一个json数据格式的例子
http://www.smartclient.com/smartgwt/showcase/#grid_databinding_json_datasource
里边的差别就是建立DataSource的时候通过setDataFormat(DSDataFormat.JSON);  
将数据源的格式指定为json格式，没有指定setRecordXPath是因为这个json数据里根节点的数据就是需要的数据。

可以看到用SmartGWT可以很方便的来展示数据，在MVC框架中可以用SmartGWT来画前台界面，后台只需要生成指定格式（xml或json，个人比较偏向使用json）的数据就可以了。

建了个smartGWT的qq群，有兴趣的可以进来一起学习讨论

117824970