55.2.3. 3. DataField

DataField 주석은 필드의 속성을 정의합니다. 각 datafield는 레코드, 유형(string, int, date, …​) 및 선택적으로 패턴의 위치에 의해 식별됩니다.

케이스 1 : pos

이 매개변수/attribute는 CSV 레코드에서 필드의 위치를 나타냅니다.

위치

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

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 5)
    private String isinCode;

}

이 예제에서 볼 수 있듯이 위치는 1 에서 시작하지만 클래스 순서에서 5 에서 계속됩니다. 2 에서 4 사이의 숫자는 클래스 클라이언트에 정의되어 있습니다 (아래 참조).

position은 다른 모델 클래스에서 계속됩니다.

public class Client {

    @DataField(pos = 2)
    private String clientNr;

    @DataField(pos = 3)
    private String firstName;

    @DataField(pos = 4)
    private String lastName;
}

케이스 2 : 패턴

패턴을 통해 데이터 형식을 보강하거나 검증할 수 있습니다.

패턴

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

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 5)
    private String isinCode;

    @DataField(name = "Name", pos = 6)
    private String instrumentName;

    @DataField(pos = 7, precision = 2)
    private BigDecimal amount;

    @DataField(pos = 8)
    private String currency;

    // pattern used during parsing or when the date is created
    @DataField(pos = 9, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

케이스 3: precision

전체 자릿수는 숫자의 10진수 부분을 정의하려는 경우에 유용합니다.The precision is helpful when you want to define the decimal part of your number.

Precision

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

    @DataField(pos = 1)
    private int orderNr;

    @Link
    private Client client;

    @DataField(pos = 5)
    private String isinCode;

    @DataField(name = "Name", pos = 6)
    private String instrumentName;

    @DataField(pos = 7, precision = 2)
    private BigDecimal amount;

    @DataField(pos = 8)
    private String currency;

    @DataField(pos = 9, pattern = "dd-MM-yyyy")
    private Date orderDate;
}

케이스 4: Position은 출력에서 다릅니다.

position 속성은 생성된 CSV 레코드에 필드를 배치하는 방법을 bindy에 알립니다. 기본적으로 사용되는 위치는 pos 속성으로 정의된 위치에 해당합니다. 위치가 다르면 (즉, 무형에서 마샬링에서 마샬링을 비교하는 천문 프로세스가 있는 경우, 위치 를 사용하여 이를 표시할 수 있습니다.

예를 들면 다음과 같습니다.

위치가 출력에 따라 다릅니다.

@CsvRecord(separator = ",", isOrdered = true)
public class Order {

    // Positions of the fields start from 1 and not from 0

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

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

    @DataField(pos = 3, position = 9)
    private String firstName;

    @DataField(pos = 4, position = 8)
    private String lastName;

    @DataField(pos = 5, position = 7)
    private String instrumentCode;

    @DataField(pos = 6, position = 6)
    private String instrumentNumber;
}

주석 @DataField 의 이 속성은 주석 @CsvRecord 의 attribute isOrdered = true 와 함께 사용해야 합니다.

케이스 5 : 필수

필드가 필수인 경우 true로 설정된 특성을 사용하기만 하면 됩니다.

필수 항목

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

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 2, required = true)
    private String clientNr;

    @DataField(pos = 3, required = true)
    private String firstName;

    @DataField(pos = 4, required = true)
    private String lastName;
}

이 필드가 레코드에 없으면 다음 정보를 사용하여 구문 분석기에 의해 오류가 발생합니다.If this field is not present in the record, then an error will be raised by the parser with the following information:

Some fields are missing (optional or mandatory), line :

case 6 : trim

필드에 처리되기 전에 제거해야 하는 선행 및/또는 후행 공백이 있는 경우 속성 trim 을 true로 설정합니다.

Trim

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

    @DataField(pos = 1, trim = true)
    private int orderNr;

    @DataField(pos = 2, trim = true)
    private Integer clientNr;

    @DataField(pos = 3, required = true)
    private String firstName;

    @DataField(pos = 4)
    private String lastName;
}

case 7 : defaultValue

필드가 정의되지 않은 경우 defaultValue 특성으로 표시된 값을 사용합니다.

기본값

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

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 2)
    private Integer clientNr;

    @DataField(pos = 3, required = true)
    private String firstName;

    @DataField(pos = 4, defaultValue = "Barin")
    private String lastName;
}

case 8 : columnName

@CsvRecord 주석이 generateHeaderColumns = true 인 경우에만 속성의 열 이름을 지정합니다.

열 이름

@CsvRecord(separator = ",", generateHeaderColumns = true)
public class Order {

    @DataField(pos = 1)
    private int orderNr;

    @DataField(pos = 5, columnName = "ISIN")
    private String isinCode;

    @DataField(name = "Name", pos = 6)
    private String instrumentName;
}

이 속성은 선택적 필드에만 적용할 수 있습니다.