DataField 주석은 필드의 속성을 정의합니다. 각 데이터 필드는 레코드의 위치, 유형(문자열, int, date, …) 및 선택적으로 패턴으로 식별됩니다.
Expand
주석 이름
레코드 유형
level
DataField
all
속성
Expand
매개변수 이름
type
정보
POS
int
mandatory - 필드의 입력 위치입니다. 1에서 …까지 시작하는 숫자 번호 - position 매개변수를 참조하십시오.
패턴
string
선택 사항 - default value = "" -는 Date, Date 형식 지정에 사용됩니다.
길이
int
선택 사항 - 고정 길이 형식의 필드 길이를 나타냅니다.
precision
int
선택 사항 - 이름이 포맷 / 구문될 때 사용할 전체값을 나타냅니다.
패턴
string
선택 사항 - default value = "" -는 Java formatter(예: SimpleDateFormat by example)에서 데이터 포맷/검증하는 데 사용됩니다. 패턴을 사용하는 경우 바인딩 데이터 형식으로 로케일을 설정하는 것이 좋습니다. "us"와 같이 알려진 로케일으로 설정하거나 "default"를 사용하여 플랫폼 기본 로케일을 사용합니다. "default"에는 Camel 2.14/2.13.3/2.12.5가 필요합니다.
위치
int
선택 사항 - 생성된 CSV 필드의 필드 위치가 입력 위치(pos)와 비교되어야 하는 경우 사용해야 합니다. pos 매개변수를 참조하십시오.
필수 항목
boolean
optional - default value = "false"
Trim
boolean
optional - default value = "false"
defaultValue
string
Camel 2.10: 선택 사항 - 기본값 = "" - 각 CSV 필드가 비어 있거나 사용할 수 없는 경우 필드의 기본값을 정의합니다.
impliedDecimalSeparator
boolean
Camel 2.11: 선택 사항 - 기본값 = "false" - 지정된 위치에 임의의 소수점이 있는지 나타냅니다.
lengthPos
int
Camel 2.11: 선택 사항 - 이 필드의 고정 길이를 정의하는 고정 길이 레코드에서 데이터 필드를 식별하는 데 사용할 수 있습니다.
align
string
선택 사항 - default value = "R" - 텍스트를 고정 길이 필드 내에서 오른쪽 또는 왼쪽으로 정렬합니다. 값 'R' 또는 'L' 사용
구분 기호
string
Camel 2.11: 선택 사항 - 고정 길이 레코드 내에서 변수 길이 필드의 끝을 구분 해제하는 데 사용할 수 있습니다.
케이스 1 : pos
이 매개변수/attribute는 csv 레코드의 필드 위치를 나타냅니다.
위치
@CsvRecord(separator = ",")
public class Order {
@DataField(pos = 1)
private int orderNr;
@DataField(pos = 5)
private String isinCode;
}
@CsvRecord(separator = ",")
public class Order {
@DataField(pos = 1)
private int orderNr;
@DataField(pos = 5)
private String isinCode;
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
이 예에서 볼 수 있듯이 위치는 '1'에서 시작하지만 클래스 Order에서 '5'로 계속합니다. '2'에서 '4'로의 숫자는 클래스 Client에 정의되어 있습니다(다음 참조).
Copy to ClipboardCopied!Toggle word wrapToggle overflow
케이스 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;
}
@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;
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Copy to ClipboardCopied!Toggle word wrapToggle overflow
케이스 4 : 출력에 따라 다릅니다.
position 속성은 생성된 CSV 레코드에 필드를 배치하는 방법을 바인딩하는 방법을 알려줍니다. 기본적으로 사용되는 위치는 속성 'pos'로 정의된 위치에 해당합니다. If the position is different (즉, we have an asymetric processus comparing from unmarshaling) we can use 'position' to indicate this.
예를 들면 다음과 같습니다.
출력은 위치가 다릅니다.
@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;
}
@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;
}
Copy to ClipboardCopied!Toggle word wrapToggle overflow
주석 @DataField의 이 속성은 속성과 함께 사용해야 합니다. @CsvRecord 주석의Ordered = true
케이스 5: 필수
필드가 필수인 경우 'required' 값을 true로 설정된 속성을 사용하기만 하면 됩니다.