public function setDefaultComponentInterfaceFolder( $strDefaultComponentInterfaceFolder )
    {
        $this->strDefaultComponentInterfaceFolder = $strDefaultComponentInterfaceFolder;
    }

    /**

     private function checkIfClassBelongToGroup( $strClassName )
    {
        if( !$this->classBelongsToTheGroup( $strClassName ) )
        {
            throw new CorujaAutoLoadGroupException( "Class " . $strClassName . "don't belong to this group" );
        }
    }

    /**

     public static function getInstance()
    {
        if( self::$objInstance == null )
        {
            self::$objInstance = new CorujaBegins();
        }
        return self::$objInstance;
    }

    /**

     private static function requireOnce( $strFile )
    {
        require_once( $strFile );
    }

    /**

     public function setFrameworkFolder( $strFrameworkFolder )
    {
        $this->strFrameworkFolder = (string)$strFrameworkFolder;
    }

    /**

     public function loadXmlPath()
    {
        $strAdminPath = $this->strFrameworkFolder . self::FOLDER_CORUJA_ADMIN;
        $this->objXmlPath = simplexml_load_file( $strAdminPath . self::XML_PATH_CONFIG );
    }

     protected function getPatternFileStart()
    {
        return (string)$this->objXmlPath->pattern->start->file;
    }

    /**

     public function getComponentsPath()
    {
        return (string)$this->objXmlPath->components->path;
    }

    /**

     public function getComponentsInterfacePath()
    {
        return (string)$this->objXmlPath->components->interface->path;
    }

    /**

     public function getComponentsDefaultPath()
    {
        return (string)$this->objXmlPath->components->default->path;
    }

    /**

     public function getComponentsExtraPath()
    {
        return (string)$this->objXmlPath->components->extra->path;
    }

    /**

     protected function getAutoloadPath()
    {
        return (string)$this->objXmlPath->components->autoload->path;
    }

    /**

     protected function getLibraryPath()
    {
        return (string)$this->objXmlPath->components->library->path;
    }

    /**

     protected function getEnviromentsVarsPath()
    {
        return (string)$this->objXmlPath->components->enviromentvars->path;
    }

    /**

     public function getPublicPath()
    {
        return (string)$this->objXmlPath->public->path;
    }

    /**

     protected function loadFrameworkExceptions()
    {
        self::requireOnce( $this->getFrameworkFolder() . $this->getExceptionFolderPattern() . "/" . $this->getPatternFileStart() );
    }

    /**

     protected function loadFrameworkAutoLoadComponent()
    {

        $strComponentsExceptionFolder = $this->getFrameworkFolder() . $this->getComponentsPath() . "/" . $this->getExceptionFolderPattern() ;
        $this->includeDir( $strComponentsExceptionFolder );

        self::requireOnce(  $this->getFrameworkFolder() . $this->getComponentsInterfacePath() . "/" . $this->getAutoloadPath() . "/" . $this->getPatternFileStart()  );
        self::requireOnce(  $this->getFrameworkFolder() . $this->getComponentsDefaultPath() . "/" . $this->getAutoloadPath() . "/" . $this->getPatternFileStart() );

        CorujaAutoLoad::getInstance()->preLoadClassFolder( $this->getFrameworkFolder() . $this->getComponentsPath() . "/" .  $this->getAutoloadGroupFolderPattern()  );

    }

    /**

     protected function loadDefaultAutoloadGroups()
    {
        // autoload group of the default components //
        $objDefaultComponentAutoLoadGroup = new DefaultComponentAutoloadGroup();
        $objDefaultComponentAutoLoadGroup->setDefaultComponentFolder( $this->getFrameworkFolder() . $this->getComponentsDefaultPath() );
        CorujaAutoLoad::getInstance()->addAutoLoadGroup( $objDefaultComponentAutoLoadGroup );

        // autoload group of the default interfaces //
        $objDefaultInterfaceAutoloadGroup = new DefaultInterfaceAutoloadGroup();
        $objDefaultInterfaceAutoloadGroup->setDefaultComponentInterfaceFolder( $this->getFrameworkFolder() . $this->getComponentsInterfacePath() );
        CorujaAutoLoad::getInstance()->addAutoLoadGroup( $objDefaultInterfaceAutoloadGroup );

        // autoload group of the extra components //
        $objExtraComponentAutoLoadGroup = new ExtraComponentAutoloadGroup();
        $objExtraComponentAutoLoadGroup->setExtraComponentFolder( $this->getFrameworkFolder() . $this->getComponentsExtraPath() );
        CorujaAutoLoad::getInstance()->addAutoLoadGroup( $objExtraComponentAutoLoadGroup );

        // preload the library //
        CorujaAutoLoad::getInstance()->preLoadClassFolder( $this->getFrameworkFolder() . $this->getComponentsDefaultPath() . "/" . $this->getLibraryPath() );

        // preload the enviroments vars //
        CorujaAutoLoad::getInstance()->preLoadClassFolder( $this->getFrameworkFolder() . $this->getComponentsDefaultPath() . "/" . $this->getEnviromentsVarsPath() );
    }

    /**

     public function __construct()
    {
        $this->intMicrotimeBegin = microtime( true );
        ini_set( "display_errors", "On" );
        error_reporting( E_ALL | E_NOTICE | E_WARNING | E_STRICT );
    }

    /**

     public function __destruct()
    {
        $this->intMicrotimeEnd = microtime( true );
        print "\n<!-- " . ( $this->intMicrotimeEnd - $this->intMicrotimeBegin ) . " seconds -->";
    }

    /**

     public function perform()
    {
        $this->loadXmlPath();
        $this->loadFrameworkExceptions();
        $this->loadFrameworkAutoLoadComponent();
        $this->loadDefaultAutoloadGroups();
        CorujaComponentsManager::getInstance();
    }

    /**

     public function includeDir( $strDirName )
    {
        $objDir = dir( $strDirName );
        while( false !== ( $strFile = $objDir->read() ) )
        {
            if( substr( $strFile, -4) == ".php" )
            {
                self::requireOnce( $strDirName . "/" . $strFile );
            }
        }
    }

    /**

     public static function begin( $strFrameworkFolder )
    {
        $objCorujaBegins = self::getInstance();
        $objCorujaBegins->setFrameworkFolder( $strFrameworkFolder );
        $objCorujaBegins->perform();
    }

    public static function getCorujaFolderAdmin()

     public static function getCorujaFolderAdmin()
    {
        return self::getInstance()->getFrameworkFolder() . self::FOLDER_CORUJA_ADMIN;
    }

    public static function getCorujaFolderComponentsAdmin()

     public static function getCorujaFolderPublic()
    {
        return CorujaFileManipulation::removeRelativeSlicesOfFile( 
            self::getInstance()->getFrameworkFolder() .
            self::getInstance()->getPublicPath() .
            "/"
        );
    }

    public static function getCorujaFolderComponentsDefault()

     public static function getCorujaFolderComponentsDefault()
    {
        return CorujaFileManipulation::removeRelativeSlicesOfFile( 
            self::getInstance()->getFrameworkFolder() .
            self::getInstance()->getComponentsDefaultPath() .
            "/"
        );
    }
}
?>

     public static function getInstance()
    {
        if( self::$objCorujaAutoLoad == null )
        {
            self::$objCorujaAutoLoad = new CorujaAutoLoad();
        }
        return self::$objCorujaAutoLoad;
    }

    /**

     public static function getFileNameByClass( $strClassName )
    {
        CorujaAutoLoad::getInstance()->loadClass( $strClassName );
        $strFileName = CorujaAutoLoad::getInstance()->getFilefromClass( $strClassName );
        if( $strFileName == null )
        {
            if( !class_exists( $strClassName ) )
            {
                throw new CorujaAutoLoadException( "Unable to find the file of the class $strClassName " );
            }
            $objReflection = new ReflectionClass( $strClassName );
            $strFileName = $objReflection->getFileName();
        }
        return $strFileName;
    }

    /**

     public function addAutoLoadGroupFolder( $strFolder )
    {
        $strDirName = $strFolder . "/" . $this->getAutoLoadFolderPattern() ;
        $oDirExceptions = dir( $strDirName );
        while( false !== ( $strFile = $oDirExceptions->read() ) )
        {
            if( substr( $strFile, -4) == ".php" )
            {
                require_once( $strDirName . "/" . $strFile );
                $strClassName = substr( $strFile , 0 , strpos( $strFile , "." ) );
                $objElement = new $strClassName();
                if( $objElement instanceof CorujaAutoLoadGroupInterface )
                {
                    $this->addAutoLoadGroup( $objElement ) ;
                }
                else
                {
                    throw new CorujaAutoLoadException( "The Class " . $strClassName . " it is not a Coruja Autoload Group Interface" );
                }
            }
        }
    }

    /**

     public function addAutoLoadGroup( CorujaAutoLoadGroupInterface $objAutoLoadGroup )
    {
        $this->arrAutoLoadGroups[] = $objAutoLoadGroup;
    }

    public function removeAutoLoadGroup( CorujaAutoLoadGroupInterface $objAutoLoadGroup )

     public function removeAutoLoadGroup( CorujaAutoLoadGroupInterface $objAutoLoadGroup )
    {
        foreach( $this->arrAutoLoadGroups as $intKey => $objAutoLoadGroupElement )
        {
            if( $objAutoLoadGroupElement == $objAutoLoadGroup )
            {
                array_splice( $this->arrAutoLoadGroups , $intKey , 1 );
            }
        }
    }

    /**

     public function getFilefromClass( $strClassName )
    {
        return CorujaArrayManipulation::getArrayField( $this->arrAutoLoadClassFile , $strClassName );
    }

    /**

     public function loadClass( $strClassName )
    {
        $strClassName = (string)$strClassName;
        $arrFilesNames = array();
        
        if( array_key_exists( $strClassName, $this->arrAutoLoadClassFile ) )
        {
            $strFileName = $this->arrAutoLoadClassFile[ $strClassName ];
            $arrFilesNames[] = $strFileName;
            if( $this->tryLoadClass( $strFileName, $strClassName ) )
            {
                return true;
            }
        }
        foreach( $this->arrAutoLoadGroups as $objAutoLoadGroup )
        {
            /**
             * @var $objAutoLoadGroup CorujaAutoLoadGroupInterface
             */
            if( $objAutoLoadGroup->classBelongsToTheGroup( $strClassName ) )
            {
                $strFileName = $objAutoLoadGroup->getTheFileNameOfTheClass( $strClassName );
                $arrFilesNames[] = $strFileName;
                if( $this->tryLoadClass( $strFileName, $strClassName ) )
                {
                    $objAutoLoadGroup->onLoadClass( $strClassName );
                    return true;
                }
            }
        }
        if( !class_exists( $strClassName , false ) && !interface_exists( $strClassName , false ) )
        {
            if( strlen( $strClassName ) == 0 )
            {
                throw new Exception( "Invalid Autoload Request, Empty class Name");
            }

            $strLowerClass = strtolower( $strClassName );
            if( 
                ! in_array(
                    $strLowerClass[0] ,
                    array( 'a' , 'b' , 'c' , 'd' , 'e' , 'f' , 'g' , 'h' , 'i' ,
                           'j' , 'k' , 'l' , 'm' , 'n' , 'o' , 'p' , 'q' , 'r' ,
                           's' , 't' , 'v' , 'v' , 'x' , 'y' , 'w' , 'z' 
                    )
                )
            )
            {
                throw new Exception( "Invalid Class Name $strClassName!");
            }

            try
            {
                $strClassNotFounded = 'class ' . $strClassName . ' extends CorujaNotFoundedClass
                  {
                    protected static $strClassName = "' . $strClassName . '";
                  }
                 ';
                eval( $strClassNotFounded );
            }
            catch( Exception $objError )
            {
                // nothing //
            }
            throw new Exception( " Unabled to find the file of the class "   . $strClassName . ". File exists into: " . implode( "\n" , $arrFilesNames ) . " ? ");
        }
    }

    /**

     public function preLoadClassFile( $strClassName, $strFileName )
    {
        $this->arrAutoLoadClassFile[ $strClassName ] = $strFileName;
    }

    /**

     public function preLoadClassFolder( $strClassFolder )
    {
        $oDirExceptions = dir( $strClassFolder );
        while( false !== ( $strFileName = $oDirExceptions->read() ) )
        {
            if( substr( $strFileName, -4) == ".php" )
            {
                $strClassName = substr( $strFileName , 0 , strpos( $strFileName , "." ) );
                $this->preLoadClassFile( $strClassName , $strClassFolder . "/" . $strFileName);
            }
        }
    }

    public function classExists( $strClassName )

     public function classExists( $strClassName )
    {
    
        if( in_array( $strClassName , array( "integer" , "string" , "number" , "float" ) ) )
        {
            return false;
        }
        
        try
        {
            $this->loadClass( $strClassName );
        }
        catch( Exception $objException )
        {
            return false;
        }
        if( get_parent_class( $strClassName ) == 'CorujaNotFoundedClass' )
        {
            return false;
        }
        else

     public function setDefaultComponentFolder( $strComponentFolder )
    {
        $this->strDefaultComponentFolder = $strComponentFolder;
    }

    /**

     public function classBelongsToTheGroup( $strClassName )
    {
        if( self::DEFAULT_COMPONENT_PREFIX != "" )
        {
            if ( strpos( $strClassName , self::DEFAULT_COMPONENT_PREFIX ) != 0 )
            {
                return false;
            }
        }
        if( self::DEFAULT_COMPONENT_SUFIX != "" )
        {
            if ( strpos( $strClassName , self::DEFAULT_COMPONENT_SUFIX ) != 0 )
            {
                return false;
            }
        }
        return true;
    }

    /**

     private function checkIfClassBelongToGroup( $strClassName )
    {
        if( !$this->classBelongsToTheGroup( $strClassName ) )
        {
            throw new CorujaAutoLoadGroupException( "Class " . $strClassName . "don't belong to this group" );
        }
    }

    /**

     public function onLoadClass( $strClassName )
    {
        $strFolderName = $this->getTheFolderName( $strClassName );
        $this->loadFolder( $strFolderName , $strClassName );

        $strExceptionFolder = $strFolderName . "/" . CorujaBegins::getInstance()->getExceptionFolderPattern() . "/";
        if( is_dir( $strExceptionFolder ) )
        {
            $this->loadFolder( $strExceptionFolder , $strClassName );
        }

        $strAutoloadFolder =  $strFolderName . "/" . CorujaBegins::getInstance()->getAutoloadGroupFolderPattern() . "/";
        if( is_dir( $strAutoloadFolder ) )
        {
            $this->loadFolder( $strAutoloadFolder , $strClassName );
        }
    }

    /**

 class CorujaComponentsManager implements CorujaComponentsManagerInterface
{
    /**
     * Singleton of the class
     * @var CorujaComponentsManager
     */
    protected static $objInstance;

    /**
     *
     * @var CorujaTree
     */
    protected $objConfiguration;

    /**
     * Error Component
     *
     * @var CorujaErrorInterface
     */
    protected $objErrorComponent;

    /**
     * Check if the Error Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booErrorLoaded = false;

    /**
     * Log Component
     *
     * @var CorujaLogInterface
     */
    protected $objLogComponent;

    /**
     * Check if the Log Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booLogLoaded = false;

    /**
     * Cache Component
     *
     * @var CorujaCacheInterface
     */
    protected $objCacheComponent;

    /**
     * Check if the Cache Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booCacheLoaded = false;

    /**
     * Xml 2 Php Component
     *
     * @var CorujaXml2PhpInterface
     */
    protected $objXml2PhpComponent;

    /**
     * Check if the Xml2Php Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booXml2PhpLoaded = false;

    /**
     * Authentication Component
     *
     * @var CorujaAuthenticationInterface
     */
    protected $objAuthenticationComponent;

    /**
     * Check if the Authentication Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booAuthenticationLoaded = false;

    /**
     * Permission Component
     *
     * @var CorujaPermissionInterface
     */
    protected $objPermissionComponent;

    /**
     * Check if the Permission Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booPermissionLoaded = false;

    /**
     * Profile Component
     *
     * @var CorujaProfileInterface
     */
    protected $objProfileComponent;

    /**
     * Check if the Profile Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booProfileLoaded = false;

    /**
     * Annotation Component
     *
     * @var CorujaAnnotationInterface
     */
    protected $objAnnotationComponent;

    /**
     * Check if the Annotation Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booAnnotationLoaded = false;

    /**
     * Exception Handler Component
     *
     * @var Component
     */
    protected $objExceptionHandlerComponent;

    /**
     * Check if the Exception Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booExceptionLoaded = false;

    /**
     * Backtrace Component
     *
     * @var CorujaBacktraceInterface
     */
    protected $objBacktraceComponent;

    /**
     * Check if the Backtrace Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booBacktraceLoaded = false;

    /**
     * Backtrace Explain Component
     *
     * @var CorujaBackTraceExplainInterface
     */
    protected $objBacktraceExplainComponent;

    /**
     * Check if the Backtrace Explain Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booBacktraceExplainLoaded = false;

    /**
     * Session Component
     *
     * @var CorujaSessionInterface
     */
    protected $objSessionComponent;

    /**
     * Check if the Session Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booSessionLoaded = false;

    /**
     * Template Component
     *
     * @var CorujaTemplateInterface
     */
    protected $objTemplateComponent;

    /**
     * Check if the Template Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booTemplateLoaded = false;

    /**
     * Database Component
     *
     * @var CorujaDatabaseInterface
     */
    protected $objDatabaseComponent;

    /**
     * Check if the Database Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booDatabaseLoaded = false;

    /**
     * Query Filter Component
     *
     * @var CorujaQueryFilterInterface
     */
    protected $objQueryFilterComponent;

    /**
     * Check if the Query Filter Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booQueryFilterLoaded = false;

    /**
     * Coruja Request Component
     *
     * @var CorujaRequestInterface
     */
    protected $objRequestComponent;

    /**
     * Check if the Request Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booRequestLoaded = false;

    /**
     * Coruja Layer Component
     *
     * @var CorujaLayers
     */
    protected $objLayersComponent;

    /**
     * Check if the Layers Component already as load, or try to load
     *
     * @var boolean
     */
    protected $booLayersLoaded = false;

    /**
     *
     * @return CorujaComponentsManager
     */
    public static function getInstance()
    {
        if( self::$objInstance === null )
        {
            self::$objInstance = new CorujaComponentsManager();
        }
        return self::$objInstance;
    }

    public function loadConfiguration()
    {
        return CorujaComponentsManagerConfig::load();
    }

    public function  __construct()
    {

        $this->objConfiguration = $this->loadConfiguration();
        $arrChildNodes = $this->objConfiguration->getChildNodes();
        foreach( $arrChildNodes as $objChildNode )
        {
            /**
             * @var $objChildNode CorujaTree
             */
            if( !$objChildNode->isTextNode() && $objChildNode->autostart == "true")
            {
                $this->loadComponent( $objChildNode );
            }
        }
    }

    /**
     * Load a component by its name
     *
     * @param string $strComponentName
     */
    protected function loadComponentByName( $strComponentName )
    {
        if( $this->objConfiguration->hasChildNode( $strComponentName ) )
        {
            $strMethod = "get" . ucfirst( strtolower( $strComponentName ) );
            $objChildNode = $this->objConfiguration->$strMethod();
            $this->loadComponent( $objChildNode );
        }
    }

    /**
     * Load a component by its configuration coruja tree
     *
     * @param CorujaTree $objChildNode
     */
    protected function loadComponent( CorujaTree $objChildNode )
    {
        $strTagName = ( $objChildNode->getNodeName() );
        $strComponentName = ( $objChildNode->componentname );

        $strMethodName = "set" . ucfirst( strtolower( $strTagName ) ) . "Component";
        if( !method_exists($this, $strMethodName ) )
        {
            throw new CorujaComponentManagerException( "Invalid component element " . $strMethodName , " to the component mananger " );
        }

        if( !class_exists( $strComponentName ) )
        {
            throw new CorujaComponentManagerException( "Invalid component class " . $strComponentName , " to the component mananger " );
        }
        $objElement = new $strComponentName();
        $this->$strMethodName( $objElement );
    }

    /**
     * Try, to load the error component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadErrorComponent()
    {
        if( $this->objErrorComponent == null && $this->booErrorLoaded == false )
        {
            $this->booErrorLoaded = true;
            $this->loadComponentByName( "Error" );
        }
    }

    /**
     * Set the Error Component
     *
     * @param CorujaErrorInterface $objErrorComponent
     */
    public function setErrorComponent( CorujaErrorInterface $objErrorComponent )
    {
        $this->objErrorComponent = $objErrorComponent;
    }

    /**
     * Return a Error Component
     *
     * @return CorujaErrorInterface
     */
    public function getErrorComponent()
    {
        $this->loadErrorComponent();
        if( $this->objErrorComponent == null )
        {
            throw new CorujaException( "No Error Component was defined. Without it you can not use Error resources." );
        }
        return $this->objErrorComponent;
    }

    /**
     * Has a Error component
     *
     * @return boolean
     */
    public function hasErrorComponent()
    {
        $this->loadErrorComponent();
        return ( $this->objErrorComponent !== null );
    }

    /**
     * Try, to load the Log component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadLogComponent()
    {
        if( $this->objLogComponent == null && $this->booLogLoaded == false )
        {
            $this->booLogLoaded = true;
            $this->loadComponentByName( "Log" );
        }
    }

    /**
     * Set the Log Component
     *
     * @param CorujaLogInterface $objLogComponent
     */
    public function setLogComponent( CorujaLogInterface $objLogComponent )
    {
        $this->objLogComponent = $objLogComponent;
    }

    /**
     * Return a Log Component
     *
     * @return CorujaLogInterface
     */
    public function getLogComponent()
    {
        $this->loadLogComponent();
        if( $this->objLogComponent == null )
        {
            throw new CorujaException( "No Log Component was defined. Without it you can not use Log resources." );
        }
        return $this->objLogComponent;
    }

    /**
     * Has Log Component Component
     *
     * @return boolean
     */
    public function hasLogComponent()
    {
        $this->loadLogComponent();
        return ( $this->objLogComponent !== null );
    }

    /**
     * Try, to load the Cache component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadCacheComponent()
    {
        if( $this->objCacheComponent == null && $this->booCacheLoaded == false )
        {
            $this->booCacheLoaded = true;
            $this->loadComponentByName( "Cache" );
        }
    }

    /**
     * Set the Cache Component
     *
     * @param CorujaCacheInterface $objCacheComponent
     */
    public function setCacheComponent( CorujaCacheInterface $objCacheComponent )
    {
        $this->objCacheComponent = $objCacheComponent;
    }

    /**
     * Get The Cache Component
     *
     * @return CorujaCacheInterface
     */
    public function getCacheComponent()
    {
        $this->loadCacheComponent();
        if( $this->objCacheComponent == null )
        {
            throw new CorujaException( "No Template Cache Component was defined. Without it you can not use Cache resources." );
        }
        return $this->objCacheComponent;
    }

    /**
     * Has Cache Component
     *
     * @return boolean
     */
    public function hasCacheComponent()
    {
        $this->loadCacheComponent();
        return ( $this->objCacheComponent !== null );
    }

    /**
     * Try, to load the Xml2Php component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadXml2PhpComponent()
    {
        if( $this->objXml2PhpComponent == null && $this->booXml2PhpLoaded == false )
        {
            $this->booXml2PhpLoaded = true;
            $this->loadComponentByName( "Xml2Php" );
        }
    }

    /**
     * Set the Template Xml To Script Component
     *
     * @param CorujaXml2PhpInterface $objXml2PhpComponent
     */
    public function setXml2PhpComponent( CorujaXml2PhpInterface $objXml2PhpComponent )
    {
        $this->objXml2PhpComponent = $objXml2PhpComponent;
    }

    /**
     * Get The Template Xml To Script Component
     *
     * @return CorujaXml2PhpInterface
     */
    public function getXml2PhpComponent()
    {
        $this->loadXml2PhpComponent();
        if( $this->objXml2PhpComponent == null )
        {
            throw new CorujaException( "No Component Conversor of Template Xml to Script was defined. Without it you can not use Xml to Script resources." );
        }
        return $this->objXml2PhpComponent;
    }

    /**
     * Has Template Xml To Script Component
     *
     * @return boolean
     */
    public function hasXml2PhpComponent()
    {
        $this->loadXml2PhpComponent();
        return ( $this->objXml2PhpComponent !== null );
    }

    /**
     * Try, to load the Request component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadRequestComponent()
    {
        if( $this->objRequestComponent == null && $this->booRequestLoaded == false )
        {
            $this->booRequestLoaded = true;
            $this->loadComponentByName( "Request" );
        }
    }

    /**
     * Set the Request Component
     *
     * @param CorujaRequestInterface $objRequestComponent
     */
    public function setRequestComponent( CorujaRequestInterface $objRequestComponent )
    {
        $this->objRequestComponent = $objRequestComponent;
    }

    /**
     * Get The Request Component
     *
     * @return CorujaRequestInterface
     */
    public function getRequestComponent()
    {
        $this->loadRequestComponent();
        if( $this->objRequestComponent == null )
        {
            throw new CorujaException( "No Request Component was defined. Without it you can not use Request resources." );
        }
        return $this->objRequestComponent;
    }

    /**
     * Has Request Component
     *
     * @return boolean
     */
    public function hasRequestComponent()
    {
        $this->loadRequestComponent();
        return ( $this->objRequestComponent !== null );
    }

    /**
     * Try, to load the Request component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadTemplateComponent()
    {
        if( $this->objTemplateComponent == null && $this->booTemplateLoaded == false )
        {
            $this->booTemplateLoaded = true;
            $this->loadComponentByName( "Template" );
        }
    }

    /**
     * Set the Template Component
     *
     * @param CorujaTemplateInterface $objTemplateComponent
     */
    public function setTemplateComponent( $objTemplateComponent )
    {
        $this->objTemplateComponent = $objTemplateComponent;
    }

    /**
     * Get The Template Component
     *
     * @return CorujaTemplateInterface
     */
    public function getTemplateComponent()
    {
        $this->loadTemplateComponent();
        if( $this->objTemplateComponent == null )
        {
            throw new CorujaException( "No Template Component was defined. Without it you can not use Template resources." );
        }
        return $this->objTemplateComponent;
    }

    /**
     * Has Template Component
     *
     * @return boolean
     */
    public function hasTemplateComponent()
    {
        $this->loadTemplateComponent();
        return ( $this->objTemplateComponent !== null );
    }

    /**
     * Try, to load the Layers component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadLayersComponent()
    {
        if( $this->objLayersComponent == null && $this->booLayersLoaded == false )
        {
            $this->booLayersLoaded = true;
            $this->loadComponentByName( "Layers" );
        }
    }

    /**
     * Set the Layers Component
     *
     * @param CorujaLayersInterface $objLayersComponent
     */
    public function setLayersComponent( $objLayersComponent )
    {
        $this->objLayersComponent = $objLayersComponent;
    }

    /**
     * Get The Layers Component
     *
     * @return CorujaLayersInterface
     */
    public function getLayersComponent()
    {
        $this->loadLayersComponent();
        if( $this->objLayersComponent == null )
        {
            throw new CorujaException( "No Layers Component was defined. Without it you can not use Layers resources." );
        }
        return $this->objLayersComponent;
    }

    /**
     * Has Layers Component
     *
     * @return boolean
     */
    public function hasLayersComponent()
    {
        $this->loadLayersComponent();
        return ( $this->objLayersComponent !== null );
    }

    /**
     * Try, to load the Authentication component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadAuthenticationComponent()
    {
        if( $this->objAuthenticationComponent == null && $this->booAuthenticationLoaded == false )
        {
            $this->booAuthenticationLoaded = true;
            $this->loadComponentByName( "Authentication" );
        }
    }

    /**
     * Set The Authentication Component
     *
     * @param CorujaAuthenticationInterface $objAuthenticationComponent
     */
    public function setAuthenticationComponent( CorujaAuthenticationInterface $objAuthenticationComponent )
    {
        $this->objAuthenticationComponent = $objAuthenticationComponent;
    }

    /**
     * Get the Authentication Component
     *
     * @return CorujaAuthenticationInterface
     */
    public function getAuthenticationComponent()
    {
        $this->loadAuthenticationComponent();
        if( $this->objAuthenticationComponent == null )
        {
            throw new CorujaException( "No Authentication Component was defined. Without it you cannot use Authentication resources." );
        }
        return $this->objAuthenticationComponent;
    }

    /**
     * Has Authentication Component
     *
     * @return boolean
     */
    public function hasAuthenticationComponent()
    {
        $this->loadAuthenticationComponent();
        return ( $this->objAuthenticationComponent !== null );
    }

    /**
     * Try, to load the Permission component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadPermissionComponent()
    {
        if( $this->objPermissionComponent == null && $this->booPermissionLoaded == false )
        {
            $this->booPermissionLoaded = true;
            $this->loadComponentByName( "Permission" );
        }
    }

    /**
     * Set The Permission Component
     *
     * @param CorujaPermissionInterface $objPermissionComponent
     */
    public function setPermissionComponent( CorujaPermissionInterface $objPermissionComponent )
    {
        $this->objPermissionComponent = $objPermissionComponent;
    }

    /**
     * Get the Permission Component
     *
     * @return CorujaPermissionInterface
     */
    public function getPermissionComponent()
    {
        $this->loadPermissionComponent();
        if( $this->objPermissionComponent == null )
        {
            throw new CorujaException( "No Permission Component was defined. Without it you cannot use Permission resources." );
        }
        return $this->objPermissionComponent;
    }

    /**
     * Has Permission Component
     *
     * @return boolean
     */
    public function hasPermissionComponent()
    {
        $this->loadPermissionComponent();
        return ( $this->objPermissionComponent !== null );
    }

    /**
     * Try, to load the Profile component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadProfileComponent()
    {
        if( $this->objProfileComponent == null && $this->booProfileLoaded == false )
        {
            $this->booProfileLoaded = true;
            $this->loadComponentByName( "Profile" );
        }
    }

    /**
     * Set The Profile Component
     *
     * @param CorujaProfileInterface $objProfileComponent
     */
    public function setProfileComponent( CorujaProfileInterface $objProfileComponent )
    {
        $this->objProfileComponent = $objProfileComponent;
    }

    /**
     * Get the Profile Component
     *
     * @return CorujaProfileInterface
     */
    public function getProfileComponent()
    {
        $this->loadProfileComponent();
        if( $this->objProfileComponent == null )
        {
            throw new CorujaException( "No Profile Component was defined. Without it you cannot use Profile resources." );
        }
        return $this->objProfileComponent;
    }

    /**
     * Has Profile Component
     *
     * @return boolean
     */
    public function hasProfileComponent()
    {
        $this->loadProfileComponent();
        return ( $this->objProfileComponent !== null );
    }

    /**
     * Try, to load the Annotation component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadAnnotationComponent()
    {
        if( $this->objAnnotationComponent == null && $this->booAnnotationLoaded == false )
        {
            $this->booAnnotationLoaded = true;
            $this->loadComponentByName( "Annotation" );
        }
    }

    /**
     * Set The Annotation Component
     *
     * @param CorujaAnnotationInterface $objAnnotationComponent
     */
    public function setAnnotationComponent( CorujaAnnotationInterface $objAnnotationComponent )
    {
        $this->objAnnotationComponent = $objAnnotationComponent;
    }

    /**
     * Get the Annotation Component
     *
     * @return CorujaAnnotationInterface
     */
    public function getAnnotationComponent()
    {
        $this->loadAnnotationComponent();
        if( $this->objAnnotationComponent == null )
        {
            throw new CorujaException( "No Annotation Component was defined. Without it you cannot use Annotation resources." );
        }
        return $this->objAnnotationComponent;
    }

    /**
     * Has Annotation Component
     *
     * @return boolean
     */
    public function hasAnnotationComponent()
    {
        $this->loadAnnotationComponent();
        return ( $this->objAnnotationComponent !== null );
    }

    /**
     * Try, to load the Exception Handler component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadExceptionHandlerComponent()
    {
        if( $this->objExceptionHandlerComponent == null && $this->booExceptionHandlerLoaded == false )
        {
            $this->booExceptionHandlerLoaded = true;
            $this->loadComponentByName( "ExceptionHandler" );
        }
    }

    /**
     * Set The Exception Handler Component
     *
     * @param CorujaExceptionHandlerInterface $objExceptionHandlerComponent
     */
    public function setExceptionHandlerComponent( CorujaExceptionHandlerInterface  $objExceptionHandlerComponent )
    {
        $this->objExceptionHandlerComponent = $objExceptionHandlerComponent;
        $arrExceptionCaller = array( $this->objExceptionHandlerComponent, "handle" );
        set_exception_handler( $arrExceptionCaller );
    }

    /**
     * Get the Exception Handler Component
     *
     * @return CorujaExceptionHandlerInterface
     */
    public function getExceptionHandlerComponent()
    {
        $this->loadExceptionHandlerComponent();
        if( $this->objExceptionHandlerComponent == null )
        {
            throw new CorujaException( "No Exception Handler Component was defined. Without it you cannot use Exception Handler resources." );
        }
        return $this->objExceptionHandlerComponent;
    }

    /**
     * Has Exception Handler Component
     *
     * @return boolean
     */
    public function hasExceptionHandlerComponent()
    {
        $this->loadExceptionHandlerComponent();
        return ( $this->objExceptionHandlerComponent !== null );
    }

    /**
     * Try, to load the Backtrace component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadBacktraceComponent()
    {
        if( $this->objBacktraceComponent == null && $this->booBacktraceLoaded == false )
        {
            $this->booBacktraceLoaded = true;
            $this->loadComponentByName( "Backtrace" );
        }
    }

    /**
     * Set The Backtrace Component
     *
     * @param CorujaBackTraceInterface $objBackTraceComponent
     */
    public function setBacktraceComponent( CorujaBackTraceInterface  $objBackTraceComponent )
    {
        $this->objBacktraceComponent = $objBackTraceComponent;
    }

    /**
     * Get the Backtrace Component
     *
     * @return CorujaBackTraceInterface
     */
    public function getBacktraceComponent()
    {
        $this->loadBacktraceComponent();
        if( $this->objBacktraceComponent == null )
        {
            throw new CorujaException( "No Backtrace Component was defined. Without it you cannot use Backtrace resources." );
        }
        return $this->objBacktraceComponent;
    }

    /**
     * Has Backtrace Component
     *
     * @return boolean
     */
    public function hasBacktraceComponent()
    {
        $this->loadBacktraceComponent();
        return ( $this->objBacktraceComponent !== null );
    }

    /**
     * Try, to load the Backtrace Explain component into the configurations in case of it
     * don't be auto started. This attempt will be execute just one time by
     * execution.
     */
    public function loadBacktraceExplainComponent()
    {
        if( $this->objBacktraceExplainComponent == null && $this->booBacktraceExplainLoaded == false )
        {
            $this->booBacktraceExplainLoaded = true;
            $this->loadComponentByName( "BacktraceExplain" );
        }
    }

    /**
     * Set The Backtrace Component
     *
     * @param CorujaBackTraceExplainInterface $objBackTraceExplainComponent
     */
    public function setBacktraceExplainComponent( CorujaBackTraceExplainInterface $objBackTraceExplainComponent )
    {
        $this->objBackTraceExplainComponent = $objBackTraceExplainComponent;
    }

    /**
     * Get the Backtrace Explain Component
     *
     * @return CorujaBackTraceExplainInterface
     */
    public function getBacktraceExplainComponent()
    {
        $this->loadBacktraceExplainComponent();
        if( $this->objBackTraceExplainComponent == null )
        {
            throw new CorujaException( "No Backtrace Explain Component was defined. Without it you cannot use Backtrace Explain resources." );
        }
        return $this->objBackTraceExplainComponent;
    }

    /**
     * Has Backtrace Explain Component
     *
     * @return boolean
     */
    public function hasBacktraceExplainComponent()
    {
        $this->loadBacktraceExplainComponent();
        return ( $this->objBacktraceExplainComponent !== null );
    }
}
?>

     public static function getInstance()
    {
        if( self::$objInstance === null )
        {
            self::$objInstance = new CorujaComponentsManager();
        }
        return self::$objInstance;
    }

    public function loadConfiguration()

     public function loadConfiguration()
    {
        return CorujaComponentsManagerConfig::load();
    }

    public function  __construct()

     public function  __construct()
    {

        $this->objConfiguration = $this->loadConfiguration();
        $arrChildNodes = $this->objConfiguration->getChildNodes();
        foreach( $arrChildNodes as $objChildNode )
        {
            /**
             * @var $objChildNode CorujaTree
             */
            if( !$objChildNode->isTextNode() && $objChildNode->autostart == "true")
            {
                $this->loadComponent( $objChildNode );
            }
        }
    }

    /**

     public function loadErrorComponent()
    {
        if( $this->objErrorComponent == null && $this->booErrorLoaded == false )
        {
            $this->booErrorLoaded = true;
            $this->loadComponentByName( "Error" );
        }
    }

    /**

     public function setErrorComponent( CorujaErrorInterface $objErrorComponent )
    {
        $this->objErrorComponent = $objErrorComponent;
    }

    /**

     public function hasErrorComponent()
    {
        $this->loadErrorComponent();
        return ( $this->objErrorComponent !== null );
    }

    /**

     public function loadCacheComponent()
    {
        if( $this->objCacheComponent == null && $this->booCacheLoaded == false )
        {
            $this->booCacheLoaded = true;
            $this->loadComponentByName( "Cache" );
        }
    }

    /**

     public function setCacheComponent( CorujaCacheInterface $objCacheComponent )
    {
        $this->objCacheComponent = $objCacheComponent;
    }

    /**

     public function getCacheComponent()
    {
        $this->loadCacheComponent();
        if( $this->objCacheComponent == null )
        {
            throw new CorujaException( "No Template Cache Component was defined. Without it you can not use Cache resources." );
        }
        return $this->objCacheComponent;
    }

    /**

     public function hasCacheComponent()
    {
        $this->loadCacheComponent();
        return ( $this->objCacheComponent !== null );
    }

    /**

     public function loadXml2PhpComponent()
    {
        if( $this->objXml2PhpComponent == null && $this->booXml2PhpLoaded == false )
        {
            $this->booXml2PhpLoaded = true;
            $this->loadComponentByName( "Xml2Php" );
        }
    }

    /**

     public function setXml2PhpComponent( CorujaXml2PhpInterface $objXml2PhpComponent )
    {
        $this->objXml2PhpComponent = $objXml2PhpComponent;
    }

    /**

     public function getXml2PhpComponent()
    {
        $this->loadXml2PhpComponent();
        if( $this->objXml2PhpComponent == null )
        {
            throw new CorujaException( "No Component Conversor of Template Xml to Script was defined. Without it you can not use Xml to Script resources." );
        }
        return $this->objXml2PhpComponent;
    }

    /**

     public function hasXml2PhpComponent()
    {
        $this->loadXml2PhpComponent();
        return ( $this->objXml2PhpComponent !== null );
    }

    /**

     public function loadRequestComponent()
    {
        if( $this->objRequestComponent == null && $this->booRequestLoaded == false )
        {
            $this->booRequestLoaded = true;
            $this->loadComponentByName( "Request" );
        }
    }

    /**

     public function setRequestComponent( CorujaRequestInterface $objRequestComponent )
    {
        $this->objRequestComponent = $objRequestComponent;
    }

    /**

     public function getRequestComponent()
    {
        $this->loadRequestComponent();
        if( $this->objRequestComponent == null )
        {
            throw new CorujaException( "No Request Component was defined. Without it you can not use Request resources." );
        }
        return $this->objRequestComponent;
    }

    /**

     public function hasRequestComponent()
    {
        $this->loadRequestComponent();
        return ( $this->objRequestComponent !== null );
    }

    /**

     public function loadTemplateComponent()
    {
        if( $this->objTemplateComponent == null && $this->booTemplateLoaded == false )
        {
            $this->booTemplateLoaded = true;
            $this->loadComponentByName( "Template" );
        }
    }

    /**

     public function setTemplateComponent( $objTemplateComponent )
    {
        $this->objTemplateComponent = $objTemplateComponent;
    }

    /**

     public function getTemplateComponent()
    {
        $this->loadTemplateComponent();
        if( $this->objTemplateComponent == null )
        {
            throw new CorujaException( "No Template Component was defined. Without it you can not use Template resources." );
        }
        return $this->objTemplateComponent;
    }

    /**

     public function hasTemplateComponent()
    {
        $this->loadTemplateComponent();
        return ( $this->objTemplateComponent !== null );
    }

    /**

     public function loadLayersComponent()
    {
        if( $this->objLayersComponent == null && $this->booLayersLoaded == false )
        {
            $this->booLayersLoaded = true;
            $this->loadComponentByName( "Layers" );
        }
    }

    /**

     public function setLayersComponent( $objLayersComponent )
    {
        $this->objLayersComponent = $objLayersComponent;
    }

    /**

     public function getLayersComponent()
    {
        $this->loadLayersComponent();
        if( $this->objLayersComponent == null )
        {
            throw new CorujaException( "No Layers Component was defined. Without it you can not use Layers resources." );
        }
        return $this->objLayersComponent;
    }

    /**

     public function hasLayersComponent()
    {
        $this->loadLayersComponent();
        return ( $this->objLayersComponent !== null );
    }

    /**

     public function loadAuthenticationComponent()
    {
        if( $this->objAuthenticationComponent == null && $this->booAuthenticationLoaded == false )
        {
            $this->booAuthenticationLoaded = true;
            $this->loadComponentByName( "Authentication" );
        }
    }

    /**

     public function setAuthenticationComponent( CorujaAuthenticationInterface $objAuthenticationComponent )
    {
        $this->objAuthenticationComponent = $objAuthenticationComponent;
    }

    /**

     public function getAuthenticationComponent()
    {
        $this->loadAuthenticationComponent();
        if( $this->objAuthenticationComponent == null )
        {
            throw new CorujaException( "No Authentication Component was defined. Without it you cannot use Authentication resources." );
        }
        return $this->objAuthenticationComponent;
    }

    /**

     public function hasAuthenticationComponent()
    {
        $this->loadAuthenticationComponent();
        return ( $this->objAuthenticationComponent !== null );
    }

    /**

     public function loadPermissionComponent()
    {
        if( $this->objPermissionComponent == null && $this->booPermissionLoaded == false )
        {
            $this->booPermissionLoaded = true;
            $this->loadComponentByName( "Permission" );
        }
    }

    /**

     public function setPermissionComponent( CorujaPermissionInterface $objPermissionComponent )
    {
        $this->objPermissionComponent = $objPermissionComponent;
    }

    /**

     public function getPermissionComponent()
    {
        $this->loadPermissionComponent();
        if( $this->objPermissionComponent == null )
        {
            throw new CorujaException( "No Permission Component was defined. Without it you cannot use Permission resources." );
        }
        return $this->objPermissionComponent;
    }

    /**

     public function hasPermissionComponent()
    {
        $this->loadPermissionComponent();
        return ( $this->objPermissionComponent !== null );
    }

    /**

     public function loadProfileComponent()
    {
        if( $this->objProfileComponent == null && $this->booProfileLoaded == false )
        {
            $this->booProfileLoaded = true;
            $this->loadComponentByName( "Profile" );
        }
    }

    /**

     public function setProfileComponent( CorujaProfileInterface $objProfileComponent )
    {
        $this->objProfileComponent = $objProfileComponent;
    }

    /**

     public function getProfileComponent()
    {
        $this->loadProfileComponent();
        if( $this->objProfileComponent == null )
        {
            throw new CorujaException( "No Profile Component was defined. Without it you cannot use Profile resources." );
        }
        return $this->objProfileComponent;
    }

    /**

     public function hasProfileComponent()
    {
        $this->loadProfileComponent();
        return ( $this->objProfileComponent !== null );
    }

    /**

     public function loadAnnotationComponent()
    {
        if( $this->objAnnotationComponent == null && $this->booAnnotationLoaded == false )
        {
            $this->booAnnotationLoaded = true;
            $this->loadComponentByName( "Annotation" );
        }
    }

    /**

     public function setAnnotationComponent( CorujaAnnotationInterface $objAnnotationComponent )
    {
        $this->objAnnotationComponent = $objAnnotationComponent;
    }

    /**

     public function getAnnotationComponent()
    {
        $this->loadAnnotationComponent();
        if( $this->objAnnotationComponent == null )
        {
            throw new CorujaException( "No Annotation Component was defined. Without it you cannot use Annotation resources." );
        }
        return $this->objAnnotationComponent;
    }

    /**

     public function hasAnnotationComponent()
    {
        $this->loadAnnotationComponent();
        return ( $this->objAnnotationComponent !== null );
    }

    /**

     public function loadExceptionHandlerComponent()
    {
        if( $this->objExceptionHandlerComponent == null && $this->booExceptionHandlerLoaded == false )
        {
            $this->booExceptionHandlerLoaded = true;
            $this->loadComponentByName( "ExceptionHandler" );
        }
    }

    /**

     public function setExceptionHandlerComponent( CorujaExceptionHandlerInterface  $objExceptionHandlerComponent )
    {
        $this->objExceptionHandlerComponent = $objExceptionHandlerComponent;
        $arrExceptionCaller = array( $this->objExceptionHandlerComponent, "handle" );
        set_exception_handler( $arrExceptionCaller );
    }

    /**

     public function getExceptionHandlerComponent()
    {
        $this->loadExceptionHandlerComponent();
        if( $this->objExceptionHandlerComponent == null )
        {
            throw new CorujaException( "No Exception Handler Component was defined. Without it you cannot use Exception Handler resources." );
        }
        return $this->objExceptionHandlerComponent;
    }

    /**

     public function hasExceptionHandlerComponent()
    {
        $this->loadExceptionHandlerComponent();
        return ( $this->objExceptionHandlerComponent !== null );
    }

    /**

     public function loadBacktraceComponent()
    {
        if( $this->objBacktraceComponent == null && $this->booBacktraceLoaded == false )
        {
            $this->booBacktraceLoaded = true;
            $this->loadComponentByName( "Backtrace" );
        }
    }

    /**

     public function setBacktraceComponent( CorujaBackTraceInterface  $objBackTraceComponent )
    {
        $this->objBacktraceComponent = $objBackTraceComponent;
    }

    /**

     public function getBacktraceComponent()
    {
        $this->loadBacktraceComponent();
        if( $this->objBacktraceComponent == null )
        {
            throw new CorujaException( "No Backtrace Component was defined. Without it you cannot use Backtrace resources." );
        }
        return $this->objBacktraceComponent;
    }

    /**

     public function hasBacktraceComponent()
    {
        $this->loadBacktraceComponent();
        return ( $this->objBacktraceComponent !== null );
    }

    /**

     public function loadBacktraceExplainComponent()
    {
        if( $this->objBacktraceExplainComponent == null && $this->booBacktraceExplainLoaded == false )
        {
            $this->booBacktraceExplainLoaded = true;
            $this->loadComponentByName( "BacktraceExplain" );
        }
    }

    /**

     public function setBacktraceExplainComponent( CorujaBackTraceExplainInterface $objBackTraceExplainComponent )
    {
        $this->objBackTraceExplainComponent = $objBackTraceExplainComponent;
    }

    /**

     public function getBacktraceExplainComponent()
    {
        $this->loadBacktraceExplainComponent();
        if( $this->objBackTraceExplainComponent == null )
        {
            throw new CorujaException( "No Backtrace Explain Component was defined. Without it you cannot use Backtrace Explain resources." );
        }
        return $this->objBackTraceExplainComponent;
    }

    /**

     public function hasBacktraceExplainComponent()
    {
        $this->loadBacktraceExplainComponent();
        return ( $this->objBacktraceExplainComponent !== null );
    }
}
?>

     }

    /**
     * Remove element from it's parent node child list
     *
     * @assert()->getParentNode()->getPosition == -1
     */

      *     $objCorujaTree = CorujaTree::loadString( "<parent><a/><b/><c/></parent>" );
     *  $objCorujaTree->removeElementChild(0);
     *  $objCorujaTree == CorujaTree::loadString( "<parent><b/><c/></parent>" );
     * </code>
     * @param integer $intPosition
     * @assert( 0 ) throws CorujaTreeException
     */
    public function removeElementChild( $intPosition )
    {
        if( $intPosition < sizeof( $this->arrChilds ) )
        {
            array_splice( $this->arrChilds , $intPosition , 1 );
        }
        else
        {

         return $this;

    }

    /**
     * Remove the element from it's tree
     */
    public function remove()
    {
        $arrChilds = $this->getParentNode()->getChildNodes();
        foreach( $arrChilds as $intPos => $objChild )
        {
            if( $objChild === $this )
            {

      *      foreach( $objChild->getBrothersNodes() as $objBrother )
     *      {
     *          print $objBrother->c . " "; // 1 2 3 //
     *      }
     * </code>
        * @return CorujaTree[]
        */
    public function getBrothersNodes()
    {
        $arrBrothers = $this->arrBrotherNodes;
        $arrBrothers[] = $this;
        $arrChilds = $this->getParentNode()->getChildNodes();
        $arrReturn = array();
        foreach( $arrChilds as $objChild )
        {
            foreach( $arrBrothers as $objBrother )
            {
                if( $objBrother === $objChild )
                {
                    $arrReturn[] = $objChild;

     /**
     * returns the xml of the coruja tree
     *
     * @param integer $intDepper
     * @return string
     * @assert() == "<node/>"
     */
    public function asXml( $intDepper = 0 )
    {
        if( $this->isTextNode() )
        {
            //return str_repeat( "\t", $intDepper ) . $this->getTextContent();
            return CorujaStringManipulation::XMLEntities( $this->getTextContent() );
        }

        
        $arrLines = array();
        $arrChilds = array();
        
        if(  $this->getNodeName() == "#comment" )
        {  
            $strOpenTag =  str_repeat( "\t", $intDepper )  . "<!-- ";
            $strCloseTag = "-->";
        }
        else
        {
            $strOpenTag =  str_repeat( "\t", $intDepper )  . "<" . strtolower( $this->getNodeName() );
            $strCloseTag = "</" . strtolower( $this->getNodeName() ) . ">";
        }

        foreach( $this->arrNodeAttributes as $strAttribute => $strValue )
        {
            $strPrintValue = CorujaStringManipulation::XMLEntities( $strValue );
            $strOpenTag .= " {$strAttribute}=\"{$strPrintValue}\" ";
        }

        if( sizeof( $this->arrChilds ) > 0 )
        {
            if(  $this->getNodeName() != "#comment" )
            {
                $strOpenTag .=  ">";
            }
            $arrLines[] = $strOpenTag;

         {
            return $this->strTextContent;
        }
        else
        {
            $strTextNode = '';
            foreach( $this->arrChilds as $objChild )
            {
                if( $booRecursive )
                {
                    $strTextNode .= $objChild->getTextContent( $booRecursive );
                }
                else
                {
                    if( $objChild->isTextNode() )
                    {
                        $strTextNode .= $objChild->getTextContent( $booRecursive );

     private function display( $strLevel, $strMessage, $strFile, $intNumber )
    {
        print "/*<fieldset><legend><b>" . $strLevel . "</b></legend>";
        print "\n<pre><b>File: </b>" . $strFile . "&nbsp;&nbsp;&nbsp;<b>Line: </b>" . $intNumber . "&nbsp;&nbsp;&nbsp;" . $strMessage . "</pre>";
        print "\n</fieldset>\n\n*/";
    }

    /**

     public function handle( $intNumber, $strError, $strFile, $intLine )
    {
        switch ( $intNumber )
        {
            case E_NOTICE:
            case E_USER_NOTICE:
                {
                    self::notice( $strError, $strFile, $intNumber );
                    break;
                }
            case E_WARNING:
            case E_USER_WARNING:
                {
                    self::warning( $strError, $strFile, $intNumber );
                    break;
                }
            case E_USER_ERROR:
                {
                    self::fatal( $strError, $strFile, $intNumber );
                    break;
                }
            default:
                {
                    self::unknown( $strError, $strFile, $intNumber );
                    break;
                }
        }
    }

    /**

     public function handle( $intNumber, $strError, $strFile, $intLine )
    {
        switch ( $intNumber )
        {
            case E_NOTICE:
            case E_USER_NOTICE:
                {
                    self::notice( $strError, $strFile, $intNumber );
                    break;
                }
            case E_WARNING:
            case E_USER_WARNING:
                {
                    self::warning( $strError, $strFile, $intNumber );
                    break;
                }
            case E_USER_ERROR:
                {
                    self::fatal( $strError, $strFile, $intNumber );
                    break;
                }
            default:
                {
                    self::unknown( $strError, $strFile, $intNumber );
                    break;
                }
        }
    }

    /**

     private function createLogMessage( $strLevel, $strMessage, $strFile, $intNumber )
    {
        $sMessage = "";
        $sMessage .= "level:    " . $strLevel . ";    ";
        $sMessage .= "file:    " . $strFile . ";    ";
        $sMessage .= "line:    " . $intNumber . ";    ";
        $sMessage .= "message:    " . $strMessage . ";    ";
    }

    /**

     private function report( $strLevel, $strMessage, $strFile, $intNumber )
    {
        self::loadConfiguration();

        if( isset( self::$arrConfiguration[$strLevel]["boolLog"] ) && ( self::$arrConfiguration[$strLevel]["boolLog"] ) )
        {
            if( ComponentsResourceController::hasLogComponent() )
            {
                $oLog = ComponentsResourceController::getLogComponent();
                $oLog->event( "error" , self::createLogMessage( $strLevel, $strMessage, $strFile, $intNumber ) );
            }
        }

        if( isset( self::$arrConfiguration[$strLevel]["boolDisplay"] ) && ( self::$arrConfiguration[$strLevel]["boolDisplay"] ) )
        {
            self::display( $strLevel, $strMessage, $strFile, $intNumber );
        }

        if( isset( self::$arrConfiguration[$strLevel]["boolExit"] ) && self::$arrConfiguration[$strLevel]["boolExit"] )
        {
            $strExitMessage = htmlentities( $strMessage, ENT_QUOTES );
            require_once( PATH_CORUJA_TEMPLATE . "error.php" );
            exit();
        }

        if( isset( self::$arrConfiguration[$strLevel]["boolThrow"] ) && self::$arrConfiguration[$strLevel]["boolThrow"] )
        {
            switch( $strLevel )
            {
                case self::NOTICE:
                    {
                        throw new NoticeException( $strMessage );
                        break;
                    }
                case self::WARNING:
                    {
                        throw new WarningException( $strMessage );
                        break;
                    }
                case self::FATAL:
                    {
                        throw new FatalException( $strMessage );
                        break;
                    }
                case self::SQL:
                    {
                        throw new SqlException( $strMessage );
                        break;
                    }
                default:
                    {
                        throw new CorujaException( $strMessage );
                        break;
                    }
            }
        }

        return false;
    }

    /**

     private function report( $strLevel, $strMessage, $strFile, $intNumber )
    {
        self::loadConfiguration();

        if( isset( self::$arrConfiguration[$strLevel]["boolLog"] ) && ( self::$arrConfiguration[$strLevel]["boolLog"] ) )
        {
            if( ComponentsResourceController::hasLogComponent() )
            {
                $oLog = ComponentsResourceController::getLogComponent();
                $oLog->event( "error" , self::createLogMessage( $strLevel, $strMessage, $strFile, $intNumber ) );
            }
        }

        if( isset( self::$arrConfiguration[$strLevel]["boolDisplay"] ) && ( self::$arrConfiguration[$strLevel]["boolDisplay"] ) )
        {
            self::display( $strLevel, $strMessage, $strFile, $intNumber );
        }

        if( isset( self::$arrConfiguration[$strLevel]["boolExit"] ) && self::$arrConfiguration[$strLevel]["boolExit"] )
        {
            $strExitMessage = htmlentities( $strMessage, ENT_QUOTES );
            require_once( PATH_CORUJA_TEMPLATE . "error.php" );
            exit();
        }

        if( isset( self::$arrConfiguration[$strLevel]["boolThrow"] ) && self::$arrConfiguration[$strLevel]["boolThrow"] )
        {
            switch( $strLevel )
            {
                case self::NOTICE:
                    {
                        throw new NoticeException( $strMessage );
                        break;
                    }
                case self::WARNING:
                    {
                        throw new WarningException( $strMessage );
                        break;
                    }
                case self::FATAL:
                    {
                        throw new FatalException( $strMessage );
                        break;
                    }
                case self::SQL:
                    {
                        throw new SqlException( $strMessage );
                        break;
                    }
                default:
                    {
                        throw new CorujaException( $strMessage );
                        break;
                    }
            }
        }

        return false;
    }

    /**

     public function notice( $strMessage, $strFile, $intNumber )
    {
        self::report( self::NOTICE, $strMessage, $strFile, $intNumber );
    }

    /**

     public function unknown( $strMessage, $strFile, $intNumber )
    {
        if( self::report( self::UNKNOWN, $strMessage, $strFile, $intNumber ) )
        {
            throw new Exception( $strMessage , $intNumber );
        }
    }

    /**

     public function warning( $strMessage, $strFile, $intNumber )
    {
        if( self::report( self::WARNING, $strMessage, $strFile, $intNumber ) )
        {
            throw new WarningException( $strMessage , $intNumber );
        }
    }

    /**

     public function fatal( $strMessage, $strFile, $intNumber )
    {
        if( self::report( self::FATAL, $strMessage, $strFile, $intNumber ) )
        {
            throw new FatalException( $strMessage , $intNumber );
        }
    }

    /**

     public function sql( $strMessage, $strFile, $intNumber )
    {
        if( self::report( self::SQL, $strMessage, $strFile, $intNumber ) )
        {
            throw new SqlException( $strMessage, $intNumber );
        }
    }

     public static function config()
    {
        $objConfiguration       = simplexml_load_file( PATH_CORUJA_ADMIN_CONFIG . "log.xml" );
        self::$strFileExtension = (string) $objConfiguration->strFileExtension;
        self::$strFilePath      = (string) $objConfiguration->strFilePath;
        if( defined( self::$strFilePath ) )
        {
            self::$strFilePath = constant( self::$strFilePath );
        }
        self::$arrFileHandler   = array();
        self::$arrSection       = array();
        foreach ( $objConfiguration->sections->section as $objSection )
        {
            $arrSectionElement = array();
            $arrSectionElement[ "status" ] = (boolean) $objSection->boolStatus;
            $arrSectionElement[ "file" ] = (string) $objSection->strFile;

            self::$arrSection[(string) $objSection->strName] = $arrSectionElement;
        }
        if ( !is_dir( self::$strFilePath ) )
        {
            // should not call the CorujaComponentsManager::getErrorComponent() //
            // because this element can call the log element creating a a infinite loop //

            throw new  WarningException( 'Fail on write the file ' . self::$strFilePath , __FILE__ , __LINE__ );
            if ( !mkdir( self::$strFilePath, 0777, TRUE ) )
            {
                throw new FatalException( " The user of the system does not have permission to write to the log directory." );
            }
        }
    }

    /**

     public static function config()
    {
        $objConfiguration       = simplexml_load_file( PATH_CORUJA_ADMIN_CONFIG . "log.xml" );
        self::$strFileExtension = (string) $objConfiguration->strFileExtension;
        self::$strFilePath      = (string) $objConfiguration->strFilePath;
        if( defined( self::$strFilePath ) )
        {
            self::$strFilePath = constant( self::$strFilePath );
        }
        self::$arrFileHandler   = array();
        self::$arrSection       = array();
        foreach ( $objConfiguration->sections->section as $objSection )
        {
            $arrSectionElement = array();
            $arrSectionElement[ "status" ] = (boolean) $objSection->boolStatus;
            $arrSectionElement[ "file" ] = (string) $objSection->strFile;

            self::$arrSection[(string) $objSection->strName] = $arrSectionElement;
        }
        if ( !is_dir( self::$strFilePath ) )
        {
            // should not call the CorujaComponentsManager::getErrorComponent() //
            // because this element can call the log element creating a a infinite loop //

            throw new  WarningException( 'Fail on write the file ' . self::$strFilePath , __FILE__ , __LINE__ );
            if ( !mkdir( self::$strFilePath, 0777, TRUE ) )
            {
                throw new FatalException( " The user of the system does not have permission to write to the log directory." );
            }
        }
    }

    /**

     private function convertTimeStamp( $intTime, $realMicroTime )
    {
        preg_match( "/0\.([0-9]{6})/", (string) $realMicroTime, $arrMicroTime );
        $strNewTime = date( "Y-m-d H:i:s" , $intTime ) . "." . $arrMicroTime[1];
        return( $strNewTime );
    }

    /**

     public static function event( $strSection, $strMessage )
    {
        if ( !self::$arrSection[ $strSection ] )
        {
            CorujaComponentsManager::getInstance()->getErrorComponent()->warning( "Unable to find the section " . $strSection . " into the Log file" , __FILE__  , __LINE__ );
        }

        $arrSectionElement = self::$arrSection[ $strSection ];

        if( $arrSectionElement[ "status" ] )
        {
            $strSection = str_pad( $strSection, 15,  " ", STR_PAD_RIGHT );
            list( $realMicroTime, $intTime ) = explode( " ", microtime() );
            $resFileHandler = self::logFile( $strSection , $intTime );
            $strTime        = self::convertTimeStamp( $intTime, $realMicroTime );
            $strMessage     = trim( str_replace( array("\n", "\r", "\t"), "", $strMessage ) );
            $strUserIp = $_SERVER["REMOTE_ADDR"];
            $strText        = $strTime . "\t" . $strSection . "\t" . $strUserIp . "\t" . html_entity_decode( $strMessage ) . "\n";
            fwrite( $resFileHandler, $strText );
        }
    }

    /**

     private function logFile( $strSection , $intTime )
    {
        $strFileName = $strSection . date( "Y-m-d", $intTime ) . "." . self::$strFileExtension;
        if ( !array_key_exists( $strFileName, self::$arrFileHandler ) )
        {
            self::$arrFileHandler[$strFileName] = fopen( self::$strFilePath . '/' . $strFileName, "a+" );
        }
        $reference =& self::$arrFileHandler[$strFileName];
        return( $reference );
    }

     public function __call( $strMethod, $arrParameters )
    {
        ErrorDealer::fatal( " The method " . $strMethod . " was not founded into the Log class " . get_class($this) . ". " , __FILE__ , __LINE__ ) ;
    }
}

     public function getMessages()
    {
        return $this->arrMessages;
    }

    public function throwIfHaveMessages()

     public function throwIfHaveMessages()
    {
        if( sizeof( $this->arrMessages ) > 0 )
        {
            throw $this;
        }
    }
}
?>

     public static function getRelativePath( $strFolderFrom, $strFolderTo, $booValidPath = true )
    {
        // check for valid parameters

        $strFolderFrom = str_replace( "\\" , "/" , $strFolderFrom );
        $strFolderTo = str_replace( "\\" , "/" , $strFolderTo );

        if( $booValidPath
        && ( ! is_dir( $strFolderFrom ) || ! is_dir( $strFolderTo ) )
        )
        {
            throw new InvalidArgumentException("Invalid parameter: strFolderFrom: ".$strFolderFrom." strFolderTo: ".$strFolderTo);
        }

        // special case: equal paths
        if( $strFolderFrom == $strFolderTo )
        {
            $strReturnPath = './';
        }
        else
        {
            // explode parameters using '/'
            $arrFileFrom = explode( '/', $strFolderFrom );
            $arrFileTo   = explode( '/', $strFolderTo );

            // remove similar base folders
            while(
            current( $arrFileFrom ) == current( $arrFileTo )
            && count( $arrFileFrom ) > 0
            )
            {
                array_shift( $arrFileFrom );
                array_shift( $arrFileTo );
            }

            $arrReturnPath = array();

            // make final address
            foreach( $arrFileFrom as $strFolder )
            {
                if( $strFolder != "" ) {
                    $arrReturnPath[] = "..";
                }
            }

            foreach( $arrFileTo as $strFolder )
            {
                $arrReturnPath[] = $strFolder;
            }

            $strReturnPath = implode( '/', $arrReturnPath );
        }
        return $strReturnPath;
    }

    /**

     public static function getRelativePath( $strFolderFrom, $strFolderTo, $booValidPath = true )
    {
        // check for valid parameters

        $strFolderFrom = str_replace( "\\" , "/" , $strFolderFrom );
        $strFolderTo = str_replace( "\\" , "/" , $strFolderTo );

        if( $booValidPath
        && ( ! is_dir( $strFolderFrom ) || ! is_dir( $strFolderTo ) )
        )
        {
            throw new InvalidArgumentException("Invalid parameter: strFolderFrom: ".$strFolderFrom." strFolderTo: ".$strFolderTo);
        }

        // special case: equal paths
        if( $strFolderFrom == $strFolderTo )
        {
            $strReturnPath = './';
        }
        else
        {
            // explode parameters using '/'
            $arrFileFrom = explode( '/', $strFolderFrom );
            $arrFileTo   = explode( '/', $strFolderTo );

            // remove similar base folders
            while(
            current( $arrFileFrom ) == current( $arrFileTo )
            && count( $arrFileFrom ) > 0
            )
            {
                array_shift( $arrFileFrom );
                array_shift( $arrFileTo );
            }

            $arrReturnPath = array();

            // make final address
            foreach( $arrFileFrom as $strFolder )
            {
                if( $strFolder != "" ) {
                    $arrReturnPath[] = "..";
                }
            }

            foreach( $arrFileTo as $strFolder )
            {
                $arrReturnPath[] = $strFolder;
            }

            $strReturnPath = implode( '/', $arrReturnPath );
        }
        return $strReturnPath;
    }

    /**

     public static function isRelativePath( $strFile )
    {
        $strFile = str_replace( "\\", "/", $strFile);
        if
        (
            ( strpos( $strFile, "./") === 0 )
        or
            ( strpos( $strFile, "../") === 0 )
        or
            ( strpos( $strFile, "/../") !== false )
        or
            ( strpos( $strFile, "/./") !== false )
        )
        {
            return true;
        }
        elseif( strpos( $strFile, "/") === false )
        {
            return true;
        }
        else
        {
            return false;
        }
    }
     
    /**

     public static function isRelativePath( $strFile )
    {
        $strFile = str_replace( "\\", "/", $strFile);
        if
        (
            ( strpos( $strFile, "./") === 0 )
        or
            ( strpos( $strFile, "../") === 0 )
        or
            ( strpos( $strFile, "/../") !== false )
        or
            ( strpos( $strFile, "/./") !== false )
        )
        {
            return true;
        }
        elseif( strpos( $strFile, "/") === false )
        {
            return true;
        }
        else
        {
            return false;
        }
    }
     
    /**

     public static function dir( $strFolder )
    {
        $arrElements = array();
        $objDir = dir( $strFolder );
        while( false !== ( $strElement = $objDir->read() ) )
        {
            $arrElements[] = $strElement;
        }
        sort( $arrElements );
        return $arrElements;
    }

    public static function getFilePath( $strFileFrom , $strRelativePath )

     public static function getFilePath( $strFileFrom , $strRelativePath )
    {
        $strPath = CorujaFileManipulation::getPathOfFile( $strFileFrom );
        $strRelativeFullPath = $strPath . $strRelativePath;
        return self::removeRelativeSlicesOfFile( $strRelativeFullPath );
    }

}