View Javadoc
1   /**
2    * This file Copyright (c) 2014-2018 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.rendering.listeners;
35  
36  import info.magnolia.objectfactory.Components;
37  import info.magnolia.rendering.engine.OutputProvider;
38  import info.magnolia.rendering.template.RenderableDefinition;
39  import info.magnolia.voting.voters.ResponseContentTypeVoter;
40  import info.magnolia.voting.voters.VoterSet;
41  
42  import java.util.Arrays;
43  import java.util.Map;
44  
45  import javax.jcr.Node;
46  import javax.jcr.RepositoryException;
47  import javax.servlet.http.HttpServletResponse;
48  
49  /**
50   * Listener for {@link info.magnolia.rendering.engine.RenderingEngine}.
51   */
52  public abstract class AbstractRenderingListener {
53  
54      private VoterSet<HttpServletResponse> shouldProcess = new VoterSet<HttpServletResponse>();
55  
56      /**
57       * Rendering listener return codes.
58       */
59      public static enum RenderingListenerReturnCode {
60          SKIP,
61          STOP,
62          NOT_FOUND
63      }
64  
65      private boolean enabled = true;
66  
67      public AbstractRenderingListener() {
68          // process by default only "text/html"
69          ResponseContentTypeVoter voter = new ResponseContentTypeVoter();
70          voter.setAllowed(Arrays.asList("text/html"));
71          getShouldProcess().addVoter(voter);
72      }
73  
74      public RenderingListenerReturnCode init(OutputProvider outputProvider, HttpServletResponse response) throws RepositoryException {
75          return this.shouldProcess(response) ? null : RenderingListenerReturnCode.SKIP;
76      }
77  
78      protected boolean shouldProcess(HttpServletResponse response) {
79          if (getShouldProcess().vote(response) <= 0) {
80              return false;
81          }
82          return true;
83      }
84  
85      public abstract RenderingListenerReturnCode before(Node content, RenderableDefinition definition, Map<String, Object> contextObjects, OutputProvider out) throws RepositoryException;
86  
87      public abstract RenderingListenerReturnCode after(Node content, RenderableDefinition definition, Map<String, Object> contextObjects, OutputProvider out) throws RepositoryException;
88  
89      public boolean isEnabled() {
90          return enabled;
91      }
92  
93      public void setEnabled(boolean enabled) {
94          this.enabled = enabled;
95      }
96  
97      /**
98       * The instance of each {@link AbstractRenderingListener} needs to be copied per request.
99       * Override this method to set your custom properties which should be shared between all instances.
100      */
101     public AbstractRenderingListener copy() { // no need to copy enabled field since such node is disabled by N2B
102         AbstractRenderingListener copy = Components.newInstance(this.getClass());
103         copy.setShouldProcess(shouldProcess);
104         return copy;
105     }
106 
107     public VoterSet<HttpServletResponse> getShouldProcess() {
108         return shouldProcess;
109     }
110 
111     public void setShouldProcess(VoterSet<HttpServletResponse> shouldProcess) {
112         this.shouldProcess = shouldProcess;
113     }
114 
115 }