: <?php                                                                                                                
                 : /**                                                                                                                  
                 :  * TApplication class file                                                                                           
                 :  *                                                                                                                   
                 :  * @author Qiang Xue <qiang.xue@gmail.com>                                                                           
                 :  * @link http://www.pradosoft.com/                                                                                   
                 :  * @copyright Copyright &copy; 2005 PradoSoft                                                                        
                 :  * @license http://www.pradosoft.com/license/                                                                        
                 :  * @version $Id: TApplication.php 2244 2007-09-26 13:15:56Z xue $                                                    
                 :  * @package System                                                                                                   
                 :  */                                                                                                                  
                 :                                                                                                                      
                 : /**                                                                                                                  
                 :  * Includes core interfaces essential for TApplication class                                                         
                 :  */                                                                                                                  
                 : require_once(PRADO_DIR.'/interfaces.php');                                                                           
                 :                                                                                                                      
                 : /**                                                                                                                  
                 :  * Includes core classes essential for TApplication class                                                            
                 :  */                                                                                                                  
                 : Prado::using('System.TApplicationComponent');                                                                        
                 : Prado::using('System.TModule');                                                                                      
                 : Prado::using('System.TService');                                                                                     
                 : Prado::using('System.Exceptions.TErrorHandler');                                                                     
                 : Prado::using('System.Caching.TCache');                                                                               
                 : Prado::using('System.IO.TTextWriter');                                                                               
                 : Prado::using('System.Collections.TList');                                                                            
                 : Prado::using('System.Collections.TMap');                                                                             
                 : Prado::using('System.Collections.TStack');                                                                           
                 : Prado::using('System.Xml.TXmlDocument');                                                                             
                 : Prado::using('System.Security.TAuthorizationRule');                                                                  
                 : Prado::using('System.Security.TSecurityManager');                                                                    
                 : Prado::using('System.Web.THttpUtility');                                                                             
                 : Prado::using('System.Web.Javascripts.TJavaScript');                                                                  
                 : Prado::using('System.Web.THttpRequest');                                                                             
                 : Prado::using('System.Web.THttpResponse');                                                                            
                 : Prado::using('System.Web.THttpSession');                                                                             
                 : Prado::using('System.Web.Services.TPageService');                                                                    
                 : Prado::using('System.Web.TAssetManager');                                                                            
                 : Prado::using('System.I18N.TGlobalization');                                                                          
                 :                                                                                                                      
                 : /**                                                                                                                  
                 :  * TApplication class.                                                                                               
                 :  *                                                                                                                   
                 :  * TApplication coordinates modules and services, and serves as a configuration                                      
                 :  * context for all Prado components.                                                                                 
                 :  *                                                                                                                   
                 :  * TApplication uses a configuration file to specify the settings of                                                 
                 :  * the application, the modules, the services, the parameters, and so on.                                            
                 :  *                                                                                                                   
                 :  * TApplication adopts a modular structure. A TApplication instance is a composition                                 
                 :  * of multiple modules. A module is an instance of class implementing                                                
                 :  * {@link IModule} interface. Each module accomplishes certain functionalities                                       
                 :  * that are shared by all Prado components in an application.                                                        
                 :  * There are default modules and user-defined modules. The latter offers extreme                                     
                 :  * flexibility of extending TApplication in a plug-and-play fashion.                                                 
                 :  * Modules cooperate with each other to serve a user request by following                                            
                 :  * a sequence of lifecycles predefined in TApplication.                                                              
                 :  *                                                                                                                   
                 :  * TApplication has four modes that can be changed by setting {@link setMode Mode}                                   
                 :  * property (in the application configuration file).                                                                 
                 :  * - <b>Off</b> mode will prevent the application from serving user requests.                                        
                 :  * - <b>Debug</b> mode is mainly used during application development. It ensures                                     
                 :  *   the cache is always up-to-date if caching is enabled. It also allows                                            
                 :  *   exceptions are displayed with rich context information if they occur.                                           
                 :  * - <b>Normal</b> mode is mainly used during production stage. Exception information                                
                 :  *   will only be recorded in system error logs. The cache is ensured to be                                          
                 :  *   up-to-date if it is enabled.                                                                                    
                 :  * - <b>Performance</b> mode is similar to <b>Normal</b> mode except that it                                         
                 :  *   does not ensure the cache is up-to-date.                                                                        
                 :  *                                                                                                                   
                 :  * TApplication dispatches each user request to a particular service which                                           
                 :  * finishes the actual work for the request with the aid from the application                                        
                 :  * modules.                                                                                                          
                 :  *                                                                                                                   
                 :  * TApplication maintains a lifecycle with the following stages:                                                     
                 :  * - [construct] : construction of the application instance                                                          
                 :  * - [initApplication] : load application configuration and instantiate modules and the requested service            
                 :  * - onBeginRequest : this event happens right after application initialization                                      
                 :  * - onAuthentication : this event happens when authentication is needed for the current request                     
                 :  * - onAuthenticationComplete : this event happens right after the authentication is done for the current request    
                 :  * - onAuthorization : this event happens when authorization is needed for the current request                       
                 :  * - onAuthorizationComplete : this event happens right after the authorization is done for the current request      
                 :  * - onLoadState : this event happens when application state needs to be loaded                                      
                 :  * - onLoadStateComplete : this event happens right after the application state is loaded                            
                 :  * - onPreRunService : this event happens right before the requested service is to run                               
                 :  * - runService : the requested service runs                                                                         
                 :  * - onSaveState : this event happens when application needs to save its state                                       
                 :  * - onSaveStateComplete : this event happens right after the application saves its state                            
                 :  * - onPreFlushOutput : this event happens right before the application flushes output to client side.               
                 :  * - flushOutput : the application flushes output to client side.                                                    
                 :  * - onEndRequest : this is the last stage a request is being completed                                              
                 :  * - [destruct] : destruction of the application instance                                                            
                 :  * Modules and services can attach their methods to one or several of the above                                      
                 :  * events and do appropriate processing when the events are raised. By this way,                                     
                 :  * the application is able to coordinate the activities of modules and services                                      
                 :  * in the above order. To terminate an application before the whole lifecycle                                        
                 :  * completes, call {@link completeRequest}.                                                                          
                 :  *                                                                                                                   
                 :  * Examples:                                                                                                         
                 :  * - Create and run a Prado application:                                                                             
                 :  * <code>                                                                                                            
                 :  * $application=new TApplication($configFile);                                                                       
                 :  * $application->run();                                                                                              
                 :  * </code>                                                                                                           
                 :  *                                                                                                                   
                 :  * @author Qiang Xue <qiang.xue@gmail.com>                                                                           
                 :  * @version $Id: TApplication.php 2244 2007-09-26 13:15:56Z xue $                                                    
                 :  * @package System                                                                                                   
                 :  * @since 3.0                                                                                                        
                 :  */                                                                                                                  
                 : class TApplication extends TComponent                                                                                
                 : {                                                                                                                    
                 : 	/**                                                                                                                 
                 : 	 * possible application mode.                                                                                       
                 : 	 * @deprecated deprecated since version 3.0.4 (use TApplicationMode constants instead)                              
                 : 	 */                                                                                                                 
                 : 	const STATE_OFF='Off';                                                                                              
                 : 	const STATE_DEBUG='Debug';                                                                                          
                 : 	const STATE_NORMAL='Normal';                                                                                        
                 : 	const STATE_PERFORMANCE='Performance';                                                                              
                 :                                                                                                                      
                 : 	/**                                                                                                                 
                 : 	 * Page service ID                                                                                                  
                 : 	 */                                                                                                                 
                 : 	const PAGE_SERVICE_ID='page';                                                                                       
                 : 	/**                                                                                                                 
                 : 	 * Application configuration file name                                                                              
                 : 	 */                                                                                                                 
                 : 	const CONFIG_FILE='application.xml';                                                                                
                 : 	/**                                                                                                                 
                 : 	 * File extension for external config files                                                                         
                 : 	 */