dorado & BDF常见问题

部分记录了我在 使用 dorado 开发当中遇到的问题,该问题列表会不断补充,也同时欢迎在评论里补充新问题。

相关网站

dorado nexus 私服
http://nexus.bsdn.org
dorado client api
http://dorado7.bsdn.org/jsdoc/
wiki
http://wiki.bsdn.org/
BDF2项目创建向导
http://bsdn.org/projects/bdf/deploy/bdf2-new-project-wizard/view.Wizard.d
dorado eclipse plugin
百度网盘: https://pan.baidu.com/s/1chalW5ebFOC3cKkYJLvkig
提取码:xobo

Dorado

Q: 想在 Spring Boot 环境下使用 dorado

A: BDF3 就是基于 Spring Boot2 的,可以在 BDF3 的基础之上开发或学习其如何把 dorado 和 Spring Boot2 集成在一起的。 https://github.com/muxiangqiu/bdf3.git

Dorado IDE

Q: 打开view 文件时"Loading Model...遇到问题"。

A: 需要更新 dorado 规则, 更新 dorado IDE 规则 具体可以参考dorado配置规则。建议使用在线方式更新。

在线模式下 ServerName对应着域名或ip, Port就是端口号, App Name就是contextpath,如果为空可以不填。图片中是示例访问地址为: http://localhost:8080/waterdrop 。如果
项目访问地址是: http://localhost:8080

Server Name: localhost
Port: 8080
App Name:

Widget

AjaxAction

Q: AjaxAction如何根据后台执行的或失败执行不同的Javascript代码?

A: ajaxAction 的对应的后台 @Expose 方法,返回一个字符串。如果返回空就是执行成功,错误就把错误信息返回。然后在回调函数中根据返回值,进行不同的判断。

View

Q: 如何切换皮肤?

A:

Q: 为什么我的控件显示是英文

A: dorado 默认是支持多语言的,dorado 的默认控件会根据HTTP Header中 accept-language 的值来选择显示语言。如果没有多语言需求的话可以把语言固定下来。在dorado home目录下的context.xml里添加如下配置:

Q: 如何在外部获取 dorado 控件?

A: 在 dorado 控件的事件内,可以通过 view.id/get 等方法来获取其它 dorado 控件。对于事件以外的地方作用域里没有 view 对象,这个时候我们可以使用 viewMain 或 $id来获取。 viewMain 其实就是 view 但是在dorado7 低版本中不支持; $id 只能通过控件 id 来选取控件,而且其返回的是dorado.ObjectGroup,我们需要通过.objects0来获取具体的控件。 $id("widgetId").objects[0]

DataSet

Q: 为什么DataProvider的代码里加载出数据,而的dataSet 中没有呢?

A: 如果开启分页,即 dataSet 中 pageSize 值大于 0, dataSet 会从 page.entities 内取值。

Q: 设置的DataProvider明明存在,为什么会提示无法在"XXXXX"类中查找到唯一匹配的"XXXX"方法?

A:如果开启分页,@DataProvider 标记的方法必须有 Page page 属性,其中T 为相应的 POJO 类。

Q: 为什么 DataSet刷新后中有数据,用调试器也能取出来为什么JS代码取不出来呢?

A: DataSet 的刷新有两个方法,同步与异步 flush, flushAsync。 最直白的理解使用 flush 刷新数据时,代码会等数据加载完成之后再执行后续代码;使用flushAsync刷新数据时,先处理后续代码,最后处理数据加载。 所以遇到该情况,多是使用了 flushAsync 刷新 DataSet 然后直接在下一行代码里就从 DataSet 中取数据。建议使用异步加回调的方式。

AutoForm

Q: 为什么AutoForm 的 entity 有时候是 dorado.Entity 有时候是 JavaScript Object?

A: AutoForm 绑定 dataSet 时返回的是 entity,如果没有返回的是 JavaScript Object。aufoform 一直是与 dataSet 同时出现的,如果确实不需要 dataSet,可以将 AutoForm 的 createPrivateDataSet 属性设为 true,它会自行创建一个自有 DataSet。

Q: 如何在一组输入框内,实现选择日期区间选择,如下图所示。

