View Javadoc

1   /**
2    * This file Copyright (c) 2008-2011 Magnolia International
3    * Ltd.  (http://www.magnolia-cms.com). All rights reserved.
4    *
5    *
6    * This file is dual-licensed under both the Magnolia
7    * Network Agreement and the GNU General Public License.
8    * You may elect to use one or the other of these licenses.
9    *
10   * This file is distributed in the hope that it will be
11   * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
12   * implied warranty of MERCHANTABILITY or FITNESS FOR A
13   * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
14   * Redistribution, except as permitted by whichever of the GPL
15   * or MNA you select, is prohibited.
16   *
17   * 1. For the GPL license (GPL), you can redistribute and/or
18   * modify this file under the terms of the GNU General
19   * Public License, Version 3, as published by the Free Software
20   * Foundation.  You should have received a copy of the GNU
21   * General Public License, Version 3 along with this program;
22   * if not, write to the Free Software Foundation, Inc., 51
23   * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24   *
25   * 2. For the Magnolia Network Agreement (MNA), this file
26   * and the accompanying materials are made available under the
27   * terms of the MNA which accompanies this distribution, and
28   * is available at http://www.magnolia-cms.com/mna.html
29   *
30   * Any modifications to this file must keep this entire header
31   * intact.
32   *
33   */
34  package info.magnolia.module.templating;
35  
36  import info.magnolia.cms.core.AggregationState;
37  import info.magnolia.cms.core.Content;
38  import info.magnolia.cms.i18n.I18nContentWrapper;
39  import info.magnolia.context.MgnlContext;
40  
41  import java.io.Writer;
42  import java.util.HashMap;
43  import java.util.Iterator;
44  import java.util.Map;
45  
46  import org.apache.commons.lang.exception.ExceptionUtils;
47  
48  
49  /**
50   * Abstract renderer which can be used to implement paragraph or template renderers.
51   * Sets up the context by providing the following objects: content, aggregationState, page, model, actionResult, mgnl
52   *
53   * @author pbracher
54   * @version $Id: AbstractRenderer.java 48832 2011-08-31 08:22:48Z had $
55   * @deprecated since 4.5, replaced by {@link info.magnolia.rendering.renderer.AbstractRenderer}
56   * FIXME remove most of the code and and try to extend the new {@link info.magnolia.rendering.renderer.AbstractRenderer}
57   *
58   */
59  @Deprecated
60  public abstract class AbstractRenderer implements RenderingModelBasedRenderer {
61  
62      private static final String MODEL_ATTRIBUTE = RenderingModel.class.getName();
63  
64      public AbstractRenderer() {
65      }
66  
67      protected void render(Content content, RenderableDefinition definition, Writer out) throws RenderException {
68  
69          final RenderingModel parentModel = (RenderingModel) MgnlContext.getAttribute(MODEL_ATTRIBUTE);
70  
71          RenderingModel model;
72          String actionResult;
73  
74          model = (RenderingModel) MgnlContext.getAttribute(ModelExecutionFilter.MODEL_ATTRIBUTE_PREFIX + content.getUUID());
75  
76          if (model == null) {
77  
78              model = newModel(content, definition, parentModel);
79  
80              actionResult = model.execute();
81  
82              if (RenderingModel.SKIP_RENDERING.equals(actionResult)) {
83                  return;
84              }
85          } else {
86              actionResult = (String) MgnlContext.getAttribute(ModelExecutionFilter.ACTION_RESULT_ATTRIBUTE_PREFIX + content.getUUID());
87              if (model instanceof EarlyExecutionAware) {
88                  ((EarlyExecutionAware)model).setParent(parentModel);
89              }
90          }
91  
92          String templatePath = determineTemplatePath(content, definition, model, actionResult);
93  
94          final Map ctx = newContext();
95          final Map savedContextState = saveContextState(ctx);
96          setupContext(ctx, content, definition, model, actionResult);
97          MgnlContext.setAttribute(MODEL_ATTRIBUTE, model);
98          onRender(content, definition, out, ctx, templatePath);
99          MgnlContext.setAttribute(MODEL_ATTRIBUTE, parentModel);
100 
101         restoreContext(ctx, savedContextState);
102     }
103 
104     protected String determineTemplatePath(Content content, RenderableDefinition definition, RenderingModel model, final String actionResult) {
105         String templatePath = definition.determineTemplatePath(actionResult, model);
106 
107         if (templatePath == null) {
108             throw new IllegalStateException("Unable to render " + definition.getClass().getName() + " " + definition.getName() + " in page " + content.getHandle() + ": templatePath not set.");
109         }
110         return templatePath;
111     }
112 
113     /**
114      * Creates the model for this rendering process. Will set the properties
115      */
116     @Override
117     public RenderingModel newModel(Content content, RenderableDefinition definition, RenderingModel parentModel) throws RenderException {
118         try {
119             final Content wrappedContent = wrapNodeForModel(content, getMainContentSafely(content));
120             return definition.newModel(wrappedContent, definition, parentModel);
121         } catch (Exception e) {
122             throw new RenderException("Can't create rendering model: " + ExceptionUtils.getRootCauseMessage(e), e);
123         }
124     }
125 
126     protected Map saveContextState(final Map ctx) {
127         Map state = new HashMap();
128         // save former values
129         saveAttribute(ctx, state, "content");
130         saveAttribute(ctx, state, "def");
131         saveAttribute(ctx, state, "state");
132         saveAttribute(ctx, state, "mgnl");
133         saveAttribute(ctx, state, "model");
134         saveAttribute(ctx, state, "actionResult");
135 
136         saveAttribute(ctx, state, getPageAttributeName());
137         return state;
138     }
139 
140     protected void saveAttribute(final Map ctx, Map state, String name) {
141         state.put(name, ctx.get(name));
142     }
143 
144     protected void restoreContext(final Map ctx, Map state) {
145         for (Iterator iterator = state.keySet().iterator(); iterator.hasNext();) {
146             String name = (String) iterator.next();
147             setContextAttribute(ctx, name, state.get(name));
148         }
149     }
150 
151     protected void setupContext(final Map ctx, Content content, RenderableDefinition definition, RenderingModel model, Object actionResult){
152         final Content mainContent = getMainContentSafely(content);
153 
154         setContextAttribute(ctx, getPageAttributeName(), wrapNodeForTemplate(mainContent, mainContent));
155         setContextAttribute(ctx, "content", wrapNodeForTemplate(content, mainContent));
156         setContextAttribute(ctx, "def", definition);
157         setContextAttribute(ctx, "state", getAggregationStateSafely());
158         setContextAttribute(ctx, "mgnl", getMagnoliaTemplatingUtilities());
159         setContextAttribute(ctx, "model", model);
160         setContextAttribute(ctx, "actionResult", actionResult);
161     }
162 
163     /**
164      * Gets the current main contain and treats the situation where the context is not a web context nicely by using the current content instead.
165      */
166     protected Content getMainContentSafely(Content current) {
167         AggregationState state = getAggregationStateSafely();
168         if(state != null){
169             return state.getMainContent();
170         }
171         return current;
172     }
173 
174     /**
175      * This gets the aggregation state without throwing an exception if the current context is not a WebContext.
176      */
177     protected AggregationState getAggregationStateSafely() {
178         if(MgnlContext.isWebContext()){
179             return MgnlContext.getAggregationState();
180         }
181         return null;
182     }
183 
184     protected MagnoliaTemplatingUtilities getMagnoliaTemplatingUtilities() {
185         return MagnoliaTemplatingUtilities.getInstance();
186     }
187 
188     /**
189      * Wraps the current content node before passing it to the model.
190      * @param currentContent the actual content
191      * @param mainContent the current "main content" or "page", which might be needed in certain wrapping situations
192      */
193     protected Content wrapNodeForModel(Content currentContent, Content mainContent) {
194         return new I18nContentWrapper(currentContent);
195     }
196 
197     /**
198      * Wraps the current content node before exposing it to the template renderer.
199      * @param currentContent the actual content being exposed to the template
200      * @param mainContent the current "main content" or "page", which might be needed in certain wrapping situations
201      * @see info.magnolia.module.templating.paragraphs.JspParagraphRenderer
202      * TODO : return an Object instance instead - more flexibility for the template engine ?
203      */
204     protected Content wrapNodeForTemplate(Content currentContent, Content mainContent) {
205         return new I18nContentWrapper(currentContent);
206     }
207 
208     protected Object setContextAttribute(final Map ctx, final String name, Object value) {
209         return ctx.put(name, value);
210     }
211 
212     /**
213      * Used to give JSP implementations to give the chance to use on other name than page which is a reserved name in JSPs.
214      */
215     protected String getPageAttributeName() {
216         return "page";
217     }
218 
219     /**
220      * Create a new context object which is a map.
221      */
222     protected abstract Map newContext();
223 
224     /**
225      * Finally execute the rendering.
226      * @param content TODO
227      */
228     protected abstract void onRender(Content content, RenderableDefinition definition, Writer out, Map ctx, String templatePath) throws RenderException;
229 
230 }