Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

48.7. 4.FixedLengthRecord

FixedLengthRecord 注解用于识别模型的根类。它代表一个记录，"文件/消息的行"包含数据固定长度格式"，并可链接到多个子模型类。这个格式特别之处，因为字段的数据可以与右或左侧一致。

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

Expand
注解名称记录类型级别

FixedLengthRecord

FIXED

类

Expand
参数名称type必需默认值info

countGrapheme

布尔值

 

false

表示如何计算慈善对象。

crlf

字符串

 

WINDOWS

用于在每个记录后添加回车的字符（可选）。可能的值有：WINDOWS、UNIX、MAC 或自定义.这个选项只在 marshalling 期间使用，而 unmarshalling 使用系统默认的 JDK 提供行分隔符，除非 eol 已自定义。

EOL

字符串

  

字符用于在未编出时（可选 - default = "" ）在每条记录后结束行结束，这将帮助 JDK 提供默认的 JDK 提供行分隔符，除非提供任何其他行分隔符）。这个选项只适用于 unmarshalling，其中 marshalling 使用系统默认的分隔符作为"WINDOWS"，除非提供任何其他值。

footer

类

 

void

表示此类型的记录可能后跟文件末尾的单个页脚记录。

header

   

表示此类型的记录前面可以位于文件的开头处的一个标题记录。

ignoreMissingChars

   

指明是否会忽略太短行

ignoreTrailingChars

   

表示在卸载 / 解析时可以忽略除最后映射文件以外的字符。此注解与模型的根类关联，并且必须声明一次。

length

int

 

0

记录的固定长度（字符数）。这意味着记录将始终是长期使用 {#paddingChar （）} 的 padded。

name

字符串

  

描述记录的名称（可选）。

paddingChar

char

  

款项加权。

skipFooter

布尔值

 

false

配置数据格式，以跳过页脚记录的 marshalling / unmarshalling / unmarshalling，在主记录（例如，而不是标头或 footer）上配置这个参数。

skipHeader

布尔值

 

false

配置数据格式，以跳过标头记录的 marshalling / unmarshalling。在主记录（例如，而不是标头或页脚）中配置此参数。

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

案例 1：简单固定长度记录

此简单示例演示了如何设计用于解析/重新格式化固定消息的模型。 

10A9PaulineMISINXD12345678BUYShare2500.45USD01-08-2009
Copy to Clipboard Toggle word wrap

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;
}
Copy to Clipboard Toggle word wrap

问题单 2：使用对齐和 padding 修复的长度记录

这个更细致的示例演示了如何为字段定义对齐以及如何分配 padding 字符，本例中为 " ： 

10A9 PaulineM ISINXD12345678BUYShare2500.45USD01-08-2009
Copy to Clipboard Toggle word wrap

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;
}
Copy to Clipboard Toggle word wrap

案例 3：字段 padding

有时，为记录定义的 default padding 不能应用于字段，因为我们想使用 '0' 而不是 '' 进行分页格式。在这种情形中，模型中，您可以使用 @DataField 上的属性 paddingChar 设置此值。 

10A9 PaulineM ISINXD12345678BUYShare000002500.45USD01-08-2009
Copy to Clipboard Toggle word wrap

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;
}
Copy to Clipboard Toggle word wrap

问题单 4：使用分隔符修复长度记录

固定长度记录有时会在记录中有分隔的内容。在以下示例中，firstName 和 lastName 字段使用以下示例中的 ^ 字符分隔： 

10A9Pauline^M^ISINXD12345678BUYShare000002500.45USD01-08-2009
Copy to Clipboard Toggle word wrap

固定分隔 

@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;
}
Copy to Clipboard Toggle word wrap

固定长度记录中的 pos 值可以选择使用 或dinal 或 sequential 值来定义，而不使用精确列号。

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

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

10A9Pauline^M^ISIN10XD12345678BUYShare000002500.45USD01-08-2009
Copy to Clipboard Toggle word wrap

固定分隔 

@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;
}
Copy to Clipboard Toggle word wrap

问题单 6：使用标头和页脚修复长度记录

Bindy 将发现配置为所注释类的一部分提供的固定长度标题和 footer 记录，它们存在于与主 @FixedLengthRecord 类或其中一个配置的扫描软件包中。以下文本说明了一个标头记录和页脚记录的两个固定长度记录。 

101-08-2009
10A9 PaulineM ISINXD12345678BUYShare000002500.45USD01-08-2009
10A9 RichN ISINXD12345678BUYShare000002700.45USD01-08-2009
9000000002
Copy to Clipboard Toggle word wrap

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;
}
Copy to Clipboard Toggle word wrap

case 7 ：解析固定长度记录时跳过内容。

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

同样，除 some 字段外的内容都可能不是相关的内容。在这种情况下，您可以通过在 @FixedLengthRecord 声明上设置 ignoreTrailingChars 属性来跳过除最后映射字段以外的任何内容的解析。 

@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

}
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat