红帽全球峰会60.2. 注解
创建的注解允许将模型的不同概念映射到 POJO，如下所示：
- 记录类型(CSV，键值对（如 FIX 消息)、固定长度 …）
- 链接（指向另一个对象中的链接对象），
- DataField 及其属性(int、type、…)
- KeyValuePairField （用于 key = value 格式，如我们在修复财务消息中一样）
- 部分（用于识别标头、正文和页脚部分），
- OneToMany,
- BindyConverter,
- FormatFactories
本节将描述它们。
60.2.1. 1.CsvRecord
CsvRecord 注解用于识别模型的根类。它代表记录 = " CSV 文件行"，并可链接到多个子模型类。
| 注解名称 | 记录类型 | 级别 |
|---|---|---|
| CsvRecord | CSV | 类 |
| 参数名称 | 类型 | 必填 | 默认值 | info |
|---|---|---|---|---|
| 分隔符 | 字符串 | ✓ | 用于在令牌中分割记录的分隔符（必需）- 可以是 ',' 或 ';' 或 'anything'。支持的唯一空格字符是 tab (\t)。不支持其他空格字符（空格）。这个值被解释为正则表达式。如果要使用在正则表达式中具有特殊含义的符号，如 '|' 符号，您必须屏蔽它，如 '|'。 | |
| allowEmptyStream | 布尔值 | false | allowEmptyStream 参数将允许 prcoess CSV 文件无法查询的流。 | |
| autospanLine | 布尔值 | false | 最后一个记录涵盖其余行（可选）- 如果启用，则最后一列会自动跨越行尾，例如，如果其注释，则允许行包含所有字符，也是分隔符字符。 | |
| CRLF | 字符串 | WINDOWS | 用于在每次记录后（可选）添加回车符的字符 - 允许定义要使用的回车符。如果您指定之前列出的三个值，则您输入的值(custom)将用作 CRLF 字符。可以使用三个值：WINDOWS、UNIX、MAC 或自定义。 | |
| endWithLineBreak | 布尔值 | true | 如果 CSV 文件应该以换行符或没有行结尾（可选） | |
| generateHeaderColumns | 布尔值 | false | generateHeaderColumns 参数允许在 CSV 中添加，生成的标头包含列的名称 | |
| isOrdered | 布尔值 | false | 指明信息是否必须在输出中排序 | |
| name | 字符串 | 描述记录的名称（可选） | ||
| quote | 字符串 | " | 是否使用给定引号字符（可选）替换列（可选）- 在生成 CSV 时可以指定字段的引号字符。此注解与模型的根类关联，必须一次性声明。 | |
| 引用 | 布尔值 | false | 指明值（和标头）是否在 marshaling 时加上引号（可选） | |
| quotingEscaped | 布尔值 | false | 指明值在 quoting 时是否必须转义（可选） | |
| removeQuotes | 布尔值 | true | 如果 unmarshalling 应该为每个字段删除引号，则 remove quotes 参数标志 | |
| skipField | 布尔值 | false | skipField 参数将允许跳过 CSV 文件的字段。如果不需要一些字段，可以跳过它们。 | |
| skipFirstLine | 布尔值 | false | skipFirstLine 参数将允许跳过或不跳过 CSV 文件的第一行。此行通常包含列定义 |
case 1 : separator = ','
用于隔离 CSV 记录中字段的分隔符是 ，
10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500, USD, 08-01-2009
10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500, USD, 08-01-2009@CsvRecord( separator = "," )
public Class Order {
}
@CsvRecord( separator = "," )
public Class Order {
}case 2 : separator = ';'
与前面的情况相比，这里的分隔符为 ; 而不是 ：
10; J; Pauline; M; XD12345678; Fortis Dynamic 15/15; 2500; USD; 08-01-2009
10; J; Pauline; M; XD12345678; Fortis Dynamic 15/15; 2500; USD; 08-01-2009@CsvRecord( separator = ";" )
public Class Order {
}
@CsvRecord( separator = ";" )
public Class Order {
}case 3 : separator = '|'
与前面的情况相比，这里的分隔符为 | 而不是 ; ：
10| J| Pauline| M| XD12345678| Fortis Dynamic 15/15| 2500| USD| 08-01-2009
10| J| Pauline| M| XD12345678| Fortis Dynamic 15/15| 2500| USD| 08-01-2009@CsvRecord( separator = "\\|" )
public Class Order {
}
@CsvRecord( separator = "\\|" )
public Class Order {
}case 4 : separator = '\",\"'
适用于 Camel 2.8.2 或更早版本
当要解析 CSV 记录的字段包含 , 或 ； （也用作分隔符）时，我们应找到另一个策略以告诉 camel bindy 如何处理这种情况。要使用逗号定义包含数据的字段，您可以使用单引号或双引号作为分隔符（例如： '10', 'Street 10, NY', 'USA' 或 "10", "Street 10, NY", "USA"）。
| __ | 在这种情况下，将通过 bindy 删除行的第一个和最后一个字符，即单引号或双引号。 |
"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15","2500","USD","08-01-2009"
"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15","2500","USD","08-01-2009"@CsvRecord( separator = "\",\"" )
public Class Order {
}
@CsvRecord( separator = "\",\"" )
public Class Order {
}Bindy 会自动检测记录是否用单引号或双引号括起来，并在从 CSV 重复到对象时自动删除这些引号。因此 ，不要在 分隔符中包含引号，而是不要如下所示：
"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15","2500","USD","08-01-2009"
"10","J","Pauline"," M","XD12345678","Fortis Dynamic 15,15","2500","USD","08-01-2009"@CsvRecord( separator = "," )
public Class Order {
}
@CsvRecord( separator = "," )
public Class Order {
}
请注意，如果要从对象到 CSV 并使用引号，则需要使用 @CsvRecord 上的 quote 属性来指定要使用的引号字符，如下所示：
@CsvRecord( separator = ",", quote = "\"" )
public Class Order {
}
@CsvRecord( separator = ",", quote = "\"" )
public Class Order {
}case 5 : 分隔符和跳过FirstLine
当客户端要在文件的第一行（数据字段的名称）中时，这个功能非常有趣：
order id, client id, first name, last name, isin code, instrument name, quantity, currency, date
order id, client id, first name, last name, isin code, instrument name, quantity, currency, date要告知绑定此第一行在解析过程中必须跳过，那么我们使用属性 ：
@CsvRecord(separator = ",", skipFirstLine = true)
public Class Order {
}
@CsvRecord(separator = ",", skipFirstLine = true)
public Class Order {
}case 6 : generateHeaderColumns
要在生成的 CSV 第一行中添加，注解中的 generateHeaderColumns 属性必须设置为 true，如下所示：
@CsvRecord( generateHeaderColumns = true )
public Class Order {
}
@CsvRecord( generateHeaderColumns = true )
public Class Order {
}因此，在 unmarshaling 过程中绑定会生成 CSV，如下所示：
order id, client id, first name, last name, isin code, instrument name, quantity, currency, date 10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500, USD, 08-01-2009
order id, client id, first name, last name, isin code, instrument name, quantity, currency, date
10, J, Pauline, M, XD12345678, Fortis Dynamic 15/15, 2500, USD, 08-01-2009问题单 7：回车符
如果运行 camel-bindy 的平台不是 Windows，而是 Macintosh 或 Unix，则您可以更改类似如下的 crlf 属性。可用的三个值有：WINDOWS、UNIX 或 MAC
@CsvRecord(separator = ",", crlf="MAC")
public Class Order {
}
@CsvRecord(separator = ",", crlf="MAC")
public Class Order {
}另外，如果出于某种原因您需要添加不同的行尾字符，您可以使用 crlf 参数指定它。在以下示例中，我们可以使用逗号结束行，后跟换行符：
@CsvRecord(separator = ",", crlf=",\n")
public Class Order {
}
@CsvRecord(separator = ",", crlf=",\n")
public Class Order {
}case 8 : isOrdered
有时，在从模型创建 CSV 记录时要遵循的顺序与解析过程中使用的顺序不同。然后，在这种情况下，我们可以使用属性 isOrdered = true 来指示这一点与 DataField 注解的属性 位置 相结合。
| __ |
|
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}