FlowFacesContext.java

/*
 * Copyright 2004-2023 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.springframework.faces.webflow;

import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.Set;

import jakarta.el.ELContext;
import jakarta.faces.application.FacesMessage;
import jakarta.faces.context.ExternalContext;
import jakarta.faces.context.FacesContext;
import jakarta.faces.context.FacesContextWrapper;
import jakarta.faces.context.PartialViewContext;
import jakarta.faces.context.PartialViewContextFactory;
import jakarta.faces.lifecycle.Lifecycle;

import org.springframework.binding.message.Message;
import org.springframework.binding.message.MessageResolver;
import org.springframework.binding.message.Severity;
import org.springframework.context.MessageSource;
import org.springframework.core.style.ToStringCreator;
import org.springframework.util.ObjectUtils;
import org.springframework.util.StringUtils;
import org.springframework.webflow.execution.RequestContext;

/**
 * Custom {@link FacesContext} implementation that delegates all standard FacesContext messaging functionality to a
 * Spring {@link MessageSource} made accessible as part of the current Web Flow request. Additionally, it manages the
 * {@code renderResponse} flag in flash scope so that the execution of the JSF {@link Lifecycle} may span multiple
 * requests in the case of the POST+REDIRECT+GET pattern being enabled.
 * 
 * @see FlowExternalContext
 * 
 * @author Jeremy Grelle
 * @author Phillip Webb
 * @author Rossen Stoyanchev
 */
public class FlowFacesContext extends FacesContextWrapper {

	/**
	 * The key for storing the renderResponse flag
	 */
	static final String RENDER_RESPONSE_KEY = "flowRenderResponse";

	private static final Map<Severity, FacesMessage.Severity> SPRING_SEVERITY_TO_FACES;
	static {
		SPRING_SEVERITY_TO_FACES = new HashMap<>();
		SPRING_SEVERITY_TO_FACES.put(Severity.INFO, FacesMessage.SEVERITY_INFO);
		SPRING_SEVERITY_TO_FACES.put(Severity.WARNING, FacesMessage.SEVERITY_WARN);
		SPRING_SEVERITY_TO_FACES.put(Severity.ERROR, FacesMessage.SEVERITY_ERROR);
		SPRING_SEVERITY_TO_FACES.put(Severity.FATAL, FacesMessage.SEVERITY_FATAL);
	}

	private static final Map<FacesMessage.Severity, Severity> FACES_SEVERITY_TO_SPRING;
	static {
		FACES_SEVERITY_TO_SPRING = new HashMap<>();
		for (Map.Entry<Severity, FacesMessage.Severity> entry : SPRING_SEVERITY_TO_FACES.entrySet()) {
			FACES_SEVERITY_TO_SPRING.put(entry.getValue(), entry.getKey());
		}
	}

	private final FacesContext wrapped;

	private final RequestContext context;

	private final ExternalContext externalContext;

	private final PartialViewContext partialViewContext;

	private boolean viewRootHolderFromFlashScope;


	public FlowFacesContext(RequestContext context, FacesContext wrapped) {
		this.context = context;
		this.wrapped = wrapped;
		this.externalContext = new FlowExternalContext(context, wrapped.getExternalContext());
		PartialViewContextFactory factory = JsfUtils.findFactory(PartialViewContextFactory.class);
		PartialViewContext partialViewContextDelegate = factory.getPartialViewContext(this);
		this.partialViewContext = new FlowPartialViewContext(partialViewContextDelegate);
		setCurrentInstance(this);
	}

	public FacesContext getWrapped() {
		return this.wrapped;
	}

	public void release() {
		super.release();
		setCurrentInstance(null);
	}

	public ExternalContext getExternalContext() {
		return this.externalContext;
	}

	public PartialViewContext getPartialViewContext() {
		return this.partialViewContext;
	}

	public ELContext getELContext() {
		ELContext elContext = super.getELContext();
		// Ensure that our wrapper is used over the stock FacesContextImpl
		elContext.putContext(FacesContext.class, this);
		return elContext;
	}

	public boolean getRenderResponse() {
		Boolean renderResponse = this.context.getFlashScope().getBoolean(RENDER_RESPONSE_KEY);
		return (renderResponse != null && renderResponse);
	}

	public boolean getResponseComplete() {
		return this.context.getExternalContext().isResponseComplete();
	}

	public void renderResponse() {
		// stored in flash scope to survive a redirect when transitioning from one view to another
		this.context.getFlashScope().put(RENDER_RESPONSE_KEY, true);
	}

	public void responseComplete() {
		this.context.getExternalContext().recordResponseComplete();
	}

	public boolean isValidationFailed() {
		if (this.context.getMessageContext().hasErrorMessages()) {
			return true;
		} else {
			return super.isValidationFailed();
		}
	}

