<?php
/**
 * Entier Studio
 *
 * LICENSE
 *
 *	Copyright 2006 Entier Studio team.
 *
 *	Licensed under the Apache License, Version 2.0 (the "License");
 *	you may not use this file except in compliance with the License.
 *	You may obtain a copy of the License at
 *
 *		http://www.apache.org/licenses/LICENSE-2.0
 *
 *	Unless required by applicable law or agreed to in writing, software
 *	distributed under the License is distributed on an "AS IS" BASIS,
 *	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *	See the License for the specific language governing permissions and
 *	limitations under the License.
 *
 * @package    entier.framework
 * @copyright  Copyright (c) 2006 Entier Studio team. All rights reserved.
 * @author	   $Author: yannromefort $
 * @version	   $Id: datasource.locator.php 81 2008-01-17 23:08:21Z yannromefort $
 */
//-----------------------------------------------------------------------------
//	namespace
if (!defined("DefDataSourceLocator")) {
    //-------------------------------------------------------------------------
    //	Define
    define("DefDataSourceLocator", "1");
    //-------------------------------------------------------------------------
    //	Include
    @require_once (FRAMEWORK_DIR . "datasource.factory.php");
    //-------------------------------------------------------------------------
    //	Class
    class DataSourceLocator {
        //---------------------------------------------------------------------
        //	Attributes
        
        /**
         * // Hold an instance of the datasource
         * @var	object
         */
        var $m_dataSource = NULL;
        //---------------------------------------------------------------------
        //	Constructor
        
        /**
         * Data source constructor
         *
         */
        function DataSourceLocator() {
            //
            $dataSource = DataSourceFactory::createInstance(DBFACTORY);
            //
            if (isset($dataSource)) {
                if ($dataSource->openConnection() == false) die($dataSource->errorString());
                //
                $this->m_dataSource = $dataSource->GetDataHandler();
            }
        }
        //---------------------------------------------------------------------
        //	Methods
        
        /**
         *
         * The singleton method
         * @return	object
         */
        function &getInstance() {
            //
            static $locator;
            //
            if (!$locator) $locator = new DataSourceLocator;
            //
            return $locator->m_dataSource;
        }
    };
    //	Class
    //-------------------------------------------------------------------------
    
}
//	namespace
//-----------------------------------------------------------------------------
?>