ADF FacesのDateTimeConverter
は、JSFのDateTimeConverter
APIを拡張したAPIです。コンストラクタは、次のとおりです。
public DateTimeConverter(java.lang.String pattern)
public DateTimeConverter(java.lang.String pattern, java.lang.String secondaryPattern)
public DateTimeConverter()
JSFの日時コンバータとは異なり、ADF FacesのDateTimeConverter
では、第2のパターンを設定でき、変換時にパターンを使用して容認レベルが考慮されます。次に例を示します。
pattern
またはsecondaryPattern
で月がMMMに設定されている場合は、MMやMなどの書式の値が有効とみなされます。
pattern
またはsecondaryPattern
に指定されたセパレータに関係なく「-」、「.」または「/」が含まれている値は有効とみなされます。
また、adf-faces-config.xml
構成ファイルには、アプリケーションのデフォルト・タイムゾーン値を設定できます。コンバータにタイムゾーンが設定されていない場合、ADF Facesは、adf-faces-config.xml
のタイムゾーンのデフォルト値を参照します。したがって、タイムゾーンが必要なコンポーネントすべてにタイムゾーンを設定せずに、デフォルトのタイムゾーンを使用して解析と書式設定を実行できます。
ADF FacesのDateTimeConverter
の詳細は、oracle.adf.view.faces.convert.DateTimeConverter
のJavadocを参照してください。
変換に失敗した場合は、コンバータ例外がスローされ、適切なメッセージ識別子でFacesMessage
が作成されてキューイングされます。次のメソッドを使用すると、メッセージIDで識別されたエラー・メッセージの詳細部分をオーバーライドできます。
メッセージID | メソッド |
---|---|
CONVERT_DATE_MESSAGE_ID
|
setConvertDateMessageDetail(java.lang.String convertDateMessageDetail)
|
CONVERT_TIME_MESSAGE_ID
|
setConvertTimeMessageDetail(java.lang.String convertTimeMessageDetail)
|
CONVERT_BOTH_MESSAGE_ID
|
setConvertBothMessageDetail(java.lang.String convertBothMessageDetail)
|
convertXXXMessageDetail
にはカスタム・エラー・メッセージを指定します。このカスタム・エラー・メッセージには、実行時に適切な値に置換されるプレースホルダを含めることができます。
ADF FacesのDateTimeConverter
は、JSFの日時コンバータIDに自動的に関連付けられます。これは、JSFのf:convertDateTime
タグを適用する都度、ADF FacesのDateTimeConverter
が自動的に使用されることを意味します。このために特別な構成を実行する必要はありません。
ヒント: ADF Facesのaf:convertDateTime
タグを(f:convertDateTime
タグのかわりに)使用すると、変換できない値について詳細なカスタム・エラー・メッセージを提供できる追加属性にアクセスできます。詳細は、「af:convertDateTimeとf:convertDateTimeの違いについて」を参照してください。
ADF Facesのクライアント・コンバータおよびバリデータのAPIについて
ADF Faces構成の使用
Copyright © 1997, 2007, Oracle. All rights reserved.