Jakarta Faces 4+自定义组件@FacesComponent渲染异常求助

• 核对页面命名空间声明
  确保index.xhtml中<t:dataList>的命名空间与自定义标签库的URI完全匹配。例如自定义标签库URI为http://your-domain.com/jsf/components，则页面需添加：

  xmlns:t="http://your-domain.com/jsf/components"
  

• 检查faces-config.xml组件注册
  必须在faces-config.xml中正确关联组件类、渲染器类及组件族，示例配置：

  <faces-config version="4.0" xmlns="https://jakarta.ee/xml/ns/jakartaee">
    <component>
      <component-type>com.yourpackage.DataList</component-type>
      <component-class>com.yourpackage.DataList</component-class>
      <component-family>com.yourpackage.DataListFamily</component-family>
    </component>
    <renderer>
      <component-family>com.yourpackage.DataListFamily</component-family>
      <renderer-type>com.yourpackage.DataListRenderer</renderer-type>
      <renderer-class>com.yourpackage.DataListRenderer</renderer-class>
    </renderer>
  </faces-config>
  

  注意component-family需在组件和渲染器配置中保持一致，这是JSF匹配组件与渲染器的核心标识。

• 验证自定义标签库描述文件（taglib.xml）
  若使用自定义标签库，需将taglib.xml放置在WEB-INF或META-INF目录下，确保标签与组件类型正确绑定：

  <facelet-taglib version="4.0" xmlns="https://jakarta.ee/xml/ns/jakartaee">
    <namespace>http://your-domain.com/jsf/components</namespace>
    <tag>
      <tag-name>dataList</tag-name>
      <component>
        <component-type>com.yourpackage.DataList</component-type>
      </component>
    </tag>
  </facelet-taglib>
  

• 确认组件类继承与方法实现
  自定义组件类需继承UIComponentBase（或合适的子类），并正确实现getFamily()方法返回配置中定义的组件族：

  public class DataList extends UIComponentBase {
    @Override
    public String getFamily() {
      return "com.yourpackage.DataListFamily";
    }
  
    // 添加value等属性的getter/setter，例如：
    public List<?> getValue() {
      return (List<?>) getStateHelper().eval("value");
    }
  
    public void setValue(List<?> value) {
      getStateHelper().put("value", value);
    }
  }
  

• 检查渲染器类的核心方法
  渲染器类需继承Renderer，并重写encodeEnd()（或encodeBegin()）方法实现渲染逻辑，确保输出正确的HTML结构：

  public class DataListRenderer extends Renderer {
    @Override
    public void encodeEnd(FacesContext context, UIComponent component) throws IOException {
      DataList dataList = (DataList) component;
      List<?> items = dataList.getValue();
      ResponseWriter writer = context.getResponseWriter();
  
      writer.startElement("ul", component);
      if (items != null) {
        for (Object item : items) {
          writer.startElement("li", null);
          writer.writeText(item.toString(), null);
          writer.endElement("li");
        }
      }
      writer.endElement("ul");
    }
  }
  

• 验证Maven依赖配置
  pom.xml中需引入正确的Jakarta Faces API依赖，且范围设为provided（避免与GlassFish自带的Mojarra冲突）：

  <dependency>
    <groupId>jakarta.faces</groupId>
    <artifactId>jakarta.faces-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
  </dependency>
  

• 核对web.xml的Faces Servlet配置
  确保web.xml中Faces Servlet的映射覆盖所有JSF页面，示例：

  <web-app version="5.0" xmlns="https://jakarta.ee/xml/ns/jakartaee">
    <servlet>
      <servlet-name>Faces Servlet</servlet-name>
      <servlet-class>jakarta.faces.webapp.FacesServlet</servlet-class>
      <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
      <servlet-name>Faces Servlet</servlet-name>
      <url-pattern>*.xhtml</url-pattern>
    </servlet-mapping>
  </web-app>
  

  访问页面时需确保走Faces Servlet（例如http://localhost:8080/your-app/index.xhtml），而非直接访问静态资源。

• 查看GlassFish服务器日志
  检查GlassFish域目录下的logs/server.log，里面会记录组件注册失败、类加载异常、配置错误等关键信息，这些往往是问题的根源。

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