日期区间选择
A: 详见DateRangeDemo.view.xml附件。
DateRangeDemo.view.xml

Q: 如何限制文件框只能输入两个字符

A: 可以利用editor的onKeyPress事件

DataGrid

Q: 重新加载数据后,dataGrid 启用 client filter 时,dataGrid 数据为什么不更新?

A: 这个可以确认为 dorado7 的 Bug, 目前通过以下代码手动刷新 dataGrid。

Q: DataGrid 如何设置某些数据不能选中

在 RowSelectorColumn 的 onRenderCell 事件里,修改默认渲染动作。

Q: 如何在 DataGrid 的 Column上显示按钮?

A: 可以在 DataColumn 的 onRenderCell 事件里重写渲染方法。

DownloadAction

下载控件,我用过的最难用的 dorado 控件之一,极不推荐使用。该 Action 提交是采用表单提交的方式,一旦在该 action 的后台处理上遇到异常直接就把用户页面转到 5xx 的错误页面去了。

Q: 为什么通过 DownloadAction 的方式传递到后台的代码有乱码?

A: 在web.xml中配置编解码Filter(org.springframework.web.filter.CharacterEncodingFilter). 一定要做为第一个 fitler才行。

Q: 为什么通过DownloadAction 传递到后台的参数都变成 String ?

A: 对于 dorado 的绝大多数 action 控件来说,能准确的把前台赋值给 parameter 属性的值在后台转换为相应的 Java 值。但是 downloadAction 会把 parameter 的值都转换为字符串。已经习惯了把 dorado 对象直接丢到 parameter 里传到后台的,在这里肯定要踩坑。兼容方案就是在前台把要传递的值先转化为 JSON 字符串,然后把这个字符串传到后台,在后台再把字符串转回 Map。dorado 提供了工具类 dorado.JSON.stringify 来把对象转化为 JSON 字符串。

UploadAction

Q: 如何给uploadAction添加阻塞的任务指示器?

A:

dropdown

Q: DataSetDropDown 添加自定义列之后,如何显示过滤框?

A: 在 DataSetDropDown 的 onOpen 事件里,添加如下代码:

日期选择器

Q: 如何把日期选择器的默认日期改为输入框的值?

A: dorado 的日期选择框默认打开的时候都是当前时间。创建一个新的DateDropDown控件,然后在其 onCreate 事件中插入如下代码:

杂项

dorado滚动条

dorado滚动条默认是窄窄的一条,只有鼠标指上去之后才会变宽。但是对于部分客户这个设定是不可以接受的。又由于 dorado 布局相关的原因,没有计划去支持实体的滚动条。只能通过调整滚动条的宽度来照顾该部分客户。 我们需要配置如下两个属性: widget.scrollerSize是默认滚动条宽度; widget.scrollerExpandedSize是展开后滚动条宽度,建议设置为 10.

文件下载

触发文件下载有两种方式

  1. 使用 window.location.href = "downloadUrl";
  2. 通过 iframe.

文件下载Java端代码片段

父子页面交互

在一些业务场景下,我们会需要在子页面来操作父页面的元素,或者反过来。  

BDF2

Maven 依赖

Q: BDF2 突然不能正常启动,报NoSuchMethodError异常:

Initialization of bean failed; nested exception is java.lang.NoSuchMethodError: com.bstek.bdf2.core.context.ContextHolder.getApplicationContext()Lorg/springframework/web/context/WebApplicationContext;

A: bdf2-orm(v2.1.0)为了兼容 Spring Boot 把ContextHolder.getApplicationContext()的返回值由WebApplicationContext改为ApplicationContext, 而 bdf2 的其它模块基本上都依赖于最新的 bdf2-orm, 导致 bdf2 的maven 项目出现不兼容的新老模块混用情况以致抛出方法未找到异常。 解决办法就是统一 bdf2 的 jar 包依赖: 1:升级其它 BDF2 模块到 2.1.0 及其以后版本; 2: 降级bdf2-orm。 Maven 项目可以通过排除依赖的bdf2-orm,然后指定bdf2-orm的版本为 2.0.7。 添加依赖:

Home

Q: BDF2 如何通过JavaScript在首页中打开新的Tab页:
A: 在子页面调用 top.openUrlInFrameTab 方法。