PrimeFaces 10升级11后TreeNode变为原始类型问题咨询

问题现象 #

从PrimeFaces 10.0.0版本升级到11.0.0版本后，原有TreeNode相关代码出现编译警告与阻断错误，查阅官方11.0.0版本迁移指南未找到对应变更说明，具体表现如下：

• 按原有方式定义TreeNode子节点列表：

List node = otherNode.getChildren();

代码编写完成后收到两条编译警告：

1. 赋值语句左侧警告：TreeNode is a raw type. References to generic type TreeNode should be parameterized
2. 赋值语句右侧警告：Type safety: The expression of type List needs unchecked conversion to conform to List

• 使用for循环遍历列表时出现编译阻断，遍历代码如下：

for(TreeNode loopingNode : node.getChildren())
{
...
}

触发明确编译错误：Type mismatch: cannot convert from element type Object to TreeNode

• 上述问题仅在升级到11.0.0版本后出现，10.0.0版本下无相关报错。

产生原因 #

该问题是PrimeFaces 11.0.0的未公示破坏性变更导致：
10.0.0及更早版本中TreeNode为非泛型接口，getChildren()方法直接返回List<TreeNode>类型，不需要额外参数化声明。
11.0.0版本中TreeNode被改造为泛型接口TreeNode<T>，泛型参数T对应该节点挂载的业务数据类型，getChildren()方法的返回值同步调整为List<TreeNode<T>>。未指定泛型参数时，TreeNode会被识别为原始类型，返回的List元素类型默认是Object，最终导致类型转换报错。

修复方案 #

根据业务场景选择对应声明方式即可解决问题：

• 如果不需要为TreeNode绑定特定业务实体类型，统一使用通配符泛型声明即可：

// 声明子节点列表，无编译警告
List<TreeNode<?>> node = otherNode.getChildren();

// 遍历代码可正常运行
for(TreeNode<?> loopingNode : node.getChildren()) {
    // 业务逻辑
}

• 如果节点已经绑定了具体业务对象（比如菜单、用户、组织机构类），直接将泛型参数替换为对应业务类型即可，还可以省去后续获取节点数据时的强制类型转换步骤，例如绑定Menu实体的节点声明为TreeNode<Menu>。

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