Java ChoiceFormat 怎样把数字范围映射为提示文本

Java ChoiceFormat 适合把一个数字直接映射成分段提示文本。最重要的规则是：limits 必须升序，数字会落入对应的半开区间；模式里的 # 包含下限， 则表示严格大于该边界。这样可以把散落在业务代码里的多层判断收拢成一份可读的区间配置。

官方参考：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/ChoiceFormat.html

下面用 0、1、2+ 三个计数档位做基线。目标不是比较某个 JVM 的绝对耗时，而是让 5 个边界样例都能按同一套规则得到稳定结果。

先理解 ChoiceFormat 的区间规则

ChoiceFormat 的每个 limit 对应一个格式文本。相邻 limit 形成半开区间：当前 limit 包含，下一 limit 不包含。limits 不升序时，格式结果就不可靠，因此配置应先按从小到大排列。

模式字符串适合直接写出固定提示：

import java.text.ChoiceFormat;

public class ChoicePatternDemo {
    public static void main(String[] args) {
        // # 表示包含下限， " + format.format(sample));
        }
    }
}

这里的 1# 命中数字 1，而 1 只命中大于 1 的数字。若业务数据是整数计数，这种写法自然表达了 0、1、2 及以上；若数据包含小数，必须重新确认 1 到 2 之间的值应该归入哪一档。

用数组构造复用动态提示

当边界来自配置、常量或计算结果时，数组构造比拼接模式字符串更容易维护。limits 和 formats 长度必须相同，并且每个位置一一对应。

import java.text.ChoiceFormat;

public class ChoiceArrayDemo {
    public static void main(String[] args) {
        // 每个下限对应一个固定提示；limits 必须保持升序。
        double[] limits = {0, 1, 2};
        String[] formats = {"没有任务", "1 个任务", "多个任务"};
        ChoiceFormat format = new ChoiceFormat(limits, formats);

        // 计数 2 会进入 [2, 正无穷) 这一档。
        System.out.println(format.format(0));
        System.out.println(format.format(1));
        System.out.println(format.format(2));
    }
}

数组方式的改动点很明确：只改边界数组和文本数组，不动选择逻辑。不要把 formats 少写一项，也不要把未排序的边界直接传入；这两类错误会让结果与读者看到的业务规则不一致。

需要把数字带回提示文本时怎么写

ChoiceFormat 本身返回的是选中的文本。如果提示需要显示原始数字，例如“当前有 1273 条消息”，可以让它作为 MessageFormat 的参数格式。格式文本中的 {0} 会在选中对应档位后继续交给消息模板处理。

import java.text.ChoiceFormat;
import java.text.MessageFormat;

public class ChoiceMessageDemo {
    public static void main(String[] args) {
        // 0 和 1 使用固定文案，2 及以上保留参数中的实际数量。
        double[] limits = {0, 1, 2};
        String[] parts = {"没有消息", "1 条消息", "{0} 条消息"};
        ChoiceFormat choices = new ChoiceFormat(limits, parts);

        // 把第 0 个参数交给 ChoiceFormat，再由 MessageFormat 组合完整句子。
        MessageFormat message = new MessageFormat("收件箱：{0}");
        message.setFormatByArgumentIndex(0, choices);

        // 这些输入构成最小可复查样例集，重点观察 0、1、2 三个边界。
        for (int count : new int[] {0, 1, 2, 1273}) {
            System.out.println(message.format(new Object[] {count}));
        }
    }
}

这里需要注意一个容易忽略的事实：ChoiceFormat 依然按照 double 处理数字，long 的格式化也会走 double 能表示的范围。普通消息计数通常没有实际限制，但极大的精确整数应先评估是否适合直接交给它。

用 5 个边界样例做结果对比

以 0、1、1.5、2、8 五个输入为最小复查集，可以快速发现规则是否符合预期：

这个对比表是功能覆盖指标，不是线上性能承诺。真正接入业务时，至少补上负数、空值转换失败和最大值等输入边界，并把 limits 与 formats 当作同一个配置单元维护。

另外，ChoiceFormat 实例不是线程安全的。并发请求不要共享一个可变实例；更稳妥的方式是为每个线程或请求创建独立对象，或者在外层做好同步。

常见问题

为什么 limits 一定要升序？

因为 ChoiceFormat 按相邻边界确定区间。顺序被打乱后，数字与格式的对应关系就不再能按配置直读，结果可能错误。

# 和 应该怎么选？

要包含当前下限就用 #；要表达严格大于当前值就用 。整数计数常用 0、1、2 这样的数组边界，小数区间则应逐个确认临界值。

什么时候直接用 if/else 更合适？

如果每一档除了文本还要执行不同业务动作，if/else 更容易表达副作用。ChoiceFormat 更适合把数字到文本的映射单独抽出来。

总结一下：先把边界升序排列，再决定下限是否包含；固定文案用模式或数组，带回原始数字时组合 MessageFormat；最后用边界样例检查区间，并注意实例的线程安全范围。