DORADO 学习笔记

具有过滤功能的dropdown控件是DynamicDropDown

·escapeValue在MatchRules中设置

·使用DynamicDropDown的时候不能进行过滤可能是因为没有设置MatchRules导致的，如果设置了MatchRules还没有显示，就有可能是MatchRules中的value与filterParamter的设置不一致

·如果要将列表中某列以其他的形式展示，比如radiogroup，那么需要设置renderType

·使用UpdateCommand执行提交的时候，实际提交的是客户端的Dataset对象

·在执行更新的时候，默认处理就是将所有列值进行更新，有时候主键是由数据库自己管理的自增类型的，是不允许更新的，这时候需要设置指定列的updatable为false

·当View编辑Tab页处于事件编辑面板的时候是无法将control复制到jsp页面的，必须切换到属性编辑面板

·要对表格，form执行更新操作，必须设置keyFields值，否则会抛出异常(异常会提示你这样做)

·执行CRUD操作的时候，只有Update操作是不需要写代码的，其他的需要在指定的控件上写脚本对相应的Dataset进行操作

·将button和command进行绑定，在button的任何一个事件中写了代码之后，command将不会自动执行execute方法

·绑定只是在少数情况下使用，比如更新操作，面对复杂逻辑需要自己写脚本调用command的execute方法

·对于多表关联的更新操作，dataset中必须存在关联表中的外键，否则保存的时候会提示找不到外键字段，虽然外键在table或form中是不显示的

·别以为按钮都是要通过绑定指定的command，有些是不需要绑定的，需要你手动调用指定的command.execute()方法，一般delete和insert类型的button就不需要绑定command

·ReferenceDataset是没有MatchRule属性的，都在被引用的真正的Dataset中

·escapeEnabled=true表示没有给参数设置值的时候，不会在sql中添加where语句

·在打开一个子窗口时通常会使用到RequestCommand

·使用RequestCommand的时候通过设置Dataset和parameterFields来指定要传递的参数，如果要传递多个参数，那么parameterFields中将多个字段用逗号分隔

·通过request传递的参数不会自动赋值给dataset，需要手动设置，这个是在view的onload事件中做的

·对于查询表单来说要使用FormDataset与之对应，FormDataset不与指定的数据库表关联，它的作用仅仅用来封装form的数据，并向后台提交，而与之对应的则是QueryCommand：用来提交FormDataset中的查询参数，并将结果Dataset返回给指定的显示Dataset使用。

·要对多个同类型的元素设置同一个值请使用Merged View

·要设置Form布局的时候每行显示多少列，需要在form下级节点 <formgroup> </formgroup> 中设置columnCount值，默认是2

·在给查询参数添加%的时候，应该先通过dataset取出参数值，然后再设置到command的parameter中去

·排版控件放在文件夹图标下

·SplitPanel的position表示的是第一个panel的宽度或高度

·可以直接在JavaScript中直接使用EL表达式，比如从Request中取值：Request.parameterName

·在jsp页面中的所有dorado控件标签必须放在<d:view></d:view>中间，否则会报nullpointer的异常

·在嵌套使用splitPanel的时候，必须设置id值，否则有些panel会显示不出来，也不报错。

·为了使用menu control，必须同时使用两个组件，一个是menu（model），另一个是menubar（view），如果menubar中的数据是动态生成的，则需要在View的实现类中复写initControl方法，为指定的menu添加menuItem选项

·验证是在dataset的指定Field添加Validator-XXX，然后设置errMessage

·在遍历Dataset的时候，Dataset Loop会比Dataset Loop（Fast）慢的原因是因为前者的数据会默认与control绑定起来，数据修改之后会更新控件的内容，同时还有可能触发control相关的事件。

·form中某个编辑框的id值一般采用这个格式：formQuery_editor_elementName。

·外界的值不能直接赋值给matchrule的那个:value中的value，必须先传给parameter，然后dataset在内部将parameter的值传给matchrule中的value

·给matchrule赋值的两种方式：一种就是在事件中写js给parameter赋值，然后parameter会将值传递给matchrule对应的匹配value，另一个还是通过parameter来传值，但是是在parameter中设置EL来赋值，比如${Request.emplyee_id}

