Jakarta Faces 10编程式视图中添加HTML头部链接的正确方式

直接使用UIOutput组件创建<link>标签时，核心是要借助Jakarta Faces的资源处理机制正确引用资源目录中的文件，而非使用普通相对路径。以下是两种可靠的实现方案：

方法一：通过EL表达式自动解析资源路径 #

利用#{resource['library:filename']}表达式让Faces框架自动处理资源的上下文路径和版本管理，实现简单高效：

FacesContext facesContext = FacesContext.getCurrentInstance();
UIViewRoot viewRoot = facesContext.getViewRoot();
UIComponent head = viewRoot.getFacet("head");

// 创建<link>标签组件
UIOutput cssLink = new UIOutput();
cssLink.setTagName("link");
cssLink.getAttributes().put("rel", "stylesheet");
cssLink.getAttributes().put("type", "text/css");

// 解析resources/css目录下的style.css文件路径
String resourceUrl = facesContext.getApplication()
    .evaluateExpressionGet(facesContext, "#{resource['css/style.css']}", String.class);
cssLink.getAttributes().put("href", resourceUrl);

// 将组件添加到head节点下
head.getChildren().add(cssLink);

方法二：使用Resource API手动获取资源路径 #

通过ResourceHandler直接获取资源的请求路径，适合需要自定义资源处理逻辑的场景：

FacesContext facesContext = FacesContext.getCurrentInstance();
UIViewRoot viewRoot = facesContext.getViewRoot();
UIComponent head = viewRoot.getFacet("head");

// 获取资源实例（参数1为文件名，参数2为资源所在的库目录）
Resource cssResource = facesContext.getApplication()
    .getResourceHandler().createResource("style.css", "css");

if (cssResource != null) {
    UIOutput cssLink = new UIOutput();
    cssLink.setTagName("link");
    cssLink.getAttributes().put("rel", "stylesheet");
    cssLink.getAttributes().put("type", "text/css");
    cssLink.getAttributes().put("href", cssResource.getRequestPath());
    
    head.getChildren().add(cssLink);
}

关键注意事项 #

• 资源文件必须放在项目的src/main/webapp/resources目录下（Maven标准结构），例如resources/css/style.css，否则无法被Jakarta Faces资源处理器识别。
• 禁止使用硬编码的相对路径，否则会忽略上下文路径和资源版本管理（若启用）。
• 若视图根的head facet不存在，需先创建并添加到视图根：

  if (head == null) {
      head = new UIOutput();
      head.setTagName("head");
      viewRoot.getFacets().put("head", head);
  }
  

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