コンポーネントプロパティーの java.lang.String 値とデータ型 java.lang.Enum または Java のプリミティブ型 enum の間の変換を行います。このコンバータは JavaServer Faces 1.2 以降で使用可能なため、Java EE 5 を使用するプロジェクトで使用できます。通常、変換は、値の表示およびユーザーが入力した値の読み取りにコンポーネントが使用するプロパティーに適用されます。たとえば、テキストフィールドコンポーネントはこの目的で「text」プロパティーを使用します。
EnumConverter() がコンバータのインスタンス化に使用されます。しかし、コンバータが Java enum クラスをパラメータとした、次のクラスコンストラクタを使用するようにしなければなりません。
EnumConverter(Class targetClass)
その例として、コンポーネントが次のように宣言された enum 型 Day の値をバインドする方法を示します。
public enum Day {Sunday, Monday, Tuesday,
Wednesday, Thursday,
Friday, Saturday};
private EnumConverter enumConverter1 = new EnumConverter();
Day クラスをパラメータとして new EnumConverter() 文に追加します。
private EnumConverter enumConverter1 = new EnumConverter(Day.class);
名前: <入力された値> は <コンバータの型> である必要があります。
このメッセージの <名前> は、コンポーネントの ID か、コンポーネントにラベルがある場合はラベルの内容のいずれかです。<入力された値> はユーザーが入力した値で、<コンバータの型> はコンバータの型です。たとえば、コンバータが BigDecimal コンバータの場合は、<コンバータの型> は符号付き 10 進数です。