View Javadoc

1   /**
2    * This file Copyright (c) 2003-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.cms.filters;
35  
36  import java.io.IOException;
37  import javax.servlet.Filter;
38  import javax.servlet.FilterChain;
39  import javax.servlet.FilterConfig;
40  import javax.servlet.ServletContext;
41  import javax.servlet.ServletException;
42  import javax.servlet.ServletRequest;
43  import javax.servlet.ServletResponse;
44  import javax.servlet.http.HttpServletRequest;
45  import javax.servlet.http.HttpServletResponse;
46  
47  import org.slf4j.Logger;
48  import org.slf4j.LoggerFactory;
49  
50  import info.magnolia.context.MgnlContext;
51  import info.magnolia.objectfactory.Components;
52  
53  
54  /**
55   * Entry point for Magnolia filter dispatching. Intercepts all requests and passes them on to the Magnolia filter chain
56   * that will either process the request or pass it on to the next filter configured in web.xml.
57   *
58   * @version $Id$
59   * @see FilterManager
60   * @see MgnlFilterDispatcher
61   */
62  public class MgnlMainFilter implements Filter {
63  
64      private static final Logger log = LoggerFactory.getLogger(MgnlMainFilter.class);
65  
66      /**
67       * @deprecated since 4.5, use {@link FilterManager#SERVER_FILTERS}.
68       */
69      public static final String SERVER_FILTERS = FilterManager.SERVER_FILTERS;
70  
71      /**
72       * @deprecated since 4.5, use IoC to access FilterManager.
73       */
74      private static MgnlMainFilter instance;
75  
76      private FilterManager filterManager;
77  
78      @Override
79      public void init(FilterConfig filterConfig) throws ServletException {
80          instance = this;
81          filterManager = getFilterManager(filterConfig.getServletContext());
82          filterManager.init(filterConfig);
83      }
84  
85      @Override
86      public void destroy() {
87          if (filterManager != null) {
88              filterManager.destroy();
89          }
90      }
91  
92      @Override
93      public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
94          doFilter((HttpServletRequest) request, (HttpServletResponse) response, chain);
95      }
96  
97      public void doFilter(HttpServletRequest request, HttpServletResponse response, FilterChain chain) throws IOException, ServletException {
98          log.debug("Handling URI: {} - Path info: {}", request.getRequestURI(), request.getPathInfo());
99  
100         // global fix for MAGNOLIA-3338 to make this independent of other dispatching rules
101         boolean contextUpdated = false;
102         if (MgnlContext.hasInstance()) {
103             MgnlContext.push(request, response);
104             contextUpdated = true;
105         }
106 
107         try {
108             filterManager.getFilterDispatcher().doDispatch(request, response, chain);
109         } finally {
110             if (contextUpdated && MgnlContext.hasInstance()) {
111                 MgnlContext.pop();
112             }
113         }
114     }
115 
116     /**
117      * Returns the root filter, note that the filter is destroyed if the filter chain is reloaded.
118      */
119     public MgnlFilter getRootFilter() {
120         return filterManager.getFilterDispatcher().getTargetFilter();
121     }
122 
123     protected FilterManager getFilterManager(ServletContext servletContext) {
124         return Components.getComponent(FilterManager.class);
125     }
126 
127     /**
128      * @deprecated since 4.5, use IoC to access FilterManager.
129      */
130     public static MgnlMainFilter getInstance() {
131         return instance;
132     }
133 
134 }