Throw-Exception
説明
例外を発生させます。タスク内のユニットのボディ内から Webject を呼び出す場合に、ブロックが存在すると、制御は failure ブロックに変換されます。Webject がユニット外から呼び出される場合、タスクは終了します。
|
|
Info*Engine は、タスクの実行時に発生した例外の名前とメッセージを整理して、exception-class および exception-message という名前の SERVER コンテキストグループの属性に自動的に登録します。これにより、ユニット内の失敗ブロックが例外を処理し、パラメータを渡さずに Throw‑Exception Webject を呼び出して例外を返すことができます。exception-object という SERVER コンテキスト属性は、ネステッド例外をアンラップし、未処理のラップされていない例外オブジェクトを作成して登録します。Throw-Exception Webject は、この SERVER コンテキスト属性を検索し、存在する場合は、関連する例外オブジェクトを直接生成します。
|
構文
<ie:webject name="Throw-Exception" type="MGT">
<ie:param name="BUNDLE" data="bundle_name"/>
<ie:param name="CLASS" data="exception_class_name"/>
<ie:param name="GROUP_IN" data="input_group"/>
<ie:param name="KEY" data="resource_key"/>
<ie:param name="MESSAGE" data="text_message"/>
<ie:param name="PARAM" data="resource_param"/>
</ie:webject>
パラメータ
|
必須
|
選択
|
オプション
|
|
BUNDLE
|
CLASS
|
|
GROUP_IN
|
|
|
KEY
|
|
|
MESSAGE
|
|
|
PARAM
|
|
BUNDLE
例外と関連付けるローカライズされたメッセージテンプレートを含んでいる、Java リソースバンドルのクラス名を識別します。
KEY および PARAM パラメータを使用するには、BUNDLE または GROUP_IN のいずれかも指定する必要があります。
CLASS
発生する例外の Java クラス名を指定します。CLASS を省略すると、Webject は exception-class という名前の SERVER コンテキストグループの属性からクラス名を取得します。属性が存在しない場合、クラス名はデフォルト値である com.infoengine.util.IEException になります。このパラメータはオプションです。
GROUP_IN
Get-Resource Webject によって生成されたグループなどの、ローカライズされたリソース定義を含んでいるグループを識別します。BUNDLE および GROUP_IN の両方を指定すると、BUNDLE が優先され、GROUP_IN は無視されます。
KEY および PARAM パラメータを使用するには、BUNDLE または GROUP_IN のいずれかも指定する必要があります。
KEY
バンドルまたはグループからローカライズされたメッセージテンプレートを選択します。KEY 値は数字または Java 変数参照名として指定できます。
このパラメータは、BUNDLE または GROUP_IN パラメータのいずれかも指定する場合のみ使用します。
MESSAGE
MESSAGE パラメータは、例外に関連付けられるテキストメッセージを指定します。このパラメータは、例外にローカライズ可能なメッセージを生成する必要がない場合のみ使用します。このパラメータを省略し、BUNDLE および GROUP_IN パラメータも省略した場合、Webject は exception-message という名前の SERVER コンテキストグループ属性からメッセージテキストを取得します。MESSAGE とともに BUNDLE または GROUP_IN を指定すると、MESSAGE パラメータが優先され、BUNDLE および GROUP_IN は無視されます。
PARAM
最終的なメッセージテキストを生成するために、ローカライズされたメッセージテンプレートに置換される 1 つまたは複数の値を指定します。PARAM を指定しない場合、BUNDLE または GROUP_IN および KEY パラメータによって識別されるメッセージテンプレートには置換キーワードが含まれず、したがって置換は実行されないと見なされます。
このパラメータは、BUNDLE または GROUP_IN パラメータのいずれかも指定する場合のみ使用します。
例
以下の Throw-Exception の例は、指定したリソースバンドルの KEY 番号 19 で識別されるローカライズされたメッセージを使用して、例外を発生させます。
<%@page language="java"
session="false"
errorPage="../IEError.jsp"%>
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie" %>
html>
<head><title>Throw Exception</title></head>
<body>
ie:webject name="Throw-Exception" type="MGT">
<ie:param name="BUNDLE"
data="com.infoengine.util.IEResource"/>
<ie:param name="KEY" data="19"/>
</ie:webject>
/body>
</html>
