EAS-BOS应用框架编程指南(4)

{

CurrencyInfo info = new CurrencyInfo();

// 设定初值

info.setCreator(sysContext.getOperator()); info.setIsoCode(defaultIsoCode); info.setSign(defaultSign); return info; }

2. protected abstract IObjectBase getBizInterface()：获取实体对象的业务接口，供调用后台方法使

用。

示例：

protected IObjectBase getBizInterface() { }

return CurrencyFactory.getRemoteInstance();

可选的方法：

1. protected void verifyInput () throws Exception：校验输入的合法性。可以直接检查空或范围等条

件，也可以调用服务端提供的校验方法。可使用SysUtil.abort方法中断操作流程，并视情况弹出提示框及设置输入焦点。 示例：

protected void verifyInput() throws Exception {

if (isNull(txtNum.getText())) {

MsgBox.showWarning(“编号不能为空”); txtNum.requestFocus(); SysUtil.abort(); }

// 可能抛出异常但无须捕获，最外层有缺省的异常处理器 getBizInterface().checkNameDup(editData); // ? 其它检查代码 }

2. loadFields/storeFields：作用请参考前面通用设计方法的说明。

3. getMessageIcon()/getMessageBgcolor()/getMessageText()设置状态栏提示图标、背景色、提示文

字。

示例：

protected Icon getMessageIcon()

{

return SHOW_MESSAGE_ICON_DEFAULT; }

protected Color getMessageBgcolor() {

return new Color(0x0F , 0x88 , 0x28); }

protected String getMessageText() {

return SHOW_MESSAGE_TEXT_OK; }

4. showSaveSuccess/showSubmitSuccess子类可重载这些处理方式。默认情况下，如果有状态栏则使

用状态栏处理，如果保存成功则绿色背景闪烁三次；否则使用消息对话框显示。

示例：

protected void showSaveSuccess() {

MsgBox.ShowInfo(“success!”); }

常见问题

2.3.3. 单据编辑类UI

超类为BillEditUI，从EditUI继承。BillEditUI支持单据对象的编辑，除继承了EditUI的能力外，还可处理单据行的新增和删除。BillEditUI支持的实体对象必须从BillBase及其子类继承。 类方法介绍

单据编辑类UI从com.kingdee.eas.framework.client.BillEditUI继承。通过BOS Studio完成UI对象的创建、更改继承Entity对象的类型以及处理控件绑定等。

必须重载的方法：

1. protected IObjectValue createNewDetailData()：新建单据行，并设置初始值。

示例：

protected IObjectValue createNewDetailData() {

VoucherEntryInfo info = new VoucherEntryInfo();

// 设定初值

info.setCreator(sysContext.getOperator()); info.setXXX?

return info; }

可选的方法：

1. loadLineFields/storeLineFields：数据绑定方法，针对单据行。若不能利用BOS Studio在设计期全部

定义好绑定关系，则需要编码完成。 2. protected void afterAddLine(IObjectValue lineData)：通知方法，允许在增加单据行后做相关处理。

protected void afterAddLine(IObjectValue lineData) { }

// 计算合计值并显示 calcTotalAmount();

3. protected void afterRemoveLine(IObjectValue lineData )：通知方法，允许在删除单据行后做相关

处理。 4. protected void afterSelectLine(IObjectValue lineData )：通知方法，允许在选中单据行后做相关

处理。 常见问题

3. EAS迁移 3.1. 实体对象的迁移

在BOS Studio设计器中，完成如下工作： 1. 找到要修改的实体对象，打开编辑视图

2. 选择合适的超类实体对象作为父实体对象。例如，对于币别对象，应选择从DataBase继承。 3. 将超类中已经定义的属性需要去掉。例如，对于币别对象，应将超类中已经定义的id、number和

name属性去掉。 4. 重新发布数据表

对于从TreeBase派生的层次数据对象，要注意：

1. 因为超类中定义的关系无法实例化，所以TreeBase并未定义parent关联属性。要求在子类中自行

建立这个表示指向父节点的关联属性，并且约定属性名一定是parent。 3.2. UI对象的迁移

UI对象需要重新生成。可以同时打开老的UI对象和新的UI对象，把控件拷贝过来。相关处理代码若超类已提供处理则废弃，否则拷贝过来并做适当修改。