如何为项目所有h:outputText全局应用<f:convertNumber>转换器？

当然有办法！不用挨个给每个h:outputText手动加<f:convertNumber>标签，JSF提供了几种全局配置方案，能一次性给所有数值类型的输出统一应用type="number"的格式化效果，下面给你详细拆解：

方法1：通过faces-config.xml全局绑定转换器到数值类型 #

这是最直接的方式，把java.lang.Number（及其子类比如Integer、Double）和JSF自带的NumberConverter绑定，并预设type="number"的配置。这样所有输出数值类型的h:outputText都会自动应用这个转换器。

在你的faces-config.xml里添加这段配置：

<faces-config xmlns="http://xmlns.jcp.org/xml/ns/javaee"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd"
              version="2.2">

    <converter>
        <!-- 指定要绑定的Java类型 -->
        <converter-for-class>java.lang.Number</converter-for-class>
        <!-- 使用JSF自带的数值转换器 -->
        <converter-class>javax.faces.convert.NumberConverter</converter-class>
        <!-- 设置转换器的type属性为number -->
        <property>
            <property-name>type</property-name>
            <property-value>number</property-value>
        </property>
        <!-- 可选：还可以添加其他格式化属性，比如小数点位数、千分位分隔符 -->
        <!-- <property>
            <property-name>pattern</property-name>
            <property-value>#,##0.00</property-value>
        </property> -->
    </converter>

</faces-config>

方法2：用@FacesConverter注解自定义全局转换器（JSF 2.2+） #

如果你的项目用的是JSF 2.2及以上版本，可以写一个自定义转换器类，继承自带的NumberConverter，在构造方法里预设type="number"，然后通过@FacesConverter注解绑定到Number类型：

import javax.faces.convert.NumberConverter;
import javax.faces.convert.FacesConverter;

@FacesConverter(forClass = Number.class)
public class GlobalNumberConverter extends NumberConverter {
    public GlobalNumberConverter() {
        // 预设转换器类型为number
        setType("number");
        // 可选：添加其他默认配置，比如固定小数点格式
        // setPattern("#,##0.##");
    }
}

这个类会自动被JSF识别，所有输出Number类型值的h:outputText都会自动使用这个转换器。

方法3：针对h:outputText组件设置全局默认转换器（慎用） #

如果你想强制所有h:outputText（不管绑定的是什么类型）都用数值转换器，可以在faces-config.xml里给组件设置默认转换器属性，但这种方式局限性大（比如非数值类型会报错），只适合所有h:outputText都是数值的场景：

<faces-config>
    <component>
        <!-- 定位到h:outputText的组件类型 -->
        <component-type>javax.faces.OutputText</component-type>
        <attribute>
            <attribute-name>converter</attribute-name>
            <!-- 设置默认转换器为数值转换器 -->
            <default-value>javax.faces.convert.NumberConverter</default-value>
        </attribute>
    </component>
</faces-config>

⚠️ 注意：这种方式没法直接设置转换器的type属性，所以还是推荐前两种针对类型绑定的方案，更精准也更安全。

额外提示 #

• 局部覆盖：如果某个特定的h:outputText需要特殊的格式化（比如显示为货币），你仍然可以手动添加<f:convertNumber>标签，手动设置的转换器优先级会高于全局配置。
• 兼容性：以上方案在Mojarra和MyFaces主流JSF实现中都能正常工作，属于JSF规范标准功能。

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