Changeset 2939 for trunk/lib/Doctrine.php

Timestamp:

10/19/07 15:23:42 (15 months ago)

Author:

jwage

Message:

Removed Facade and moved all static methods to Doctrine class.

Files:

• trunk/lib/Doctrine.php (modified) (15 diffs)

trunk/lib/Doctrine.php

@@ -255 +255 @@
     /**
      * Portability: turn off all portability features.
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_NONE          = 0;
@@ -262 +262 @@
      * Portability: convert names of tables and fields to case defined in the
      * "field_case" option when using the query*(), fetch*() methods.
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_FIX_CASE      = 1;
@@ -268 +268 @@
     /**
      * Portability: right trim the data output by query*() and fetch*().
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_RTRIM         = 2;
@@ -274 +274 @@
     /**
      * Portability: force reporting the number of rows deleted.
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_DELETE_COUNT  = 4;
@@ -281 +281 @@
      * Portability: convert empty values to null strings in data output by
      * query*() and fetch*().
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_EMPTY_TO_NULL = 8;
@@ -287 +287 @@
     /**
      * Portability: removes database/table qualifiers from associative indexes
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_FIX_ASSOC_FIELD_NAMES = 16;
@@ -293 +293 @@
     /**
      * Portability: makes Doctrine_Expression throw exception for unportable RDBMS expressions
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_EXPR          = 32;
@@ -299 +299 @@
     /**
      * Portability: turn on all portability features.
-     * @see Doctrine::ATTR_PORTABILITY
+     * @see self::ATTR_PORTABILITY
      */
     const PORTABILITY_ALL           = 63;
@@ -445 +445 @@
     public static function loadAll()
     {
-        return Doctrine_Facade::loadAllRuntimeClasses();
+        return self::loadAllRuntimeClasses();
+    }
+    
+    /**
+     * importSchema
+     * method for importing existing schema to Doctrine_Record classes
+     *
+     * @param string $directory Directory to write your models to
+     * @param array $databases Array of databases to generate models for
+     * @return boolean
+     */
+    public static function importSchema($directory, array $databases = array())
+    {
+        return self::generateModelsFromDb($directory, $databases);
+    }
+    
+    /**
+     * exportSchema
+     * method for exporting Doctrine_Record classes to a schema
+     *
+     * @param string $directory Directory containing your models
+     * @return void
+     */
+    public static function exportSchema($directory = null)
+    {
+        return self::createTablesFromModels($directory);
+    }
+    
+    /**
+     * exportSql
+     * method for exporting Doctrine_Record classes to a schema
+     *
+     * @param string $directory
+     */
+    public static function exportSql($directory = null)
+    {
+        return self::generateSqlFromModels($directory);
+    }
+    
+    /**
+     * loadAllRuntimeClasses
+     *
+     * loads all runtime classes
+     *
+     * @return void
+     */
+    public static function loadAllRuntimeClasses()
+    {
+        $classes = Doctrine_Compiler::getRuntimeClasses();
+
+        foreach ($classes as $class) {
+            self::autoload($class);
+        }
     }
     
@@ -458 +510 @@
     public static function loadModels($directory)
     {
-        return Doctrine_Facade::loadModels($directory);
+        $declared = get_declared_classes();
+        
+        if ($directory !== null) {
+            foreach ((array) $directory as $dir) {
+                $it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir),
+                                                        RecursiveIteratorIterator::LEAVES_ONLY);
+
+                foreach ($it as $file) {
+                    $e = explode('.', $file->getFileName());
+                    if (end($e) === 'php' && strpos($file->getFileName(), '.inc') === false) {
+                        require_once $file->getPathName();
+                    }
+                }
+            }
+            
+            $declared = array_diff(get_declared_classes(), $declared);
+        }
+        
+        return self::getLoadedModels($declared);
     }
     
@@ -471 +541 @@
     public static function getLoadedModels($classes = null)
     {
-        return Doctrine_Facade::getLoadedModels($classes);
+        if ($classes === null) {
+            $classes = get_declared_classes();
+        }
+        
+        $parent = new ReflectionClass('Doctrine_Record');
+        
+        $loadedModels = array();
+        
+        // we iterate trhough the diff of previously declared classes
+        // and currently declared classes
+        foreach ($classes as $name) {
+            $class = new ReflectionClass($name);
+            
+            // Skip the following classes
+            // - abstract classes
+            // - not a subclass of Doctrine_Record 
+            // - don't have a setTableDefinition method
+            if ($class->isAbstract() || 
+                !$class->isSubClassOf($parent) || 
+                !$class->hasMethod('setTableDefinition')) {
+                continue;
+            }
+            
+            $loadedModels[] = $name;
+        }
+        
+        return $loadedModels;
     }
     
