PrimeFaces 13.0.2：如何捕获p:growl展示的所有消息？

问题根源 #

你遇到的问题核心在于：Bean验证、数据库约束这类消息，会在Growl组件渲染后被标记为已处理消息，默认会从FacesContext中清除；而你通过FacesContext.getMessage()或Growl Binding获取的是未被处理的消息，所以只能拿到未被Growl渲染过的消息（比如登录欢迎消息）。

解决方案：全局消息监听+历史存储 #

推荐通过监听消息添加事件，在消息被处理前就完成捕获和存储，确保所有类型的消息都能被记录。

1. 实现消息监听Bean #

创建一个视图作用域的Bean，监听所有PostAddMessageEvent事件（即消息被添加到FacesContext的瞬间），并将消息复制到历史列表中：

import javax.faces.application.FacesMessage;
import javax.faces.context.FacesContext;
import javax.faces.event.PostAddMessageEvent;
import javax.faces.event.SystemEvent;
import javax.faces.event.SystemEventListener;
import javax.faces.view.ViewScoped;
import javax.inject.Named;
import javax.annotation.PostConstruct;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.List;

@Named
@ViewScoped
public class MessageHistoryBean implements Serializable, SystemEventListener {

    private List<FacesMessage> messageHistory;

    @PostConstruct
    public void init() {
        messageHistory = new ArrayList<>();
        // 注册消息添加事件监听器
        FacesContext.getCurrentInstance().getApplication().subscribeToEvent(PostAddMessageEvent.class, this);
    }

    @Override
    public boolean isListenerForSource(Object source) {
        // 监听所有来源的消息添加事件
        return true;
    }

    @Override
    public void processEvent(SystemEvent event) {
        if (event instanceof PostAddMessageEvent) {
            PostAddMessageEvent addEvent = (PostAddMessageEvent) event;
            FacesMessage originalMsg = addEvent.getFacesMessage();
            // 复制消息（避免原消息被清除后历史列表失效）
            FacesMessage clonedMsg = new FacesMessage(
                    originalMsg.getSeverity(),
                    originalMsg.getSummary(),
                    originalMsg.getDetail()
            );
            messageHistory.add(clonedMsg);
        }
    }

    // Getter方法供页面调用
    public List<FacesMessage> getMessageHistory() {
        return messageHistory;
    }
}

2. 页面展示消息历史 #

在页面中添加消息历史展示区域，用PrimeFaces组件渲染存储的历史消息：

<!-- 消息历史面板 -->
<h:panelGroup id="messageHistoryPanel" style="margin-top:20px;">
    <h3>消息历史</h3>
    <p:dataList value="#{messageHistoryBean.messageHistory}" var="msg" emptyMessage="暂无历史消息">
        <p:panel styleClass="#{msg.severity == 'ERROR' ? 'msg-error' : (msg.severity == 'WARN' ? 'msg-warn' : 'msg-info')}">
            <h:outputText value="#{msg.severity}" style="font-weight:bold; margin-right:10px;"/>
            <h:outputText value="#{msg.summary}"/>
            <h:outputText value=" - #{msg.detail}" rendered="#{not empty msg.detail}"/>
        </p:panel>
    </p:dataList>
</h:panelGroup>

<!-- 样式区分消息级别 -->
<h:outputStylesheet>
    .msg-error { border-left: 4px solid #dc3545; }
    .msg-warn { border-left: 4px solid #ffc107; }
    .msg-info { border-left: 4px solid #17a2b8; }
</h:outputStylesheet>

3. 配合AJAX更新 #

如果页面使用AJAX请求，需要在每个AJAX组件的update属性中加入messageHistoryPanel，确保消息历史实时更新：

<!-- 示例：CRUD保存按钮的AJAX配置 -->
<p:commandButton value="保存" action="#{crudBean.save}" update="growl messageHistoryPanel"/>

备选方案：保留Growl消息 #

如果不想用监听器，也可以通过设置Growl的keepMessages="true"，让消息不被自动清除，之后从FacesContext中批量获取：

<!-- 修改原Growl组件 -->
<p:growl keepMessages="true" />

在Bean中获取所有消息：

public List<FacesMessage> getMessageHistory() {
    List<FacesMessage> allMessages = new ArrayList<>();
    FacesContext context = FacesContext.getCurrentInstance();
    
    // 获取所有组件关联的消息
    for (String clientId : context.getMessages().keySet()) {
        allMessages.addAll(context.getMessages(clientId));
    }
    // 获取全局消息
    allMessages.addAll(context.getMessages(null));
    
    return allMessages;
}

注意：此方法会导致消息一直留在FacesContext中，需要手动调用context.getMessages().clear()来清除历史，否则页面刷新后消息会重复显示。

内容的提问来源于stack exchange，提问作者ula.uvula