如何创建可处理同类型记录不同长度的BeanIO配置？

问题根源 #

当前配置默认使用固定长度流（fixedlength），BeanIO会强制校验每条记录的总长度等于所有字段length之和，且每个字段的实际长度必须匹配定义的length值。当记录长度不固定或字段仅部分填充时，就会触发长度校验错误。

具体解决步骤 #

1. 将流改为可变长度类型

在<stream>标签中添加type="variable"，允许记录长度不固定，BeanIO会按字段定义依次读取内容直到记录结束：

<stream name="YourStream" type="variable">

2. 调整字段配置

根据需求选择以下两种配置方式之一：

方式一：保留length并关闭长度校验

适合需要限制字段最大读取长度，但允许内容不足的场景：

<record name="Record" minOccurs="0" maxOccurs="unbounded" class="com.common.vo.Record">
    <field name="record_type" length="3" default="REC" literal="REC" rid="true" validateLength="true"/>
    <field name="idNumber" length="19" trim="true" validateLength="false"/>
    <field name="centerCode" length="20" trim="true" validateLength="false" required="false"/>
</record>

• validateLength="false"：关闭字段长度强制校验，不再要求内容长度等于length值
• trim="true"：自动去除字段内容前后空白，处理部分填充后的空格
• required="false"：允许字段不存在（按需设置）

方式二：使用minLength和maxLength替代length

适合需要明确字段长度范围的场景，需确保流类型为variable（固定长度流要求字段必须有length）：

<record name="Record" minOccurs="0" maxOccurs="unbounded" class="com.common.vo.Record">
    <field name="record_type" length="3" default="REC" literal="REC" rid="true"/>
    <field name="idNumber" minLength="0" maxLength="19" trim="true"/>
    <field name="centerCode" minLength="0" maxLength="20" required="false"/>
</record>

• minLength="0"：允许字段内容为空或长度为0
• maxLength：限制字段内容的最大长度

关键说明 #

• 必须先将流改为variable类型，才能打破固定长度的强制校验规则
• 两种方式都无需创建多个流，可在同一个流配置中兼容可变长度记录与部分填充字段

内容的提问来源于stack exchange，提问作者Cris Manrique