/**
* Copyright (C) 2009 eXo Platform SAS.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.exoplatform.portal.webui.application;
import org.exoplatform.Constants;
import org.exoplatform.commons.utils.Text;
import org.exoplatform.container.ExoContainer;
import org.exoplatform.portal.application.PortalRequestContext;
import org.exoplatform.portal.portlet.PortletExceptionHandleService;
import org.exoplatform.portal.webui.portal.UIPortal;
import org.exoplatform.portal.webui.util.Util;
import org.exoplatform.resolver.ApplicationResourceResolver;
import org.exoplatform.services.log.ExoLogger;
import org.exoplatform.services.log.Log;
import org.exoplatform.services.portletcontainer.PortletContainerException;
import org.exoplatform.web.application.ApplicationMessage;
import org.exoplatform.webui.application.WebuiApplication;
import org.exoplatform.webui.application.WebuiRequestContext;
import org.exoplatform.webui.core.UIComponent;
import org.exoplatform.webui.core.lifecycle.Lifecycle;
import org.exoplatform.webui.core.lifecycle.WebuiBindingContext;
import org.exoplatform.webui.event.Event;
import org.exoplatform.webui.exception.MessageException;
import org.gatein.common.util.MultiValuedPropertyMap;
import org.gatein.pc.api.invocation.RenderInvocation;
import org.gatein.pc.api.invocation.response.ErrorResponse;
import org.gatein.pc.api.invocation.response.FragmentResponse;
import org.gatein.pc.api.invocation.response.PortletInvocationResponse;
import org.w3c.dom.Element;
import java.io.Serializable;
import java.nio.charset.Charset;
import java.util.List;
import java.util.Map;
import javax.portlet.MimeResponse;
import javax.portlet.PortletMode;
import javax.portlet.WindowState;
import javax.servlet.http.Cookie;
/**
* Created by The eXo Platform SAS May 8, 2006
*/
public class UIPortletLifecycle<S, C extends Serializable, I> extends Lifecycle<UIPortlet<S, C>>
{
protected static Log log = ExoLogger.getLogger("portal:UIPortletLifecycle");
/**
* This processAction method associated with the portlet UI component does the
* following work:
*
* 1) If the current request is one that target the portal than an event
* targeting a Portal level ActionListener is sent. This case happen when the
* incoming request contains the parameter
* PortalRequestContext.UI_COMPONENT_ACTION (portal:action). When the event is
* broadcasted the methods is over 2) In other cases, the request targets the
* portlet either to a) change the portlet mode b) change the window state c)
* make a processAction() or render() call to the portlet container (Portlet
* API methods here) In those 3 cases, dedicated events are created and
* broadcasted and the portlet is added in the list of components to update
* within the AJAX call
*/
public void processAction(UIPortlet<S, C> uicomponent, WebuiRequestContext context) throws Exception
{
try
{
String action = context.getRequestParameter(PortalRequestContext.UI_COMPONENT_ACTION);
if (action != null)
{
Event<UIComponent> event = uicomponent.createEvent(action, Event.Phase.PROCESS, context);
if (event != null)
event.broadcast();
return;
}
String portletMode = context.getRequestParameter("portal:portletMode");
if (portletMode != null)
{
Event<UIComponent> event = uicomponent.createEvent("ChangePortletMode", Event.Phase.PROCESS, context);
if (event != null)
event.broadcast();
}
String windowState = context.getRequestParameter("portal:windowState");
if (windowState != null)
{
Event<UIComponent> event = uicomponent.createEvent("ChangeWindowState", Event.Phase.PROCESS, context);
if (event != null)
event.broadcast();
}
/*
* Check the type of the incoming request, can be either an ActionURL or a
* RenderURL one
*
* In case of a RenderURL, the parameter state map must be invalidated and
* this is done in the associated ActionListener
*
* If no action type is specified we assume the default, which is to render
*/
String portletActionType = context.getRequestParameter(Constants.TYPE_PARAMETER);
if (portletActionType != null)
{
if (portletActionType.equals(Constants.PORTAL_PROCESS_ACTION))
{
Event<UIComponent> event = uicomponent.createEvent("ProcessAction", Event.Phase.PROCESS, context);
if (event != null)
event.broadcast();
}
else if (portletActionType.equals(Constants.PORTAL_SERVE_RESOURCE))
{
Event<UIComponent> event = uicomponent.createEvent("ServeResource", Event.Phase.PROCESS, context);
if (event != null)
event.broadcast();
}
}
else
{
Event<UIComponent> event = uicomponent.createEvent("Render", Event.Phase.PROCESS, context);
if (event != null)
event.broadcast();
}
context.addUIComponentToUpdateByAjax(uicomponent);
}
catch (Exception e)
{
String message = e.getLocalizedMessage();
log.error("Error processing the action: " + message, e);
Object[] args = {message};
context.addUIComponentToUpdateByAjax(uicomponent);
throw new MessageException(new ApplicationMessage("UIPortletLifecycle.msg.process-error", args, ApplicationMessage.ERROR));
}
}
/**
* This methods of the Lifecycle writes into the output writer the content of
* the portlet
*
* 1) Create a RenderInput object and fill it with all the Request information
* 2) Call the portletContainer.render() method of the Portlet Container to
* get the HTML generated fragment 3) Then if the current request is an AJAX
* one, just write in the buffer the content returned by the portlet container
* 4) If not AJAX, then merge the content with the UIPortlet.gtmpl
*/
public void processRender(UIPortlet<S, C> uicomponent, WebuiRequestContext context) throws Exception
{
PortalRequestContext prcontext = (PortalRequestContext)context;
ExoContainer container = prcontext.getApplication().getApplicationServiceContainer();
//
Text markup = null;
String portletTitle = null;
try
{
Map<String, String[]> paramMap = prcontext.getRequest().getParameterMap();
if (paramMap.containsKey("removePP"))
{
UIPortal uiPortal = Util.getUIPortal();
for (String publicParamName : paramMap.get("removePP"))
{
uiPortal.getPublicParameters().remove(publicParamName);
}
}
RenderInvocation renderInvocation = uicomponent.create(RenderInvocation.class, prcontext);
if (uicomponent.getCurrentWindowState() != WindowState.MINIMIZED)
{
String appStatus = uicomponent.getProperties().get("appStatus");
if ("Window".equals(uicomponent.getPortletStyle())
&& !("SHOW".equals(appStatus) || "HIDE".equals(appStatus)))
{
markup = Text.create("<span></span>");
}
else
{
int portalMode = Util.getUIPortalApplication().getModeState();
if (portalMode % 2 == 0 || uicomponent.getCurrentPortletMode().equals(PortletMode.EDIT))
{
PortletInvocationResponse response = uicomponent.invoke(renderInvocation);
if (response instanceof FragmentResponse)
{
FragmentResponse fragmentResponse = (FragmentResponse)response;
switch (fragmentResponse.getType())
{
case FragmentResponse.TYPE_CHARS:
markup = Text.create(fragmentResponse.getContent());
break;
case FragmentResponse.TYPE_BYTES:
markup = Text.create(fragmentResponse.getBytes(), Charset.forName("UTF-8"));
break;
case FragmentResponse.TYPE_EMPTY:
markup = Text.create("");
break;
}
portletTitle = fragmentResponse.getTitle();
// setup portlet properties
if (fragmentResponse.getProperties() != null)
{
//setup transport headers
if (fragmentResponse.getProperties().getTransportHeaders() != null)
{
MultiValuedPropertyMap<String> transportHeaders =
fragmentResponse.getProperties().getTransportHeaders();
for (String key : transportHeaders.keySet())
{
for (String value : transportHeaders.getValues(key))
{
prcontext.getResponse().setHeader(key, value);
}
}
}
//setup up portlet cookies
if (fragmentResponse.getProperties().getCookies() != null)
{
List<Cookie> cookies = fragmentResponse.getProperties().getCookies();
for (Cookie cookie : cookies)
{
prcontext.getResponse().addCookie(cookie);
}
}
//setup markup headers
if (fragmentResponse.getProperties().getMarkupHeaders() != null)
{
MultiValuedPropertyMap<Element> markupHeaders =
fragmentResponse.getProperties().getMarkupHeaders();
List<Element> markupElements = markupHeaders.getValues(MimeResponse.MARKUP_HEAD_ELEMENT);
if (markupElements != null)
{
for (Element element : markupElements)
{
if ("title".equals(element.getNodeName().toLowerCase()) && element.getFirstChild() != null)
{
String title = element.getFirstChild().getTextContent();
prcontext.getRequest().setAttribute(PortalRequestContext.REQUEST_TITLE, title);
}
else
{
prcontext.addExtraMarkupHeader(element);
}
}
}
}
}
}
else
{
PortletContainerException pcException;
if (response instanceof ErrorResponse)
{
ErrorResponse errorResponse = (ErrorResponse)response;
pcException =
new PortletContainerException(errorResponse.getMessage(), errorResponse.getCause());
}
else
{
pcException =
new PortletContainerException("Unknown invocation response type [" + response.getClass()
+ "]. Expected a FragmentResponse or an ErrorResponse");
}
PortletExceptionHandleService portletExceptionService =
(PortletExceptionHandleService)container
.getComponentInstanceOfType(PortletExceptionHandleService.class);
portletExceptionService.handle(pcException);
markup = Text.create("This portlet encountered an error and could not be displayed.");
}
}
}
}
}
catch (Exception e)
{
PortletContainerException pcException = new PortletContainerException(e);
PortletExceptionHandleService portletExceptionService =
(PortletExceptionHandleService)container.getComponentInstanceOfType(PortletExceptionHandleService.class);
if (portletExceptionService != null)
{
portletExceptionService.handle(pcException);
}
else
{
log.warn("Could not find the PortletExceptionHandleService in the exo container");
}
markup = Text.create("This portlet encountered an error and could not be displayed.");
}
//
if (portletTitle == null)
{
portletTitle = "Portlet";
}
//
if (context.useAjax() && !prcontext.getFullRender())
{
if (markup != null)
{
markup.writeTo(prcontext.getWriter());
}
}
else
{
WebuiApplication app = (WebuiApplication)prcontext.getApplication();
ApplicationResourceResolver resolver = app.getResourceResolver();
WebuiBindingContext bcontext = new WebuiBindingContext(resolver, context.getWriter(), uicomponent, prcontext);
bcontext.put(UIComponent.UICOMPONENT, uicomponent);
bcontext.put("portletContent", markup);
bcontext.put("portletTitle", portletTitle);
try
{
renderTemplate(uicomponent.getTemplate(), bcontext);
}
catch (Throwable ex)
{
ex.printStackTrace();
}
}
}
}