	/**
	 * Translates a FacesMessage to a Spring Web Flow message and adds it to the current MessageContext
	 */
	public void addMessage(String clientId, FacesMessage message) {
		FacesMessageSource source = new FacesMessageSource(clientId);
		FlowFacesMessage flowFacesMessage = new FlowFacesMessage(source, message);
		this.context.getMessageContext().addMessage(flowFacesMessage);
	}

	/**
	 * Returns an Iterator for all component clientId's for which messages have been added.
	 */
	public Iterator<String> getClientIdsWithMessages() {
		Set<String> clientIds = new LinkedHashSet<>();
		for (Message message : this.context.getMessageContext().getAllMessages()) {
			Object source = message.getSource();
			if (source instanceof String) {
				clientIds.add((String) source);
			} else if (message.getSource() instanceof FacesMessageSource) {
				clientIds.add(((FacesMessageSource) source).getClientId());
			}
		}
		return Collections.unmodifiableSet(clientIds).iterator();
	}

	/**
	 * Return the maximum severity level recorded on any FacesMessages that has been queued, whether or not they are
	 * associated with any specific UIComponent. If no such messages have been queued, return null.
	 */
	public FacesMessage.Severity getMaximumSeverity() {
		if (this.context.getMessageContext().getAllMessages().length == 0) {
			return null;
		}
		FacesMessage.Severity max = FacesMessage.SEVERITY_INFO;
		Iterator<FacesMessage> messages = getMessages();
		while (messages.hasNext()) {
			FacesMessage message = messages.next();
			if (message.getSeverity().getOrdinal() > max.getOrdinal()) {
				max = message.getSeverity();
			}
			if (max.getOrdinal() == FacesMessage.SEVERITY_FATAL.getOrdinal()) {
				break;
			}
		}
		return max;
	}

	/**
	 * Returns an Iterator for all Messages in the current MessageContext that does translation to FacesMessages.
	 */
	public Iterator<FacesMessage> getMessages() {
		return getMessageList().iterator();
	}

	/**
	 * Returns a List for all Messages in the current MessageContext that does translation to FacesMessages.
	 */
	public List<FacesMessage> getMessageList() {
		Message[] messages = this.context.getMessageContext().getAllMessages();
		return asFacesMessages(messages);
	}

	/**
	 * Returns an Iterator for all Messages with the given clientId in the current MessageContext that does translation
	 * to FacesMessages.
	 */
	public Iterator<FacesMessage> getMessages(String clientId) {
		return getMessageList(clientId).iterator();
	}

	/**
	 * Returns a List for all Messages with the given clientId in the current MessageContext that does translation to
	 * FacesMessages.
	 */
	public List<FacesMessage> getMessageList(final String clientId) {
		final FacesMessageSource source = new FacesMessageSource(clientId);
		Message[] messages = this.context.getMessageContext().getMessagesByCriteria(message ->
				ObjectUtils.nullSafeEquals(message.getSource(), source)
						|| ObjectUtils.nullSafeEquals(message.getSource(), clientId));
		return asFacesMessages(messages);
	}

	private List<FacesMessage> asFacesMessages(Message[] messages) {
		if (messages == null || messages.length == 0) {
			return Collections.emptyList();
		}
		List<FacesMessage> facesMessages = new ArrayList<>();
		for (Message message : messages) {
			facesMessages.add(asFacesMessage(message));
		}
		return Collections.unmodifiableList(facesMessages);
	}

	private FacesMessage asFacesMessage(Message message) {
		if (message instanceof FlowFacesMessage) {
			return ((FlowFacesMessage) message).getFacesMessage();
		}
		FacesMessage.Severity severity = SPRING_SEVERITY_TO_FACES.get(message.getSeverity());
		if (severity == null) {
			severity = FacesMessage.SEVERITY_INFO;
		}
		return new FacesMessage(severity, message.getText(), null);
	}

	/**
	 * This flag is set internally when the UIViewRoot is restored following a
	 * redirect and prior to rendering and is then checked whether to return
	 * {@code true} from {@link #isPostback()} so that JSF (2.2.7+) won't think
	 * it's building a new component tree.
	 * @see com.sun.faces.facelets.tag.jsf.ComponentSupport#isBuildingNewComponentTree
	 * @since 2.4.2
	 */
	void setViewRootRestoredFromFlashScope() {
		this.viewRootHolderFromFlashScope = true;
	}

	@Override
	public boolean isPostback() {
		return (this.viewRootHolderFromFlashScope || super.isPostback());
	}

	public static FlowFacesContext newInstance(RequestContext context, Lifecycle lifecycle) {
		FacesContext defaultFacesContext = newDefaultInstance(context, lifecycle);
		return new FlowFacesContext(context, defaultFacesContext);
	}

