com.github.mygreen.supercsv.annotation.format

注釈型 CsvEnumFormat

@Target(value={FIELD,ANNOTATION_TYPE})
 @Retention(value=RUNTIME)
 @Documented
public @interface CsvEnumFormat

列挙型の書式を定義するためのアノテーションです。

基本的な使い方

列挙型の場合、アノテーションを付与しなくてもマッピングできます。
その際は、カラムの値と列挙型の要素の値をマッピングさせます。
要素の値とは、Enum.name()で取得できる値です。

• 属性ignoreCase()で、読み込み時に大文字・小文字の区別なく比較するか指定します。

 @CsvBean
 public class SampleCsv {
       
     @CsvColumn(number=1, label="権限")
     private RoleType role;
     
     // 読み込み時に大文字・小文字の区別を行いません。
     @CsvColumn(number=2, label="権限2")
     @CsvEnumFormat(ignoreCase=true)
     private RoleType role2;
     
     // setter/getterは省略
 }
 
 // 列挙型の定義
 public enum RoleType {
     Normal, Admin;
 }
 

別名でマッピングする場合

別名でマッピングする場合、属性selector() で列挙型の要素の別名を取得するメソッド名を指定します。

以下の例では、読み込み時に入力値が 一般権限 の場合、 RoleType.Normal にマッピングされます。

 @CsvBean
 public class SampleCsv {
       
     @CsvColumn(number=1, label="権限")
     @CsvEnumFormat(selector="localeName")
     private RoleType role;
     
     // setter/getterは省略
 }
 
 // 列挙型の定義
 public enum RoleType {
     Normal("一般権限"), Admin("管理者権限");
     
     // 別名の設定
     private String localeName;
     
     private RoleType(String localeName) {
         this.localeName = localeName;
     }
     
     // 別名の取得用メソッド
     public String localeName() {
         return this.localeName;
     }
 }
 

バージョン:

2.0

作成者:

T.TSUCHIE

任意要素のサマリー

任意要素

修飾子とタイプ	任意要素と説明
boolean	ignoreCase 読み込み時に、大文字・小文字を区別なく候補の値と比較して判定するか指定します。
String	message エラー時のメッセージを指定します。
String	selector 列挙型をEnum.name()メソッド以外から取得するときに指定します。

要素の詳細

ignoreCase

public abstract boolean ignoreCase

読み込み時に、大文字・小文字を区別なく候補の値と比較して判定するか指定します。

戻り値:

trueの場合、大文字・小文字の区別は行いません。

デフォルト:

false

selector

public abstract String selector

列挙型をEnum.name()メソッド以外から取得するときに指定します。

例). Color.label()のlabel()メソッドを指定するときには、'label'と指定します。

戻り値:

独自に実装した引数なしの文字列型を返すメソッドを指定します。省略した場合は、Enum.name()から取得できる値が採用されます。

デフォルト:

""

message

public abstract String message

エラー時のメッセージを指定します。

{key}の書式の場合、プロパティファイルから取得した値を指定できます。

このメッセージは、文字列を列挙型にパースする際に失敗したときに適用されるメッセージに使用します。

使用可能なメッセージ中の変数は下記の通りです。

• lineNumber : カラムの値に改行が含まれている場合を考慮した実際の行番号です。1から始まります。
• rowNumber : CSVの行番号です。1から始まります。
• columnNumber : CSVの列番号です。1から始まります。
• label : カラムの見出し名です。
• validatedValue : 実際のカラムの値です。
• ignoreCase : アノテーションの属性ignoreCase()の値です。
• selector : アノテーションの属性selector()の値です。
• enums : 列挙型の値をCollection型に変換した値です。

戻り値:

省略した場合は、適用されたCellProcessorに基づいたメッセージが出力されます。

デフォルト:

"{com.github.mygreen.supercsv.annotation.format.CsvEnumFormat.message}"