60.2.4. 4.FixedLengthRecord

FixedLengthRecord 注解用于标识模型的根类。它代表一个记录 ="包含数据固定长度（字符数）格式的 file/message 行，并可链接到多个子模型类。这个格式是非常大的，因为字段的数据可能会与右侧或左侧的数据一致。

当数据的大小没有填写字段的长度时，我们可以添加"pad"字符。

Expand

注解名称	记录类型	级别
FixedLengthRecord	FIXED	类

Expand

参数名称	类型	默认值	info
countGrapheme	布尔值	false	指明如何计算chars
crlf	字符串	WINDOWS	字符用于在每条记录后添加回车符（可选）。可能的值：WINDOWS、UNIX、MAC 或自定义。这个选项仅在 marshalling 期间使用，除非自定义 eol，否则 unmarshalling 使用系统默认 JDK 提供的行分隔符。
EOL	字符串		字符用于在每个记录后处理行的结尾，同时解包（可选：default: ""），除非提供了其他任何行分隔符，否则，此选项仅在未总结期间使用，其中 marshalling 使用系统默认行分隔符为"WINDOWS"，除非提供了任何其他值。
footer	类	void	表示此类型的记录可以跟在文件的末尾有一个页脚记录
header	类	void	表示此类型的记录前面带有单个标题记录（在文件开头）：
ignoreMissingChars	布尔值	false	指明是否将被忽略短行
ignoreTrailingChars	布尔值	false	表示在解压缩 / 解析时可以忽略最后一个映射文件以外的字符。此注解与模型的 root 类关联，必须声明一个时间。
length	int	0	记录的固定长度（字符数）。这意味着，记录总是使用 \{#paddingChar（）} 的长 padded
name	字符串		描述记录的名称（可选）
paddingChar	char		开班加班的 chard.
skipFooter	布尔值	false	配置数据格式，以跳过页脚记录的/清除/清除数据。在主记录（例如，而不是标题或页脚）上配置此参数。
skipHeader	布尔值	false	配置数据格式，以跳过标头记录的 marshalling / unmarshalling。在主记录（例如，而不是标题或页脚）上配置此参数。

记录不可是标题/页脚和主固定长度记录。

问题单 1：简单固定长度记录

这个简单示例演示了如何设计模型来解析/格式固定的信息

10A9PaulineMISINXD12345678BUYShare2500.45USD01-08-2009

fixed-simple

@FixedLengthRecord(length=54, paddingChar=' ')
public static class Order {

    @DataField(pos = 1, length=2)
    private int orderNr;

    @DataField(pos = 3, length=2)
    private String clientNr;

    @DataField(pos = 5, length=7)
    private String firstName;

    @DataField(pos = 12, length=1, align="L")
    private String lastName;

    @DataField(pos = 13, length=4)
    private String instrumentCode;

    @DataField(pos = 17, length=10)
    private String instrumentNumber;

    @DataField(pos = 27, length=3)
    private String orderType;

    @DataField(pos = 30, length=5)
    private String instrumentType;

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

    @DataField(pos = 42, length=3)
    private String currency;

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

问题单 2：修复长度记录，并提供对齐和 padding

这种更协作的示例显示了如何定义字段的协调以及如何分配 padding 字符，其中 "这里"

10A9 PaulineM ISINXD12345678BUYShare2500.45USD01-08-2009

fixed-padding-align

@FixedLengthRecord(length=60, paddingChar=' ')
public static class Order {

    @DataField(pos = 1, length=2)
    private int orderNr;

    @DataField(pos = 3, length=2)
    private String clientNr;

    @DataField(pos = 5, length=9)
    private String firstName;

    @DataField(pos = 14, length=5, align="L")   // align text to the LEFT zone of the block
    private String lastName;

    @DataField(pos = 19, length=4)
    private String instrumentCode;

    @DataField(pos = 23, length=10)
    private String instrumentNumber;

    @DataField(pos = 33, length=3)
    private String orderType;

    @DataField(pos = 36, length=5)
    private String instrumentType;

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

    @DataField(pos = 48, length=3)
    private String currency;

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

案例 3：字段 padding

有时，为记录定义的默认 padding 无法应用到该字段，因为我们会以"0"（而不是 '0" ）进行分页格式。在这种情况下，您可以在 @DataField 上的属性 paddingChar 模型中使用来设置此值。

10A9 PaulineM ISINXD12345678BUYShare000002500.45USD01-08-2009

fixed-padding-field

@FixedLengthRecord(length = 65, paddingChar = ' ')
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

    @DataField(pos = 3, length = 2)
    private String clientNr;

    @DataField(pos = 5, length = 9)
    private String firstName;

    @DataField(pos = 14, length = 5, align = "L")
    private String lastName;

    @DataField(pos = 19, length = 4)
    private String instrumentCode;

    @DataField(pos = 23, length = 10)
    private String instrumentNumber;

    @DataField(pos = 33, length = 3)
    private String orderType;

    @DataField(pos = 36, length = 5)
    private String instrumentType;

    @DataField(pos = 41, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 53, length = 3)
    private String currency;

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

案例 4：使用分隔符修复长度

修复了长度记录，有时在记录中包含分隔的内容。firstName 和 lastName 字段使用以下示例中的 ^ 字符分隔：

10A9Pauline^M^ISINXD12345678BUYShare000002500.45USD01-08-2009

固定分隔

@FixedLengthRecord
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

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

    @DataField(pos = 3, delimiter = "^")
    private String firstName;

    @DataField(pos = 4, delimiter = "^")
    private String lastName;

    @DataField(pos = 5, length = 4)
    private String instrumentCode;

    @DataField(pos = 6, length = 10)
    private String instrumentNumber;

    @DataField(pos = 7, length = 3)
    private String orderType;

    @DataField(pos = 8, length = 5)
    private String instrumentType;

    @DataField(pos = 9, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 10, length = 3)
    private String currency;

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

固定长度记录中的 pos 值可以选择使用 ordinal、sequential 值而不是精确的栏号来定义。

问题单 5：使用记录定义字段长度的修复长度

有时，固定长度记录可能包含用于定义相同记录中另一个字段的预期长度的字段。在以下示例中，instrumentNumber 字段值的长度由记录中的 instrumentNumberLen 字段的值定义。

10A9Pauline^M^ISIN10XD12345678BUYShare000002500.45USD01-08-2009

固定分隔

@FixedLengthRecord
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

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

    @DataField(pos = 3, delimiter = "^")
    private String firstName;

    @DataField(pos = 4, delimiter = "^")
    private String lastName;

    @DataField(pos = 5, length = 4)
    private String instrumentCode;

    @DataField(pos = 6, length = 2, align = "R", paddingChar = '0')
    private int instrumentNumberLen;

    @DataField(pos = 7, lengthPos=6)
    private String instrumentNumber;

    @DataField(pos = 8, length = 3)
    private String orderType;

    @DataField(pos = 9, length = 5)
    private String instrumentType;

    @DataField(pos = 10, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 11, length = 3)
    private String currency;

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

问题单 6：带有标题和页脚修复长度记录

Bindy 将发现配置为模型一部分的固定长度标题和页脚记录（只要注释的类存在于与主 @FixedLengthRecord 类相同的软件包中，或者在配置的扫描软件包之一内。以下文本演示了两个固定长度记录，这些记录由标题记录和页脚记录进行编码。

101-08-2009
10A9 PaulineM ISINXD12345678BUYShare000002500.45USD01-08-2009
10A9 RichN ISINXD12345678BUYShare000002700.45USD01-08-2009
9000000002

fixed-header-and-footer-main-class

@FixedLengthRecord(header = OrderHeader.class, footer = OrderFooter.class)
public class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

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

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

    @DataField(pos = 4, length = 5, align = "L")
    private String lastName;

    @DataField(pos = 5, length = 4)
    private String instrumentCode;

    @DataField(pos = 6, length = 10)
    private String instrumentNumber;

    @DataField(pos = 7, length = 3)
    private String orderType;

    @DataField(pos = 8, length = 5)
    private String instrumentType;

    @DataField(pos = 9, precision = 2, length = 12, paddingChar = '0')
    private BigDecimal amount;

    @DataField(pos = 10, length = 3)
    private String currency;

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

@FixedLengthRecord
public  class OrderHeader {
    @DataField(pos = 1, length = 1)
    private int recordType = 1;

    @DataField(pos = 2, length = 10, pattern = "dd-MM-yyyy")
    private Date recordDate;
}

@FixedLengthRecord
public class OrderFooter {

    @DataField(pos = 1, length = 1)
    private int recordType = 9;

    @DataField(pos = 2, length = 9, align = "R", paddingChar = '0')
    private int numberOfRecordsInTheFile;
}

案例 7：在解析固定长度记录时跳过内容

通常与提供固定长度记录（包含目标用例所需信息）的系统集成很常见。在这种情况下，跳过声明并解析我们不需要的这些字段。为获得此日期，如果下一个声明字段的 pos 值超过最后一个解析字段的光标位置，则 Bindy 将跳到记录中的下一个映射字段。将绝对组成位置用于感兴趣的字段（而不是或dinal 值）会导致 Bindy 在两个字段之间跳过内容。

同样，除某些字段之外的内容都可能值得关注。在这种情况下，您可以通过在 @FixedLengthRecord 声明上设置 ignoreTrailingChars 属性，告知 Bindy 跳过除最后一个映射字段之外的所有解析。

@FixedLengthRecord(ignoreTrailingChars = true)
public static class Order {

    @DataField(pos = 1, length = 2)
    private int orderNr;

    @DataField(pos = 3, length = 2)
    private String clientNr;

    // any characters that appear beyond the last mapped field will be ignored

}

60.2.4. 4.FixedLengthRecord

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links