JSF模板数据传递问题：如何动态修改页面标题、菜单等内容

你的理解是正确的：JSF模板作为通用布局容器，定义header、content、footer等固定结构，由具体页面（客户端）填充内容。针对动态修改页面标题、菜单、面包屑这类需求，以下是几种实用的实现方式：

1. 使用<ui:param>传递简单参数 #

适合页面标题、单个文本这类简单数据，直接在客户端页面向模板传递参数，模板中接收使用。

模板示例（template.xhtml） #

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:ui="http://xmlns.jcp.org/jsf/facelets">
<head>
    <title>#{pageTitle != null ? pageTitle : '默认标题'}</title>
</head>
<body>
    <!-- 面包屑区域 -->
    <div class="breadcrumb">
        #{breadcrumbText}
    </div>
    <!-- 内容占位 -->
    <ui:insert name="content"/>
    <!-- 页脚 -->
    <footer>默认页脚</footer>
</body>
</html>

客户端页面示例（home.xhtml） #

<ui:composition template="/template.xhtml"
                xmlns:ui="http://xmlns.jcp.org/jsf/facelets">
    <!-- 向模板传递参数 -->
    <ui:param name="pageTitle" value="首页"/>
    <ui:param name="breadcrumbText" value="首页 > 欢迎"/>

    <ui:define name="content">
        <!-- 页面具体内容 -->
        <h1>欢迎访问首页</h1>
    </ui:define>
</ui:composition>

2. 使用视图作用域Bean共享复杂数据 #

针对菜单、面包屑这类需要动态生成（比如从数据库获取、根据用户权限调整）的复杂数据，推荐使用视图作用域的Managed Bean来共享数据。

视图Bean示例 #

import jakarta.faces.view.ViewScoped;
import jakarta.inject.Named;
import java.io.Serializable;
import java.util.List;

@Named
@ViewScoped
public class LayoutBean implements Serializable {
    private String pageTitle;
    private List<BreadcrumbItem> breadcrumbItems;

    // 初始化方法，可在客户端页面加载时调用，或者通过@PostConstruct初始化
    public void init(String title, List<BreadcrumbItem> items) {
        this.pageTitle = title;
        this.breadcrumbItems = items;
    }

    // getter/setter
    public String getPageTitle() { return pageTitle; }
    public List<BreadcrumbItem> getBreadcrumbItems() { return breadcrumbItems; }

    // 面包屑项实体类
    public static class BreadcrumbItem {
        private String text;
        private String url;

        public BreadcrumbItem(String text, String url) {
            this.text = text;
            this.url = url;
        }

        // getter
        public String getText() { return text; }
        public String getUrl() { return url; }
    }
}

模板中使用Bean数据 #

<!-- 模板中的面包屑区域 -->
<div class="breadcrumb">
    <ui:repeat value="#{layoutBean.breadcrumbItems}" var="item">
        <a href="#{item.url}">#{item.text}</a>
        <ui:if test="#{not empty item.next}"> > </ui:if>
    </ui:repeat>
</div>

客户端页面初始化Bean数据 #

<ui:composition template="/template.xhtml"
                xmlns:ui="http://xmlns.jcp.org/jsf/facelets"
                xmlns:f="http://xmlns.jcp.org/jsf/core">
    <!-- 页面加载时初始化布局Bean -->
    <f:event type="preRenderView" listener="#{layoutBean.init('用户列表', [
        new layoutBean.BreadcrumbItem('首页', '/home.xhtml'),
        new layoutBean.BreadcrumbItem('用户管理', '/users.xhtml')
    ])}"/>

    <ui:define name="content">
        <!-- 用户列表内容 -->
    </ui:define>
</ui:composition>

3. 针对你提到的两种实现方式的适配 #

• 方式一（分离XHTML引入）：使用<ui:include>时，同样可以通过<ui:param>传递参数。例如引入header.xhtml时：

  <ui:include src="/header.xhtml">
      <ui:param name="pageTitle" value="动态标题"/>
  </ui:include>
  

  在header.xhtml中直接使用#{pageTitle}即可接收参数。

• 方式二（模板布局）：结合上述<ui:param>或视图Bean的方式，客户端页面在<ui:composition>标签内传递参数，模板中通过EL表达式获取即可，无需特殊的生命周期处理——只要参数在视图渲染前被赋值，模板就能正确读取。

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