OAF_EO系列7 - OAException异常处理及实现（案例）

2014-06-12 Created By BaoXinjian

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继承结构