·在dataset的parameter赋初始null值要这么写$null

·parameter的名称必须与matchrule中value占位符名称相符

·递归树需要在tree控件下添加recursive tree level节点，然后设置recursiveKeyFields和recursiveKeyParameters，第一个参数表示将当前记录的那个字段的值作为获取child level的sql语句中的matchrule参数value占位符的值，当然这里是无法直接传递给matchrule的必须通过parameters作为中间媒介，而第二个参数就是使用哪个dataset中设置的parameter中的name值，要哪个parameter来接收就设置哪个parameter的name。还有一个要设置的就是labelField的值。

·如果要在递归树上挂接另外一个关联表中的数据，那么需要在recursive TreeLevel下添加simple TreeLevel，并在simple TreeLevel中设置三个关键属性masterKeyFields和detailKeyParamters以及hasChild，前面两个参数表示从上级菜单record中取对应field值，然后传给下级菜单所对应的dataset的matchrule，第三个参数询问挂接的菜单是否还子菜单

·对于matchrule的:value中的value是不区分大小写的

·使用RequestCommand打开的子窗口用SubWindow.hideParent()关闭，普通的子窗口用 子窗口id.hide()关闭

·跟dataset绑定的tree node类型是RecordTreeNode，然后通过RecordTreeNode的getRecord可以返回绑定的Record

·在使用customdropdown来显示树的时候，有时候树很长，dropdown显示不下，需要加滚动条，只要把tree的width和height设置成100%就可以了，设置dropdown的width和height是不起作用的

·使用customdropdown的时候，要关闭打开的dropdown，则需要使用DropDown.closeFrame(selectObject)方法，这里的selectObject对象表示要传递给dropdown的值

·在CustomDropDown里面要接受关联的jsp页面传过来的内容，需要在onSelect事件中处理

·要在listdropdown中显示的是label而非value，那么需要将dropdown中的mapvalue设置为true

·如果要将button移动到里面，需要先在form中添加一个custom element，然后将已有的button与这个custom element关联即可

·日历控件对象的field用于设置用dataset中的哪个字段与calendar的日期进行挂接。date用于设置日历打开显示的日期

·如果一个页面中表格的数据需要根据request传过来的参数来得到，那么这个一般的做法是在view的onload事件中根据参数给dataset的parameters赋值，然后dataset.flushData()方法
DODataset

·在使用hsqldb数据库时，使用middlegenide要注意boolean类型默认的是object，在generate的时候要改成boolean

·在使用DODataset的时候，需要实现自己的ViewModel，并且复写doLoadData方法，在该方法中调用Hibernate的相关的方法取得所需要的数据，同理在做更新的时候需要复写onUpdateData()方法

·监听器是针对某一个dataset的操作，viewmodel是针对所有的dataset的操作

·DatasetListener.beforeLoadData()方法返回false表示不再调用Dataset的loadData方法加载数据。

·在分页的时候，设置dataset的pageSize之后，还要设置supportsPaging为true，因为默认是false

·如果使用dataset的监听器来加载数据的话，一般需要实现afterLoadData来加载数据，beforeLoadData方法中加载数据会有问题

·要给tree设置勾选，需要将tree的checkable为true，需要判断当前节点是否勾选，需要访问node的isChecked()方法

·customDataset跟DoDataset之间的区别在于前者不支持内存分页

·dataset的listener可以同时支持多个，在设置listener属性的时候用逗号分开。

·使用DBStatement的步骤一般是：调用setDataSource()方法设置Datasource；调用setSql()方法设置要执行的sql语句；执行query()或者queryForList()方法得到查询的结果（前者返回单条记录，后者返回记录集合）；关闭statement


·当在客户端调用了某一个dataset的flushData方法之后，将调用ViewModel的初始化方法。

·menu对象是没法跟dataset绑定的，这个需要手工编码将数据库中的数据拿出来加到menu中去

·RPCCommand是无法使用Dataset进行前后台数据通讯的，只能通过Command.parameters()进行传值