@@ -484 +580 @@
     public static function getConnectionByTableName($tableName)
     {
-        return Doctrine_Facade::getConnectionByTableName($tableName);
-    }
-    
-    /**
-     * importSchema
+        $loadedModels = self::getLoadedModels();
+        
+        foreach ($loadedModels as $name) {
+            $model = new $name();
+            $table = $model->getTable();
+            
+            if ($table->getTableName() == $tableName) {
+               return $table->getConnection(); 
+            }
+        }
+        
+        return Doctrine_Manager::connection();
+    }
+    
+    /**
+     * generateModelsFromDb
+     *
      * method for importing existing schema to Doctrine_Record classes
      *
@@ -495 +603 @@
      * @return boolean
      */
-    public static function importSchema($directory, array $databases = array())
-    {
-        return Doctrine_Facade::generateModelsFromDb($directory, $databases);
-    }
-    
-    /**
-     * exportSchema
-     * method for exporting Doctrine_Record classes to a schema
+    public static function generateModelsFromDb($directory, array $databases = array())
+    {
+        return Doctrine_Manager::connection()->import->importSchema($directory, $databases);
+    }
+    
+    /**
+     * generateYamlFromDb
+     *
+     * Generates models from database to temporary location then uses those models to generate a yaml schema file.
+     * This should probably be fixed. We should write something to generate a yaml schema file directly from the database.
+     *
+     * @param string $yamlPath Path to write oyur yaml schema file to
+     * @return void
+     */
+    public static function generateYamlFromDb($yamlPath)
+    {
+        $directory = '/tmp/tmp_doctrine_models';
+
+        Doctrine::generateModelsFromDb($directory);
+
+        $export = new Doctrine_Export_Schema();
+        
+        $result = $export->exportSchema($yamlPath, 'yml', $directory);
+        
+        exec('rm -rf ' . $directory);
+        
+        return $result;
+    }
+    /**
+     * generateModelsFromYaml
+     *
+     * Generate a yaml schema file from an existing directory of models
+     *
+     * @param string $yamlPath Path to your yaml schema files
+     * @param string $directory Directory to generate your models in
+     * @return void
+     */
+    public static function generateModelsFromYaml($yamlPath, $directory)
+    {
+        $import = new Doctrine_Import_Schema();
+        $import->generateBaseClasses(true);
+        
+        return $import->importSchema($yamlPath, 'yml', $directory);
+    }
+    
+    /**
+     * createTablesFromModels
+     *
+     * Creates database tables for the models in the specified directory
      *
      * @param string $directory Directory containing your models
      * @return void
      */
