001/**
002 *
003 * Copyright (c) 2014, the Railo Company Ltd. All rights reserved.
004 *
005 * This library is free software; you can redistribute it and/or
006 * modify it under the terms of the GNU Lesser General Public
007 * License as published by the Free Software Foundation; either 
008 * version 2.1 of the License, or (at your option) any later version.
009 * 
010 * This library is distributed in the hope that it will be useful,
011 * but WITHOUT ANY WARRANTY; without even the implied warranty of
012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013 * Lesser General Public License for more details.
014 * 
015 * You should have received a copy of the GNU Lesser General Public 
016 * License along with this library.  If not, see <http://www.gnu.org/licenses/>.
017 * 
018 **/
019package lucee.runtime.listener;
020
021import lucee.runtime.PageContext;
022import lucee.runtime.PageSource;
023import lucee.runtime.exp.PageException;
024
025/**
026 * this lstener is executed after the application.cfc/application.cfm was invoked, but before onApplicationStart, this class can change the PageSource executed
027*/
028public interface RequestListener {
029        
030        /**
031         * execute by the Application Listener
032         * @param pc page context of the current request
033         * @param requestedPage original requested pagesource
034         * @return pagesource that should be use by the ApplicationListener
035         * @throws PageException
036         */
037        public PageSource execute(PageContext pc, PageSource requestedPage) throws PageException;
038
039}