10. CORBA系统和用户定义的异常 | 10. CORBA System and User Defined Exceptions

10.1系统异常

Orber或任何其他ORB可能引发系统异常。 这些例外包含状态和次要字段，并且可能不会出现在操作引发异常IDL定义中。

状态字段

状态字段指示请求是否完成，并且将被分配以下Erlang原子之一：

状态	描述
'COMPLETED_YES'	该操作在目标对象上被调用，但在对象回答后发生错误。例如，如果服务器回复但Orber无法封送并将回复发送给客户端ORB，则会发生这种情况。
'COMPLETED_NO'	Orber未能调用目标对象上的操作。例如，如果对象不再存在，就会发生这种情况。
'COMPLETED_MAYBE'	Orber调用目标对象上的操作，但发生错误，无法确定请求是否真的到达对象。

次要字段

次要字段包含一个整数（VMCID），这与调用失败的更具体原因有关。该函数orber:exception_info/1可用于将次要代码映射到字符串。请注意，对于未被OMG或Orber分配的VMCID：，必须查阅该特定ORB的文档。

支持的系统异常

OMGCORBA规范定义了以下异常：

• 'BAD_CONTEXT' - 如果请求不包含正确的上下文，则引发此异常。

• 'BAD_INV_ORDER' - 此异常表示操作已按错误顺序调用操作，这会导致例如死锁。

• 'BAD_OPERATION' - 如果目标对象存在，则引发，但被调用的操作不受支持。

• 'BAD_PARAM' - 例如，如果参数超出范围或被认为是非法的，则抛出该错误。

• 'BAD_TYPECODE' - 如果传递了非法类型代码，例如封装在任何数据类型中，'BAD_TYPECODE'则会引发异常。

• 'BAD_QOS' - 只要对象无法支持所需的服务质量就会引发。

• 'CODESET_INCOMPATIBLE' - 如果由于例如char和/或的不同表示而导致两个ORB无法通信，则引发'CODESET_INCOMPATIBLE'wchar。

• 'COMM_FAILURE' - 如果ORB无法建立通信或在操作正在进行时丢失，则引发此错误。

• 'DATA_CONVERSION' - 如果ORB无法将接收到的数据转换为本机表示，则产生'DATA_CONVERSION'。另见'CODESET_INCOMPATIBLE'例外。

• 'FREE_MEM' - ORB未能释放动态内存并失败。

• 'IMP_LIMIT' - 运行时在ORB中超出了实施限制。例如，对象工厂可能会限制允许创建的对象客户端的数量。

• 'INTERNAL' - ORB内部发生故障，无法识别。您可以考虑联系ORB提供商的支持。

• 'INTF_REPOS' - ORB无法访问接口存储库，或检测到与接口存储库有关的其他故障。

• 'INITIALIZE' - ORB初始化失败，例如，由于网络或配置错误。

• 'INVALID_TRANSACTION' - 如果请求携带无效的事务上下文，则引发。

• 'INV_FLAG' - 一个无效标志被传递给一个操作，例如导致连接关闭。

• 'INV_IDENT' - 此异常表示IDL标识符不正确。

• 'INV_OBJREF' - 如果对象引用格式错误或引用为零（参见corba：create_nil_objref / 0），则会引发此异常。

• 'INV_POLICY' - 由于适用于特定调用的策略覆盖之间不兼容，无法进行调用。

• 'MARSHAL' - 当ORB无法编组/解组请求或回复时，客户端或服务器端可能会提出此异常。

• 'NO_IMPLEMENT' - 如果操作存在但没有实现存在，则引发此异常。

• 'NO_MEMORY' - ORB内存不足。

• 'NO_PERMISSION' - 呼叫者没有足够的权限，例如SSL证书不正确。

• 'NO_RESOURCES' - 超出了一般平台资源限制。

• 'NO_RESPONSE' - 没有可用的延迟同步请求响应。

• 'OBJ_ADAPTER' - 表示管理不匹配; 对象适配器无法将对象与实现存储库相关联。

• 'OBJECT_NOT_EXIST' - 对象已被处置或终止; 客户端应该删除对象引用的所有副本并启动所需的恢复过程。

• 'PERSIST_STORE' - ORB无法建立与其持久存储的连接，或存储中包含的数据已损坏。

• 'REBIND' - 一个请求导致，例如，一条'LOCATION_FORWARD'消息; 如果政策不兼容，则会引发此例外情况。

• 'TIMEOUT' - 如果请求在给定的时间限制内未能完成则产生。

• 'TRANSACTION_MODE' - 检测到交易策略不匹配。

• 'TRANSACTION_REQUIRED' - 被调用的操作需要一个事务，但该请求不包含事务上下文。

• 'TRANSACTION_ROLLEDBACK' - 与请求相关的事务已经回滚或将会。

• 'TRANSACTION_UNAVAILABLE' - 由于ORB无法联系事务服务，因此无法提供事务上下文。

• 'TRANSIENT' - ORB无法确定对象的当前状态，因为无法到达。错误可能是暂时的。

• 'UNKNOWN' - 如果实现抛出一个非CORBA或无法识别的异常，则抛出该错误。

10.2 用户定义的例外

用户异常在IDL文件中定义，并在操作中列出引发异常列表。例如，如果我们有以下IDL代码：

module MyModule {

  exception MyException {};
  exception MyExceptionMsg { string ExtraInfo; };

  interface MyInterface {

    void foo() 
      raises(MyException);

    void bar() 
      raises(MyException, MyExceptionMsg);

    void baz();
  };
};    
    

10.3 抛出异常

为了能够引发MyException或MyExceptionMsg异常，必须包含生成的MyModule.hrl，其典型用法是：

-module('MyModule_MyInterface_impl').
-include("MyModule.hrl").

bar(State) ->
    case TestingSomething of
        ok ->
           {reply, ok, State};
        {error, Reason} when list(Reason) ->
           corba:raise(#'MyModule_MyExceptionMsg'{'ExtraInfo' = Reason});
        error ->
           corba:raise(#'MyModule_MyException'{})
    end.
    

10.4捕获异常

根据我们调用的操作必须能够处理：

• foo - MyException或者系统异常。

• bar- MyException，MyExceptionMsg或系统异常。

• 系统异常。

捕获和匹配异常可以以不同的方式完成：

case catch 'MyModule_MyInterface':bar(MIReference) of
    ok ->
       %% The operation raised no exception.
       ok;
    {'EXCEPTION', #'MyModule_MyExceptionMsg'{'ExtraInfo' = Reason}} ->
       %% If we want to log the Reason we must extract 'ExtraInfo'.
       error_logger:error_msg("Operation 'bar' raised: ~p~n", [Reason]),
       ... do something ...;
    {'EXCEPTION', E} when record(E, 'OBJECT_NOT_EXIST') ->
       ... do something ...;
    {'EXCEPTION', E} ->
       ... do something ...
end.