-    public static function exportSchema($directory = null)
-    {
-        return Doctrine_Facade::createTablesFromModels($directory);
-    }
-    
-    /**
-     * exportSql
-     * method for exporting Doctrine_Record classes to a schema
-     *
-     * @param string $directory
-     */
-    public static function exportSql($directory = null)
-    {
-        return Doctrine_Facade::generateSqlFromModels($directory);
+    public static function createTablesFromModels($directory = null)
+    {
+        return Doctrine_Manager::connection()->export->exportSchema($directory);
+    }
+    
+    /**
+     * generateSqlFromModels
+     *
+     * @param string $directory 
+     * @return void
+     */
+    public static function generateSqlFromModels($directory = null)
+    {
+        $sql = Doctrine_Manager::connection()->export->exportSql($directory);
+        
+        $build = '';
+        foreach ($sql as $query) {
+            $build .= $query.";\n";
+        }
+        
+        return $build;
+    }
+
+    /**
+     * generateYamlFromModels
+     *
+     * Generate yaml schema file for the models in the specified directory
+     *
+     * @param string $yamlPath Path to your yaml schema files
+     * @param string $directory Directory to generate your models in
+     * @return void
+     */
+    public static function generateYamlFromModels($yamlPath, $directory)
+    {
+        $export = new Doctrine_Export_Schema();
+        
+        return $export->exportSchema($yamlPath, 'yml', $directory);
+    }
+    
+    /**
+     * createDatabases
+     *
+     * Creates databases for connections
+     *
+     * @param string $specifiedConnections Array of connections you wish to create the database for
+     * @return void
+     */
+    public static function createDatabases($specifiedConnections)
+    {
+        if (!is_array($specifiedConnections)) {
+            $specifiedConnections = (array) $specifiedConnections;
+        }
+        
+        $connections = Doctrine_Manager::getInstance()->getConnections();
+        
+        foreach ($connections as $name => $connection) {
+            if (!empty($specifiedConnections) && !in_array($name, $specifiedConnections)) {
+                continue;
+            }
+            
+            $connection->export->createDatabase($name);
+        }
+    }
+    
+    /**
+     * dropDatabases
+     *
+     * Drops databases for connections
+     *
+     * @param string $specifiedConnections Array of connections you wish to drop the database for
+     * @return void
+     */
+    public static function dropDatabases($specifiedConnections = array())
+    {
+        if (!is_array($specifiedConnections)) {
+            $specifiedConnections = (array) $specifiedConnections;
+        }
+        
+        $connections = Doctrine_Manager::getInstance()->getConnections();
+        
+        foreach ($connections as $name => $connection) {
+            if (!empty($specifiedConnections) && !in_array($name, $specifiedConnections)) {
+                continue;
+            }
+            
+            $connection->export->dropDatabase($name);
+        }
+    }
+    
+    /**
+     * dumpData
+     *
+     * Dump data to a yaml fixtures file
+     *
+     * @param string $yamlPath Path to write the yaml data fixtures to
+     * @param string $individualFiles Whether or not to dump data to individual fixtures files
+     * @return void
+     */
+    public static function dumpData($yamlPath, $individualFiles = false)
+    {
+        $data = new Doctrine_Data();
+        
+        return $data->exportData($yamlPath, 'yml', array(), $individualFiles);
+    }
+    
+    /**
+     * loadData
+     *
+     * Load data from a yaml fixtures file.
+     * The output of dumpData can be fed to loadData
+     *
+     * @param string $yamlPath Path to your yaml data fixtures
+     * @param string $append Whether or not to append the data
+     * @return void
+     */
+    public static function loadData($yamlPath, $append = false)
+    {
+        $delete = isset($append) ? ($append ? false : true) : true;
+
+        if ($delete)
+        {
+            $models = Doctrine::getLoadedModels();
+
+            foreach ($models as $model)
+            {
+                $model = new $model();
+
+                $model->getTable()->createQuery()->delete($model)->execute();
+            }
+        }
+
+        $data = new Doctrine_Data();
+        
+        return $data->importData($yamlPath, 'yml');
+    }
+    
+    /**
+     * loadDummyData
+     *
+     * Populdate your models with dummy data
+     *
+     * @param string $append Whether or not to append the data
+     * @param string $num Number of records to populate
+     * @return void
+     */
+    public static function loadDummyData($append, $num = 5)
+    {
+        $delete = isset($append) ? ($append ? false : true) : true;
+
+        if ($delete)
+        {
+          $models = Doctrine::getLoadedModels();
+
+          foreach ($models as $model)
+          {
+            $model = new $model();
+
+            $model->getTable()->createQuery()->delete($model)->execute();
+          }
+        }
+        
+        $data = new Doctrine_Data();
+        
+        return $data->importDummyData($num);
+    }
+    
+    /**
+     * migrate
+     * 
+     * Migrate database to specified $to version. Migrates from current to latest if you do not specify.
+     *
+     * @param string $directory Directory which contains your migration classes
+     * @param string $to Version you wish to migrate to.
+     * @return void
+     */
+    public static function migrate($directory, $to = null)
+    {
+        $migration = new Doctrine_Migration($directory);
+        
+        return $migration->migrate($to);
+    }
+    
+    /**
+     * generateMigrationClass
+     *
+     * Generate new migration class skeleton
+     *
+     * @param string $className Name of the Migration class to generate
+     * @param string $directory Directory which contains your migration classes
+     * @package default
+     */
+    public static function generateMigrationClass($className, $directory)
+    {
+        $migration = new Doctrine_Migration($directory);
+        $next = (string) $migration->getNextVersion();
+        
+        $fileName = str_repeat('0', (3 - strlen($next))) . $next . '_' . self::tableize($className) . '.class.php';
+        $path = $directory . DIRECTORY_SEPARATOR . $fileName;
+        
+        $code  = '<?php' . PHP_EOL;
+        $code .= "// Automatically generated by the Doctrine ORM Framework\n";
+        $code .= "class " . self::classify($className) . " extends Doctrine_Migration\n";
+        $code .= "{\n";
+        $code .= "\tpublic function up()\n\t{ }\n\n";
+        $code .= "\tpublic function down()\n\t{ }\n";
+        $code .= "}";
+        
+        file_put_contents($path, $code);
     }
     
@@ -536 +879 @@
     public static function compile($target = null, $includedDrivers = array())
     {
-        return Doctrine_Facade::compile($target, $includedDrivers);
+        return Doctrine_Compiler::compile($target, $includedDrivers);
     }
     
@@ -583 +926 @@
                 $ret[] = 'Array(';
                 foreach ($var as $k => $v) {
-                    $ret[] = $k . ' : ' . Doctrine::dump($v, false);
+                    $ret[] = $k . ' : ' . self::dump($v, false);
                 }
                 $ret[] = ")";