CsvNumberFormat (Super CSV Annotation 2.3 API)

```
@Target(value={FIELD,ANNOTATION_TYPE})
 @Retention(value=RUNTIME)
 @Documented
public @interface CsvNumberFormat
```
数値型の書式を定義するためのアノテーションです。
対応する型は以下の通りです。
- プリミティブ型「byte/short/int/long/float/double」および、そのラッパークラス。
- java.math.BigDecimal/java.math.BigInteger
プリミティブ型に対して読み込む際に、CSVのカラムの値が空の場合、それぞれのプリミティブ型の初期値が設定されます。
整数型の場合は 0 が、小数型の場合は 0.0 が設定されます。

基本的な使い方
- 属性pattern()で、書式を指定します。
  省略した場合は、各クラスの標準の形式で解析します。
- 属性locale()で、ロケールを指定します。
  - 言語コードのみを指定する場合、ja の2桁で指定します。
  - 言語コードと国コードを指定する場合、ja_JP のようにアンダーバーで区切り指定します。
  - 和暦を扱う時など、バリアントを指定する場合も同様に、ja_JP_JP のようにさらにアンダーバーで区切り指定します。
- 属性currency()で、通貨コード(ISO-4217コード)を指定します。
```
 @CsvBean
 public class SampleCsv {
     
     @CsvColumn(number=1)
     @CsvNumberFormat(pattern="#,##0")
     private int number;
     
     @CsvColumn(number=2, label="給与")
     @CsvNumberFormat(pattern="¤¤ #,##0.0000", locale="ja_JP", currency="USD")
     private Double salary;
     
     // getter/setterは省略
 }
 
```
バージョン:

2.0

作成者:

T.TSUCHIE

任意要素のサマリー

任意要素
修飾子とタイプ	任意要素と説明
`String`	`currency` 通貨コード `Currency` を指定します。
`boolean`	`lenient` 読み込み時に数値の解析を曖昧に行うか指定します。
`String`	`locale` ロケールを指定します。
`String`	`message` エラー時のメッセージを指定します。
`String`	`pattern` 数値の書式を指定します。
`int`	`precision` 丸めの精度を指定します。
`RoundingMode`	`rounding` 丸めの方法を指定します。

- 要素の詳細
  - pattern
```
public abstract String pattern
```
    数値の書式を指定します。
    DecimalFormatで解釈可能な値を指定する必要があります。
    
    戻り値:
    
    指定しない場合は、クラスタイプごとの標準の書式が適用されます。
    
    デフォルト:
    
    ""
- - lenient
```
public abstract boolean lenient
```
    読み込み時に数値の解析を曖昧に行うか指定します。
    例えば、 12.51 と小数を整数型にマッピングする場合、13と丸めの補正が行われます。
    また、123,456.0ab のように、途中から数値以外の文字が出現した場合、それまでの文字 123,456.0 を抽出して処理が行われます。
    
    戻り値:
    
    trueの場合、曖昧に解析を行います。
    
    デフォルト:
    
    false
- - currency
```
public abstract String currency
```
    通貨コード Currency を指定します。(ISO 4217 Code)
    属性pattern()を指定したときのみ有効になります。
    
    戻り値:
    
    通貨コード (ISO 4217 コード)
    
    デフォルト:
    
    ""
- - locale
```
public abstract String locale
```
    ロケールを指定します。
    <言語コード>、<言語コード>_<国コード>、<言語コード>_<国コード>_<バリアント>の3つの書式で指定します。
    
    例 'ja'、'ja_JP'、'ja_JP_JP'
    
    属性pattern()を指定したときのみ有効になります。
    
    戻り値:
    
    省略した場合、システム標準の値を使用します。
    
    デフォルト:
    
    ""
- - rounding
```
public abstract RoundingMode rounding
```
    丸めの方法を指定します。
    詳細は、RoundingModeのJavaDocを参照してください。
    
    戻り値:
    
    パース時やフォーマット時の桁の丸めの方法。
    
    導入されたバージョン:
    
    1.2
    
    デフォルト:
    
    java.math.RoundingMode.HALF_EVEN
- - precision
```
public abstract int precision
```
    丸めの精度を指定します。
    属性pattern()を指定しない場合に有効になります。
    主に小数の場合に有効桁数を揃える際に利用します。
    例えば、precision=4で、文字列 123.45 を double型にマッピングする場合、結果は 123.4 として読み込まれます。
    
    丸めの方法は、属性rounding()で指定します。
    
    戻り値:
    
    0以上の値を指定すると有効になります。
    
    導入されたバージョン:
    
    1.2
    
    デフォルト:
    
    -1
- - message
```
public abstract String message
```
    エラー時のメッセージを指定します。
    {key}の書式の場合、プロパティファイルから取得した値を指定できます。
    
    このメッセージは、文字列を数値型にパースする際に失敗したときに適用されるメッセージに使用します。
    - lineNumber : カラムの値に改行が含まれている場合を考慮した実際の行番号です。1から始まります。
    - rowNumber : CSVの行番号です。1から始まります。
    - columnNumber : CSVの列番号です。1から始まります。
    - label : カラムの見出し名です。
    - validatedValue : 実際のカラムの値です。
    - pattern : アノテーションの属性pattern()の値です。指定されている場合のみ設定されます。
    戻り値:
    
    省略した場合は、適用されたCellProcessorに基づいたメッセージが出力されます。
    
    デフォルト:
    
    "{com.github.mygreen.supercsv.annotation.format.CsvNumberFormat.message}"

注釈型 CsvNumberFormat

基本的な使い方

任意要素のサマリー

要素の詳細

pattern

lenient

currency

locale

rounding

precision

message