This tool deals with Struts error messages. Errors may stem from the validation of a submitted form or from the processing of a request. If there are errors, they are made available to the view to render. A few important aspects about errors are:
property that describes the category of
error. This allows the view designer to place error messages precisely where an
error occurred. For example, errors that apply to the entire page can be rendered
at the top of the page, errors that apply to a specific input field can be rendered
next to this input field. Several methods of this tool provide a parameter
property that allows to select a specific category of errors to operate
on. Without the property parameter, methods operate on all error messages.このツールは Struts のエラーメッセージを提供します。 エラーはサブミットされたフォームの検証中、あるいはリクエストの処理中に発生します。 エラーが起きた場合、ビューへの出力を生成できるようになります。 エラーについて抑えておくべき重要な点は:
property 属性を持ちます。
これはビューデザイナがエラーが発生した場所に適切にエラーメッセージを配置することを可能にします。
例えば、ページの全体に対してのエラーはページの一番上に表示し、
特定の入力フィールドに対してのエラーはこの入力フィールドの隣りに表示することができます。
このツールのいくつかのメソッドは、処理対象とする特定のエラーカテゴリを選択できる property パラメータを提供します。
property パラメータを指定しない場合、これらのメソッドは全てのエラーメッセージを処理します。See the Struts User's Guide, section Building View Components for more information on this topic.
この話題のより詳細については Struts ユーザガイドの Building View Components の章を参照してください。
true if there are errors queued, otherwise false.
true if there are error messages queued. false otherwise.
Calling exist() without the property parameter checks for error messages of
any category. The property parameter can be used to limit the check to
error messages of a specific category.
trueを返却、その他の場合false。
trueを返却、その他の場合false。
property パラメータを指定せずに exist() を呼び出すと全てのカテゴリのエラーメッセージがチェックされます。
property パラメータは特定カテゴリのエラーメッセージのチェックに使用します。
Calling getSize() without the property parameter returns the total
number of queued error messages. The property parameter can be used to
obtain the number of queued error messages for a specific category.
property パラメータを指定せずに getSize() を呼び出すと全てのカテゴリのエラーメッセージの総数を返却します。
property パラメータは特定カテゴリのエラーメッセージの数を取得するときに使用します。
$errors.get($errors.globalName)
See the section on get() for more information.
$errors.get($errors.globalName)と同等の簡易メソッドです。
より詳細についてはget()セクションを参照してください。
The following example shows a macro to render the error messages:
This produces output similar to the following:
以下の例はエラーメッセージを表示するマクロです:
これは以下のような出力を生成します:
java.util.List of java.lang.String.
If no error messages exist for the specified category,
null is returned.
If the message resources are lacking an error message for a
particular message key, the key itself is used as an error message
and a warning is logged.
The following example shows a macro to render the error messages for a particular category of errors:
This produces output similar to the following:
java.lang.String の java.util.List 。
指定されたカテゴリにエラーメッセージが無い場合には、
null を返却します。
特定のメッセージキーのエラーメッセージがメッセージリソースに無かった場合、
そのキー自体がエラーメッセージとして使用され、このとき警告がロギングされます。
以下の例は特定のエラーカテゴリのエラーメッセージを表示するマクロです:
これは以下のような出力を生成します:
String is returned.
This method renders the queued error messages as a list. If the method
is called without a parameter, all queued errors are rendered. With the
parameter property the list of rendered messages can be
limited to a specific category of errors. Error message texts
are looked up in the message resources. If a message text
cannot be found, the message key will be displayed instead.
The method expects a message header and a message footer
to be defined in the message resources. The corresponding
message keys are errors.header and
errors.footer.
Assuming that the message resources contain the following definitions:
an error message would be rendered as follows:
String が返却されます。
このメソッドはエラーメッセージをリストとして表示します。
パラメータ無しで呼び出した場合、全てのエラーが表示されます。
property パラメータを指定した場合、特定のカテゴリのエラーのメッセージリストを表示します。
エラーメッセージの文字列はメッセージリソースから取得されます。
メッセージが見つからなかった場合、メッセージのキーを代わりに表示します。
このメソッドはメッセージヘッダとメッセージフッタがメッセージリソースに定義されていることを前提とします。
これらのメッセージのキーは errors.header と
errors.footer です。
メッセージリソースが以下のように定義されている場合:
エラーメッセージは以下のように表示されます: