如何在JSF复合组件属性中指定泛型类型？

1. 声明为原始List类型，在组件内部做类型校验 #

由于XML规范不允许属性值包含<字符，你可以先把rooms属性的类型声明为java.util.List，再在复合组件的实现逻辑里对列表元素的类型做校验，确保只有PatientRoom类型的元素被处理：

复合组件代码示例 #

<cc:interface>
    <cc:attribute name="patient" type="com.divudi.entity.Patient" />
    <cc:attribute name="rooms" type="java.util.List" required="true" />
</cc:interface>

<cc:implementation>
    <!-- 渲染时检查元素类型，不符合则提示错误 -->
    <ui:repeat value="#{cc.attrs.rooms}" var="room">
        <c:if test="#{not room instanceof com.divudi.entity.inward.PatientRoom}">
            <h:outputText value="错误：rooms列表包含非PatientRoom类型元素" style="color:red;" />
        </c:if>
        <!-- 正常渲染Room数据的逻辑 -->
    </ui:repeat>
</cc:implementation>

后端Bean校验示例 #

如果有对应的后端Bean处理该属性，也可以在setter方法里做强制校验：

public void setRooms(List<?> rooms) {
    for (Object item : rooms) {
        if (!(item instanceof PatientRoom)) {
            throw new IllegalArgumentException("rooms列表只能包含PatientRoom类型元素");
        }
    }
    this.rooms = (List<PatientRoom>) rooms;
}

2. 创建自定义包装类封装泛型List #

定义一个专门的类来持有List<PatientRoom>，这样就能在cc:attribute里直接指定这个包装类的类型，完全避开泛型符号的问题：

包装类代码 #

public class PatientRoomList {
    private List<PatientRoom> rooms;

    // 构造方法、getter、setter
    public PatientRoomList(List<PatientRoom> rooms) {
        this.rooms = rooms;
    }

    public List<PatientRoom> getRooms() {
        return rooms;
    }

    public void setRooms(List<PatientRoom> rooms) {
        this.rooms = rooms;
    }
}

复合组件引用包装类 #

<cc:interface>
    <cc:attribute name="patient" type="com.divudi.entity.Patient" />
    <cc:attribute name="rooms" type="com.divudi.entity.inward.PatientRoomList" required="true" />
</cc:interface>

使用组件时传入包装实例 #

// 后端Bean中提供包装后的列表
private List<PatientRoom> patientRooms;

public PatientRoomList getPatientRoomList() {
    return new PatientRoomList(patientRooms);
}

<!-- 调用复合组件 -->
<ez:admission_details patient="#{bean.patient}" rooms="#{bean.patientRoomList}" />

3. 进阶：结合Bean验证或CDI限定符（适合大型项目） #

如果对类型安全要求极高，可以自定义Bean验证注解，或者用CDI限定符来约束传入的列表类型。这种方式实现成本较高，适合复杂系统的严格校验场景。

JSF复合组件的XML描述符遵循XML规范，<是XML特殊字符，无法直接在属性值中使用，这是泛型类型声明报错的根本原因。上述方案中：

• 第一种是轻量化实现，适合大多数普通场景；
• 第二种通过包装类实现了强类型约束，代码可读性更强；
• 第三种适合对类型校验要求极高的复杂项目。

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