2014-06-12 Created By BaoXinjian

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle一、摘要


Oracle Application Framework将异常分为三类

异常类型type

1. 常规异常General Exception

Class:oracle.apps.fnd.framework.OAException

Function: 提供了在运行时刻同时显示多种类型异常的手段,结合EBS的Message,可显示有用的信息

2. 验证异常Validation Exception

Class:oracle.apps.fnd.framework.OAAttrValException/OAROwValException

Function: 分别代表字段级和记录级的验证异常,用于字段级和记录级的校验,继承与OAException,所以可以显示方式有类似性

3. 严重的异常Server Exception

Function: OAF系统自动抛出,系统级别的异常,以OAErrorPage呈现给用户,比如OAF调试多次后抛出Space空间不足异常

异常包class

1. OAException

(1). 异常类型

OAException.ERROR   //错误

OAException.WARNING   //警告

OAException.INFORMATION   //信息

OAException.CONFIRMATION  //确认

OAException.SEVERE //致命

(2). 定义方式

定义异常的的实例变量,然后抛出

OAException  errormessage = new OAException(…);  throw errormessage;

直接生成实例抛出

throw new OAException(…);

(3). 抛出方式:语法

Messagebox抛出 - throw new OAException(…);

pageContext.putDialogMessage(…) - Dialog  page 抛出

​OAException​​(​​String​​ appShortName, //应用短名

              ​​String​​ messageName,  //消息名称

              ​​MessageToken​​[] messageTokens, //消息参数

              byte messageType, //异常类型

              ​​Exception​​[] details) //异常明细

可以省略其中部分参数,例如: OAException(String messageName)

                           OAException(String messageName, byte messageType)

                           OAException(String messageName, MessageToken[],byte messagType)

2.1 OAAttrValException

如果在视图对象行或者实体对象中,任意属性级别的验证失败,你都可以像如下抛出一个OAAttrValException.语法

源对象类型(OAException.TYP_ENTITY_OBJECT或者OAException.TYP_VIEW_OBJECT)

完整的实体定义的名称或者视图实例的名字

实体或者行的主键

正验证的属性名

验证失败的属性值

错误消息所属的应用缩写名

错误消息名称

​OAAttrValException​​(int objType, //对象类型

                     ​​String​​ objName,  //对象名称

                     ​​Key​​ key,  //对象主键

                     ​​String​​ attrName, //字段名

                     ​​Object​​ attrValue,  //错误的字段值

                     ​​String​​ appShortName,  //应用短名

                     ​​String​​ messageName,  //消息名称

                     ​​MessageToken​​[] messageTokens, //消息参数

                     byte messageType,  //消息类型

                     ​​Exception​​[] details,  //异常明细

                     boolean peer)

2.2. OARowValException

如果在视图对象行或者实体对象上的任意的行级别的验证失败,你可以像下面展示的抛出一个OARowValException

要示例化这个异常,你必须传入以下的信息:

完整的实体定义名称或者视图对象名称

实体或者行的主键

错误消息所属的应用缩写名

错误消息名

3. BundledExceptions

Bundled exceptions 允许你在进行验证的时候叠加同等的异常,当你完成验证的时候一块显示给用户。这些同等的异常被分组到一个叫做bundled exception 的容器异常中.

可以包含任意类型的服务器端的异常(包括系统级的异常,数据格式错误,属性验证错误,行验证错误以及实体创建错误).

4. 异常class继承结构

OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_02

5. 处理异常时 try- catch - finally 语法

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_03


OAF_EO系列7 - OAException异常处理及实现(案例)_字段_04二、常规异常General Exception的案例


案例:在一个客制化的页面上有ReportName栏位,如为空值,则提示用户进行录入

1. 在EBS定义Error Message,通过&P_EMPLOYEE_NAME进行传参数,动态地显示参数

OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_05

2. 在FND_NEW_MESSAGES确认是否定义成功

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_06

3. 在OAF调用OAException 如果ReportName为空则,进行抛出异常

OAF_EO系列7 - OAException异常处理及实现(案例)_字段_07

4. 通过定义异常,再进行抛出该异常,测试结果

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_08

5. 直接抛出该异常,测试结果

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_09


OAF_EO系列7 - OAException异常处理及实现(案例)_OAF_10三、验证异常Validation Exception的案列


案例1. 在EO的字段添加异常,如果Total为0值,则抛出异常

1. 字段级验证异常调用

OAF_EO系列7 - OAException异常处理及实现(案例)_OAF_11

2. 字段级验证异常测试

OAF_EO系列7 - OAException异常处理及实现(案例)_OAF_12


案例2. 在EO的记录级validateEntity()添加异常,将多个字段组合进行判断,则抛出异常

1. 记录级验证异常调用

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_13

2. 记录级验证异常调用测试

OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_14


OAF_EO系列7 - OAException异常处理及实现(案例)_字段_15四、系统异常Server Exception的案例


例如: Jeveloper和EBS服务器断开,跑出的系统异常,系统异常就不做过多介绍了

OAF_EO系列7 - OAException异常处理及实现(案例)_字段_16


Thanks and Regards

参考:Tony Liu - http://blog.itpub.net/10359218/viewspace-677445/

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_17


2014-06-12 Created By BaoXinjian

OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_18一、摘要


Oracle Application Framework将异常分为三类

异常类型type

1. 常规异常General Exception

Class:oracle.apps.fnd.framework.OAException

Function: 提供了在运行时刻同时显示多种类型异常的手段,结合EBS的Message,可显示有用的信息

2. 验证异常Validation Exception

Class:oracle.apps.fnd.framework.OAAttrValException/OAROwValException

Function: 分别代表字段级和记录级的验证异常,用于字段级和记录级的校验,继承与OAException,所以可以显示方式有类似性

3. 严重的异常Server Exception

Function: OAF系统自动抛出,系统级别的异常,以OAErrorPage呈现给用户,比如OAF调试多次后抛出Space空间不足异常

异常包class

1. OAException

(1). 异常类型

OAException.ERROR   //错误

OAException.WARNING   //警告

OAException.INFORMATION   //信息

OAException.CONFIRMATION  //确认

OAException.SEVERE //致命

(2). 定义方式

定义异常的的实例变量,然后抛出

OAException  errormessage = new OAException(…);  throw errormessage;

直接生成实例抛出

throw new OAException(…);

(3). 抛出方式:语法

Messagebox抛出 - throw new OAException(…);

pageContext.putDialogMessage(…) - Dialog  page 抛出

OAException​​(​​String​​ appShortName, //应用短名

              ​​String​​ messageName,  //消息名称

              ​​MessageToken​​[] messageTokens, //消息参数

              byte messageType, //异常类型

              ​​Exception​​[] details) //异常明细

可以省略其中部分参数,例如: OAException(String messageName)

                           OAException(String messageName, byte messageType)

                           OAException(String messageName, MessageToken[],byte messagType)

2.1 OAAttrValException

如果在视图对象行或者实体对象中,任意属性级别的验证失败,你都可以像如下抛出一个OAAttrValException.语法

源对象类型(OAException.TYP_ENTITY_OBJECT或者OAException.TYP_VIEW_OBJECT)

完整的实体定义的名称或者视图实例的名字

实体或者行的主键

正验证的属性名

验证失败的属性值

错误消息所属的应用缩写名

错误消息名称

OAAttrValException​(int objType, //对象类型

                     ​​String​​ objName,  //对象名称

                     ​​Key​​ key,  //对象主键

                     ​​String​​ attrName, //字段名

                     ​​Object​​ attrValue,  //错误的字段值

                     ​​String​​ appShortName,  //应用短名

                     ​​String​​ messageName,  //消息名称

                     ​​MessageToken​​[] messageTokens, //消息参数

                     byte messageType,  //消息类型

                     ​​Exception​​[] details,  //异常明细

                     boolean peer)

2.2. OARowValException

如果在视图对象行或者实体对象上的任意的行级别的验证失败,你可以像下面展示的抛出一个OARowValException

要示例化这个异常,你必须传入以下的信息:

完整的实体定义名称或者视图对象名称

实体或者行的主键

错误消息所属的应用缩写名

错误消息名

3. BundledExceptions

Bundled exceptions 允许你在进行验证的时候叠加同等的异常,当你完成验证的时候一块显示给用户。这些同等的异常被分组到一个叫做bundled exception 的容器异常中.

可以包含任意类型的服务器端的异常(包括系统级的异常,数据格式错误,属性验证错误,行验证错误以及实体创建错误).

4. 异常class继承结构

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_19

5. 处理异常时 try- catch - finally 语法

OAF_EO系列7 - OAException异常处理及实现(案例)_字段_20


OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_21二、常规异常General Exception的案例


案例:在一个客制化的页面上有ReportName栏位,如为空值,则提示用户进行录入

1. 在EBS定义Error Message,通过&P_EMPLOYEE_NAME进行传参数,动态地显示参数

OAF_EO系列7 - OAException异常处理及实现(案例)_OAF_22

2. 在FND_NEW_MESSAGES确认是否定义成功

OAF_EO系列7 - OAException异常处理及实现(案例)_OAF_23

3. 在OAF调用OAException 如果ReportName为空则,进行抛出异常

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_24

4. 通过定义异常,再进行抛出该异常,测试结果

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_25

5. 直接抛出该异常,测试结果

OAF_EO系列7 - OAException异常处理及实现(案例)_字段_26


OAF_EO系列7 - OAException异常处理及实现(案例)_OAF_27三、验证异常Validation Exception的案列


案例1. 在EO的字段添加异常,如果Total为0值,则抛出异常

1. 字段级验证异常调用

OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_28

2. 字段级验证异常测试

OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_29


案例2. 在EO的记录级validateEntity()添加异常,将多个字段组合进行判断,则抛出异常

1. 记录级验证异常调用

OAF_EO系列7 - OAException异常处理及实现(案例)_oracle_30

2. 记录级验证异常调用测试

OAF_EO系列7 - OAException异常处理及实现(案例)_OAF_31


OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_32四、系统异常Server Exception的案例


例如: Jeveloper和EBS服务器断开,跑出的系统异常,系统异常就不做过多介绍了

OAF_EO系列7 - OAException异常处理及实现(案例)_抛出异常_33


Thanks and Regards

参考:Tony Liu - http://blog.itpub.net/10359218/viewspace-677445/