例外を発生させます。
構文
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 つの形式があります。
- メソッドの第 1
の形式は、例外タイプおよびストリングを渡す新しい例外を作成します。この例外を使用して、メッセージをメソッドの呼び出し自体に組み込みます。
- 第 2
の形式は、例外タイプおよびマップ・メッセージ・ファイルに含まれるメッセージへの参照を渡す新しい例外を作成します。メソッドの呼び出しには、コンマで区切られた、最大
5 つのパラメーターを含めることができます。
- 第 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);