	private static FacesContext newDefaultInstance(RequestContext context, Lifecycle lifecycle) {
		Object nativeContext = context.getExternalContext().getNativeContext();
		Object nativeRequest = context.getExternalContext().getNativeRequest();
		Object nativeResponse = context.getExternalContext().getNativeResponse();
		return FacesContextHelper.newDefaultInstance(nativeContext, nativeRequest, nativeResponse, lifecycle);
	}

	/**
	 * Adapter class to convert a {@link FacesMessage} to a Spring {@link Message}. This adapter is required to allow
	 * <code>FacesMessages</code> to be registered with Spring whilst still retaining their mutable nature. It is not
	 * uncommon for <code>FacesMessages</code> to be changed after they have been added to a <code>FacesContext</code>, for
	 * example, from a <code>PhaseListener</code>.
	 * <p>
	 * NOTE: Only {@link jakarta.faces.application.FacesMessage} instances are directly adapted, any subclasses will be
	 * converted to the standard FacesMessage implementation. This is to protect against bugs such as SWF-1073.
	 * For convenience this class also implements the {@link MessageResolver} interface.
	 */
	protected static class FlowFacesMessage extends Message implements MessageResolver {

		private transient FacesMessage facesMessage;

		public FlowFacesMessage(FacesMessageSource source, FacesMessage message) {
			super(source, null, null);
			this.facesMessage = asStandardFacesMessageInstance(message);
		}

		/**
		 * Use standard faces message as required to protect against bugs such as SWF-1073.
		 * 
		 * @param message {@link jakarta.faces.application.FacesMessage} or subclass.
		 * @return {@link jakarta.faces.application.FacesMessage} instance
		 */
		private FacesMessage asStandardFacesMessageInstance(FacesMessage message) {
			if (FacesMessage.class.equals(message.getClass())) {
				return message;
			}
			return new FacesMessage(message.getSeverity(), message.getSummary(), message.getDetail());
		}

		// Custom serialization to work around myfaces bug MYFACES-1347

		private void writeObject(ObjectOutputStream oos) throws IOException {
			oos.defaultWriteObject();
			oos.writeObject(this.facesMessage.getSummary());
			oos.writeObject(this.facesMessage.getDetail());
			oos.writeInt(this.facesMessage.getSeverity().getOrdinal());
		}

		private void readObject(ObjectInputStream ois) throws ClassNotFoundException, IOException {
			ois.defaultReadObject();
			String summary = (String) ois.readObject();
			String detail = (String) ois.readObject();
			int severityOrdinal = ois.readInt();
			FacesMessage.Severity severity = FacesMessage.SEVERITY_INFO;
			for (Object o : FacesMessage.VALUES) {
				FacesMessage.Severity value = (FacesMessage.Severity) o;
				if (value.getOrdinal() == severityOrdinal) {
					severity = value;
				}
			}
			this.facesMessage = new FacesMessage(severity, summary, detail);
		}

		public String getText() {
			StringBuilder text = new StringBuilder();
			if (StringUtils.hasLength(this.facesMessage.getSummary())) {
				text.append(this.facesMessage.getSummary());
			}
			if (StringUtils.hasLength(this.facesMessage.getDetail())) {
				text.append(text.length() == 0 ? "" : " : ");
				text.append(this.facesMessage.getDetail());
			}
			return text.toString();
		}

		public Severity getSeverity() {
			Severity severity = null;
			if (this.facesMessage.getSeverity() != null) {
				severity = FACES_SEVERITY_TO_SPRING.get(this.facesMessage.getSeverity());
			}
			return (severity == null ? Severity.INFO : severity);
		}

		public String toString() {
			ToStringCreator rtn = new ToStringCreator(this);
			rtn.append("severity", getSeverity());
			if (FacesContext.getCurrentInstance() != null) {
				// Only append text if running within a faces context
				rtn.append("text", getText());
			}
			return rtn.toString();
		}

		public Message resolveMessage(MessageSource messageSource, Locale locale) {
			return this;
		}

		/**
		 * @return The original {@link FacesMessage} adapted by this class.
		 */
		public FacesMessage getFacesMessage() {
			return this.facesMessage;
		}
	}

	/**
	 * A Spring Message {@link Message#getSource() Source} that originated from JSF.
	 */
	public static class FacesMessageSource implements Serializable {

		private String clientId;

		public FacesMessageSource(String clientId) {
			if (StringUtils.hasLength(clientId)) {
				this.clientId = clientId;
			}
		}

		public String getClientId() {
			return this.clientId;
		}

		public int hashCode() {
			return ObjectUtils.nullSafeHashCode(this.clientId);
		}

		public boolean equals(Object obj) {
			if (obj == null) {
				return false;
			}
			if (obj == this) {
				return true;
			}
			if (obj.getClass().equals(FacesMessageSource.class)) {
				return ObjectUtils.nullSafeEquals(getClientId(), ((FacesMessageSource) obj).getClientId());
			}
			return false;
		}
	}
}