Front controller

<h2 id="instruction">Instruction</h2>

<p>Front controllers are often used in <a href="/facts/Web_application/BLkF3BIN">web applications</a> to implement workflows. While not strictly required, it is much easier to control navigation across a set of related pages (for instance, multiple pages used in an online purchase) from a front controller than it is to assign individual pages responsibility for navigation.
</p><p>The front controller may be implemented as a <a href="/facts/Java_(programming_language)/9ScgFyAL">Java</a> object, or as a script in a <a href="/facts/Script_language/8pF4ajBL">scripting language</a> such as <a href="/facts/PHP/02Lfe6RM">PHP</a>, <a href="/facts/Raku_(programming_language)/9eYW7vRJ">Raku</a>, <a href="/facts/Python_(programming_language)/YbuGqofa">Python</a> or <a href="/facts/Ruby_(programming_language)/BeYSaPSR">Ruby</a> that is called for every request of a web <a href="/facts/Session_(computer_science)/PRQuXhIL">session</a>. This script would handle all tasks that are common to the application or the framework, such as session handling, <a href="/facts/Caching_(computing)/gmJYN8wm">caching</a> and input filtering. Based on the specific request, it would then instantiate further objects and call methods to handle the required tasks.
</p><p>The alternative to a front controller is the usage of page controllers mapped to each site page or path. Although this may cause each individual controller to contain duplicate code, the page-controller approach delivers a high degree of specialization.
</p>
<h2 id="examples">Examples</h2>
<p>Several web-tier application frameworks implement the front controller pattern:
</p>
<ul><li><a href="/facts/Apache_Struts/n6IaPbD7">Apache Struts</a></li>
<li><a href="/facts/ASP.NET_MVC/KFyeWXHx">ASP.NET MVC</a></li>
<li><a href="/facts/Cairngorm_(Flex_framework)/Dljpf4at">Cairngorm</a> framework in <a href="/facts/Adobe_Flex/WvwRnWt2">Adobe Flex</a></li>
<li>Cro or Bailador frameworks in <a href="/facts/Raku_(programming_language)/9eYW7vRJ">Raku</a></li>
<li><a href="/facts/Drupal/pX3JIDD3">Drupal</a></li>
<li><a href="/facts/Model%25E2%2580%2593view%25E2%2580%2593controller/vRbMXjMm">MVC</a> frameworks written in <a href="/facts/PHP/02Lfe6RM">PHP</a>, such as <a href="/facts/Yii/IcC2yaV2">Yii</a>, <a href="/facts/Cake_PHP/GfHu3DxM">CakePHP</a>, <a href="/facts/Laravel/nc3vYq0J">Laravel</a>, <a href="/facts/Symfony/xkYa3sh1">Symfony</a>, <a href="/facts/CodeIgniter/kCKRWtBf">CodeIgniter</a> and <a href="/facts/Laminas/J4xsYpzy">Laminas</a></li>
<li><a href="/facts/Spring_Framework/ajIwLM73">Spring Framework</a><a class="footnote-ref" id="fnref:2" href="#fn:2"><sup>2</sup></a></li>
<li><a href="/facts/Yesod_(web_framework)/HjuUzuCa">Yesod</a>, written in <a href="/facts/Haskell_(programming_language)/4Htv9WLu">Haskell</a></li></ul>
<h2 id="implementation">Implementation</h2>
<p>Front controllers may divided into three components:
</p>
<ol><li><a href="/facts/XML/clNgUfWk">XML</a> mapping: files that map requests to the class that will handle the request processing.</li>
<li>Request processor: used for request processing and modifying or retrieving the appropriate model.</li>
<li>Flow manager: determines what will be shown on the next page.</li></ol>
<h3>Participants and responsibilities</h3>
<table><tbody><tr><th>Controller</th><th>Dispatcher</th><th>Helper</th><th>View</th></tr><tr><td>The controller is an entrance for users to handle requests in the system. It realizes authentication by playing the role of delegating helper or initiating contact retrieval.</td><td>Dispatchers can be used for navigation and managing the view output. Users will receive the next view that is determined by the dispatcher. Dispatchers are also flexible; they can be encapsulated within the controller directly or separated into another component. The dispatcher provides a static view along with the dynamic mechanism.</td><td>Helpers assist in the processing of views or controllers.<p>On the view side, the helper collects data and sometimes stores data as an intermediate station. Helpers do certain preprocesses such as formatting of the data to web content or providing direct access to the raw data. Multiple helpers can collaborate with one view for most conditions. Additionally, a helper works as a transformer that adapts and converts the model into a suitable format.</p></td><td>With the collaboration of helpers, views display information to the client by processing data from a model. The view will display if the processing succeeds, and vice versa.</td></tr></tbody></table>
<h3>Java implementation example</h3><p>
The front controller implemented in Java code:<a class="footnote-ref" id="fnref:3" href="#fn:3"><sup>3</sup></a></p>private void doProcess(HttpServletRequest request,
                       HttpServletResponse response)
    throws IOException, ServletException {
    ...
    try {
        getRequestProcessor().processRequest(request);
        getScreenFlowManager().forwardToNextScreen(request, response);
    } catch (Throwable ex) {
        String className = ex.getClass().getName();
        nextScreen = getScreenFlowManager().getExceptionScreen(ex);
        // Put the exception in the request
        request.setAttribute("javax.servlet.jsp.jspException", ex);
        if (nextScreen == null) {
            // Send to general error screen
            ex.printStackTrace();
            throw new ServletException("MainServlet: unknown exception: " +
                className);
        }
    }

<h2 id="benefits-and-liabilities">Benefits and liabilities</h2>
<p>There are three primary benefits associated with the front controller pattern.<a class="footnote-ref" id="fnref:4" href="#fn:4"><sup>4</sup></a>
</p>
<ul><li>Centralized control. The front controller handles all the requests to the <a href="/facts/Web_application/BLkF3BIN">web application</a>. This implementation of centralized control that avoids using multiple controllers is desirable for enforcing application-wide policies such as user tracking and security.</li>
<li>Thread safety. A new command object arises when receiving a new request, and the command objects are not meant to be thread-safe. Thus, it will be safe in the command classes. Though safety is not guaranteed when threading issues are gathered, code that interacts with commands is still thread-safe.</li>
<li>Configurability. As only one front controller is employed in a web application, the application configuration may be greatly simplified. Because the handler shares the responsibility of dispatching, new commands may be added without changes needed to the code.</li></ul>
<p>The front controller pattern may incur performance issues because the single controller is performing a great deal of work, and handlers may introduce bottlenecks if they involve database or document queries. The front controller approach is also more complex than that of page controllers.
</p>
<h2 id="relationship-with-mvc">Relationship with MVC</h2>
<ol><li>In order to improve system reliability and maintainability, duplicate code should be avoided and centralized when it involves common logic used throughout the system.</li>
<li>The data for the application is best handled in a single location, obviating the need for duplicate data-retrieval code.</li>
<li>Different roles in the <a href="/facts/Model%25E2%2580%2593view%25E2%2580%2593controller/vRbMXjMm">model–view–controller</a> (MVC) pattern should be separated to increase testability, which is also true for the controller part in the MVC pattern.</li></ol>
<h2 id="comparison">Comparison</h2>
<p>The page-controller pattern is an alternative to the front controller approach in the MVC model.
</p>
<table><tbody><tr><th></th><th>Page Controller</th><th>Front Controller</th></tr><tr><td>Base class</td><td>A base class is needed and will grow simultaneously with the development of the application.</td><td>The centralization of requests is easier to modify than is a base class.</td></tr><tr><td>Security</td><td>Low security because various objects react differently without consistency.</td><td>High, because the controller is implemented in a coordinated fashion.</td></tr><tr><td>Logical Page</td><td>Single object on each logical page.</td><td>Only one controller handles all requests.</td></tr><tr><td>Complexity</td><td>Low</td><td>High</td></tr></tbody></table>
<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/Software_design_pattern/mV7r4egw">Software design pattern</a></li>
<li><a href="/facts/Mediator_pattern/E9ncaBAy">Mediator pattern</a> (note: the front controller pattern is a specialized kind of mediator pattern)</li></ul>

<h2 id="notes">Notes</h2>
<ul><li>Alur, Deepak; John Crup; Dan Malks (2003). <i>Core J2EE Patterns, Best Practices and Design Strategies, 2nd Ed</i>. Sun Microsystems Press. pp. 650pp. <a href="/facts/ISBN_(identifier)/15AdSPa9">ISBN</a> 0-13-142246-4.</li>
<li><a href="/facts/Martin_Fowler_(software_engineer)/l8k3NRI1">Fowler, Martin</a> (2003). <a href="http://www.martinfowler.com/books.html#eaa"><i>Patterns of Enterprise Application Architecture</i></a>. Addison-Wesley Professional. pp. 560pp. <a href="/facts/ISBN_(identifier)/15AdSPa9">ISBN</a> 978-0-321-12742-6.</li></ul>
<h2 id="external-links">External links</h2>
<ul><li><a href="https://web.archive.org/web/20160305004850/http://www.bibeault.org/frontman/">Bear Bibeault's Front Man™</a>, a lightweight Java implementation.</li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>Fowler, Martin. "Front Controller". Retrieved September 26, 2017. <a href="/wiki/Martin_Fowler_(software_engineer)" target="_blank">/wiki/Martin_Fowler_(software_engineer)</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>"Web MVC framework". Spring Framework Reference Documentation. Pivotal Software. Retrieved September 26, 2017. <a href="https://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html#mvc-servlet" target="_blank">https://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html#mvc-servlet</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
<li id="fn:3"><p>"Demo code in Java". Archived from the original on 2012-04-19.{{cite web}}:  CS1 maint: bot: original URL status unknown (link) <a href="https://web.archive.org/web/20120419115929/http://java.sun.com/blueprints/patterns/FrontController.html" target="_blank">https://web.archive.org/web/20120419115929/http://java.sun.com/blueprints/patterns/FrontController.html</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li>
<li id="fn:4"><p>"Benefits for using front controller". 17 March 2014. <a href="https://msdn.microsoft.com/en-us/library/ff648617.aspx" target="_blank">https://msdn.microsoft.com/en-us/library/ff648617.aspx</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li>
</ol>

Front controller open-in-new

Front controller