dorado中的视图实现类和监听器

视图模型实现类(DefaultViewModel.java)的主要功能:

 1. Dataset的初始化以及数据导入

 2. 各种View组件的初始化工作

DefaultViewModel也是动态创建的,由他来管理dataset的数据分批请求操作以及dataset的数据提交操作

每一次DefaultViewModel.java被创建的时候都会触发该类中的init方法，不同的初始化方式,该方法的参数会有所不同:

init方法的申明如下:

public void init(int state) throws java.lang.Exception

其中state为一个整数值,取值不同代表客户端向服务器端发出的不同类型的请求

页面请求:state为ViewModel.STATE_VIEW

分批数据下载:state为ViewModel.STATE_SERVICE

数据提交:state为ViewModel.STATE_UPDATING

在state为ViewModel.STATE_VIEW期间:

DefaultViewModel.java在读取视图模型xml配置文件时会解析两大类的对象：

Dataset

View组件

DefaultViewModel会自动创建Dataset与Contro对象,并将xml配置中的信息读取到相关对象中,同时自动执行DefaultViewModel的方法:

initDatasets

initControls

开发人员可以通过继承实现这两个方法的实现对dataset以及control的初始化工作。

在state为ViewModel.STATE_SERVICE期间,我们可以继承DefaultViewModel的doLoadData方法自定义实现dataset的数据加载工作。

在state为ViewModel.STATE_UPDATING 期间,我们可以继承DefaultViewModel的doUpdateData方法自定义实现dataset的数据保存工作。

常用开发技巧

1. 根据权限定制菜单的内容

为了实现权限菜单功能，我们可以利用initControls方法定制menu中的内部菜单项

protected void initControls() throws Exception {
　　Menu menu = (Menu)getControl("menu1");//获得视图模型已经定义的menu对象
　　MenuItem item = menu.addItem("value1", "文件");//添加文件子菜单
　　item.addItem("new", "新增");//在文件子菜单中添加下一级的新增子菜单项
　　menu.addItem("value2", "编辑");
　　menu.addItem("value3", "视图");
　　menu.addItem("value4", "工具");
}

通过menu对象提供的api我们可以很容易的构造出一个多极菜单。结合权限，我们只要在该处菜单的初始化过程之前获取登录用户的信息,一般的web系统都是通过session对象获取用户的登录信息，这儿也不例外,只是调整为通过dorado的上下文对象获取:

DoradoContext context = DoradoContext();

Object user = context.getAttribute(DoradoContext.SESSION, “sessionKey”);

以上代码和

Object user = session.getAttribute(“sessionKey”);

的效果是一样的。

通过DoradoContext对象我们可以很容易的获取登录系统的用户信息，并据次初始化菜单对象中的菜单项，实现权限管理。

2.根据权限定制按钮的可见性

同开发技巧1一样

Button buttonSave = (Button)getControl(“buttonSave”);// 获得视图模型已经定义的保存数据的按钮对象

buttonSave.setIgnored(true);//设定按钮的逃逸功能为true，这样在JSP打开后，该按钮就不会在客户端显示。

同1那样，如果这儿再添加权限管理，我们可以通过DoradoContext这个上下文对象获取登录用户的信息，并根据这个信息决定是否要设定buttonSave.setIgnored(true)使它逃逸不在客户端输出。

3. 根据查询条件定制dataset的返回结果

监听器(Listener)是基于dataset提供的一个监听和管理dataset对象的创建和查询以及数据保存的动作。事件对应列表:

Dataset事件	Listener事件
init	onInit
createFields	beforeCreateFields afterCreateFields
loadData	beforeLoadData afterLoadData
updateData	beforeUpdateData afterUpdateData

l   boolean beforeCreateFields(Dataset dataset)

当Dataset将要自动创建所有字段之前触发的事件.即当调用Dataset.createFields()之前触发的事件.

l   boolean beforeLoadData(Dataset dataset)

当Dataset将要装载数据之前触发的事件.即当调用Dataset.loadData()之前触发的事件.

l   boolean beforeUpdateData(Dataset dataset)

当Dataset将要装载数据之前触发的事件.即当调用Dataset.update()之前触发的事件.

以上listener的所有before方法都需要提供一个boolean的返回值,dorado根据这个返回值确定是否需要执行默认的initFields,loadData, updateData方法

Dataset与listener之间的关系，由dataset的管理者对象维护,在dorado中一般为视图模型或者数据坞对象,在视图模型或则数据坞中配置dataset对象时，通过listener属性管理监听器对象。

<Dataset
id="datasetSection"
type="Wrapper"
wrappedType="Sql"
dataSource="DIRWH"
originTable="DIR_Section"
keyFields="ID"
listener="sample.DatasetSectionListener" />

监听器是继承com.bstek.dorado.data.AbstractDatasetListener的实现类。

如果我们想自定义datasetSection的数据导入，对于DB类型的Dataset对象，我们可以通过监听器的beforeLoadData方法动态修改dataset的sql语句，让dataset的loadData方法执行使用beforeLoadData中定义的sql语句执行查询。

这样我们就应该创建一个新的监听器DatasetSectionListener.java继承与com.bstek.dorado.data.AbstractDatasetListener,并实现其中的beforeLoadData方法:

public boolean beforeLoadData(Dataset dataset) throws Exception {
　　String city = DoradoContext.getContext().getAttribute(DoradoContext.VIEW, “city”);//从Dorado的上下文环境中获取城市信息
　　String sql = “select * from section where city=’+city+”’”;//根据城市拼写地区的sql
　　SqlDataset sqlDataset = (SqlDataset)dataset;//由于当前操作的对象转换为SqlDataset类型进行操作
　　sqlDataset.setSql(sql);//对Sql类型Dataset对象设置sql语句
　　return true;//返回true，通知dataset继续执行默认的标准查询动作，并使用当前设定好的sql语句进行查询
}

最后在视图模型的dataset的xml配置文件中设定dataset的listeners属性,设定的时候要注意要设置listener的全路径，包含java package的申明，如:

<Dataset
id="datasetSection"
type="Wrapper"
wrappedType="Sql"
dataSource="DIRWH"
originTable="DIR_Section"
keyFields="ID"
listener="sample.DatasetSectionListener" />