·如果有业务逻辑，那么建议写在Command的beforeExecute事件里面，而不是写在控件的相应方法中，因为在控件里面写了代码之后，command的execute方法将不会自动调用，需要手动调用command的execute方法才行，这按就失去了控件跟command绑定的意义

·command只会跟dataset打交道，而其他的显示控件跟它是没有关系的

·DODataset和CustomDataset基本上没有区别，建议使用CustomDataset

·所谓的MarmotDataset跟Spring的结合实质就是将通过DoradoContext拿到WebApplicationContext或者BeanFactory

·EL的本质在于在对jsp中给定的表达式根据请求进行动态替换以生成最终的静态内容，跟自定义标签有些像

·自定义EL有两个步骤：一个是自定义表达式处理实体，例如定义各种方法，对于传递过来的参数执行相应的逻辑，第二个就是自定义 ExprInitializer，像EL容器（说白了就是一个Map）中将自定义表达式实体跟页面说要使用的名称对应起来。

·既可以在ViewModel的initLoadData，onLoadData，updateData插入调用逻辑的代码，也可以在DatasetListener的相关方法中插入逻辑代码

·SplitPanel自定义标签的id必须有值，如果id没有值会出现有些panel显示不出来的问题

·当将表格的水平滚动条设置为不显示的时候，对表格列的宽度调整将不起作用

·不同view之间的datatset和control可以互相copy

·查询参数必须放到parameter

·在EL表达式中，Request用来访问属性，request用来访问方法

·当dataset的autoLoadData设置为false，那么初始化之后datset.getCurrent()的值为null

·更新操作步骤：得到record迭代器RecordIterator ri = dataset.recordIterator();设置过滤条件ri.setVisibility(Dataset.FILTER_MODIFIED);遍历每一条记录执行相关的操作

·DummyField的用法：当该列的name设置为select的时候，那么提交的记录将是所有被选中的

·RPCCommand的使用步骤：添加command，在自定义的viewmodel中添加public void methodName(ParameterSet parameters, ParameterSet outParameters) throws Exception{}，设置command的method为methodName，或者通过指定action向任何url发送请求

·querycommand的执行机制：该命令通常用于实现页面无刷新特征的数据查询,通过设定该命令的查询条件数据集(conditionDataset),以及查询数据集(queryDataset)设置,该命令执行时会自动将查询条件数据集中的当前记录的信息作为查询结果集的parameters,发出AJAX请求,由服务器端的services接受该请求,并利用查询数据集中包含的parameters信息以及pageIndex,pageSize信息获得用户需要的数据,并保存到数据集中,从而实现页面数据的刷新.

·updatecommand的执行机制：dorado中标准也是默认的更新命令，通过设定其中的datasetInfos指定需要提交的记录集以及制定该命令的parameters，该命令会自动的完成客户端数据收集操作，通过method的设定,命令对象会自动触发ViewModel实现类的指定方法，以及根据该方法的反馈信息决定调用命令对象的onSuccess事件或者onFailure事件

·requestcommand的执行机制：该命令用于新URL请求，可替代open, openModelDialog等JS操作。可以直接设置该命令的绑定记录集(dataset)属性,并指定paramFields,该命令执行时将会自动取出绑定记录集相关字段的值并传递到path属性指定的URL上。另外该命令还可以通过设定target属性指定新请求的目标类型:_self:更新本窗口;_blank:打开新IE窗口;_parent:在当前窗口的父窗口打开;_top:在当前窗口的最顶级窗口中打开;_modal_dialog:打开模态窗口;_modeless_dialog:打开非模态窗口

·给指定的date输入控件指定一个默认当前日期需要在defaultValue属性上添加${Util.getDate("yyyy-MM-dd")}

·datasetdropdown的设置一般分两种，一种是通过设置labelField，mapValue，valueField将一个dataset映射成一个map，一种是通过设置readValues和writeValues将下拉列表dataset选中的记录映射成编辑框所对应的dataset中的值，visiableValues是用来控制可显示的列的

