OAF_EO系列4 - Create详解和实现（案例）

2014-06-02 Created By BaoXinjian

一、摘要

实现OAF的新增功能insert的具体解析

建立EO时，在向导中选择生产Create Method，则EOImpl中会包含标准create()

public void create(AttributeList attributelist)

{

   super.create(attributeList);

}

在以上方法中可以加入初始化方法，在super.create后

当用户进行create record时，数据流向如下

Page Create Page Button->CO 中processFormRequest -> AM具体的create方法 ->VO具体的create的方法 ->EO 中的create方法

在Create时必须的VO进行初始化，新增Row以存放需create record的内容

1. 创建记录常用的两种方式

• 在新增一个主界面上有个Create按钮，一旦触发该按钮，直接跳到一个明细页，用以新增记录
• 在主Table上，有个Add New An Record按钮，一旦触发该按钮，直接在表后新增一个Record，用以新增记录

2. VO的数据的三个层次

• View Object
• Row
• Attribute

3. EO Row的六个status

• STATUS_NEW-> 新增记录状态
• STATUS_DELETED-> 记录已被删除状态
• STATUS_MODIFIED-> 记录已被修改状态
• STATUS_UNMODIFED-> 记录未被修改或者已修改未提交
• STATUS_DEAD-> 新增未提交即被删除
• STATUS_INITALZIED -> 初始化状态

注意点：当执行EO的create()方法后，EO默认Row的状态为STATUS_NEW,这时,这条Row会被加入OAF的校验队列里,也就是说OAF会对这 条记录进行有效性的校验.这时,如果你的记录中有必填项,但新增时必然还没填入值,这校校验失败,OAF会返回错误信息,当然,新增动作也就失败了.因 此,我们可以加上row.setNewRowState(Row.STATUS_INITIALIZED)来设置记录状态为初始化状态,这样,这条记录将 不再进入校验队列,所以可以正常的建立,并输入值了

4. AM Create Date关键方法

public void createData()

 {

   OAViewObjectImpl vo1 = this.getOrderLineVO1(); //取得VO的实例

   Row row = vo1.createRow();  //新增记录

   vo1.insertRow(row); //插入记录

   row.setNewRowState(Row.STATUS_INITIALIZED); //置EO Row的状态

}

5. AM Commit Date关键方法

public void applyDate()

{

getOADBTransaction().commit();

}

二、案例1 - Create 按钮跳到明细页

案例：从主页面ExpenseSummary.PG通过按钮Create，跳转至明细页面ExpenseCreate.PG，对Expense进行新增

1. 通过ExpenseSummary.PG主界面中的Create按钮进行跳转

2. 跳转至明细页面ExpenseCreate.PG

2.1 在导入页面过程中，触发CO的processRequest方法

2.2 在CO中调用AM中初始化方法

2.3 AM在初始化VO和Row时，系统会自动调用EOImpl中的方法

由他文进行介绍，在此略过

2.4 处理后系统跳转至ExpenseCreate明细页面

3. 输入数据后，点击保存save按钮，对数据进行处理进入database

3.1 输入数据

3.2 触发CO中processFormRequest方法

3.3 在CO中调用AM中方法，对Transaction进行Commit

4. Commit后数据进入数据库，进行查看

三、案例2 - Add New Record对表结构后新增一行

案例：再进一步，结合上面，在定义对Expense Line进行操作，通过Add an new line对表新增行

1. 在点击Add an new line后触发CO中的代码，在通过CO触发AM中的关键初始化代码

2.  有些步骤就略去，看下图，点击add an new line后，系统会自动增加一行expense line，实现了Expense Header和Line的主从关

3. 新增后查看数据

Thanks and Regards