46.3. 1.CsvRecord

CsvRecord アノテーションは、モデルのルートクラスを特定するために使用されます。これは CSV ファイルのレコード = 行を表し、複数の子モデルクラスにリンクできます。

case 1 : separator = ','

CSV レコードのフィールドを分離するために使用される区切り文字は ',' です。

10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500,
USD,08-01-2009

@CsvRecord( separator = "," )
public Class Order {

}

case 2 : separator = ';'

前のケースと比較すると、ここでのセパレーターは ',' ではなく ';' になります。

10; J; Pauline; M; XD12345678; Fortis Dynamic 15/15; 2500; USD; 08-01-2009

@CsvRecord( separator = ";" )
public Class Order {

}

case 3 : separator = '|'

前のケースと比較すると、ここでの区切り文字は ';' ではなく '|' です。

10| J| Pauline| M| XD12345678| Fortis Dynamic 15/15| 2500| USD|
08-01-2009

@CsvRecord( separator = "\\|" )
public Class Order {

}

case 4 : separator = '\",\"'

Camel 2.8.2 以前に適用されます。

CSV レコードの解析されるフィールドに ',' または ';' が含まれ、これはセパレーターとしても使用されます。
は、このケースの処理方法を camel バインドy に伝えるために別のストラテジーを見つけました。コンマで区切られたデータを含むフィールドを定義するには、区切り文字として simple または double quotes
を使用します（例： '10'、'Street 10、NY'、'USA'、"Street 10、NY", "USA"）。
Remark : この場合、単純または二重引用符である行の最初の文字と最後の文字がバインドによって削除されます。

"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15"
2500","USD","08-01-2009"

@CsvRecord( separator = "\",\"" )
public Class Order {

}

Camel 2.8.3/2.9 以降、またはバインドy は、レコードが一 重引用符または二重引用符で囲まれているかどうかを自動的に検出し、CSV からオブジェクトへのアンマーシャリング時にこれらの引用符を自動的に削除します。したがって、区切り文字には引用符を含め ない でくださいが、以下のように簡単に実行できます。

"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15"
2500","USD","08-01-2009"

@CsvRecord( separator = "," )
public Class Order {

}

オブジェクトから CSV にマーシャリングし、引用符を使用する場合は、以下のように @CsvRecord の引用符属性を使用して、使用する 引用 符を指定する必要があります。

@CsvRecord( separator = ",", quote = "\"" )
public Class Order {

}

ケース5: セパレーターおよびスキップライン

この機能は、クライアントがデータフィールドの名前であるファイルの最初の行に合わせる場合に適しています。

order id、クライアント ID、名、姓、コードのインストルメント化名、数値、通貨、日付

解析プロセス中にこの最初の行をスキップする必要があることをバインドするには、属性を使用します。

@CsvRecord(separator = ",", skipFirstLine = true)
public Class Order {

}

case 6 : generateHeaderColumns

生成された CSV の最初の行で追加するには、以下のようにアノテーションで generateHeaderColumns 属性を true に設定する必要があります。

@CsvRecord( generateHeaderColumns = true )
public Class Order {

}

その結果、アンマーシャリングプロセス中にバインドすると、以下のような CSV が生成されます。

order id、クライアント ID、名、姓、コードのインストルメント化名、数値、通貨、日付

10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500, USD,08-01-2009

case 7 : carriage return

camel-bindy が実行されるプラットフォームが Windows ではなく、Macintosh または Unix の場合は、以下のように crlf プロパティーを変更できます。使用できる値は、WINDOWS、UNIX、または MAC です。

@CsvRecord(separator = ",", crlf="MAC")
public Class Order {

}

さらに、何らかの理由で別の行末文字を追加する必要がある場合は、clf パラメーターを使用してそれを指定することもできます。以下の例では、行末には改行文字を続きます。

@CsvRecord(separator = ",", crlf=",\n")
public Class Order {

}

case 8 : isOrdered

モデルからの CSV レコードの作成時に発生する順序は、解析中に使用される順序と異なる場合があります。次に、この属性 isOrdered = true を使用して、DataField アノテーションの属性 'position' と組み合わせて使用できます。

@CsvRecord(isOrdered = true)
public Class Order {

   @DataField(pos = 1, position = 11)
   private int orderNr;

   @DataField(pos = 2, position = 10)
   private String clientNr;

}

Remark : ファイルの解析に使用され、CSV の生成に位置が使用されます。