·如果需要对autoform中的单个元素进行布局，那么需要使用eleemntRender，具体步骤是在autoform外部添加要编辑元素，然后在autoform中添加eleementRender元素，同时要给autuform中的groupbox取一个名字，接着改造jsp页面中的autoform元素，在它内部手工添加elementRender标签，并指定相应的group和element属性，然后在elementRender中手工添加在autoform外部添加的编辑元素，并对其进行布局，如果要对整个autoform中的元素进行重新布局的话，那么就没有必要使用autoform，可以直接使用groupbox和fieldlabel，editor进行布局

·如果一个command被多个操作使用，那么在使用之前必须先清空parameters中的内容，否则上一次的parameters会被保留

·当使用了选择列之后，为了在后台能得到所有被选中的记录，必须将updatecommand中指定dataset的submitScope设置为selected

·在dorado跟struts和其他webframework集成要点：首先要使用dodataset这种类型的dataset，因为该类型的dataset有一个contextAttribute属性用来指定类似struts的action中给request的attribute中添加的内容，同时还要指定loadDataAction，这个就是指定的对应struts中的xxx.do（注意不要加/）。如果需要在action中处理提交的dataset，那么需要使用DOSet容器，它用来将request的attribute中保存的转换成DOSet，我们可以将其看成一种轻量级的dataset，它相当于是对提交表格数据的javabean形式的一种容器。这个转换过程是通过RPCHelper.execute(DOSet)来做的。为了实现无跳转还需要添加<forward name="no-forward" path="/dorado/noForward.d"></forward>，为了区分不同的操作类型，还需要做类似doset.getDO(DOSet.STATE_DELETED)的过滤操作。

·dataset的flushDataset不会执行dataset的updateData方法，只会下载数据

·在使用updatecommand的时候，一般在viewmode的update_method方法中处理，不建议在datasetlistener中处理

·在querycommand中conditionDataset和QueryDataset之间的关系：先这样var parameters = queryDataset._parameters;然后将conditionDataset当前记录中的每一个field中的值添加到这个parameters中去，如果出现重名的parameter，那么将前面设置的值将会被覆盖

·在上面是输入框输入查询条件，下面是表格显示最终查询结果的界面中，我使用了querycommand，并指定上面输入条件form对应的dataset为querycommand的conditiondataset，下面的表格对应的dataset为querycommand的querydataset，那么用来处理这个querycommand的后台应该写在querydatasetlistener中。

·requestcommand中parameters的处理：如果指定了dataset，那么从dataset的当前记录中取出field的名字对添加到parameters中，然后将parameters拼接成querystring加到请求url中（如果是get方式的话），post方式则会新建一个form来进行提交

·使用marmot的时候，没必要将provider和resolver分开，可以使用一个，如果是取数据的方法则采用：public void execute(DataSet dataSet) throws Exception；如果是修改数据则采用：public Object execute(Map dataSetMap, Object parameter) throws Exception

· Marmot的DataSet和dorado的dataset没有继承关系，在取得保存数据的时候，跟以前的做法有些区别，过滤方式得这样写：employees = datasetEmployee.getRecords(DataSet.MODIFIED); 迭代器这样用：Employee employee = (Employee) iter.next(); 因为marmot的dataset包装不是record而直接是javabean

·在使用updatecommand的时候，默认情况下会将修改的记录进行提交，如果dataset没有修改，command是不会执行的，比如要将当前记录删除，但是没有执行dataset.deleteRecord()方法，那么提交是不会执行的，这时可以将comand所包含的dataset的submitScope设置为current。

·updatecommand中dataset的clearSelectionOnSussess属性用法，当在要提交的dataset中使用了dummyField字段并将其name设置为select，希望在对summyField进行更新之后select被清空，那么需要将clearSelectionOnSuccess设置true。

·当使用subwindow来打开子窗口，除了通过requestcommand来做之外，还可以直接在jsp页面上添加一个subwindow标签，然后可以像使用requestcommand打开子页面一样在subwindow标签内部添加内容，这样做的好处可以使用共享同一个页面中的dataset。如果需要关闭当前页面，不能使用SubWindow.hideParent();而必须使用subwindowId.hide();