Vaadin 23.3.0 IntegerField校验Bug及解决方案咨询

问题根源 #

当输入超过Integer.MAX_VALUE的数字时，IntegerField的解析逻辑会返回null，而你的校验规则允许null值（对应可选字段），所以校验直接通过，导致后台BusinessObject的字段被设为null。同时，前端会保留用户输入的无效原始文本，再次调用Binder.readBean()时，因为Bean中的字段是null，IntegerField不会覆盖已显示的无效内容，进而出现readBean()失效的现象。

解决方案 #

1. 增强服务器端校验，区分空输入与无效输入 #

修改校验逻辑，判断用户是否输入了内容但解析失败（即原始输入非空但解析后为null），这种情况直接校验不通过：

binder.forField(number)
    .withValidator(num -> {
        String rawInput = number.getRawValue().trim();
        // 输入非空但解析失败，校验不通过
        if (!rawInput.isEmpty() && num == null) {
            return false;
        }
        // 空输入或数字在1-999区间内
        return num == null || (num >= 1 && num <= 999);
    }, getTranslation("number_must_be_valid_integer_between_1_and_999"))
    .bind(BusinessObject::getNumber, BusinessObject::setNumber);

2. 客户端限制输入（辅助手段） #

为从源头减少无效输入，可以设置IntegerField的输入规则，限制最多3位数字并限定范围：

// 只允许输入0-9的数字，最多3位
number.setAllowedCharPattern("[0-9]{0,3}");
// 客户端层面限制范围（可被绕过，需配合服务器端校验）
number.setMin(1);
number.setMax(999);

3. 修复readBean()失效问题 #

重新加载Bean数据时，先手动清空IntegerField的原始输入，再调用readBean()：

number.clear();
binder.readBean(businessObject);

关于IntegerField不限制输入位数的原因 #

IntegerField的默认设计仅负责将输入文本解析为Integer类型，不主动限制输入位数。当输入的数字超出Integer取值范围时，组件会返回null而非抛出错误，这是为了兼容可选字段场景，但也导致了你遇到的问题。若需要限制位数，必须通过setAllowedCharPattern手动配置。

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