raiseException()

例外を発生させます。

構文

void raiseException(String exceptionType, String message)
  
 void raiseException(String exceptionType, int messageNum,
    String parameter[,...])
  
 void raiseException(RunTimeEntityException exception)
 

パラメーター

exceptionType
以下の IBM WebSphere Business Integration Server Express 定義の定数の 1 つです。

AnyException
不特定の例外です。

AttributeException
属性でアクセスする場合の問題です。例えば、String 属性に対して getDouble() を呼び出したり、存在しない属性に対して getString() を呼び出すコラボレーションがあります。

JavaException
IBM WebSphere Business Integration Server Express API の一部ではない Java コードに関する問題です。

ObjectException
メソッドに渡されたビジネス・オブジェクトが無効でした。または、null オブジェクトにアクセスされました。

OperationException
サービス呼び出しが適切に設定されませんでした。あるいは送信されませんでした。

ServiceCallException
サービス呼び出しに失敗しました。例えば、コネクターやアプリケーションは使用できません。

SystemException
IBM WebSphere Business Integration Server Express システム内の内部エラーです。

message
メソッドの呼び出しに例外メッセージを組み込むテキスト・ストリング。

messageNum
マップ・メッセージ・ファイル内の番号付きメッセージへの参照。

parameters
メッセージ自体のパラメーターの値。メソッドの呼び出しにおいて、最大 5 つのパラメーターで構成されます。

exception
例外オブジェクト変数の名前。

戻り値

なし。

注記

raiseException() メソッドには、以下の 3 つの形式があります。

注:
messageNum パラメーターを取得するメソッドのすべての形式で、メッセージ・ファイルを使用する必要があります。このファイルはメッセージ番号でインデックスが付けられます。メッセージ・テキスト・ファイルの設定方法の詳細は、付録 A, "メッセージ・ファイル"を参照してください。

次の例では、メソッドの第 1 の形式を使用して ServiceCallException タイプの例外を生成します。テキストはメソッドの呼び出しに組み込まれます。

raiseException(ServiceCallException, 
    "Attempt to validate Customer failed.");
 

次の例は、ServiceCallException タイプの例外を生成します。メッセージ・ファイル内のメッセージは、以下のとおりです。

23
 Customer update failed for CustomerID={1} CustomerName={2} 
 

raiseException() メソッドはメッセージを呼び出して、fromCustomer 変数からメッセージ・パラメーターの値を取得し、raiseException() 呼び出しに渡します。

raiseException(ServiceCallException, 23,
    fromCustomer.getString("CustomerID"),
    fromCustomer.getString("CustomerName"));
 

最後の例では、処理済みの例外を生成します。システム定義変数 currentException は、例外を含む例外オブジェクトです。

raiseException(currentException);
 

Copyright IBM Corp. 2004