Completed
Pull Request — 4.0 (#58)
by David
05:12
created
src/Mouf/Database/TDBM/Controllers/TdbmController.php 1 patch
Indentation   +144 added lines, -144 removed lines patch added patch discarded remove patch
@@ -18,148 +18,148 @@
 block discarded – undo
18 18
  */
19 19
 class TdbmController extends AbstractMoufInstanceController
20 20
 {
21
-    /**
22
-     * @var HtmlBlock
23
-     */
24
-    public $content;
25
-
26
-    protected $daoNamespace;
27
-    protected $beanNamespace;
28
-    protected $daoFactoryName;
29
-    protected $daoFactoryInstanceName;
30
-    protected $autoloadDetected;
31
-    protected $storeInUtc;
32
-    protected $useCustomComposer;
33
-
34
-    /**
35
-     * Admin page used to display the DAO generation form.
36
-     *
37
-     * @Action
38
-     */
39
-    public function defaultAction($name, $selfedit = 'false')
40
-    {
41
-        $this->initController($name, $selfedit);
42
-
43
-        // Fill variables
44
-        if ($this->moufManager->getVariable('tdbmDefaultSourceDirectory_'.$name) != null) {
45
-            $this->daoNamespace = $this->moufManager->getVariable('tdbmDefaultDaoNamespace_'.$name);
46
-            $this->beanNamespace = $this->moufManager->getVariable('tdbmDefaultBeanNamespace_'.$name);
47
-            $this->daoFactoryName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryName_'.$name);
48
-            $this->daoFactoryInstanceName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryInstanceName_'.$name);
49
-            $this->storeInUtc = $this->moufManager->getVariable('tdbmDefaultStoreInUtc_'.$name);
50
-            $this->useCustomComposer = $this->moufManager->getVariable('tdbmDefaultUseCustomComposer_'.$name);
51
-            $this->composerFile = $this->moufManager->getVariable('tdbmDefaultComposerFile_'.$name);
52
-        } else {
53
-            $this->daoNamespace = $this->moufManager->getVariable('tdbmDefaultDaoNamespace');
54
-            $this->beanNamespace = $this->moufManager->getVariable('tdbmDefaultBeanNamespace');
55
-            $this->daoFactoryName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryName');
56
-            $this->daoFactoryInstanceName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryInstanceName');
57
-            $this->storeInUtc = $this->moufManager->getVariable('tdbmDefaultStoreInUtc');
58
-            $this->useCustomComposer = $this->moufManager->getVariable('tdbmDefaultUseCustomComposer');
59
-            $this->composerFile = $this->moufManager->getVariable('tdbmDefaultComposerFile');
60
-        }
61
-
62
-        if ($this->daoNamespace == null && $this->beanNamespace == null) {
63
-            $classNameMapper = ClassNameMapper::createFromComposerFile(__DIR__.'/../../../../../../../../composer.json');
64
-
65
-            $autoloadNamespaces = $classNameMapper->getManagedNamespaces();
66
-            if ($autoloadNamespaces) {
67
-                $this->autoloadDetected = true;
68
-                $rootNamespace = $autoloadNamespaces[0];
69
-                $this->daoNamespace = $rootNamespace.'Dao';
70
-                $this->beanNamespace = $rootNamespace.'Dao\\Bean';
71
-            } else {
72
-                $this->autoloadDetected = false;
73
-                $this->daoNamespace = 'YourApplication\\Dao';
74
-                $this->beanNamespace = 'YourApplication\\Dao\\Bean';
75
-            }
76
-        } else {
77
-            $this->autoloadDetected = true;
78
-        }
79
-
80
-        $this->content->addFile(__DIR__.'/../../../../views/tdbmGenerate.php', $this);
81
-        $this->template->toHtml();
82
-    }
83
-
84
-    /**
85
-     * This action generates the DAOs and Beans for the TDBM service passed in parameter.
86
-     *
87
-     * @Action
88
-     *
89
-     * @param string $name
90
-     * @param bool   $selfedit
91
-     */
92
-    public function generate($name, $daonamespace, $beannamespace, $daofactoryclassname, $daofactoryinstancename, $storeInUtc = 0, $selfedit = 'false', $useCustomComposer = false, $composerFile = '')
93
-    {
94
-        $this->initController($name, $selfedit);
95
-
96
-        self::generateDaos($this->moufManager, $name, $daonamespace, $beannamespace, $daofactoryclassname, $daofactoryinstancename, $selfedit, $storeInUtc, $useCustomComposer, $composerFile);
97
-
98
-        // TODO: better: we should redirect to a screen that list the number of DAOs generated, etc...
99
-        header('Location: '.ROOT_URL.'ajaxinstance/?name='.urlencode($name).'&selfedit='.$selfedit);
100
-    }
101
-
102
-    /**
103
-     * This function generates the DAOs and Beans for the TDBM service passed in parameter.
104
-     *
105
-     * @param MoufManager $moufManager
106
-     * @param string      $name
107
-     * @param string      $daonamespace
108
-     * @param string      $beannamespace
109
-     * @param string      $daofactoryclassname
110
-     * @param string      $daofactoryinstancename
111
-     * @param string      $selfedit
112
-     * @param bool        $storeInUtc
113
-     *
114
-     * @throws \Mouf\MoufException
115
-     */
116
-    public static function generateDaos(MoufManager $moufManager, $name, $daonamespace, $beannamespace, $daofactoryclassname, $daofactoryinstancename, $selfedit = 'false', $storeInUtc = null, $useCustomComposer = null, $composerFile = null)
117
-    {
118
-        $moufManager->setVariable('tdbmDefaultDaoNamespace_'.$name, $daonamespace);
119
-        $moufManager->setVariable('tdbmDefaultBeanNamespace_'.$name, $beannamespace);
120
-        $moufManager->setVariable('tdbmDefaultDaoFactoryName_'.$name, $daofactoryclassname);
121
-        $moufManager->setVariable('tdbmDefaultDaoFactoryInstanceName_'.$name, $daofactoryinstancename);
122
-        $moufManager->setVariable('tdbmDefaultStoreInUtc_'.$name, $storeInUtc);
123
-        $moufManager->setVariable('tdbmDefaultUseCustomComposer_'.$name, $useCustomComposer);
124
-        $moufManager->setVariable('tdbmDefaultComposerFile_'.$name, $composerFile);
125
-
126
-        // In case of instance renaming, let's use the last used settings
127
-        $moufManager->setVariable('tdbmDefaultDaoNamespace', $daonamespace);
128
-        $moufManager->setVariable('tdbmDefaultBeanNamespace', $beannamespace);
129
-        $moufManager->setVariable('tdbmDefaultDaoFactoryName', $daofactoryclassname);
130
-        $moufManager->setVariable('tdbmDefaultDaoFactoryInstanceName', $daofactoryinstancename);
131
-        $moufManager->setVariable('tdbmDefaultStoreInUtc', $storeInUtc);
132
-        $moufManager->setVariable('tdbmDefaultUseCustomComposer', $useCustomComposer);
133
-        $moufManager->setVariable('tdbmDefaultComposerFile', $composerFile);
134
-
135
-        // Remove first and last slash in namespace.
136
-        $daonamespace = trim($daonamespace, '\\');
137
-        $beannamespace = trim($beannamespace, '\\');
138
-
139
-        $tdbmService = new InstanceProxy($name);
140
-        /* @var $tdbmService TDBMService */
141
-        $tables = $tdbmService->generateAllDaosAndBeans($daofactoryclassname, $daonamespace, $beannamespace, $storeInUtc, ($useCustomComposer ? $composerFile : null));
142
-
143
-        $moufManager->declareComponent($daofactoryinstancename, $daonamespace.'\\Generated\\'.$daofactoryclassname, false, MoufManager::DECLARE_ON_EXIST_KEEP_INCOMING_LINKS);
144
-
145
-        $tableToBeanMap = [];
146
-
147
-        //$tdbmServiceDescriptor = $moufManager->getInstanceDescriptor('tdbmService');
148
-
149
-        foreach ($tables as $table) {
150
-            $daoName = TDBMDaoGenerator::getDaoNameFromTableName($table);
151
-
152
-            $instanceName = TDBMDaoGenerator::toVariableName($daoName);
153
-            if (!$moufManager->instanceExists($instanceName)) {
154
-                $moufManager->declareComponent($instanceName, $daonamespace.'\\'.$daoName);
155
-            }
156
-            $moufManager->setParameterViaConstructor($instanceName, 0, $name, 'object');
157
-            $moufManager->bindComponentViaSetter($daofactoryinstancename, 'set'.$daoName, $instanceName);
158
-
159
-            $tableToBeanMap[$table] = $beannamespace.'\\'.TDBMDaoGenerator::getBeanNameFromTableName($table);
160
-        }
161
-        $tdbmServiceDescriptor = $moufManager->getInstanceDescriptor($name);
162
-        $tdbmServiceDescriptor->getSetterProperty('setTableToBeanMap')->setValue($tableToBeanMap);
163
-        $moufManager->rewriteMouf();
164
-    }
21
+	/**
22
+	 * @var HtmlBlock
23
+	 */
24
+	public $content;
25
+
26
+	protected $daoNamespace;
27
+	protected $beanNamespace;
28
+	protected $daoFactoryName;
29
+	protected $daoFactoryInstanceName;
30
+	protected $autoloadDetected;
31
+	protected $storeInUtc;
32
+	protected $useCustomComposer;
33
+
34
+	/**
35
+	 * Admin page used to display the DAO generation form.
36
+	 *
37
+	 * @Action
38
+	 */
39
+	public function defaultAction($name, $selfedit = 'false')
40
+	{
41
+		$this->initController($name, $selfedit);
42
+
43
+		// Fill variables
44
+		if ($this->moufManager->getVariable('tdbmDefaultSourceDirectory_'.$name) != null) {
45
+			$this->daoNamespace = $this->moufManager->getVariable('tdbmDefaultDaoNamespace_'.$name);
46
+			$this->beanNamespace = $this->moufManager->getVariable('tdbmDefaultBeanNamespace_'.$name);
47
+			$this->daoFactoryName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryName_'.$name);
48
+			$this->daoFactoryInstanceName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryInstanceName_'.$name);
49
+			$this->storeInUtc = $this->moufManager->getVariable('tdbmDefaultStoreInUtc_'.$name);
50
+			$this->useCustomComposer = $this->moufManager->getVariable('tdbmDefaultUseCustomComposer_'.$name);
51
+			$this->composerFile = $this->moufManager->getVariable('tdbmDefaultComposerFile_'.$name);
52
+		} else {
53
+			$this->daoNamespace = $this->moufManager->getVariable('tdbmDefaultDaoNamespace');
54
+			$this->beanNamespace = $this->moufManager->getVariable('tdbmDefaultBeanNamespace');
55
+			$this->daoFactoryName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryName');
56
+			$this->daoFactoryInstanceName = $this->moufManager->getVariable('tdbmDefaultDaoFactoryInstanceName');
57
+			$this->storeInUtc = $this->moufManager->getVariable('tdbmDefaultStoreInUtc');
58
+			$this->useCustomComposer = $this->moufManager->getVariable('tdbmDefaultUseCustomComposer');
59
+			$this->composerFile = $this->moufManager->getVariable('tdbmDefaultComposerFile');
60
+		}
61
+
62
+		if ($this->daoNamespace == null && $this->beanNamespace == null) {
63
+			$classNameMapper = ClassNameMapper::createFromComposerFile(__DIR__.'/../../../../../../../../composer.json');
64
+
65
+			$autoloadNamespaces = $classNameMapper->getManagedNamespaces();
66
+			if ($autoloadNamespaces) {
67
+				$this->autoloadDetected = true;
68
+				$rootNamespace = $autoloadNamespaces[0];
69
+				$this->daoNamespace = $rootNamespace.'Dao';
70
+				$this->beanNamespace = $rootNamespace.'Dao\\Bean';
71
+			} else {
72
+				$this->autoloadDetected = false;
73
+				$this->daoNamespace = 'YourApplication\\Dao';
74
+				$this->beanNamespace = 'YourApplication\\Dao\\Bean';
75
+			}
76
+		} else {
77
+			$this->autoloadDetected = true;
78
+		}
79
+
80
+		$this->content->addFile(__DIR__.'/../../../../views/tdbmGenerate.php', $this);
81
+		$this->template->toHtml();
82
+	}
83
+
84
+	/**
85
+	 * This action generates the DAOs and Beans for the TDBM service passed in parameter.
86
+	 *
87
+	 * @Action
88
+	 *
89
+	 * @param string $name
90
+	 * @param bool   $selfedit
91
+	 */
92
+	public function generate($name, $daonamespace, $beannamespace, $daofactoryclassname, $daofactoryinstancename, $storeInUtc = 0, $selfedit = 'false', $useCustomComposer = false, $composerFile = '')
93
+	{
94
+		$this->initController($name, $selfedit);
95
+
96
+		self::generateDaos($this->moufManager, $name, $daonamespace, $beannamespace, $daofactoryclassname, $daofactoryinstancename, $selfedit, $storeInUtc, $useCustomComposer, $composerFile);
97
+
98
+		// TODO: better: we should redirect to a screen that list the number of DAOs generated, etc...
99
+		header('Location: '.ROOT_URL.'ajaxinstance/?name='.urlencode($name).'&selfedit='.$selfedit);
100
+	}
101
+
102
+	/**
103
+	 * This function generates the DAOs and Beans for the TDBM service passed in parameter.
104
+	 *
105
+	 * @param MoufManager $moufManager
106
+	 * @param string      $name
107
+	 * @param string      $daonamespace
108
+	 * @param string      $beannamespace
109
+	 * @param string      $daofactoryclassname
110
+	 * @param string      $daofactoryinstancename
111
+	 * @param string      $selfedit
112
+	 * @param bool        $storeInUtc
113
+	 *
114
+	 * @throws \Mouf\MoufException
115
+	 */
116
+	public static function generateDaos(MoufManager $moufManager, $name, $daonamespace, $beannamespace, $daofactoryclassname, $daofactoryinstancename, $selfedit = 'false', $storeInUtc = null, $useCustomComposer = null, $composerFile = null)
117
+	{
118
+		$moufManager->setVariable('tdbmDefaultDaoNamespace_'.$name, $daonamespace);
119
+		$moufManager->setVariable('tdbmDefaultBeanNamespace_'.$name, $beannamespace);
120
+		$moufManager->setVariable('tdbmDefaultDaoFactoryName_'.$name, $daofactoryclassname);
121
+		$moufManager->setVariable('tdbmDefaultDaoFactoryInstanceName_'.$name, $daofactoryinstancename);
122
+		$moufManager->setVariable('tdbmDefaultStoreInUtc_'.$name, $storeInUtc);
123
+		$moufManager->setVariable('tdbmDefaultUseCustomComposer_'.$name, $useCustomComposer);
124
+		$moufManager->setVariable('tdbmDefaultComposerFile_'.$name, $composerFile);
125
+
126
+		// In case of instance renaming, let's use the last used settings
127
+		$moufManager->setVariable('tdbmDefaultDaoNamespace', $daonamespace);
128
+		$moufManager->setVariable('tdbmDefaultBeanNamespace', $beannamespace);
129
+		$moufManager->setVariable('tdbmDefaultDaoFactoryName', $daofactoryclassname);
130
+		$moufManager->setVariable('tdbmDefaultDaoFactoryInstanceName', $daofactoryinstancename);
131
+		$moufManager->setVariable('tdbmDefaultStoreInUtc', $storeInUtc);
132
+		$moufManager->setVariable('tdbmDefaultUseCustomComposer', $useCustomComposer);
133
+		$moufManager->setVariable('tdbmDefaultComposerFile', $composerFile);
134
+
135
+		// Remove first and last slash in namespace.
136
+		$daonamespace = trim($daonamespace, '\\');
137
+		$beannamespace = trim($beannamespace, '\\');
138
+
139
+		$tdbmService = new InstanceProxy($name);
140
+		/* @var $tdbmService TDBMService */
141
+		$tables = $tdbmService->generateAllDaosAndBeans($daofactoryclassname, $daonamespace, $beannamespace, $storeInUtc, ($useCustomComposer ? $composerFile : null));
142
+
143
+		$moufManager->declareComponent($daofactoryinstancename, $daonamespace.'\\Generated\\'.$daofactoryclassname, false, MoufManager::DECLARE_ON_EXIST_KEEP_INCOMING_LINKS);
144
+
145
+		$tableToBeanMap = [];
146
+
147
+		//$tdbmServiceDescriptor = $moufManager->getInstanceDescriptor('tdbmService');
148
+
149
+		foreach ($tables as $table) {
150
+			$daoName = TDBMDaoGenerator::getDaoNameFromTableName($table);
151
+
152
+			$instanceName = TDBMDaoGenerator::toVariableName($daoName);
153
+			if (!$moufManager->instanceExists($instanceName)) {
154
+				$moufManager->declareComponent($instanceName, $daonamespace.'\\'.$daoName);
155
+			}
156
+			$moufManager->setParameterViaConstructor($instanceName, 0, $name, 'object');
157
+			$moufManager->bindComponentViaSetter($daofactoryinstancename, 'set'.$daoName, $instanceName);
158
+
159
+			$tableToBeanMap[$table] = $beannamespace.'\\'.TDBMDaoGenerator::getBeanNameFromTableName($table);
160
+		}
161
+		$tdbmServiceDescriptor = $moufManager->getInstanceDescriptor($name);
162
+		$tdbmServiceDescriptor->getSetterProperty('setTableToBeanMap')->setValue($tableToBeanMap);
163
+		$moufManager->rewriteMouf();
164
+	}
165 165
 }
Please login to merge, or discard this patch.
src/Mouf/Database/TDBM/TDBMService.php 1 patch
Indentation   +1293 added lines, -1293 removed lines patch added patch discarded remove patch
@@ -40,213 +40,213 @@  discard block
 block discarded – undo
40 40
  */
41 41
 class TDBMService
42 42
 {
43
-    const MODE_CURSOR = 1;
44
-    const MODE_ARRAY = 2;
45
-
46
-    /**
47
-     * The database connection.
48
-     *
49
-     * @var Connection
50
-     */
51
-    private $connection;
52
-
53
-    /**
54
-     * @var SchemaAnalyzer
55
-     */
56
-    private $schemaAnalyzer;
57
-
58
-    /**
59
-     * @var MagicQuery
60
-     */
61
-    private $magicQuery;
62
-
63
-    /**
64
-     * @var TDBMSchemaAnalyzer
65
-     */
66
-    private $tdbmSchemaAnalyzer;
67
-
68
-    /**
69
-     * @var string
70
-     */
71
-    private $cachePrefix;
72
-
73
-    /**
74
-     * Cache of table of primary keys.
75
-     * Primary keys are stored by tables, as an array of column.
76
-     * For instance $primary_key['my_table'][0] will return the first column of the primary key of table 'my_table'.
77
-     *
78
-     * @var string[]
79
-     */
80
-    private $primaryKeysColumns;
81
-
82
-    /**
83
-     * Service storing objects in memory.
84
-     * Access is done by table name and then by primary key.
85
-     * If the primary key is split on several columns, access is done by an array of columns, serialized.
86
-     *
87
-     * @var StandardObjectStorage|WeakrefObjectStorage
88
-     */
89
-    private $objectStorage;
90
-
91
-    /**
92
-     * The fetch mode of the result sets returned by `getObjects`.
93
-     * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY or TDBMObjectArray::MODE_COMPATIBLE_ARRAY.
94
-     *
95
-     * In 'MODE_ARRAY' mode (default), the result is an array. Use this mode by default (unless the list returned is very big).
96
-     * In 'MODE_CURSOR' mode, the result is a Generator which is an iterable collection that can be scanned only once (only one "foreach") on it,
97
-     * and it cannot be accessed via key. Use this mode for large datasets processed by batch.
98
-     * In 'MODE_COMPATIBLE_ARRAY' mode, the result is an old TDBMObjectArray (used up to TDBM 3.2).
99
-     * You can access the array by key, or using foreach, several times.
100
-     *
101
-     * @var int
102
-     */
103
-    private $mode = self::MODE_ARRAY;
104
-
105
-    /**
106
-     * Table of new objects not yet inserted in database or objects modified that must be saved.
107
-     *
108
-     * @var \SplObjectStorage of DbRow objects
109
-     */
110
-    private $toSaveObjects;
111
-
112
-    /**
113
-     * The content of the cache variable.
114
-     *
115
-     * @var array<string, mixed>
116
-     */
117
-    private $cache;
118
-
119
-    /**
120
-     * Map associating a table name to a fully qualified Bean class name.
121
-     *
122
-     * @var array
123
-     */
124
-    private $tableToBeanMap = [];
125
-
126
-    /**
127
-     * @var \ReflectionClass[]
128
-     */
129
-    private $reflectionClassCache = array();
130
-
131
-    /**
132
-     * @param Connection     $connection     The DBAL DB connection to use
133
-     * @param Cache|null     $cache          A cache service to be used
134
-     * @param SchemaAnalyzer $schemaAnalyzer The schema analyzer that will be used to find shortest paths...
135
-     *                                       Will be automatically created if not passed.
136
-     */
137
-    public function __construct(Connection $connection, Cache $cache = null, SchemaAnalyzer $schemaAnalyzer = null)
138
-    {
139
-        if (extension_loaded('weakref')) {
140
-            $this->objectStorage = new WeakrefObjectStorage();
141
-        } else {
142
-            $this->objectStorage = new StandardObjectStorage();
143
-        }
144
-        $this->connection = $connection;
145
-        if ($cache !== null) {
146
-            $this->cache = $cache;
147
-        } else {
148
-            $this->cache = new VoidCache();
149
-        }
150
-        if ($schemaAnalyzer) {
151
-            $this->schemaAnalyzer = $schemaAnalyzer;
152
-        } else {
153
-            $this->schemaAnalyzer = new SchemaAnalyzer($this->connection->getSchemaManager(), $this->cache, $this->getConnectionUniqueId());
154
-        }
155
-
156
-        $this->magicQuery = new MagicQuery($this->connection, $this->cache, $this->schemaAnalyzer);
157
-
158
-        $this->tdbmSchemaAnalyzer = new TDBMSchemaAnalyzer($connection, $this->cache, $this->schemaAnalyzer);
159
-        $this->cachePrefix = $this->tdbmSchemaAnalyzer->getCachePrefix();
160
-
161
-        $this->toSaveObjects = new \SplObjectStorage();
162
-    }
163
-
164
-    /**
165
-     * Returns the object used to connect to the database.
166
-     *
167
-     * @return Connection
168
-     */
169
-    public function getConnection()
170
-    {
171
-        return $this->connection;
172
-    }
173
-
174
-    /**
175
-     * Creates a unique cache key for the current connection.
176
-     *
177
-     * @return string
178
-     */
179
-    private function getConnectionUniqueId()
180
-    {
181
-        return hash('md4', $this->connection->getHost().'-'.$this->connection->getPort().'-'.$this->connection->getDatabase().'-'.$this->connection->getDriver()->getName());
182
-    }
183
-
184
-    /**
185
-     * Sets the default fetch mode of the result sets returned by `findObjects`.
186
-     * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY.
187
-     *
188
-     * In 'MODE_ARRAY' mode (default), the result is a ResultIterator object that behaves like an array. Use this mode by default (unless the list returned is very big).
189
-     * In 'MODE_CURSOR' mode, the result is a ResultIterator object. If you scan it many times (by calling several time a foreach loop), the query will be run
190
-     * several times. In cursor mode, you cannot access the result set by key. Use this mode for large datasets processed by batch.
191
-     *
192
-     * @param int $mode
193
-     *
194
-     * @return $this
195
-     *
196
-     * @throws TDBMException
197
-     */
198
-    public function setFetchMode($mode)
199
-    {
200
-        if ($mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) {
201
-            throw new TDBMException("Unknown fetch mode: '".$this->mode."'");
202
-        }
203
-        $this->mode = $mode;
204
-
205
-        return $this;
206
-    }
207
-
208
-    /**
209
-     * Returns a TDBMObject associated from table "$table_name".
210
-     * If the $filters parameter is an int/string, the object returned will be the object whose primary key = $filters.
211
-     * $filters can also be a set of TDBM_Filters (see the findObjects method for more details).
212
-     *
213
-     * For instance, if there is a table 'users', with a primary key on column 'user_id' and a column 'user_name', then
214
-     * 			$user = $tdbmService->getObject('users',1);
215
-     * 			echo $user->name;
216
-     * will return the name of the user whose user_id is one.
217
-     *
218
-     * If a table has a primary key over several columns, you should pass to $id an array containing the the value of the various columns.
219
-     * For instance:
220
-     * 			$group = $tdbmService->getObject('groups',array(1,2));
221
-     *
222
-     * Note that TDBMObject performs caching for you. If you get twice the same object, the reference of the object you will get
223
-     * will be the same.
224
-     *
225
-     * For instance:
226
-     * 			$user1 = $tdbmService->getObject('users',1);
227
-     * 			$user2 = $tdbmService->getObject('users',1);
228
-     * 			$user1->name = 'John Doe';
229
-     * 			echo $user2->name;
230
-     * will return 'John Doe'.
231
-     *
232
-     * You can use filters instead of passing the primary key. For instance:
233
-     * 			$user = $tdbmService->getObject('users',new EqualFilter('users', 'login', 'jdoe'));
234
-     * This will return the user whose login is 'jdoe'.
235
-     * Please note that if 2 users have the jdoe login in database, the method will throw a TDBM_DuplicateRowException.
236
-     *
237
-     * Also, you can specify the return class for the object (provided the return class extends TDBMObject).
238
-     * For instance:
239
-     *  	$user = $tdbmService->getObject('users',1,'User');
240
-     * will return an object from the "User" class. The "User" class must extend the "TDBMObject" class.
241
-     * Please be sure not to override any method or any property unless you perfectly know what you are doing!
242
-     *
243
-     * @param string $table_name   The name of the table we retrieve an object from.
244
-     * @param mixed  $filters      If the filter is a string/integer, it will be considered as the id of the object (the value of the primary key). Otherwise, it can be a filter bag (see the filterbag parameter of the findObjects method for more details about filter bags)
245
-     * @param string $className    Optional: The name of the class to instanciate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
246
-     * @param bool   $lazy_loading If set to true, and if the primary key is passed in parameter of getObject, the object will not be queried in database. It will be queried when you first try to access a column. If at that time the object cannot be found in database, an exception will be thrown.
247
-     *
248
-     * @return TDBMObject
249
-     */
43
+	const MODE_CURSOR = 1;
44
+	const MODE_ARRAY = 2;
45
+
46
+	/**
47
+	 * The database connection.
48
+	 *
49
+	 * @var Connection
50
+	 */
51
+	private $connection;
52
+
53
+	/**
54
+	 * @var SchemaAnalyzer
55
+	 */
56
+	private $schemaAnalyzer;
57
+
58
+	/**
59
+	 * @var MagicQuery
60
+	 */
61
+	private $magicQuery;
62
+
63
+	/**
64
+	 * @var TDBMSchemaAnalyzer
65
+	 */
66
+	private $tdbmSchemaAnalyzer;
67
+
68
+	/**
69
+	 * @var string
70
+	 */
71
+	private $cachePrefix;
72
+
73
+	/**
74
+	 * Cache of table of primary keys.
75
+	 * Primary keys are stored by tables, as an array of column.
76
+	 * For instance $primary_key['my_table'][0] will return the first column of the primary key of table 'my_table'.
77
+	 *
78
+	 * @var string[]
79
+	 */
80
+	private $primaryKeysColumns;
81
+
82
+	/**
83
+	 * Service storing objects in memory.
84
+	 * Access is done by table name and then by primary key.
85
+	 * If the primary key is split on several columns, access is done by an array of columns, serialized.
86
+	 *
87
+	 * @var StandardObjectStorage|WeakrefObjectStorage
88
+	 */
89
+	private $objectStorage;
90
+
91
+	/**
92
+	 * The fetch mode of the result sets returned by `getObjects`.
93
+	 * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY or TDBMObjectArray::MODE_COMPATIBLE_ARRAY.
94
+	 *
95
+	 * In 'MODE_ARRAY' mode (default), the result is an array. Use this mode by default (unless the list returned is very big).
96
+	 * In 'MODE_CURSOR' mode, the result is a Generator which is an iterable collection that can be scanned only once (only one "foreach") on it,
97
+	 * and it cannot be accessed via key. Use this mode for large datasets processed by batch.
98
+	 * In 'MODE_COMPATIBLE_ARRAY' mode, the result is an old TDBMObjectArray (used up to TDBM 3.2).
99
+	 * You can access the array by key, or using foreach, several times.
100
+	 *
101
+	 * @var int
102
+	 */
103
+	private $mode = self::MODE_ARRAY;
104
+
105
+	/**
106
+	 * Table of new objects not yet inserted in database or objects modified that must be saved.
107
+	 *
108
+	 * @var \SplObjectStorage of DbRow objects
109
+	 */
110
+	private $toSaveObjects;
111
+
112
+	/**
113
+	 * The content of the cache variable.
114
+	 *
115
+	 * @var array<string, mixed>
116
+	 */
117
+	private $cache;
118
+
119
+	/**
120
+	 * Map associating a table name to a fully qualified Bean class name.
121
+	 *
122
+	 * @var array
123
+	 */
124
+	private $tableToBeanMap = [];
125
+
126
+	/**
127
+	 * @var \ReflectionClass[]
128
+	 */
129
+	private $reflectionClassCache = array();
130
+
131
+	/**
132
+	 * @param Connection     $connection     The DBAL DB connection to use
133
+	 * @param Cache|null     $cache          A cache service to be used
134
+	 * @param SchemaAnalyzer $schemaAnalyzer The schema analyzer that will be used to find shortest paths...
135
+	 *                                       Will be automatically created if not passed.
136
+	 */
137
+	public function __construct(Connection $connection, Cache $cache = null, SchemaAnalyzer $schemaAnalyzer = null)
138
+	{
139
+		if (extension_loaded('weakref')) {
140
+			$this->objectStorage = new WeakrefObjectStorage();
141
+		} else {
142
+			$this->objectStorage = new StandardObjectStorage();
143
+		}
144
+		$this->connection = $connection;
145
+		if ($cache !== null) {
146
+			$this->cache = $cache;
147
+		} else {
148
+			$this->cache = new VoidCache();
149
+		}
150
+		if ($schemaAnalyzer) {
151
+			$this->schemaAnalyzer = $schemaAnalyzer;
152
+		} else {
153
+			$this->schemaAnalyzer = new SchemaAnalyzer($this->connection->getSchemaManager(), $this->cache, $this->getConnectionUniqueId());
154
+		}
155
+
156
+		$this->magicQuery = new MagicQuery($this->connection, $this->cache, $this->schemaAnalyzer);
157
+
158
+		$this->tdbmSchemaAnalyzer = new TDBMSchemaAnalyzer($connection, $this->cache, $this->schemaAnalyzer);
159
+		$this->cachePrefix = $this->tdbmSchemaAnalyzer->getCachePrefix();
160
+
161
+		$this->toSaveObjects = new \SplObjectStorage();
162
+	}
163
+
164
+	/**
165
+	 * Returns the object used to connect to the database.
166
+	 *
167
+	 * @return Connection
168
+	 */
169
+	public function getConnection()
170
+	{
171
+		return $this->connection;
172
+	}
173
+
174
+	/**
175
+	 * Creates a unique cache key for the current connection.
176
+	 *
177
+	 * @return string
178
+	 */
179
+	private function getConnectionUniqueId()
180
+	{
181
+		return hash('md4', $this->connection->getHost().'-'.$this->connection->getPort().'-'.$this->connection->getDatabase().'-'.$this->connection->getDriver()->getName());
182
+	}
183
+
184
+	/**
185
+	 * Sets the default fetch mode of the result sets returned by `findObjects`.
186
+	 * Can be one of: TDBMObjectArray::MODE_CURSOR or TDBMObjectArray::MODE_ARRAY.
187
+	 *
188
+	 * In 'MODE_ARRAY' mode (default), the result is a ResultIterator object that behaves like an array. Use this mode by default (unless the list returned is very big).
189
+	 * In 'MODE_CURSOR' mode, the result is a ResultIterator object. If you scan it many times (by calling several time a foreach loop), the query will be run
190
+	 * several times. In cursor mode, you cannot access the result set by key. Use this mode for large datasets processed by batch.
191
+	 *
192
+	 * @param int $mode
193
+	 *
194
+	 * @return $this
195
+	 *
196
+	 * @throws TDBMException
197
+	 */
198
+	public function setFetchMode($mode)
199
+	{
200
+		if ($mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) {
201
+			throw new TDBMException("Unknown fetch mode: '".$this->mode."'");
202
+		}
203
+		$this->mode = $mode;
204
+
205
+		return $this;
206
+	}
207
+
208
+	/**
209
+	 * Returns a TDBMObject associated from table "$table_name".
210
+	 * If the $filters parameter is an int/string, the object returned will be the object whose primary key = $filters.
211
+	 * $filters can also be a set of TDBM_Filters (see the findObjects method for more details).
212
+	 *
213
+	 * For instance, if there is a table 'users', with a primary key on column 'user_id' and a column 'user_name', then
214
+	 * 			$user = $tdbmService->getObject('users',1);
215
+	 * 			echo $user->name;
216
+	 * will return the name of the user whose user_id is one.
217
+	 *
218
+	 * If a table has a primary key over several columns, you should pass to $id an array containing the the value of the various columns.
219
+	 * For instance:
220
+	 * 			$group = $tdbmService->getObject('groups',array(1,2));
221
+	 *
222
+	 * Note that TDBMObject performs caching for you. If you get twice the same object, the reference of the object you will get
223
+	 * will be the same.
224
+	 *
225
+	 * For instance:
226
+	 * 			$user1 = $tdbmService->getObject('users',1);
227
+	 * 			$user2 = $tdbmService->getObject('users',1);
228
+	 * 			$user1->name = 'John Doe';
229
+	 * 			echo $user2->name;
230
+	 * will return 'John Doe'.
231
+	 *
232
+	 * You can use filters instead of passing the primary key. For instance:
233
+	 * 			$user = $tdbmService->getObject('users',new EqualFilter('users', 'login', 'jdoe'));
234
+	 * This will return the user whose login is 'jdoe'.
235
+	 * Please note that if 2 users have the jdoe login in database, the method will throw a TDBM_DuplicateRowException.
236
+	 *
237
+	 * Also, you can specify the return class for the object (provided the return class extends TDBMObject).
238
+	 * For instance:
239
+	 *  	$user = $tdbmService->getObject('users',1,'User');
240
+	 * will return an object from the "User" class. The "User" class must extend the "TDBMObject" class.
241
+	 * Please be sure not to override any method or any property unless you perfectly know what you are doing!
242
+	 *
243
+	 * @param string $table_name   The name of the table we retrieve an object from.
244
+	 * @param mixed  $filters      If the filter is a string/integer, it will be considered as the id of the object (the value of the primary key). Otherwise, it can be a filter bag (see the filterbag parameter of the findObjects method for more details about filter bags)
245
+	 * @param string $className    Optional: The name of the class to instanciate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
246
+	 * @param bool   $lazy_loading If set to true, and if the primary key is passed in parameter of getObject, the object will not be queried in database. It will be queried when you first try to access a column. If at that time the object cannot be found in database, an exception will be thrown.
247
+	 *
248
+	 * @return TDBMObject
249
+	 */
250 250
 /*	public function getObject($table_name, $filters, $className = null, $lazy_loading = false) {
251 251
 
252 252
         if (is_array($filters) || $filters instanceof FilterInterface) {
@@ -332,199 +332,199 @@  discard block
 block discarded – undo
332 332
         return $obj;
333 333
     }*/
334 334
 
335
-    /**
336
-     * Removes the given object from database.
337
-     * This cannot be called on an object that is not attached to this TDBMService
338
-     * (will throw a TDBMInvalidOperationException).
339
-     *
340
-     * @param AbstractTDBMObject $object the object to delete.
341
-     *
342
-     * @throws TDBMException
343
-     * @throws TDBMInvalidOperationException
344
-     */
345
-    public function delete(AbstractTDBMObject $object)
346
-    {
347
-        switch ($object->_getStatus()) {
348
-            case TDBMObjectStateEnum::STATE_DELETED:
349
-                // Nothing to do, object already deleted.
350
-                return;
351
-            case TDBMObjectStateEnum::STATE_DETACHED:
352
-                throw new TDBMInvalidOperationException('Cannot delete a detached object');
353
-            case TDBMObjectStateEnum::STATE_NEW:
354
-                $this->deleteManyToManyRelationships($object);
355
-                foreach ($object->_getDbRows() as $dbRow) {
356
-                    $this->removeFromToSaveObjectList($dbRow);
357
-                }
358
-                break;
359
-            case TDBMObjectStateEnum::STATE_DIRTY:
360
-                foreach ($object->_getDbRows() as $dbRow) {
361
-                    $this->removeFromToSaveObjectList($dbRow);
362
-                }
363
-                // And continue deleting...
364
-            case TDBMObjectStateEnum::STATE_NOT_LOADED:
365
-            case TDBMObjectStateEnum::STATE_LOADED:
366
-                $this->deleteManyToManyRelationships($object);
367
-                // Let's delete db rows, in reverse order.
368
-                foreach (array_reverse($object->_getDbRows()) as $dbRow) {
369
-                    $tableName = $dbRow->_getDbTableName();
370
-                    $primaryKeys = $dbRow->_getPrimaryKeys();
371
-                    $this->connection->delete($tableName, $primaryKeys);
372
-                    $this->objectStorage->remove($dbRow->_getDbTableName(), $this->getObjectHash($primaryKeys));
373
-                }
374
-                break;
375
-            // @codeCoverageIgnoreStart
376
-            default:
377
-                throw new TDBMInvalidOperationException('Unexpected status for bean');
378
-            // @codeCoverageIgnoreEnd
379
-        }
380
-
381
-        $object->_setStatus(TDBMObjectStateEnum::STATE_DELETED);
382
-    }
383
-
384
-    /**
385
-     * Removes all many to many relationships for this object.
386
-     *
387
-     * @param AbstractTDBMObject $object
388
-     */
389
-    private function deleteManyToManyRelationships(AbstractTDBMObject $object)
390
-    {
391
-        foreach ($object->_getDbRows() as $tableName => $dbRow) {
392
-            $pivotTables = $this->tdbmSchemaAnalyzer->getPivotTableLinkedToTable($tableName);
393
-            foreach ($pivotTables as $pivotTable) {
394
-                $remoteBeans = $object->_getRelationships($pivotTable);
395
-                foreach ($remoteBeans as $remoteBean) {
396
-                    $object->_removeRelationship($pivotTable, $remoteBean);
397
-                }
398
-            }
399
-        }
400
-        $this->persistManyToManyRelationships($object);
401
-    }
402
-
403
-    /**
404
-     * This function removes the given object from the database. It will also remove all objects relied to the one given
405
-     * by parameter before all.
406
-     *
407
-     * Notice: if the object has a multiple primary key, the function will not work.
408
-     *
409
-     * @param AbstractTDBMObject $objToDelete
410
-     */
411
-    public function deleteCascade(AbstractTDBMObject $objToDelete)
412
-    {
413
-        $this->deleteAllConstraintWithThisObject($objToDelete);
414
-        $this->delete($objToDelete);
415
-    }
416
-
417
-    /**
418
-     * This function is used only in TDBMService (private function)
419
-     * It will call deleteCascade function foreach object relied with a foreign key to the object given by parameter.
420
-     *
421
-     * @param AbstractTDBMObject $obj
422
-     */
423
-    private function deleteAllConstraintWithThisObject(AbstractTDBMObject $obj)
424
-    {
425
-        $dbRows = $obj->_getDbRows();
426
-        foreach ($dbRows as $dbRow) {
427
-            $tableName = $dbRow->_getDbTableName();
428
-            $pks = array_values($dbRow->_getPrimaryKeys());
429
-            if (!empty($pks)) {
430
-                $incomingFks = $this->tdbmSchemaAnalyzer->getIncomingForeignKeys($tableName);
431
-
432
-                foreach ($incomingFks as $incomingFk) {
433
-                    $filter = array_combine($incomingFk->getLocalColumns(), $pks);
434
-
435
-                    $results = $this->findObjects($incomingFk->getLocalTableName(), $filter);
436
-
437
-                    foreach ($results as $bean) {
438
-                        $this->deleteCascade($bean);
439
-                    }
440
-                }
441
-            }
442
-        }
443
-    }
444
-
445
-    /**
446
-     * This function performs a save() of all the objects that have been modified.
447
-     */
448
-    public function completeSave()
449
-    {
450
-        foreach ($this->toSaveObjects as $dbRow) {
451
-            $this->save($dbRow->getTDBMObject());
452
-        }
453
-    }
454
-
455
-    /**
456
-     * Takes in input a filter_bag (which can be about anything from a string to an array of TDBMObjects... see above from documentation),
457
-     * and gives back a proper Filter object.
458
-     *
459
-     * @param mixed $filter_bag
460
-     * @param int   $counter
461
-     *
462
-     * @return array First item: filter string, second item: parameters.
463
-     *
464
-     * @throws TDBMException
465
-     */
466
-    public function buildFilterFromFilterBag($filter_bag, $counter = 1)
467
-    {
468
-        if ($filter_bag === null) {
469
-            return ['', []];
470
-        } elseif (is_string($filter_bag)) {
471
-            return [$filter_bag, []];
472
-        } elseif (is_array($filter_bag)) {
473
-            $sqlParts = [];
474
-            $parameters = [];
475
-            foreach ($filter_bag as $column => $value) {
476
-                if (is_int($column)) {
477
-                    list($subSqlPart, $subParameters) = $this->buildFilterFromFilterBag($value, $counter);
478
-                    $sqlParts[] = $subSqlPart;
479
-                    $parameters += $subParameters;
480
-                } else {
481
-                    $paramName = 'tdbmparam'.$counter;
482
-                    if (is_array($value)) {
483
-                        $sqlParts[] = $this->connection->quoteIdentifier($column).' IN :'.$paramName;
484
-                    } else {
485
-                        $sqlParts[] = $this->connection->quoteIdentifier($column).' = :'.$paramName;
486
-                    }
487
-                    $parameters[$paramName] = $value;
488
-                    ++$counter;
489
-                }
490
-            }
491
-
492
-            return [implode(' AND ', $sqlParts), $parameters];
493
-        } elseif ($filter_bag instanceof AbstractTDBMObject) {
494
-            $sqlParts = [];
495
-            $parameters = [];
496
-            $dbRows = $filter_bag->_getDbRows();
497
-            $dbRow = reset($dbRows);
498
-            $primaryKeys = $dbRow->_getPrimaryKeys();
499
-
500
-            foreach ($primaryKeys as $column => $value) {
501
-                $paramName = 'tdbmparam'.$counter;
502
-                $sqlParts[] = $this->connection->quoteIdentifier($dbRow->_getDbTableName()).'.'.$this->connection->quoteIdentifier($column).' = :'.$paramName;
503
-                $parameters[$paramName] = $value;
504
-                ++$counter;
505
-            }
506
-
507
-            return [implode(' AND ', $sqlParts), $parameters];
508
-        } elseif ($filter_bag instanceof \Iterator) {
509
-            return $this->buildFilterFromFilterBag(iterator_to_array($filter_bag), $counter);
510
-        } else {
511
-            throw new TDBMException('Error in filter. An object has been passed that is neither a SQL string, nor an array, nor a bean, nor null.');
512
-        }
513
-    }
514
-
515
-    /**
516
-     * @param string $table
517
-     *
518
-     * @return string[]
519
-     */
520
-    public function getPrimaryKeyColumns($table)
521
-    {
522
-        if (!isset($this->primaryKeysColumns[$table])) {
523
-            $this->primaryKeysColumns[$table] = $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getPrimaryKeyColumns();
524
-
525
-            // TODO TDBM4: See if we need to improve error reporting if table name does not exist.
526
-
527
-            /*$arr = array();
335
+	/**
336
+	 * Removes the given object from database.
337
+	 * This cannot be called on an object that is not attached to this TDBMService
338
+	 * (will throw a TDBMInvalidOperationException).
339
+	 *
340
+	 * @param AbstractTDBMObject $object the object to delete.
341
+	 *
342
+	 * @throws TDBMException
343
+	 * @throws TDBMInvalidOperationException
344
+	 */
345
+	public function delete(AbstractTDBMObject $object)
346
+	{
347
+		switch ($object->_getStatus()) {
348
+			case TDBMObjectStateEnum::STATE_DELETED:
349
+				// Nothing to do, object already deleted.
350
+				return;
351
+			case TDBMObjectStateEnum::STATE_DETACHED:
352
+				throw new TDBMInvalidOperationException('Cannot delete a detached object');
353
+			case TDBMObjectStateEnum::STATE_NEW:
354
+				$this->deleteManyToManyRelationships($object);
355
+				foreach ($object->_getDbRows() as $dbRow) {
356
+					$this->removeFromToSaveObjectList($dbRow);
357
+				}
358
+				break;
359
+			case TDBMObjectStateEnum::STATE_DIRTY:
360
+				foreach ($object->_getDbRows() as $dbRow) {
361
+					$this->removeFromToSaveObjectList($dbRow);
362
+				}
363
+				// And continue deleting...
364
+			case TDBMObjectStateEnum::STATE_NOT_LOADED:
365
+			case TDBMObjectStateEnum::STATE_LOADED:
366
+				$this->deleteManyToManyRelationships($object);
367
+				// Let's delete db rows, in reverse order.
368
+				foreach (array_reverse($object->_getDbRows()) as $dbRow) {
369
+					$tableName = $dbRow->_getDbTableName();
370
+					$primaryKeys = $dbRow->_getPrimaryKeys();
371
+					$this->connection->delete($tableName, $primaryKeys);
372
+					$this->objectStorage->remove($dbRow->_getDbTableName(), $this->getObjectHash($primaryKeys));
373
+				}
374
+				break;
375
+			// @codeCoverageIgnoreStart
376
+			default:
377
+				throw new TDBMInvalidOperationException('Unexpected status for bean');
378
+			// @codeCoverageIgnoreEnd
379
+		}
380
+
381
+		$object->_setStatus(TDBMObjectStateEnum::STATE_DELETED);
382
+	}
383
+
384
+	/**
385
+	 * Removes all many to many relationships for this object.
386
+	 *
387
+	 * @param AbstractTDBMObject $object
388
+	 */
389
+	private function deleteManyToManyRelationships(AbstractTDBMObject $object)
390
+	{
391
+		foreach ($object->_getDbRows() as $tableName => $dbRow) {
392
+			$pivotTables = $this->tdbmSchemaAnalyzer->getPivotTableLinkedToTable($tableName);
393
+			foreach ($pivotTables as $pivotTable) {
394
+				$remoteBeans = $object->_getRelationships($pivotTable);
395
+				foreach ($remoteBeans as $remoteBean) {
396
+					$object->_removeRelationship($pivotTable, $remoteBean);
397
+				}
398
+			}
399
+		}
400
+		$this->persistManyToManyRelationships($object);
401
+	}
402
+
403
+	/**
404
+	 * This function removes the given object from the database. It will also remove all objects relied to the one given
405
+	 * by parameter before all.
406
+	 *
407
+	 * Notice: if the object has a multiple primary key, the function will not work.
408
+	 *
409
+	 * @param AbstractTDBMObject $objToDelete
410
+	 */
411
+	public function deleteCascade(AbstractTDBMObject $objToDelete)
412
+	{
413
+		$this->deleteAllConstraintWithThisObject($objToDelete);
414
+		$this->delete($objToDelete);
415
+	}
416
+
417
+	/**
418
+	 * This function is used only in TDBMService (private function)
419
+	 * It will call deleteCascade function foreach object relied with a foreign key to the object given by parameter.
420
+	 *
421
+	 * @param AbstractTDBMObject $obj
422
+	 */
423
+	private function deleteAllConstraintWithThisObject(AbstractTDBMObject $obj)
424
+	{
425
+		$dbRows = $obj->_getDbRows();
426
+		foreach ($dbRows as $dbRow) {
427
+			$tableName = $dbRow->_getDbTableName();
428
+			$pks = array_values($dbRow->_getPrimaryKeys());
429
+			if (!empty($pks)) {
430
+				$incomingFks = $this->tdbmSchemaAnalyzer->getIncomingForeignKeys($tableName);
431
+
432
+				foreach ($incomingFks as $incomingFk) {
433
+					$filter = array_combine($incomingFk->getLocalColumns(), $pks);
434
+
435
+					$results = $this->findObjects($incomingFk->getLocalTableName(), $filter);
436
+
437
+					foreach ($results as $bean) {
438
+						$this->deleteCascade($bean);
439
+					}
440
+				}
441
+			}
442
+		}
443
+	}
444
+
445
+	/**
446
+	 * This function performs a save() of all the objects that have been modified.
447
+	 */
448
+	public function completeSave()
449
+	{
450
+		foreach ($this->toSaveObjects as $dbRow) {
451
+			$this->save($dbRow->getTDBMObject());
452
+		}
453
+	}
454
+
455
+	/**
456
+	 * Takes in input a filter_bag (which can be about anything from a string to an array of TDBMObjects... see above from documentation),
457
+	 * and gives back a proper Filter object.
458
+	 *
459
+	 * @param mixed $filter_bag
460
+	 * @param int   $counter
461
+	 *
462
+	 * @return array First item: filter string, second item: parameters.
463
+	 *
464
+	 * @throws TDBMException
465
+	 */
466
+	public function buildFilterFromFilterBag($filter_bag, $counter = 1)
467
+	{
468
+		if ($filter_bag === null) {
469
+			return ['', []];
470
+		} elseif (is_string($filter_bag)) {
471
+			return [$filter_bag, []];
472
+		} elseif (is_array($filter_bag)) {
473
+			$sqlParts = [];
474
+			$parameters = [];
475
+			foreach ($filter_bag as $column => $value) {
476
+				if (is_int($column)) {
477
+					list($subSqlPart, $subParameters) = $this->buildFilterFromFilterBag($value, $counter);
478
+					$sqlParts[] = $subSqlPart;
479
+					$parameters += $subParameters;
480
+				} else {
481
+					$paramName = 'tdbmparam'.$counter;
482
+					if (is_array($value)) {
483
+						$sqlParts[] = $this->connection->quoteIdentifier($column).' IN :'.$paramName;
484
+					} else {
485
+						$sqlParts[] = $this->connection->quoteIdentifier($column).' = :'.$paramName;
486
+					}
487
+					$parameters[$paramName] = $value;
488
+					++$counter;
489
+				}
490
+			}
491
+
492
+			return [implode(' AND ', $sqlParts), $parameters];
493
+		} elseif ($filter_bag instanceof AbstractTDBMObject) {
494
+			$sqlParts = [];
495
+			$parameters = [];
496
+			$dbRows = $filter_bag->_getDbRows();
497
+			$dbRow = reset($dbRows);
498
+			$primaryKeys = $dbRow->_getPrimaryKeys();
499
+
500
+			foreach ($primaryKeys as $column => $value) {
501
+				$paramName = 'tdbmparam'.$counter;
502
+				$sqlParts[] = $this->connection->quoteIdentifier($dbRow->_getDbTableName()).'.'.$this->connection->quoteIdentifier($column).' = :'.$paramName;
503
+				$parameters[$paramName] = $value;
504
+				++$counter;
505
+			}
506
+
507
+			return [implode(' AND ', $sqlParts), $parameters];
508
+		} elseif ($filter_bag instanceof \Iterator) {
509
+			return $this->buildFilterFromFilterBag(iterator_to_array($filter_bag), $counter);
510
+		} else {
511
+			throw new TDBMException('Error in filter. An object has been passed that is neither a SQL string, nor an array, nor a bean, nor null.');
512
+		}
513
+	}
514
+
515
+	/**
516
+	 * @param string $table
517
+	 *
518
+	 * @return string[]
519
+	 */
520
+	public function getPrimaryKeyColumns($table)
521
+	{
522
+		if (!isset($this->primaryKeysColumns[$table])) {
523
+			$this->primaryKeysColumns[$table] = $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getPrimaryKeyColumns();
524
+
525
+			// TODO TDBM4: See if we need to improve error reporting if table name does not exist.
526
+
527
+			/*$arr = array();
528 528
             foreach ($this->connection->getPrimaryKey($table) as $col) {
529 529
                 $arr[] = $col->name;
530 530
             }
@@ -545,135 +545,135 @@  discard block
 block discarded – undo
545 545
                     throw new TDBMException($str);
546 546
                 }
547 547
             }*/
548
-        }
549
-
550
-        return $this->primaryKeysColumns[$table];
551
-    }
552
-
553
-    /**
554
-     * This is an internal function, you should not use it in your application.
555
-     * This is used internally by TDBM to add an object to the object cache.
556
-     *
557
-     * @param DbRow $dbRow
558
-     */
559
-    public function _addToCache(DbRow $dbRow)
560
-    {
561
-        $primaryKey = $this->getPrimaryKeysForObjectFromDbRow($dbRow);
562
-        $hash = $this->getObjectHash($primaryKey);
563
-        $this->objectStorage->set($dbRow->_getDbTableName(), $hash, $dbRow);
564
-    }
565
-
566
-    /**
567
-     * This is an internal function, you should not use it in your application.
568
-     * This is used internally by TDBM to remove the object from the list of objects that have been
569
-     * created/updated but not saved yet.
570
-     *
571
-     * @param DbRow $myObject
572
-     */
573
-    private function removeFromToSaveObjectList(DbRow $myObject)
574
-    {
575
-        unset($this->toSaveObjects[$myObject]);
576
-    }
577
-
578
-    /**
579
-     * This is an internal function, you should not use it in your application.
580
-     * This is used internally by TDBM to add an object to the list of objects that have been
581
-     * created/updated but not saved yet.
582
-     *
583
-     * @param AbstractTDBMObject $myObject
584
-     */
585
-    public function _addToToSaveObjectList(DbRow $myObject)
586
-    {
587
-        $this->toSaveObjects[$myObject] = true;
588
-    }
589
-
590
-    /**
591
-     * Generates all the daos and beans.
592
-     *
593
-     * @param string $daoFactoryClassName The classe name of the DAO factory
594
-     * @param string $daonamespace        The namespace for the DAOs, without trailing \
595
-     * @param string $beannamespace       The Namespace for the beans, without trailing \
596
-     * @param bool   $storeInUtc          If the generated daos should store the date in UTC timezone instead of user's timezone.
597
-     * @param string $composerFile        If it's set, location of custom Composer file. Relative to project root.
598
-     *
599
-     * @return \string[] the list of tables
600
-     */
601
-    public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc, $composerFile = null)
602
-    {
603
-        // Purge cache before generating anything.
604
-        $this->cache->deleteAll();
605
-
606
-        $tdbmDaoGenerator = new TDBMDaoGenerator($this->schemaAnalyzer, $this->tdbmSchemaAnalyzer->getSchema(), $this->tdbmSchemaAnalyzer);
607
-        if (null !== $composerFile) {
608
-            $tdbmDaoGenerator->setComposerFile(__DIR__.'/../../../../../../../'.$composerFile);
609
-        }
610
-
611
-        return $tdbmDaoGenerator->generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc);
612
-    }
613
-
614
-    /**
615
-     * @param array<string, string> $tableToBeanMap
616
-     */
617
-    public function setTableToBeanMap(array $tableToBeanMap)
618
-    {
619
-        $this->tableToBeanMap = $tableToBeanMap;
620
-    }
621
-
622
-    /**
623
-     * Saves $object by INSERTing or UPDAT(E)ing it in the database.
624
-     *
625
-     * @param AbstractTDBMObject $object
626
-     *
627
-     * @throws TDBMException
628
-     */
629
-    public function save(AbstractTDBMObject $object)
630
-    {
631
-        $status = $object->_getStatus();
632
-
633
-        // Let's attach this object if it is in detached state.
634
-        if ($status === TDBMObjectStateEnum::STATE_DETACHED) {
635
-            $object->_attach($this);
636
-            $status = $object->_getStatus();
637
-        }
638
-
639
-        if ($status === TDBMObjectStateEnum::STATE_NEW) {
640
-            $dbRows = $object->_getDbRows();
641
-
642
-            $unindexedPrimaryKeys = array();
643
-
644
-            foreach ($dbRows as $dbRow) {
645
-                $tableName = $dbRow->_getDbTableName();
646
-
647
-                $schema = $this->tdbmSchemaAnalyzer->getSchema();
648
-                $tableDescriptor = $schema->getTable($tableName);
649
-
650
-                $primaryKeyColumns = $this->getPrimaryKeyColumns($tableName);
651
-
652
-                if (empty($unindexedPrimaryKeys)) {
653
-                    $primaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow);
654
-                } else {
655
-                    // First insert, the children must have the same primary key as the parent.
656
-                    $primaryKeys = $this->_getPrimaryKeysFromIndexedPrimaryKeys($tableName, $unindexedPrimaryKeys);
657
-                    $dbRow->_setPrimaryKeys($primaryKeys);
658
-                }
659
-
660
-                $references = $dbRow->_getReferences();
661
-
662
-                // Let's save all references in NEW or DETACHED state (we need their primary key)
663
-                foreach ($references as $fkName => $reference) {
664
-                    $refStatus = $reference->_getStatus();
665
-                    if ($refStatus === TDBMObjectStateEnum::STATE_NEW || $refStatus === TDBMObjectStateEnum::STATE_DETACHED) {
666
-                        $this->save($reference);
667
-                    }
668
-                }
669
-
670
-                $dbRowData = $dbRow->_getDbRow();
671
-
672
-                // Let's see if the columns for primary key have been set before inserting.
673
-                // We assume that if one of the value of the PK has been set, the PK is set.
674
-                $isPkSet = !empty($primaryKeys);
675
-
676
-                /*if (!$isPkSet) {
548
+		}
549
+
550
+		return $this->primaryKeysColumns[$table];
551
+	}
552
+
553
+	/**
554
+	 * This is an internal function, you should not use it in your application.
555
+	 * This is used internally by TDBM to add an object to the object cache.
556
+	 *
557
+	 * @param DbRow $dbRow
558
+	 */
559
+	public function _addToCache(DbRow $dbRow)
560
+	{
561
+		$primaryKey = $this->getPrimaryKeysForObjectFromDbRow($dbRow);
562
+		$hash = $this->getObjectHash($primaryKey);
563
+		$this->objectStorage->set($dbRow->_getDbTableName(), $hash, $dbRow);
564
+	}
565
+
566
+	/**
567
+	 * This is an internal function, you should not use it in your application.
568
+	 * This is used internally by TDBM to remove the object from the list of objects that have been
569
+	 * created/updated but not saved yet.
570
+	 *
571
+	 * @param DbRow $myObject
572
+	 */
573
+	private function removeFromToSaveObjectList(DbRow $myObject)
574
+	{
575
+		unset($this->toSaveObjects[$myObject]);
576
+	}
577
+
578
+	/**
579
+	 * This is an internal function, you should not use it in your application.
580
+	 * This is used internally by TDBM to add an object to the list of objects that have been
581
+	 * created/updated but not saved yet.
582
+	 *
583
+	 * @param AbstractTDBMObject $myObject
584
+	 */
585
+	public function _addToToSaveObjectList(DbRow $myObject)
586
+	{
587
+		$this->toSaveObjects[$myObject] = true;
588
+	}
589
+
590
+	/**
591
+	 * Generates all the daos and beans.
592
+	 *
593
+	 * @param string $daoFactoryClassName The classe name of the DAO factory
594
+	 * @param string $daonamespace        The namespace for the DAOs, without trailing \
595
+	 * @param string $beannamespace       The Namespace for the beans, without trailing \
596
+	 * @param bool   $storeInUtc          If the generated daos should store the date in UTC timezone instead of user's timezone.
597
+	 * @param string $composerFile        If it's set, location of custom Composer file. Relative to project root.
598
+	 *
599
+	 * @return \string[] the list of tables
600
+	 */
601
+	public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc, $composerFile = null)
602
+	{
603
+		// Purge cache before generating anything.
604
+		$this->cache->deleteAll();
605
+
606
+		$tdbmDaoGenerator = new TDBMDaoGenerator($this->schemaAnalyzer, $this->tdbmSchemaAnalyzer->getSchema(), $this->tdbmSchemaAnalyzer);
607
+		if (null !== $composerFile) {
608
+			$tdbmDaoGenerator->setComposerFile(__DIR__.'/../../../../../../../'.$composerFile);
609
+		}
610
+
611
+		return $tdbmDaoGenerator->generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc);
612
+	}
613
+
614
+	/**
615
+	 * @param array<string, string> $tableToBeanMap
616
+	 */
617
+	public function setTableToBeanMap(array $tableToBeanMap)
618
+	{
619
+		$this->tableToBeanMap = $tableToBeanMap;
620
+	}
621
+
622
+	/**
623
+	 * Saves $object by INSERTing or UPDAT(E)ing it in the database.
624
+	 *
625
+	 * @param AbstractTDBMObject $object
626
+	 *
627
+	 * @throws TDBMException
628
+	 */
629
+	public function save(AbstractTDBMObject $object)
630
+	{
631
+		$status = $object->_getStatus();
632
+
633
+		// Let's attach this object if it is in detached state.
634
+		if ($status === TDBMObjectStateEnum::STATE_DETACHED) {
635
+			$object->_attach($this);
636
+			$status = $object->_getStatus();
637
+		}
638
+
639
+		if ($status === TDBMObjectStateEnum::STATE_NEW) {
640
+			$dbRows = $object->_getDbRows();
641
+
642
+			$unindexedPrimaryKeys = array();
643
+
644
+			foreach ($dbRows as $dbRow) {
645
+				$tableName = $dbRow->_getDbTableName();
646
+
647
+				$schema = $this->tdbmSchemaAnalyzer->getSchema();
648
+				$tableDescriptor = $schema->getTable($tableName);
649
+
650
+				$primaryKeyColumns = $this->getPrimaryKeyColumns($tableName);
651
+
652
+				if (empty($unindexedPrimaryKeys)) {
653
+					$primaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow);
654
+				} else {
655
+					// First insert, the children must have the same primary key as the parent.
656
+					$primaryKeys = $this->_getPrimaryKeysFromIndexedPrimaryKeys($tableName, $unindexedPrimaryKeys);
657
+					$dbRow->_setPrimaryKeys($primaryKeys);
658
+				}
659
+
660
+				$references = $dbRow->_getReferences();
661
+
662
+				// Let's save all references in NEW or DETACHED state (we need their primary key)
663
+				foreach ($references as $fkName => $reference) {
664
+					$refStatus = $reference->_getStatus();
665
+					if ($refStatus === TDBMObjectStateEnum::STATE_NEW || $refStatus === TDBMObjectStateEnum::STATE_DETACHED) {
666
+						$this->save($reference);
667
+					}
668
+				}
669
+
670
+				$dbRowData = $dbRow->_getDbRow();
671
+
672
+				// Let's see if the columns for primary key have been set before inserting.
673
+				// We assume that if one of the value of the PK has been set, the PK is set.
674
+				$isPkSet = !empty($primaryKeys);
675
+
676
+				/*if (!$isPkSet) {
677 677
                     // if there is no autoincrement and no pk set, let's go in error.
678 678
                     $isAutoIncrement = true;
679 679
 
@@ -691,25 +691,25 @@  discard block
 block discarded – undo
691 691
 
692 692
                 }*/
693 693
 
694
-                $types = [];
694
+				$types = [];
695 695
 
696
-                foreach ($dbRowData as $columnName => $value) {
697
-                    $columnDescriptor = $tableDescriptor->getColumn($columnName);
698
-                    $types[] = $columnDescriptor->getType();
699
-                }
696
+				foreach ($dbRowData as $columnName => $value) {
697
+					$columnDescriptor = $tableDescriptor->getColumn($columnName);
698
+					$types[] = $columnDescriptor->getType();
699
+				}
700 700
 
701
-                $this->connection->insert($tableName, $dbRowData, $types);
701
+				$this->connection->insert($tableName, $dbRowData, $types);
702 702
 
703
-                if (!$isPkSet && count($primaryKeyColumns) == 1) {
704
-                    $id = $this->connection->lastInsertId();
705
-                    $primaryKeys[$primaryKeyColumns[0]] = $id;
706
-                }
703
+				if (!$isPkSet && count($primaryKeyColumns) == 1) {
704
+					$id = $this->connection->lastInsertId();
705
+					$primaryKeys[$primaryKeyColumns[0]] = $id;
706
+				}
707 707
 
708
-                // TODO: change this to some private magic accessor in future
709
-                $dbRow->_setPrimaryKeys($primaryKeys);
710
-                $unindexedPrimaryKeys = array_values($primaryKeys);
708
+				// TODO: change this to some private magic accessor in future
709
+				$dbRow->_setPrimaryKeys($primaryKeys);
710
+				$unindexedPrimaryKeys = array_values($primaryKeys);
711 711
 
712
-                /*
712
+				/*
713 713
                  * When attached, on "save", we check if the column updated is part of a primary key
714 714
                  * If this is part of a primary key, we call the _update_id method that updates the id in the list of known objects.
715 715
                  * This method should first verify that the id is not already used (and is not auto-incremented)
@@ -719,7 +719,7 @@  discard block
 block discarded – undo
719 719
                  *
720 720
                  */
721 721
 
722
-                /*try {
722
+				/*try {
723 723
                     $this->db_connection->exec($sql);
724 724
                 } catch (TDBMException $e) {
725 725
                     $this->db_onerror = true;
@@ -738,390 +738,390 @@  discard block
 block discarded – undo
738 738
                     }
739 739
                 }*/
740 740
 
741
-                // Let's remove this object from the $new_objects static table.
742
-                $this->removeFromToSaveObjectList($dbRow);
743
-
744
-                // TODO: change this behaviour to something more sensible performance-wise
745
-                // Maybe a setting to trigger this globally?
746
-                //$this->status = TDBMObjectStateEnum::STATE_NOT_LOADED;
747
-                //$this->db_modified_state = false;
748
-                //$dbRow = array();
749
-
750
-                // Let's add this object to the list of objects in cache.
751
-                $this->_addToCache($dbRow);
752
-            }
753
-
754
-            $object->_setStatus(TDBMObjectStateEnum::STATE_LOADED);
755
-        } elseif ($status === TDBMObjectStateEnum::STATE_DIRTY) {
756
-            $dbRows = $object->_getDbRows();
757
-
758
-            foreach ($dbRows as $dbRow) {
759
-                $references = $dbRow->_getReferences();
760
-
761
-                // Let's save all references in NEW state (we need their primary key)
762
-                foreach ($references as $fkName => $reference) {
763
-                    if ($reference->_getStatus() === TDBMObjectStateEnum::STATE_NEW) {
764
-                        $this->save($reference);
765
-                    }
766
-                }
767
-
768
-                // Let's first get the primary keys
769
-                $tableName = $dbRow->_getDbTableName();
770
-                $dbRowData = $dbRow->_getDbRow();
771
-
772
-                $schema = $this->tdbmSchemaAnalyzer->getSchema();
773
-                $tableDescriptor = $schema->getTable($tableName);
774
-
775
-                $primaryKeys = $dbRow->_getPrimaryKeys();
776
-
777
-                $types = [];
778
-
779
-                foreach ($dbRowData as $columnName => $value) {
780
-                    $columnDescriptor = $tableDescriptor->getColumn($columnName);
781
-                    $types[] = $columnDescriptor->getType();
782
-                }
783
-                foreach ($primaryKeys as $columnName => $value) {
784
-                    $columnDescriptor = $tableDescriptor->getColumn($columnName);
785
-                    $types[] = $columnDescriptor->getType();
786
-                }
787
-
788
-                $this->connection->update($tableName, $dbRowData, $primaryKeys, $types);
789
-
790
-                // Let's check if the primary key has been updated...
791
-                $needsUpdatePk = false;
792
-                foreach ($primaryKeys as $column => $value) {
793
-                    if (!isset($dbRowData[$column]) || $dbRowData[$column] != $value) {
794
-                        $needsUpdatePk = true;
795
-                        break;
796
-                    }
797
-                }
798
-                if ($needsUpdatePk) {
799
-                    $this->objectStorage->remove($tableName, $this->getObjectHash($primaryKeys));
800
-                    $newPrimaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow);
801
-                    $dbRow->_setPrimaryKeys($newPrimaryKeys);
802
-                    $this->objectStorage->set($tableName, $this->getObjectHash($primaryKeys), $dbRow);
803
-                }
804
-
805
-                // Let's remove this object from the list of objects to save.
806
-                $this->removeFromToSaveObjectList($dbRow);
807
-            }
808
-
809
-            $object->_setStatus(TDBMObjectStateEnum::STATE_LOADED);
810
-        } elseif ($status === TDBMObjectStateEnum::STATE_DELETED) {
811
-            throw new TDBMInvalidOperationException('This object has been deleted. It cannot be saved.');
812
-        }
813
-
814
-        // Finally, let's save all the many to many relationships to this bean.
815
-        $this->persistManyToManyRelationships($object);
816
-    }
817
-
818
-    private function persistManyToManyRelationships(AbstractTDBMObject $object)
819
-    {
820
-        foreach ($object->_getCachedRelationships() as $pivotTableName => $storage) {
821
-            $tableDescriptor = $this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName);
822
-            list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $object);
823
-
824
-            foreach ($storage as $remoteBean) {
825
-                /* @var $remoteBean AbstractTDBMObject */
826
-                $statusArr = $storage[$remoteBean];
827
-                $status = $statusArr['status'];
828
-                $reverse = $statusArr['reverse'];
829
-                if ($reverse) {
830
-                    continue;
831
-                }
832
-
833
-                if ($status === 'new') {
834
-                    $remoteBeanStatus = $remoteBean->_getStatus();
835
-                    if ($remoteBeanStatus === TDBMObjectStateEnum::STATE_NEW || $remoteBeanStatus === TDBMObjectStateEnum::STATE_DETACHED) {
836
-                        // Let's save remote bean if needed.
837
-                        $this->save($remoteBean);
838
-                    }
839
-
840
-                    $filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk);
841
-
842
-                    $types = [];
843
-
844
-                    foreach ($filters as $columnName => $value) {
845
-                        $columnDescriptor = $tableDescriptor->getColumn($columnName);
846
-                        $types[] = $columnDescriptor->getType();
847
-                    }
848
-
849
-                    $this->connection->insert($pivotTableName, $filters, $types);
850
-
851
-                    // Finally, let's mark relationships as saved.
852
-                    $statusArr['status'] = 'loaded';
853
-                    $storage[$remoteBean] = $statusArr;
854
-                    $remoteStorage = $remoteBean->_getCachedRelationships()[$pivotTableName];
855
-                    $remoteStatusArr = $remoteStorage[$object];
856
-                    $remoteStatusArr['status'] = 'loaded';
857
-                    $remoteStorage[$object] = $remoteStatusArr;
858
-                } elseif ($status === 'delete') {
859
-                    $filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk);
860
-
861
-                    $types = [];
862
-
863
-                    foreach ($filters as $columnName => $value) {
864
-                        $columnDescriptor = $tableDescriptor->getColumn($columnName);
865
-                        $types[] = $columnDescriptor->getType();
866
-                    }
867
-
868
-                    $this->connection->delete($pivotTableName, $filters, $types);
869
-
870
-                    // Finally, let's remove relationships completely from bean.
871
-                    $storage->detach($remoteBean);
872
-                    $remoteBean->_getCachedRelationships()[$pivotTableName]->detach($object);
873
-                }
874
-            }
875
-        }
876
-    }
877
-
878
-    private function getPivotFilters(AbstractTDBMObject $localBean, AbstractTDBMObject $remoteBean, ForeignKeyConstraint $localFk, ForeignKeyConstraint $remoteFk)
879
-    {
880
-        $localBeanPk = $this->getPrimaryKeyValues($localBean);
881
-        $remoteBeanPk = $this->getPrimaryKeyValues($remoteBean);
882
-        $localColumns = $localFk->getLocalColumns();
883
-        $remoteColumns = $remoteFk->getLocalColumns();
884
-
885
-        $localFilters = array_combine($localColumns, $localBeanPk);
886
-        $remoteFilters = array_combine($remoteColumns, $remoteBeanPk);
887
-
888
-        return array_merge($localFilters, $remoteFilters);
889
-    }
890
-
891
-    /**
892
-     * Returns the "values" of the primary key.
893
-     * This returns the primary key from the $primaryKey attribute, not the one stored in the columns.
894
-     *
895
-     * @param AbstractTDBMObject $bean
896
-     *
897
-     * @return array numerically indexed array of values.
898
-     */
899
-    private function getPrimaryKeyValues(AbstractTDBMObject $bean)
900
-    {
901
-        $dbRows = $bean->_getDbRows();
902
-        $dbRow = reset($dbRows);
903
-
904
-        return array_values($dbRow->_getPrimaryKeys());
905
-    }
906
-
907
-    /**
908
-     * Returns a unique hash used to store the object based on its primary key.
909
-     * If the array contains only one value, then the value is returned.
910
-     * Otherwise, a hash representing the array is returned.
911
-     *
912
-     * @param array $primaryKeys An array of columns => values forming the primary key
913
-     *
914
-     * @return string
915
-     */
916
-    public function getObjectHash(array $primaryKeys)
917
-    {
918
-        if (count($primaryKeys) === 1) {
919
-            return reset($primaryKeys);
920
-        } else {
921
-            ksort($primaryKeys);
922
-
923
-            return md5(json_encode($primaryKeys));
924
-        }
925
-    }
926
-
927
-    /**
928
-     * Returns an array of primary keys from the object.
929
-     * The primary keys are extracted from the object columns and not from the primary keys stored in the
930
-     * $primaryKeys variable of the object.
931
-     *
932
-     * @param DbRow $dbRow
933
-     *
934
-     * @return array Returns an array of column => value
935
-     */
936
-    public function getPrimaryKeysForObjectFromDbRow(DbRow $dbRow)
937
-    {
938
-        $table = $dbRow->_getDbTableName();
939
-        $dbRowData = $dbRow->_getDbRow();
940
-
941
-        return $this->_getPrimaryKeysFromObjectData($table, $dbRowData);
942
-    }
943
-
944
-    /**
945
-     * Returns an array of primary keys for the given row.
946
-     * The primary keys are extracted from the object columns.
947
-     *
948
-     * @param $table
949
-     * @param array $columns
950
-     *
951
-     * @return array
952
-     */
953
-    public function _getPrimaryKeysFromObjectData($table, array $columns)
954
-    {
955
-        $primaryKeyColumns = $this->getPrimaryKeyColumns($table);
956
-        $values = array();
957
-        foreach ($primaryKeyColumns as $column) {
958
-            if (isset($columns[$column])) {
959
-                $values[$column] = $columns[$column];
960
-            }
961
-        }
962
-
963
-        return $values;
964
-    }
965
-
966
-    /**
967
-     * Attaches $object to this TDBMService.
968
-     * The $object must be in DETACHED state and will pass in NEW state.
969
-     *
970
-     * @param AbstractTDBMObject $object
971
-     *
972
-     * @throws TDBMInvalidOperationException
973
-     */
974
-    public function attach(AbstractTDBMObject $object)
975
-    {
976
-        $object->_attach($this);
977
-    }
978
-
979
-    /**
980
-     * Returns an associative array (column => value) for the primary keys from the table name and an
981
-     * indexed array of primary key values.
982
-     *
983
-     * @param string $tableName
984
-     * @param array  $indexedPrimaryKeys
985
-     */
986
-    public function _getPrimaryKeysFromIndexedPrimaryKeys($tableName, array $indexedPrimaryKeys)
987
-    {
988
-        $primaryKeyColumns = $this->tdbmSchemaAnalyzer->getSchema()->getTable($tableName)->getPrimaryKeyColumns();
989
-
990
-        if (count($primaryKeyColumns) !== count($indexedPrimaryKeys)) {
991
-            throw new TDBMException(sprintf('Wrong number of columns passed for primary key. Expected %s columns for table "%s",
741
+				// Let's remove this object from the $new_objects static table.
742
+				$this->removeFromToSaveObjectList($dbRow);
743
+
744
+				// TODO: change this behaviour to something more sensible performance-wise
745
+				// Maybe a setting to trigger this globally?
746
+				//$this->status = TDBMObjectStateEnum::STATE_NOT_LOADED;
747
+				//$this->db_modified_state = false;
748
+				//$dbRow = array();
749
+
750
+				// Let's add this object to the list of objects in cache.
751
+				$this->_addToCache($dbRow);
752
+			}
753
+
754
+			$object->_setStatus(TDBMObjectStateEnum::STATE_LOADED);
755
+		} elseif ($status === TDBMObjectStateEnum::STATE_DIRTY) {
756
+			$dbRows = $object->_getDbRows();
757
+
758
+			foreach ($dbRows as $dbRow) {
759
+				$references = $dbRow->_getReferences();
760
+
761
+				// Let's save all references in NEW state (we need their primary key)
762
+				foreach ($references as $fkName => $reference) {
763
+					if ($reference->_getStatus() === TDBMObjectStateEnum::STATE_NEW) {
764
+						$this->save($reference);
765
+					}
766
+				}
767
+
768
+				// Let's first get the primary keys
769
+				$tableName = $dbRow->_getDbTableName();
770
+				$dbRowData = $dbRow->_getDbRow();
771
+
772
+				$schema = $this->tdbmSchemaAnalyzer->getSchema();
773
+				$tableDescriptor = $schema->getTable($tableName);
774
+
775
+				$primaryKeys = $dbRow->_getPrimaryKeys();
776
+
777
+				$types = [];
778
+
779
+				foreach ($dbRowData as $columnName => $value) {
780
+					$columnDescriptor = $tableDescriptor->getColumn($columnName);
781
+					$types[] = $columnDescriptor->getType();
782
+				}
783
+				foreach ($primaryKeys as $columnName => $value) {
784
+					$columnDescriptor = $tableDescriptor->getColumn($columnName);
785
+					$types[] = $columnDescriptor->getType();
786
+				}
787
+
788
+				$this->connection->update($tableName, $dbRowData, $primaryKeys, $types);
789
+
790
+				// Let's check if the primary key has been updated...
791
+				$needsUpdatePk = false;
792
+				foreach ($primaryKeys as $column => $value) {
793
+					if (!isset($dbRowData[$column]) || $dbRowData[$column] != $value) {
794
+						$needsUpdatePk = true;
795
+						break;
796
+					}
797
+				}
798
+				if ($needsUpdatePk) {
799
+					$this->objectStorage->remove($tableName, $this->getObjectHash($primaryKeys));
800
+					$newPrimaryKeys = $this->getPrimaryKeysForObjectFromDbRow($dbRow);
801
+					$dbRow->_setPrimaryKeys($newPrimaryKeys);
802
+					$this->objectStorage->set($tableName, $this->getObjectHash($primaryKeys), $dbRow);
803
+				}
804
+
805
+				// Let's remove this object from the list of objects to save.
806
+				$this->removeFromToSaveObjectList($dbRow);
807
+			}
808
+
809
+			$object->_setStatus(TDBMObjectStateEnum::STATE_LOADED);
810
+		} elseif ($status === TDBMObjectStateEnum::STATE_DELETED) {
811
+			throw new TDBMInvalidOperationException('This object has been deleted. It cannot be saved.');
812
+		}
813
+
814
+		// Finally, let's save all the many to many relationships to this bean.
815
+		$this->persistManyToManyRelationships($object);
816
+	}
817
+
818
+	private function persistManyToManyRelationships(AbstractTDBMObject $object)
819
+	{
820
+		foreach ($object->_getCachedRelationships() as $pivotTableName => $storage) {
821
+			$tableDescriptor = $this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName);
822
+			list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $object);
823
+
824
+			foreach ($storage as $remoteBean) {
825
+				/* @var $remoteBean AbstractTDBMObject */
826
+				$statusArr = $storage[$remoteBean];
827
+				$status = $statusArr['status'];
828
+				$reverse = $statusArr['reverse'];
829
+				if ($reverse) {
830
+					continue;
831
+				}
832
+
833
+				if ($status === 'new') {
834
+					$remoteBeanStatus = $remoteBean->_getStatus();
835
+					if ($remoteBeanStatus === TDBMObjectStateEnum::STATE_NEW || $remoteBeanStatus === TDBMObjectStateEnum::STATE_DETACHED) {
836
+						// Let's save remote bean if needed.
837
+						$this->save($remoteBean);
838
+					}
839
+
840
+					$filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk);
841
+
842
+					$types = [];
843
+
844
+					foreach ($filters as $columnName => $value) {
845
+						$columnDescriptor = $tableDescriptor->getColumn($columnName);
846
+						$types[] = $columnDescriptor->getType();
847
+					}
848
+
849
+					$this->connection->insert($pivotTableName, $filters, $types);
850
+
851
+					// Finally, let's mark relationships as saved.
852
+					$statusArr['status'] = 'loaded';
853
+					$storage[$remoteBean] = $statusArr;
854
+					$remoteStorage = $remoteBean->_getCachedRelationships()[$pivotTableName];
855
+					$remoteStatusArr = $remoteStorage[$object];
856
+					$remoteStatusArr['status'] = 'loaded';
857
+					$remoteStorage[$object] = $remoteStatusArr;
858
+				} elseif ($status === 'delete') {
859
+					$filters = $this->getPivotFilters($object, $remoteBean, $localFk, $remoteFk);
860
+
861
+					$types = [];
862
+
863
+					foreach ($filters as $columnName => $value) {
864
+						$columnDescriptor = $tableDescriptor->getColumn($columnName);
865
+						$types[] = $columnDescriptor->getType();
866
+					}
867
+
868
+					$this->connection->delete($pivotTableName, $filters, $types);
869
+
870
+					// Finally, let's remove relationships completely from bean.
871
+					$storage->detach($remoteBean);
872
+					$remoteBean->_getCachedRelationships()[$pivotTableName]->detach($object);
873
+				}
874
+			}
875
+		}
876
+	}
877
+
878
+	private function getPivotFilters(AbstractTDBMObject $localBean, AbstractTDBMObject $remoteBean, ForeignKeyConstraint $localFk, ForeignKeyConstraint $remoteFk)
879
+	{
880
+		$localBeanPk = $this->getPrimaryKeyValues($localBean);
881
+		$remoteBeanPk = $this->getPrimaryKeyValues($remoteBean);
882
+		$localColumns = $localFk->getLocalColumns();
883
+		$remoteColumns = $remoteFk->getLocalColumns();
884
+
885
+		$localFilters = array_combine($localColumns, $localBeanPk);
886
+		$remoteFilters = array_combine($remoteColumns, $remoteBeanPk);
887
+
888
+		return array_merge($localFilters, $remoteFilters);
889
+	}
890
+
891
+	/**
892
+	 * Returns the "values" of the primary key.
893
+	 * This returns the primary key from the $primaryKey attribute, not the one stored in the columns.
894
+	 *
895
+	 * @param AbstractTDBMObject $bean
896
+	 *
897
+	 * @return array numerically indexed array of values.
898
+	 */
899
+	private function getPrimaryKeyValues(AbstractTDBMObject $bean)
900
+	{
901
+		$dbRows = $bean->_getDbRows();
902
+		$dbRow = reset($dbRows);
903
+
904
+		return array_values($dbRow->_getPrimaryKeys());
905
+	}
906
+
907
+	/**
908
+	 * Returns a unique hash used to store the object based on its primary key.
909
+	 * If the array contains only one value, then the value is returned.
910
+	 * Otherwise, a hash representing the array is returned.
911
+	 *
912
+	 * @param array $primaryKeys An array of columns => values forming the primary key
913
+	 *
914
+	 * @return string
915
+	 */
916
+	public function getObjectHash(array $primaryKeys)
917
+	{
918
+		if (count($primaryKeys) === 1) {
919
+			return reset($primaryKeys);
920
+		} else {
921
+			ksort($primaryKeys);
922
+
923
+			return md5(json_encode($primaryKeys));
924
+		}
925
+	}
926
+
927
+	/**
928
+	 * Returns an array of primary keys from the object.
929
+	 * The primary keys are extracted from the object columns and not from the primary keys stored in the
930
+	 * $primaryKeys variable of the object.
931
+	 *
932
+	 * @param DbRow $dbRow
933
+	 *
934
+	 * @return array Returns an array of column => value
935
+	 */
936
+	public function getPrimaryKeysForObjectFromDbRow(DbRow $dbRow)
937
+	{
938
+		$table = $dbRow->_getDbTableName();
939
+		$dbRowData = $dbRow->_getDbRow();
940
+
941
+		return $this->_getPrimaryKeysFromObjectData($table, $dbRowData);
942
+	}
943
+
944
+	/**
945
+	 * Returns an array of primary keys for the given row.
946
+	 * The primary keys are extracted from the object columns.
947
+	 *
948
+	 * @param $table
949
+	 * @param array $columns
950
+	 *
951
+	 * @return array
952
+	 */
953
+	public function _getPrimaryKeysFromObjectData($table, array $columns)
954
+	{
955
+		$primaryKeyColumns = $this->getPrimaryKeyColumns($table);
956
+		$values = array();
957
+		foreach ($primaryKeyColumns as $column) {
958
+			if (isset($columns[$column])) {
959
+				$values[$column] = $columns[$column];
960
+			}
961
+		}
962
+
963
+		return $values;
964
+	}
965
+
966
+	/**
967
+	 * Attaches $object to this TDBMService.
968
+	 * The $object must be in DETACHED state and will pass in NEW state.
969
+	 *
970
+	 * @param AbstractTDBMObject $object
971
+	 *
972
+	 * @throws TDBMInvalidOperationException
973
+	 */
974
+	public function attach(AbstractTDBMObject $object)
975
+	{
976
+		$object->_attach($this);
977
+	}
978
+
979
+	/**
980
+	 * Returns an associative array (column => value) for the primary keys from the table name and an
981
+	 * indexed array of primary key values.
982
+	 *
983
+	 * @param string $tableName
984
+	 * @param array  $indexedPrimaryKeys
985
+	 */
986
+	public function _getPrimaryKeysFromIndexedPrimaryKeys($tableName, array $indexedPrimaryKeys)
987
+	{
988
+		$primaryKeyColumns = $this->tdbmSchemaAnalyzer->getSchema()->getTable($tableName)->getPrimaryKeyColumns();
989
+
990
+		if (count($primaryKeyColumns) !== count($indexedPrimaryKeys)) {
991
+			throw new TDBMException(sprintf('Wrong number of columns passed for primary key. Expected %s columns for table "%s",
992 992
 			got %s instead.', count($primaryKeyColumns), $tableName, count($indexedPrimaryKeys)));
993
-        }
994
-
995
-        return array_combine($primaryKeyColumns, $indexedPrimaryKeys);
996
-    }
997
-
998
-    /**
999
-     * Return the list of tables (from child to parent) joining the tables passed in parameter.
1000
-     * Tables must be in a single line of inheritance. The method will find missing tables.
1001
-     *
1002
-     * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent,
1003
-     * we must be able to find all other tables.
1004
-     *
1005
-     * @param string[] $tables
1006
-     *
1007
-     * @return string[]
1008
-     */
1009
-    public function _getLinkBetweenInheritedTables(array $tables)
1010
-    {
1011
-        sort($tables);
1012
-
1013
-        return $this->fromCache($this->cachePrefix.'_linkbetweeninheritedtables_'.implode('__split__', $tables),
1014
-            function () use ($tables) {
1015
-                return $this->_getLinkBetweenInheritedTablesWithoutCache($tables);
1016
-            });
1017
-    }
1018
-
1019
-    /**
1020
-     * Return the list of tables (from child to parent) joining the tables passed in parameter.
1021
-     * Tables must be in a single line of inheritance. The method will find missing tables.
1022
-     *
1023
-     * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent,
1024
-     * we must be able to find all other tables.
1025
-     *
1026
-     * @param string[] $tables
1027
-     *
1028
-     * @return string[]
1029
-     */
1030
-    private function _getLinkBetweenInheritedTablesWithoutCache(array $tables)
1031
-    {
1032
-        $schemaAnalyzer = $this->schemaAnalyzer;
1033
-
1034
-        foreach ($tables as $currentTable) {
1035
-            $allParents = [$currentTable];
1036
-            while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) {
1037
-                $currentTable = $currentFk->getForeignTableName();
1038
-                $allParents[] = $currentTable;
1039
-            };
1040
-
1041
-            // Now, does the $allParents contain all the tables we want?
1042
-            $notFoundTables = array_diff($tables, $allParents);
1043
-            if (empty($notFoundTables)) {
1044
-                // We have a winner!
1045
-                return $allParents;
1046
-            }
1047
-        }
1048
-
1049
-        throw new TDBMException(sprintf('The tables (%s) cannot be linked by an inheritance relationship.', implode(', ', $tables)));
1050
-    }
1051
-
1052
-    /**
1053
-     * Returns the list of tables related to this table (via a parent or child inheritance relationship).
1054
-     *
1055
-     * @param string $table
1056
-     *
1057
-     * @return string[]
1058
-     */
1059
-    public function _getRelatedTablesByInheritance($table)
1060
-    {
1061
-        return $this->fromCache($this->cachePrefix.'_relatedtables_'.$table, function () use ($table) {
1062
-            return $this->_getRelatedTablesByInheritanceWithoutCache($table);
1063
-        });
1064
-    }
1065
-
1066
-    /**
1067
-     * Returns the list of tables related to this table (via a parent or child inheritance relationship).
1068
-     *
1069
-     * @param string $table
1070
-     *
1071
-     * @return string[]
1072
-     */
1073
-    private function _getRelatedTablesByInheritanceWithoutCache($table)
1074
-    {
1075
-        $schemaAnalyzer = $this->schemaAnalyzer;
1076
-
1077
-        // Let's scan the parent tables
1078
-        $currentTable = $table;
1079
-
1080
-        $parentTables = [];
1081
-
1082
-        // Get parent relationship
1083
-        while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) {
1084
-            $currentTable = $currentFk->getForeignTableName();
1085
-            $parentTables[] = $currentTable;
1086
-        };
1087
-
1088
-        // Let's recurse in children
1089
-        $childrenTables = $this->exploreChildrenTablesRelationships($schemaAnalyzer, $table);
1090
-
1091
-        return array_merge(array_reverse($parentTables), $childrenTables);
1092
-    }
1093
-
1094
-    /**
1095
-     * Explore all the children and descendant of $table and returns ForeignKeyConstraints on those.
1096
-     *
1097
-     * @param string $table
1098
-     *
1099
-     * @return string[]
1100
-     */
1101
-    private function exploreChildrenTablesRelationships(SchemaAnalyzer $schemaAnalyzer, $table)
1102
-    {
1103
-        $tables = [$table];
1104
-        $keys = $schemaAnalyzer->getChildrenRelationships($table);
1105
-
1106
-        foreach ($keys as $key) {
1107
-            $tables = array_merge($tables, $this->exploreChildrenTablesRelationships($schemaAnalyzer, $key->getLocalTableName()));
1108
-        }
1109
-
1110
-        return $tables;
1111
-    }
1112
-
1113
-    /**
1114
-     * Casts a foreign key into SQL, assuming table name is used with no alias.
1115
-     * The returned value does contain only one table. For instance:.
1116
-     *
1117
-     * " LEFT JOIN table2 ON table1.id = table2.table1_id"
1118
-     *
1119
-     * @param ForeignKeyConstraint $fk
1120
-     * @param bool                 $leftTableIsLocal
1121
-     *
1122
-     * @return string
1123
-     */
1124
-    /*private function foreignKeyToSql(ForeignKeyConstraint $fk, $leftTableIsLocal) {
993
+		}
994
+
995
+		return array_combine($primaryKeyColumns, $indexedPrimaryKeys);
996
+	}
997
+
998
+	/**
999
+	 * Return the list of tables (from child to parent) joining the tables passed in parameter.
1000
+	 * Tables must be in a single line of inheritance. The method will find missing tables.
1001
+	 *
1002
+	 * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent,
1003
+	 * we must be able to find all other tables.
1004
+	 *
1005
+	 * @param string[] $tables
1006
+	 *
1007
+	 * @return string[]
1008
+	 */
1009
+	public function _getLinkBetweenInheritedTables(array $tables)
1010
+	{
1011
+		sort($tables);
1012
+
1013
+		return $this->fromCache($this->cachePrefix.'_linkbetweeninheritedtables_'.implode('__split__', $tables),
1014
+			function () use ($tables) {
1015
+				return $this->_getLinkBetweenInheritedTablesWithoutCache($tables);
1016
+			});
1017
+	}
1018
+
1019
+	/**
1020
+	 * Return the list of tables (from child to parent) joining the tables passed in parameter.
1021
+	 * Tables must be in a single line of inheritance. The method will find missing tables.
1022
+	 *
1023
+	 * Algorithm: one of those tables is the ultimate child. From this child, by recursively getting the parent,
1024
+	 * we must be able to find all other tables.
1025
+	 *
1026
+	 * @param string[] $tables
1027
+	 *
1028
+	 * @return string[]
1029
+	 */
1030
+	private function _getLinkBetweenInheritedTablesWithoutCache(array $tables)
1031
+	{
1032
+		$schemaAnalyzer = $this->schemaAnalyzer;
1033
+
1034
+		foreach ($tables as $currentTable) {
1035
+			$allParents = [$currentTable];
1036
+			while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) {
1037
+				$currentTable = $currentFk->getForeignTableName();
1038
+				$allParents[] = $currentTable;
1039
+			};
1040
+
1041
+			// Now, does the $allParents contain all the tables we want?
1042
+			$notFoundTables = array_diff($tables, $allParents);
1043
+			if (empty($notFoundTables)) {
1044
+				// We have a winner!
1045
+				return $allParents;
1046
+			}
1047
+		}
1048
+
1049
+		throw new TDBMException(sprintf('The tables (%s) cannot be linked by an inheritance relationship.', implode(', ', $tables)));
1050
+	}
1051
+
1052
+	/**
1053
+	 * Returns the list of tables related to this table (via a parent or child inheritance relationship).
1054
+	 *
1055
+	 * @param string $table
1056
+	 *
1057
+	 * @return string[]
1058
+	 */
1059
+	public function _getRelatedTablesByInheritance($table)
1060
+	{
1061
+		return $this->fromCache($this->cachePrefix.'_relatedtables_'.$table, function () use ($table) {
1062
+			return $this->_getRelatedTablesByInheritanceWithoutCache($table);
1063
+		});
1064
+	}
1065
+
1066
+	/**
1067
+	 * Returns the list of tables related to this table (via a parent or child inheritance relationship).
1068
+	 *
1069
+	 * @param string $table
1070
+	 *
1071
+	 * @return string[]
1072
+	 */
1073
+	private function _getRelatedTablesByInheritanceWithoutCache($table)
1074
+	{
1075
+		$schemaAnalyzer = $this->schemaAnalyzer;
1076
+
1077
+		// Let's scan the parent tables
1078
+		$currentTable = $table;
1079
+
1080
+		$parentTables = [];
1081
+
1082
+		// Get parent relationship
1083
+		while ($currentFk = $schemaAnalyzer->getParentRelationship($currentTable)) {
1084
+			$currentTable = $currentFk->getForeignTableName();
1085
+			$parentTables[] = $currentTable;
1086
+		};
1087
+
1088
+		// Let's recurse in children
1089
+		$childrenTables = $this->exploreChildrenTablesRelationships($schemaAnalyzer, $table);
1090
+
1091
+		return array_merge(array_reverse($parentTables), $childrenTables);
1092
+	}
1093
+
1094
+	/**
1095
+	 * Explore all the children and descendant of $table and returns ForeignKeyConstraints on those.
1096
+	 *
1097
+	 * @param string $table
1098
+	 *
1099
+	 * @return string[]
1100
+	 */
1101
+	private function exploreChildrenTablesRelationships(SchemaAnalyzer $schemaAnalyzer, $table)
1102
+	{
1103
+		$tables = [$table];
1104
+		$keys = $schemaAnalyzer->getChildrenRelationships($table);
1105
+
1106
+		foreach ($keys as $key) {
1107
+			$tables = array_merge($tables, $this->exploreChildrenTablesRelationships($schemaAnalyzer, $key->getLocalTableName()));
1108
+		}
1109
+
1110
+		return $tables;
1111
+	}
1112
+
1113
+	/**
1114
+	 * Casts a foreign key into SQL, assuming table name is used with no alias.
1115
+	 * The returned value does contain only one table. For instance:.
1116
+	 *
1117
+	 * " LEFT JOIN table2 ON table1.id = table2.table1_id"
1118
+	 *
1119
+	 * @param ForeignKeyConstraint $fk
1120
+	 * @param bool                 $leftTableIsLocal
1121
+	 *
1122
+	 * @return string
1123
+	 */
1124
+	/*private function foreignKeyToSql(ForeignKeyConstraint $fk, $leftTableIsLocal) {
1125 1125
         $onClauses = [];
1126 1126
         $foreignTableName = $this->connection->quoteIdentifier($fk->getForeignTableName());
1127 1127
         $foreignColumns = $fk->getForeignColumns();
@@ -1147,370 +1147,370 @@  discard block
 block discarded – undo
1147 1147
         }
1148 1148
     }*/
1149 1149
 
1150
-    /**
1151
-     * Returns an identifier for the group of tables passed in parameter.
1152
-     *
1153
-     * @param string[] $relatedTables
1154
-     *
1155
-     * @return string
1156
-     */
1157
-    private function getTableGroupName(array $relatedTables)
1158
-    {
1159
-        sort($relatedTables);
1160
-
1161
-        return implode('_``_', $relatedTables);
1162
-    }
1163
-
1164
-    /**
1165
-     * Returns a `ResultIterator` object representing filtered records of "$mainTable" .
1166
-     *
1167
-     * The findObjects method should be the most used query method in TDBM if you want to query the database for objects.
1168
-     * (Note: if you want to query the database for an object by its primary key, use the findObjectByPk method).
1169
-     *
1170
-     * The findObjects method takes in parameter:
1171
-     * 	- mainTable: the kind of bean you want to retrieve. In TDBM, a bean matches a database row, so the
1172
-     * 			`$mainTable` parameter should be the name of an existing table in database.
1173
-     *  - filter: The filter is a filter bag. It is what you use to filter your request (the WHERE part in SQL).
1174
-     *          It can be a string (SQL Where clause), or even a bean or an associative array (key = column to filter, value = value to find)
1175
-     *  - parameters: The parameters used in the filter. If you pass a SQL string as a filter, be sure to avoid
1176
-     *          concatenating parameters in the string (this leads to SQL injection and also to poor caching performance).
1177
-     *          Instead, please consider passing parameters (see documentation for more details).
1178
-     *  - additionalTablesFetch: An array of SQL tables names. The beans related to those tables will be fetched along
1179
-     *          the main table. This is useful to avoid hitting the database with numerous subqueries.
1180
-     *  - mode: The fetch mode of the result. See `setFetchMode()` method for more details.
1181
-     *
1182
-     * The `findObjects` method will return a `ResultIterator`. A `ResultIterator` is an object that behaves as an array
1183
-     * (in ARRAY mode) at least. It can be iterated using a `foreach` loop.
1184
-     *
1185
-     * Finally, if filter_bag is null, the whole table is returned.
1186
-     *
1187
-     * @param string            $mainTable             The name of the table queried
1188
-     * @param string|array|null $filter                The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column)
1189
-     * @param array             $parameters
1190
-     * @param string|null       $orderString           The ORDER BY part of the query. All columns must be prefixed by the table name (in the form: table.column)
1191
-     * @param array             $additionalTablesFetch
1192
-     * @param int               $mode
1193
-     * @param string            $className             Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
1194
-     *
1195
-     * @return ResultIterator An object representing an array of results.
1196
-     *
1197
-     * @throws TDBMException
1198
-     */
1199
-    public function findObjects($mainTable, $filter = null, array $parameters = array(), $orderString = null, array $additionalTablesFetch = array(), $mode = null, $className = null)
1200
-    {
1201
-        // $mainTable is not secured in MagicJoin, let's add a bit of security to avoid SQL injection.
1202
-        if (!preg_match('/^[a-zA-Z_][a-zA-Z0-9_]*$/', $mainTable)) {
1203
-            throw new TDBMException(sprintf("Invalid table name: '%s'", $mainTable));
1204
-        }
1205
-
1206
-        list($filterString, $additionalParameters) = $this->buildFilterFromFilterBag($filter);
1207
-
1208
-        $parameters = array_merge($parameters, $additionalParameters);
1209
-
1210
-        // From the table name and the additional tables we want to fetch, let's build a list of all tables
1211
-        // that must be part of the select columns.
1212
-
1213
-        $tableGroups = [];
1214
-        $allFetchedTables = $this->_getRelatedTablesByInheritance($mainTable);
1215
-        $tableGroupName = $this->getTableGroupName($allFetchedTables);
1216
-        foreach ($allFetchedTables as $table) {
1217
-            $tableGroups[$table] = $tableGroupName;
1218
-        }
1219
-
1220
-        foreach ($additionalTablesFetch as $additionalTable) {
1221
-            $relatedTables = $this->_getRelatedTablesByInheritance($additionalTable);
1222
-            $tableGroupName = $this->getTableGroupName($relatedTables);
1223
-            foreach ($relatedTables as $table) {
1224
-                $tableGroups[$table] = $tableGroupName;
1225
-            }
1226
-            $allFetchedTables = array_merge($allFetchedTables, $relatedTables);
1227
-        }
1228
-
1229
-        // Let's remove any duplicate
1230
-        $allFetchedTables = array_flip(array_flip($allFetchedTables));
1231
-
1232
-        $columnsList = [];
1233
-        $columnDescList = [];
1234
-        $schema = $this->tdbmSchemaAnalyzer->getSchema();
1235
-
1236
-        // Now, let's build the column list
1237
-        foreach ($allFetchedTables as $table) {
1238
-            foreach ($schema->getTable($table)->getColumns() as $column) {
1239
-                $columnName = $column->getName();
1240
-                $columnDescList[] = [
1241
-                    'as' => $table.'____'.$columnName,
1242
-                    'table' => $table,
1243
-                    'column' => $columnName,
1244
-                    'type' => $column->getType(),
1245
-                    'tableGroup' => $tableGroups[$table],
1246
-                ];
1247
-                $columnsList[] = $this->connection->quoteIdentifier($table).'.'.$this->connection->quoteIdentifier($columnName).' as '.
1248
-                    $this->connection->quoteIdentifier($table.'____'.$columnName);
1249
-            }
1250
-        }
1251
-
1252
-        $sql = 'SELECT DISTINCT '.implode(', ', $columnsList).' FROM MAGICJOIN('.$mainTable.')';
1253
-        $countSql = 'SELECT COUNT(1) FROM MAGICJOIN('.$mainTable.')';
1254
-
1255
-        if (!empty($filterString)) {
1256
-            $sql .= ' WHERE '.$filterString;
1257
-            $countSql .= ' WHERE '.$filterString;
1258
-        }
1259
-
1260
-        if (!empty($orderString)) {
1261
-            $sql .= ' ORDER BY '.$orderString;
1262
-            $countSql .= ' ORDER BY '.$orderString;
1263
-        }
1264
-
1265
-        if ($mode !== null && $mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) {
1266
-            throw new TDBMException("Unknown fetch mode: '".$this->mode."'");
1267
-        }
1268
-
1269
-        $mode = $mode ?: $this->mode;
1270
-
1271
-        return new ResultIterator($sql, $countSql, $parameters, $columnDescList, $this->objectStorage, $className, $this, $this->magicQuery, $mode);
1272
-    }
1273
-
1274
-    /**
1275
-     * @param $table
1276
-     * @param array  $primaryKeys
1277
-     * @param array  $additionalTablesFetch
1278
-     * @param bool   $lazy                  Whether to perform lazy loading on this object or not.
1279
-     * @param string $className
1280
-     *
1281
-     * @return AbstractTDBMObject
1282
-     *
1283
-     * @throws TDBMException
1284
-     */
1285
-    public function findObjectByPk($table, array $primaryKeys, array $additionalTablesFetch = array(), $lazy = false, $className = null)
1286
-    {
1287
-        $primaryKeys = $this->_getPrimaryKeysFromObjectData($table, $primaryKeys);
1288
-        $hash = $this->getObjectHash($primaryKeys);
1289
-
1290
-        if ($this->objectStorage->has($table, $hash)) {
1291
-            $dbRow = $this->objectStorage->get($table, $hash);
1292
-            $bean = $dbRow->getTDBMObject();
1293
-            if ($className !== null && !is_a($bean, $className)) {
1294
-                throw new TDBMException("TDBM cannot create a bean of class '".$className."'. The requested object was already loaded and its class is '".get_class($bean)."'");
1295
-            }
1296
-
1297
-            return $bean;
1298
-        }
1299
-
1300
-        // Are we performing lazy fetching?
1301
-        if ($lazy === true) {
1302
-            // Can we perform lazy fetching?
1303
-            $tables = $this->_getRelatedTablesByInheritance($table);
1304
-            // Only allowed if no inheritance.
1305
-            if (count($tables) === 1) {
1306
-                if ($className === null) {
1307
-                    $className = isset($this->tableToBeanMap[$table]) ? $this->tableToBeanMap[$table] : 'Mouf\\Database\\TDBM\\TDBMObject';
1308
-                }
1309
-
1310
-                // Let's construct the bean
1311
-                if (!isset($this->reflectionClassCache[$className])) {
1312
-                    $this->reflectionClassCache[$className] = new \ReflectionClass($className);
1313
-                }
1314
-                // Let's bypass the constructor when creating the bean!
1315
-                $bean = $this->reflectionClassCache[$className]->newInstanceWithoutConstructor();
1316
-                /* @var $bean AbstractTDBMObject */
1317
-                $bean->_constructLazy($table, $primaryKeys, $this);
1318
-            }
1319
-        }
1320
-
1321
-        // Did not find the object in cache? Let's query it!
1322
-        return $this->findObjectOrFail($table, $primaryKeys, [], $additionalTablesFetch, $className);
1323
-    }
1324
-
1325
-    /**
1326
-     * Returns a unique bean (or null) according to the filters passed in parameter.
1327
-     *
1328
-     * @param string            $mainTable             The name of the table queried
1329
-     * @param string|array|null $filter                The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column)
1330
-     * @param array             $parameters
1331
-     * @param array             $additionalTablesFetch
1332
-     * @param string            $className             Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
1333
-     *
1334
-     * @return AbstractTDBMObject|null The object we want, or null if no object matches the filters.
1335
-     *
1336
-     * @throws TDBMException
1337
-     */
1338
-    public function findObject($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null)
1339
-    {
1340
-        $objects = $this->findObjects($mainTable, $filter, $parameters, null, $additionalTablesFetch, self::MODE_ARRAY, $className);
1341
-        $page = $objects->take(0, 2);
1342
-        $count = $page->count();
1343
-        if ($count > 1) {
1344
-            throw new DuplicateRowException("Error while querying an object for table '$mainTable': More than 1 row have been returned, but we should have received at most one.");
1345
-        } elseif ($count === 0) {
1346
-            return;
1347
-        }
1348
-
1349
-        return $objects[0];
1350
-    }
1351
-
1352
-    /**
1353
-     * Returns a unique bean according to the filters passed in parameter.
1354
-     * Throws a NoBeanFoundException if no bean was found for the filter passed in parameter.
1355
-     *
1356
-     * @param string            $mainTable             The name of the table queried
1357
-     * @param string|array|null $filter                The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column)
1358
-     * @param array             $parameters
1359
-     * @param array             $additionalTablesFetch
1360
-     * @param string            $className             Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
1361
-     *
1362
-     * @return AbstractTDBMObject The object we want
1363
-     *
1364
-     * @throws TDBMException
1365
-     */
1366
-    public function findObjectOrFail($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null)
1367
-    {
1368
-        $bean = $this->findObject($mainTable, $filter, $parameters, $additionalTablesFetch, $className);
1369
-        if ($bean === null) {
1370
-            throw new NoBeanFoundException("No result found for query on table '".$mainTable."'");
1371
-        }
1372
-
1373
-        return $bean;
1374
-    }
1375
-
1376
-    /**
1377
-     * @param array $beanData An array of data: array<table, array<column, value>>
1378
-     *
1379
-     * @return array an array with first item = class name and second item = table name
1380
-     */
1381
-    public function _getClassNameFromBeanData(array $beanData)
1382
-    {
1383
-        if (count($beanData) === 1) {
1384
-            $tableName = array_keys($beanData)[0];
1385
-        } else {
1386
-            $tables = [];
1387
-            foreach ($beanData as $table => $row) {
1388
-                $primaryKeyColumns = $this->getPrimaryKeyColumns($table);
1389
-                $pkSet = false;
1390
-                foreach ($primaryKeyColumns as $columnName) {
1391
-                    if ($row[$columnName] !== null) {
1392
-                        $pkSet = true;
1393
-                        break;
1394
-                    }
1395
-                }
1396
-                if ($pkSet) {
1397
-                    $tables[] = $table;
1398
-                }
1399
-            }
1400
-
1401
-            // $tables contains the tables for this bean. Let's view the top most part of the hierarchy
1402
-            $allTables = $this->_getLinkBetweenInheritedTables($tables);
1403
-            $tableName = $allTables[0];
1404
-        }
1405
-
1406
-        // Only one table in this bean. Life is sweat, let's look at its type:
1407
-        if (isset($this->tableToBeanMap[$tableName])) {
1408
-            return [$this->tableToBeanMap[$tableName], $tableName];
1409
-        } else {
1410
-            return ['Mouf\\Database\\TDBM\\TDBMObject', $tableName];
1411
-        }
1412
-    }
1413
-
1414
-    /**
1415
-     * Returns an item from cache or computes it using $closure and puts it in cache.
1416
-     *
1417
-     * @param string   $key
1418
-     * @param callable $closure
1419
-     *
1420
-     * @return mixed
1421
-     */
1422
-    private function fromCache($key, callable $closure)
1423
-    {
1424
-        $item = $this->cache->fetch($key);
1425
-        if ($item === false) {
1426
-            $item = $closure();
1427
-            $this->cache->save($key, $item);
1428
-        }
1429
-
1430
-        return $item;
1431
-    }
1432
-
1433
-    /**
1434
-     * Returns the foreign key object.
1435
-     *
1436
-     * @param string $table
1437
-     * @param string $fkName
1438
-     *
1439
-     * @return ForeignKeyConstraint
1440
-     */
1441
-    public function _getForeignKeyByName($table, $fkName)
1442
-    {
1443
-        return $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getForeignKey($fkName);
1444
-    }
1445
-
1446
-    /**
1447
-     * @param $pivotTableName
1448
-     * @param AbstractTDBMObject $bean
1449
-     *
1450
-     * @return AbstractTDBMObject[]
1451
-     */
1452
-    public function _getRelatedBeans($pivotTableName, AbstractTDBMObject $bean)
1453
-    {
1454
-        list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $bean);
1455
-        /* @var $localFk ForeignKeyConstraint */
1456
-        /* @var $remoteFk ForeignKeyConstraint */
1457
-        $remoteTable = $remoteFk->getForeignTableName();
1458
-
1459
-        $primaryKeys = $this->getPrimaryKeyValues($bean);
1460
-        $columnNames = array_map(function ($name) use ($pivotTableName) { return $pivotTableName.'.'.$name; }, $localFk->getLocalColumns());
1461
-
1462
-        $filter = array_combine($columnNames, $primaryKeys);
1463
-
1464
-        return $this->findObjects($remoteTable, $filter);
1465
-    }
1466
-
1467
-    /**
1468
-     * @param $pivotTableName
1469
-     * @param AbstractTDBMObject $bean The LOCAL bean
1470
-     *
1471
-     * @return ForeignKeyConstraint[] First item: the LOCAL bean, second item: the REMOTE bean.
1472
-     *
1473
-     * @throws TDBMException
1474
-     */
1475
-    private function getPivotTableForeignKeys($pivotTableName, AbstractTDBMObject $bean)
1476
-    {
1477
-        $fks = array_values($this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName)->getForeignKeys());
1478
-        $table1 = $fks[0]->getForeignTableName();
1479
-        $table2 = $fks[1]->getForeignTableName();
1480
-
1481
-        $beanTables = array_map(function (DbRow $dbRow) { return $dbRow->_getDbTableName(); }, $bean->_getDbRows());
1482
-
1483
-        if (in_array($table1, $beanTables)) {
1484
-            return [$fks[0], $fks[1]];
1485
-        } elseif (in_array($table2, $beanTables)) {
1486
-            return [$fks[1], $fks[0]];
1487
-        } else {
1488
-            throw new TDBMException("Unexpected bean type in getPivotTableForeignKeys. Awaiting beans from table {$table1} and {$table2} for pivot table {$pivotTableName}");
1489
-        }
1490
-    }
1491
-
1492
-    /**
1493
-     * Returns a list of pivot tables linked to $bean.
1494
-     *
1495
-     * @param AbstractTDBMObject $bean
1496
-     *
1497
-     * @return string[]
1498
-     */
1499
-    public function _getPivotTablesLinkedToBean(AbstractTDBMObject $bean)
1500
-    {
1501
-        $junctionTables = [];
1502
-        $allJunctionTables = $this->schemaAnalyzer->detectJunctionTables();
1503
-        foreach ($bean->_getDbRows() as $dbRow) {
1504
-            foreach ($allJunctionTables as $table) {
1505
-                // There are exactly 2 FKs since this is a pivot table.
1506
-                $fks = array_values($table->getForeignKeys());
1507
-
1508
-                if ($fks[0]->getForeignTableName() === $dbRow->_getDbTableName() || $fks[1]->getForeignTableName() === $dbRow->_getDbTableName()) {
1509
-                    $junctionTables[] = $table->getName();
1510
-                }
1511
-            }
1512
-        }
1513
-
1514
-        return $junctionTables;
1515
-    }
1150
+	/**
1151
+	 * Returns an identifier for the group of tables passed in parameter.
1152
+	 *
1153
+	 * @param string[] $relatedTables
1154
+	 *
1155
+	 * @return string
1156
+	 */
1157
+	private function getTableGroupName(array $relatedTables)
1158
+	{
1159
+		sort($relatedTables);
1160
+
1161
+		return implode('_``_', $relatedTables);
1162
+	}
1163
+
1164
+	/**
1165
+	 * Returns a `ResultIterator` object representing filtered records of "$mainTable" .
1166
+	 *
1167
+	 * The findObjects method should be the most used query method in TDBM if you want to query the database for objects.
1168
+	 * (Note: if you want to query the database for an object by its primary key, use the findObjectByPk method).
1169
+	 *
1170
+	 * The findObjects method takes in parameter:
1171
+	 * 	- mainTable: the kind of bean you want to retrieve. In TDBM, a bean matches a database row, so the
1172
+	 * 			`$mainTable` parameter should be the name of an existing table in database.
1173
+	 *  - filter: The filter is a filter bag. It is what you use to filter your request (the WHERE part in SQL).
1174
+	 *          It can be a string (SQL Where clause), or even a bean or an associative array (key = column to filter, value = value to find)
1175
+	 *  - parameters: The parameters used in the filter. If you pass a SQL string as a filter, be sure to avoid
1176
+	 *          concatenating parameters in the string (this leads to SQL injection and also to poor caching performance).
1177
+	 *          Instead, please consider passing parameters (see documentation for more details).
1178
+	 *  - additionalTablesFetch: An array of SQL tables names. The beans related to those tables will be fetched along
1179
+	 *          the main table. This is useful to avoid hitting the database with numerous subqueries.
1180
+	 *  - mode: The fetch mode of the result. See `setFetchMode()` method for more details.
1181
+	 *
1182
+	 * The `findObjects` method will return a `ResultIterator`. A `ResultIterator` is an object that behaves as an array
1183
+	 * (in ARRAY mode) at least. It can be iterated using a `foreach` loop.
1184
+	 *
1185
+	 * Finally, if filter_bag is null, the whole table is returned.
1186
+	 *
1187
+	 * @param string            $mainTable             The name of the table queried
1188
+	 * @param string|array|null $filter                The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column)
1189
+	 * @param array             $parameters
1190
+	 * @param string|null       $orderString           The ORDER BY part of the query. All columns must be prefixed by the table name (in the form: table.column)
1191
+	 * @param array             $additionalTablesFetch
1192
+	 * @param int               $mode
1193
+	 * @param string            $className             Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
1194
+	 *
1195
+	 * @return ResultIterator An object representing an array of results.
1196
+	 *
1197
+	 * @throws TDBMException
1198
+	 */
1199
+	public function findObjects($mainTable, $filter = null, array $parameters = array(), $orderString = null, array $additionalTablesFetch = array(), $mode = null, $className = null)
1200
+	{
1201
+		// $mainTable is not secured in MagicJoin, let's add a bit of security to avoid SQL injection.
1202
+		if (!preg_match('/^[a-zA-Z_][a-zA-Z0-9_]*$/', $mainTable)) {
1203
+			throw new TDBMException(sprintf("Invalid table name: '%s'", $mainTable));
1204
+		}
1205
+
1206
+		list($filterString, $additionalParameters) = $this->buildFilterFromFilterBag($filter);
1207
+
1208
+		$parameters = array_merge($parameters, $additionalParameters);
1209
+
1210
+		// From the table name and the additional tables we want to fetch, let's build a list of all tables
1211
+		// that must be part of the select columns.
1212
+
1213
+		$tableGroups = [];
1214
+		$allFetchedTables = $this->_getRelatedTablesByInheritance($mainTable);
1215
+		$tableGroupName = $this->getTableGroupName($allFetchedTables);
1216
+		foreach ($allFetchedTables as $table) {
1217
+			$tableGroups[$table] = $tableGroupName;
1218
+		}
1219
+
1220
+		foreach ($additionalTablesFetch as $additionalTable) {
1221
+			$relatedTables = $this->_getRelatedTablesByInheritance($additionalTable);
1222
+			$tableGroupName = $this->getTableGroupName($relatedTables);
1223
+			foreach ($relatedTables as $table) {
1224
+				$tableGroups[$table] = $tableGroupName;
1225
+			}
1226
+			$allFetchedTables = array_merge($allFetchedTables, $relatedTables);
1227
+		}
1228
+
1229
+		// Let's remove any duplicate
1230
+		$allFetchedTables = array_flip(array_flip($allFetchedTables));
1231
+
1232
+		$columnsList = [];
1233
+		$columnDescList = [];
1234
+		$schema = $this->tdbmSchemaAnalyzer->getSchema();
1235
+
1236
+		// Now, let's build the column list
1237
+		foreach ($allFetchedTables as $table) {
1238
+			foreach ($schema->getTable($table)->getColumns() as $column) {
1239
+				$columnName = $column->getName();
1240
+				$columnDescList[] = [
1241
+					'as' => $table.'____'.$columnName,
1242
+					'table' => $table,
1243
+					'column' => $columnName,
1244
+					'type' => $column->getType(),
1245
+					'tableGroup' => $tableGroups[$table],
1246
+				];
1247
+				$columnsList[] = $this->connection->quoteIdentifier($table).'.'.$this->connection->quoteIdentifier($columnName).' as '.
1248
+					$this->connection->quoteIdentifier($table.'____'.$columnName);
1249
+			}
1250
+		}
1251
+
1252
+		$sql = 'SELECT DISTINCT '.implode(', ', $columnsList).' FROM MAGICJOIN('.$mainTable.')';
1253
+		$countSql = 'SELECT COUNT(1) FROM MAGICJOIN('.$mainTable.')';
1254
+
1255
+		if (!empty($filterString)) {
1256
+			$sql .= ' WHERE '.$filterString;
1257
+			$countSql .= ' WHERE '.$filterString;
1258
+		}
1259
+
1260
+		if (!empty($orderString)) {
1261
+			$sql .= ' ORDER BY '.$orderString;
1262
+			$countSql .= ' ORDER BY '.$orderString;
1263
+		}
1264
+
1265
+		if ($mode !== null && $mode !== self::MODE_CURSOR && $mode !== self::MODE_ARRAY) {
1266
+			throw new TDBMException("Unknown fetch mode: '".$this->mode."'");
1267
+		}
1268
+
1269
+		$mode = $mode ?: $this->mode;
1270
+
1271
+		return new ResultIterator($sql, $countSql, $parameters, $columnDescList, $this->objectStorage, $className, $this, $this->magicQuery, $mode);
1272
+	}
1273
+
1274
+	/**
1275
+	 * @param $table
1276
+	 * @param array  $primaryKeys
1277
+	 * @param array  $additionalTablesFetch
1278
+	 * @param bool   $lazy                  Whether to perform lazy loading on this object or not.
1279
+	 * @param string $className
1280
+	 *
1281
+	 * @return AbstractTDBMObject
1282
+	 *
1283
+	 * @throws TDBMException
1284
+	 */
1285
+	public function findObjectByPk($table, array $primaryKeys, array $additionalTablesFetch = array(), $lazy = false, $className = null)
1286
+	{
1287
+		$primaryKeys = $this->_getPrimaryKeysFromObjectData($table, $primaryKeys);
1288
+		$hash = $this->getObjectHash($primaryKeys);
1289
+
1290
+		if ($this->objectStorage->has($table, $hash)) {
1291
+			$dbRow = $this->objectStorage->get($table, $hash);
1292
+			$bean = $dbRow->getTDBMObject();
1293
+			if ($className !== null && !is_a($bean, $className)) {
1294
+				throw new TDBMException("TDBM cannot create a bean of class '".$className."'. The requested object was already loaded and its class is '".get_class($bean)."'");
1295
+			}
1296
+
1297
+			return $bean;
1298
+		}
1299
+
1300
+		// Are we performing lazy fetching?
1301
+		if ($lazy === true) {
1302
+			// Can we perform lazy fetching?
1303
+			$tables = $this->_getRelatedTablesByInheritance($table);
1304
+			// Only allowed if no inheritance.
1305
+			if (count($tables) === 1) {
1306
+				if ($className === null) {
1307
+					$className = isset($this->tableToBeanMap[$table]) ? $this->tableToBeanMap[$table] : 'Mouf\\Database\\TDBM\\TDBMObject';
1308
+				}
1309
+
1310
+				// Let's construct the bean
1311
+				if (!isset($this->reflectionClassCache[$className])) {
1312
+					$this->reflectionClassCache[$className] = new \ReflectionClass($className);
1313
+				}
1314
+				// Let's bypass the constructor when creating the bean!
1315
+				$bean = $this->reflectionClassCache[$className]->newInstanceWithoutConstructor();
1316
+				/* @var $bean AbstractTDBMObject */
1317
+				$bean->_constructLazy($table, $primaryKeys, $this);
1318
+			}
1319
+		}
1320
+
1321
+		// Did not find the object in cache? Let's query it!
1322
+		return $this->findObjectOrFail($table, $primaryKeys, [], $additionalTablesFetch, $className);
1323
+	}
1324
+
1325
+	/**
1326
+	 * Returns a unique bean (or null) according to the filters passed in parameter.
1327
+	 *
1328
+	 * @param string            $mainTable             The name of the table queried
1329
+	 * @param string|array|null $filter                The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column)
1330
+	 * @param array             $parameters
1331
+	 * @param array             $additionalTablesFetch
1332
+	 * @param string            $className             Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
1333
+	 *
1334
+	 * @return AbstractTDBMObject|null The object we want, or null if no object matches the filters.
1335
+	 *
1336
+	 * @throws TDBMException
1337
+	 */
1338
+	public function findObject($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null)
1339
+	{
1340
+		$objects = $this->findObjects($mainTable, $filter, $parameters, null, $additionalTablesFetch, self::MODE_ARRAY, $className);
1341
+		$page = $objects->take(0, 2);
1342
+		$count = $page->count();
1343
+		if ($count > 1) {
1344
+			throw new DuplicateRowException("Error while querying an object for table '$mainTable': More than 1 row have been returned, but we should have received at most one.");
1345
+		} elseif ($count === 0) {
1346
+			return;
1347
+		}
1348
+
1349
+		return $objects[0];
1350
+	}
1351
+
1352
+	/**
1353
+	 * Returns a unique bean according to the filters passed in parameter.
1354
+	 * Throws a NoBeanFoundException if no bean was found for the filter passed in parameter.
1355
+	 *
1356
+	 * @param string            $mainTable             The name of the table queried
1357
+	 * @param string|array|null $filter                The SQL filters to apply to the query (the WHERE part). All columns must be prefixed by the table name (in the form: table.column)
1358
+	 * @param array             $parameters
1359
+	 * @param array             $additionalTablesFetch
1360
+	 * @param string            $className             Optional: The name of the class to instantiate. This class must extend the TDBMObject class. If none is specified, a TDBMObject instance will be returned.
1361
+	 *
1362
+	 * @return AbstractTDBMObject The object we want
1363
+	 *
1364
+	 * @throws TDBMException
1365
+	 */
1366
+	public function findObjectOrFail($mainTable, $filter = null, array $parameters = array(), array $additionalTablesFetch = array(), $className = null)
1367
+	{
1368
+		$bean = $this->findObject($mainTable, $filter, $parameters, $additionalTablesFetch, $className);
1369
+		if ($bean === null) {
1370
+			throw new NoBeanFoundException("No result found for query on table '".$mainTable."'");
1371
+		}
1372
+
1373
+		return $bean;
1374
+	}
1375
+
1376
+	/**
1377
+	 * @param array $beanData An array of data: array<table, array<column, value>>
1378
+	 *
1379
+	 * @return array an array with first item = class name and second item = table name
1380
+	 */
1381
+	public function _getClassNameFromBeanData(array $beanData)
1382
+	{
1383
+		if (count($beanData) === 1) {
1384
+			$tableName = array_keys($beanData)[0];
1385
+		} else {
1386
+			$tables = [];
1387
+			foreach ($beanData as $table => $row) {
1388
+				$primaryKeyColumns = $this->getPrimaryKeyColumns($table);
1389
+				$pkSet = false;
1390
+				foreach ($primaryKeyColumns as $columnName) {
1391
+					if ($row[$columnName] !== null) {
1392
+						$pkSet = true;
1393
+						break;
1394
+					}
1395
+				}
1396
+				if ($pkSet) {
1397
+					$tables[] = $table;
1398
+				}
1399
+			}
1400
+
1401
+			// $tables contains the tables for this bean. Let's view the top most part of the hierarchy
1402
+			$allTables = $this->_getLinkBetweenInheritedTables($tables);
1403
+			$tableName = $allTables[0];
1404
+		}
1405
+
1406
+		// Only one table in this bean. Life is sweat, let's look at its type:
1407
+		if (isset($this->tableToBeanMap[$tableName])) {
1408
+			return [$this->tableToBeanMap[$tableName], $tableName];
1409
+		} else {
1410
+			return ['Mouf\\Database\\TDBM\\TDBMObject', $tableName];
1411
+		}
1412
+	}
1413
+
1414
+	/**
1415
+	 * Returns an item from cache or computes it using $closure and puts it in cache.
1416
+	 *
1417
+	 * @param string   $key
1418
+	 * @param callable $closure
1419
+	 *
1420
+	 * @return mixed
1421
+	 */
1422
+	private function fromCache($key, callable $closure)
1423
+	{
1424
+		$item = $this->cache->fetch($key);
1425
+		if ($item === false) {
1426
+			$item = $closure();
1427
+			$this->cache->save($key, $item);
1428
+		}
1429
+
1430
+		return $item;
1431
+	}
1432
+
1433
+	/**
1434
+	 * Returns the foreign key object.
1435
+	 *
1436
+	 * @param string $table
1437
+	 * @param string $fkName
1438
+	 *
1439
+	 * @return ForeignKeyConstraint
1440
+	 */
1441
+	public function _getForeignKeyByName($table, $fkName)
1442
+	{
1443
+		return $this->tdbmSchemaAnalyzer->getSchema()->getTable($table)->getForeignKey($fkName);
1444
+	}
1445
+
1446
+	/**
1447
+	 * @param $pivotTableName
1448
+	 * @param AbstractTDBMObject $bean
1449
+	 *
1450
+	 * @return AbstractTDBMObject[]
1451
+	 */
1452
+	public function _getRelatedBeans($pivotTableName, AbstractTDBMObject $bean)
1453
+	{
1454
+		list($localFk, $remoteFk) = $this->getPivotTableForeignKeys($pivotTableName, $bean);
1455
+		/* @var $localFk ForeignKeyConstraint */
1456
+		/* @var $remoteFk ForeignKeyConstraint */
1457
+		$remoteTable = $remoteFk->getForeignTableName();
1458
+
1459
+		$primaryKeys = $this->getPrimaryKeyValues($bean);
1460
+		$columnNames = array_map(function ($name) use ($pivotTableName) { return $pivotTableName.'.'.$name; }, $localFk->getLocalColumns());
1461
+
1462
+		$filter = array_combine($columnNames, $primaryKeys);
1463
+
1464
+		return $this->findObjects($remoteTable, $filter);
1465
+	}
1466
+
1467
+	/**
1468
+	 * @param $pivotTableName
1469
+	 * @param AbstractTDBMObject $bean The LOCAL bean
1470
+	 *
1471
+	 * @return ForeignKeyConstraint[] First item: the LOCAL bean, second item: the REMOTE bean.
1472
+	 *
1473
+	 * @throws TDBMException
1474
+	 */
1475
+	private function getPivotTableForeignKeys($pivotTableName, AbstractTDBMObject $bean)
1476
+	{
1477
+		$fks = array_values($this->tdbmSchemaAnalyzer->getSchema()->getTable($pivotTableName)->getForeignKeys());
1478
+		$table1 = $fks[0]->getForeignTableName();
1479
+		$table2 = $fks[1]->getForeignTableName();
1480
+
1481
+		$beanTables = array_map(function (DbRow $dbRow) { return $dbRow->_getDbTableName(); }, $bean->_getDbRows());
1482
+
1483
+		if (in_array($table1, $beanTables)) {
1484
+			return [$fks[0], $fks[1]];
1485
+		} elseif (in_array($table2, $beanTables)) {
1486
+			return [$fks[1], $fks[0]];
1487
+		} else {
1488
+			throw new TDBMException("Unexpected bean type in getPivotTableForeignKeys. Awaiting beans from table {$table1} and {$table2} for pivot table {$pivotTableName}");
1489
+		}
1490
+	}
1491
+
1492
+	/**
1493
+	 * Returns a list of pivot tables linked to $bean.
1494
+	 *
1495
+	 * @param AbstractTDBMObject $bean
1496
+	 *
1497
+	 * @return string[]
1498
+	 */
1499
+	public function _getPivotTablesLinkedToBean(AbstractTDBMObject $bean)
1500
+	{
1501
+		$junctionTables = [];
1502
+		$allJunctionTables = $this->schemaAnalyzer->detectJunctionTables();
1503
+		foreach ($bean->_getDbRows() as $dbRow) {
1504
+			foreach ($allJunctionTables as $table) {
1505
+				// There are exactly 2 FKs since this is a pivot table.
1506
+				$fks = array_values($table->getForeignKeys());
1507
+
1508
+				if ($fks[0]->getForeignTableName() === $dbRow->_getDbTableName() || $fks[1]->getForeignTableName() === $dbRow->_getDbTableName()) {
1509
+					$junctionTables[] = $table->getName();
1510
+				}
1511
+			}
1512
+		}
1513
+
1514
+		return $junctionTables;
1515
+	}
1516 1516
 }
Please login to merge, or discard this patch.
src/Mouf/Database/TDBM/Utils/TDBMDaoGenerator.php 1 patch
Indentation   +471 added lines, -471 removed lines patch added patch discarded remove patch
@@ -17,200 +17,200 @@  discard block
 block discarded – undo
17 17
  */
18 18
 class TDBMDaoGenerator
19 19
 {
20
-    /**
21
-     * @var SchemaAnalyzer
22
-     */
23
-    private $schemaAnalyzer;
24
-
25
-    /**
26
-     * @var Schema
27
-     */
28
-    private $schema;
29
-
30
-    /**
31
-     * The root directory of the project.
32
-     *
33
-     * @var string
34
-     */
35
-    private $rootPath;
36
-
37
-    /**
38
-     * Name of composer file.
39
-     *
40
-     * @var string
41
-     */
42
-    private $composerFile;
43
-
44
-    /**
45
-     * @var TDBMSchemaAnalyzer
46
-     */
47
-    private $tdbmSchemaAnalyzer;
48
-
49
-    /**
50
-     * Constructor.
51
-     *
52
-     * @param SchemaAnalyzer     $schemaAnalyzer
53
-     * @param Schema             $schema
54
-     * @param TDBMSchemaAnalyzer $tdbmSchemaAnalyzer
55
-     */
56
-    public function __construct(SchemaAnalyzer $schemaAnalyzer, Schema $schema, TDBMSchemaAnalyzer $tdbmSchemaAnalyzer)
57
-    {
58
-        $this->schemaAnalyzer = $schemaAnalyzer;
59
-        $this->schema = $schema;
60
-        $this->tdbmSchemaAnalyzer = $tdbmSchemaAnalyzer;
61
-        $this->rootPath = __DIR__.'/../../../../../../../../';
62
-        $this->composerFile = 'composer.json';
63
-    }
64
-
65
-    /**
66
-     * Generates all the daos and beans.
67
-     *
68
-     * @param string $daoFactoryClassName The classe name of the DAO factory
69
-     * @param string $daonamespace        The namespace for the DAOs, without trailing \
70
-     * @param string $beannamespace       The Namespace for the beans, without trailing \
71
-     * @param bool   $storeInUtc          If the generated daos should store the date in UTC timezone instead of user's timezone.
72
-     *
73
-     * @return \string[] the list of tables
74
-     *
75
-     * @throws TDBMException
76
-     */
77
-    public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc)
78
-    {
79
-        $classNameMapper = ClassNameMapper::createFromComposerFile($this->rootPath.$this->composerFile);
80
-        // TODO: check that no class name ends with "Base". Otherwise, there will be name clash.
81
-
82
-        $tableList = $this->schema->getTables();
83
-
84
-        // Remove all beans and daos from junction tables
85
-        $junctionTables = $this->schemaAnalyzer->detectJunctionTables();
86
-        $junctionTableNames = array_map(function (Table $table) {
87
-            return $table->getName();
88
-        }, $junctionTables);
89
-
90
-        $tableList = array_filter($tableList, function (Table $table) use ($junctionTableNames) {
91
-            return !in_array($table->getName(), $junctionTableNames);
92
-        });
93
-
94
-        foreach ($tableList as $table) {
95
-            $this->generateDaoAndBean($table, $daonamespace, $beannamespace, $classNameMapper, $storeInUtc);
96
-        }
97
-
98
-        $this->generateFactory($tableList, $daoFactoryClassName, $daonamespace, $classNameMapper);
99
-
100
-        // Ok, let's return the list of all tables.
101
-        // These will be used by the calling script to create Mouf instances.
102
-
103
-        return array_map(function (Table $table) { return $table->getName(); }, $tableList);
104
-    }
105
-
106
-    /**
107
-     * Generates in one method call the daos and the beans for one table.
108
-     *
109
-     * @param Table           $table
110
-     * @param string          $daonamespace
111
-     * @param string          $beannamespace
112
-     * @param ClassNameMapper $classNameMapper
113
-     * @param bool            $storeInUtc
114
-     *
115
-     * @throws TDBMException
116
-     */
117
-    public function generateDaoAndBean(Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc)
118
-    {
119
-        $tableName = $table->getName();
120
-        $daoName = $this->getDaoNameFromTableName($tableName);
121
-        $beanName = $this->getBeanNameFromTableName($tableName);
122
-        $baseBeanName = $this->getBaseBeanNameFromTableName($tableName);
123
-        $baseDaoName = $this->getBaseDaoNameFromTableName($tableName);
124
-
125
-        $beanDescriptor = new BeanDescriptor($table, $this->schemaAnalyzer, $this->schema, $this->tdbmSchemaAnalyzer);
126
-        $this->generateBean($beanDescriptor, $beanName, $baseBeanName, $table, $beannamespace, $classNameMapper, $storeInUtc);
127
-        $this->generateDao($beanDescriptor, $daoName, $baseDaoName, $beanName, $table, $daonamespace, $beannamespace, $classNameMapper);
128
-    }
129
-
130
-    /**
131
-     * Returns the name of the bean class from the table name.
132
-     *
133
-     * @param $tableName
134
-     *
135
-     * @return string
136
-     */
137
-    public static function getBeanNameFromTableName($tableName)
138
-    {
139
-        return self::toSingular(self::toCamelCase($tableName)).'Bean';
140
-    }
141
-
142
-    /**
143
-     * Returns the name of the DAO class from the table name.
144
-     *
145
-     * @param $tableName
146
-     *
147
-     * @return string
148
-     */
149
-    public static function getDaoNameFromTableName($tableName)
150
-    {
151
-        return self::toSingular(self::toCamelCase($tableName)).'Dao';
152
-    }
153
-
154
-    /**
155
-     * Returns the name of the base bean class from the table name.
156
-     *
157
-     * @param $tableName
158
-     *
159
-     * @return string
160
-     */
161
-    public static function getBaseBeanNameFromTableName($tableName)
162
-    {
163
-        return self::toSingular(self::toCamelCase($tableName)).'BaseBean';
164
-    }
165
-
166
-    /**
167
-     * Returns the name of the base DAO class from the table name.
168
-     *
169
-     * @param $tableName
170
-     *
171
-     * @return string
172
-     */
173
-    public static function getBaseDaoNameFromTableName($tableName)
174
-    {
175
-        return self::toSingular(self::toCamelCase($tableName)).'BaseDao';
176
-    }
177
-
178
-    /**
179
-     * Writes the PHP bean file with all getters and setters from the table passed in parameter.
180
-     *
181
-     * @param BeanDescriptor  $beanDescriptor
182
-     * @param string          $className       The name of the class
183
-     * @param string          $baseClassName   The name of the base class which will be extended (name only, no directory)
184
-     * @param Table           $table           The table
185
-     * @param string          $beannamespace   The namespace of the bean
186
-     * @param ClassNameMapper $classNameMapper
187
-     *
188
-     * @throws TDBMException
189
-     */
190
-    public function generateBean(BeanDescriptor $beanDescriptor, $className, $baseClassName, Table $table, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc)
191
-    {
192
-        $str = $beanDescriptor->generatePhpCode($beannamespace);
193
-
194
-        $possibleBaseFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\Generated\\'.$baseClassName);
195
-        if (empty($possibleBaseFileNames)) {
196
-            throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$baseClassName.'" is not autoloadable.');
197
-        }
198
-        $possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0];
199
-
200
-        $this->ensureDirectoryExist($possibleBaseFileName);
201
-        file_put_contents($possibleBaseFileName, $str);
202
-        @chmod($possibleBaseFileName, 0664);
203
-
204
-        $possibleFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\'.$className);
205
-        if (empty($possibleFileNames)) {
206
-            // @codeCoverageIgnoreStart
207
-            throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$className.'" is not autoloadable.');
208
-            // @codeCoverageIgnoreEnd
209
-        }
210
-        $possibleFileName = $this->rootPath.$possibleFileNames[0];
211
-        if (!file_exists($possibleFileName)) {
212
-            $tableName = $table->getName();
213
-            $str = "<?php
20
+	/**
21
+	 * @var SchemaAnalyzer
22
+	 */
23
+	private $schemaAnalyzer;
24
+
25
+	/**
26
+	 * @var Schema
27
+	 */
28
+	private $schema;
29
+
30
+	/**
31
+	 * The root directory of the project.
32
+	 *
33
+	 * @var string
34
+	 */
35
+	private $rootPath;
36
+
37
+	/**
38
+	 * Name of composer file.
39
+	 *
40
+	 * @var string
41
+	 */
42
+	private $composerFile;
43
+
44
+	/**
45
+	 * @var TDBMSchemaAnalyzer
46
+	 */
47
+	private $tdbmSchemaAnalyzer;
48
+
49
+	/**
50
+	 * Constructor.
51
+	 *
52
+	 * @param SchemaAnalyzer     $schemaAnalyzer
53
+	 * @param Schema             $schema
54
+	 * @param TDBMSchemaAnalyzer $tdbmSchemaAnalyzer
55
+	 */
56
+	public function __construct(SchemaAnalyzer $schemaAnalyzer, Schema $schema, TDBMSchemaAnalyzer $tdbmSchemaAnalyzer)
57
+	{
58
+		$this->schemaAnalyzer = $schemaAnalyzer;
59
+		$this->schema = $schema;
60
+		$this->tdbmSchemaAnalyzer = $tdbmSchemaAnalyzer;
61
+		$this->rootPath = __DIR__.'/../../../../../../../../';
62
+		$this->composerFile = 'composer.json';
63
+	}
64
+
65
+	/**
66
+	 * Generates all the daos and beans.
67
+	 *
68
+	 * @param string $daoFactoryClassName The classe name of the DAO factory
69
+	 * @param string $daonamespace        The namespace for the DAOs, without trailing \
70
+	 * @param string $beannamespace       The Namespace for the beans, without trailing \
71
+	 * @param bool   $storeInUtc          If the generated daos should store the date in UTC timezone instead of user's timezone.
72
+	 *
73
+	 * @return \string[] the list of tables
74
+	 *
75
+	 * @throws TDBMException
76
+	 */
77
+	public function generateAllDaosAndBeans($daoFactoryClassName, $daonamespace, $beannamespace, $storeInUtc)
78
+	{
79
+		$classNameMapper = ClassNameMapper::createFromComposerFile($this->rootPath.$this->composerFile);
80
+		// TODO: check that no class name ends with "Base". Otherwise, there will be name clash.
81
+
82
+		$tableList = $this->schema->getTables();
83
+
84
+		// Remove all beans and daos from junction tables
85
+		$junctionTables = $this->schemaAnalyzer->detectJunctionTables();
86
+		$junctionTableNames = array_map(function (Table $table) {
87
+			return $table->getName();
88
+		}, $junctionTables);
89
+
90
+		$tableList = array_filter($tableList, function (Table $table) use ($junctionTableNames) {
91
+			return !in_array($table->getName(), $junctionTableNames);
92
+		});
93
+
94
+		foreach ($tableList as $table) {
95
+			$this->generateDaoAndBean($table, $daonamespace, $beannamespace, $classNameMapper, $storeInUtc);
96
+		}
97
+
98
+		$this->generateFactory($tableList, $daoFactoryClassName, $daonamespace, $classNameMapper);
99
+
100
+		// Ok, let's return the list of all tables.
101
+		// These will be used by the calling script to create Mouf instances.
102
+
103
+		return array_map(function (Table $table) { return $table->getName(); }, $tableList);
104
+	}
105
+
106
+	/**
107
+	 * Generates in one method call the daos and the beans for one table.
108
+	 *
109
+	 * @param Table           $table
110
+	 * @param string          $daonamespace
111
+	 * @param string          $beannamespace
112
+	 * @param ClassNameMapper $classNameMapper
113
+	 * @param bool            $storeInUtc
114
+	 *
115
+	 * @throws TDBMException
116
+	 */
117
+	public function generateDaoAndBean(Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc)
118
+	{
119
+		$tableName = $table->getName();
120
+		$daoName = $this->getDaoNameFromTableName($tableName);
121
+		$beanName = $this->getBeanNameFromTableName($tableName);
122
+		$baseBeanName = $this->getBaseBeanNameFromTableName($tableName);
123
+		$baseDaoName = $this->getBaseDaoNameFromTableName($tableName);
124
+
125
+		$beanDescriptor = new BeanDescriptor($table, $this->schemaAnalyzer, $this->schema, $this->tdbmSchemaAnalyzer);
126
+		$this->generateBean($beanDescriptor, $beanName, $baseBeanName, $table, $beannamespace, $classNameMapper, $storeInUtc);
127
+		$this->generateDao($beanDescriptor, $daoName, $baseDaoName, $beanName, $table, $daonamespace, $beannamespace, $classNameMapper);
128
+	}
129
+
130
+	/**
131
+	 * Returns the name of the bean class from the table name.
132
+	 *
133
+	 * @param $tableName
134
+	 *
135
+	 * @return string
136
+	 */
137
+	public static function getBeanNameFromTableName($tableName)
138
+	{
139
+		return self::toSingular(self::toCamelCase($tableName)).'Bean';
140
+	}
141
+
142
+	/**
143
+	 * Returns the name of the DAO class from the table name.
144
+	 *
145
+	 * @param $tableName
146
+	 *
147
+	 * @return string
148
+	 */
149
+	public static function getDaoNameFromTableName($tableName)
150
+	{
151
+		return self::toSingular(self::toCamelCase($tableName)).'Dao';
152
+	}
153
+
154
+	/**
155
+	 * Returns the name of the base bean class from the table name.
156
+	 *
157
+	 * @param $tableName
158
+	 *
159
+	 * @return string
160
+	 */
161
+	public static function getBaseBeanNameFromTableName($tableName)
162
+	{
163
+		return self::toSingular(self::toCamelCase($tableName)).'BaseBean';
164
+	}
165
+
166
+	/**
167
+	 * Returns the name of the base DAO class from the table name.
168
+	 *
169
+	 * @param $tableName
170
+	 *
171
+	 * @return string
172
+	 */
173
+	public static function getBaseDaoNameFromTableName($tableName)
174
+	{
175
+		return self::toSingular(self::toCamelCase($tableName)).'BaseDao';
176
+	}
177
+
178
+	/**
179
+	 * Writes the PHP bean file with all getters and setters from the table passed in parameter.
180
+	 *
181
+	 * @param BeanDescriptor  $beanDescriptor
182
+	 * @param string          $className       The name of the class
183
+	 * @param string          $baseClassName   The name of the base class which will be extended (name only, no directory)
184
+	 * @param Table           $table           The table
185
+	 * @param string          $beannamespace   The namespace of the bean
186
+	 * @param ClassNameMapper $classNameMapper
187
+	 *
188
+	 * @throws TDBMException
189
+	 */
190
+	public function generateBean(BeanDescriptor $beanDescriptor, $className, $baseClassName, Table $table, $beannamespace, ClassNameMapper $classNameMapper, $storeInUtc)
191
+	{
192
+		$str = $beanDescriptor->generatePhpCode($beannamespace);
193
+
194
+		$possibleBaseFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\Generated\\'.$baseClassName);
195
+		if (empty($possibleBaseFileNames)) {
196
+			throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$baseClassName.'" is not autoloadable.');
197
+		}
198
+		$possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0];
199
+
200
+		$this->ensureDirectoryExist($possibleBaseFileName);
201
+		file_put_contents($possibleBaseFileName, $str);
202
+		@chmod($possibleBaseFileName, 0664);
203
+
204
+		$possibleFileNames = $classNameMapper->getPossibleFileNames($beannamespace.'\\'.$className);
205
+		if (empty($possibleFileNames)) {
206
+			// @codeCoverageIgnoreStart
207
+			throw new TDBMException('Sorry, autoload namespace issue. The class "'.$beannamespace.'\\'.$className.'" is not autoloadable.');
208
+			// @codeCoverageIgnoreEnd
209
+		}
210
+		$possibleFileName = $this->rootPath.$possibleFileNames[0];
211
+		if (!file_exists($possibleFileName)) {
212
+			$tableName = $table->getName();
213
+			$str = "<?php
214 214
 /*
215 215
  * This file has been automatically generated by TDBM.
216 216
  * You can edit this file as it will not be overwritten.
@@ -227,76 +227,76 @@  discard block
 block discarded – undo
227 227
 {
228 228
 
229 229
 }";
230
-            $this->ensureDirectoryExist($possibleFileName);
231
-            file_put_contents($possibleFileName, $str);
232
-            @chmod($possibleFileName, 0664);
233
-        }
234
-    }
235
-
236
-    /**
237
-     * Tries to find a @defaultSort annotation in one of the columns.
238
-     *
239
-     * @param Table $table
240
-     *
241
-     * @return array First item: column name, Second item: column order (asc/desc)
242
-     */
243
-    private function getDefaultSortColumnFromAnnotation(Table $table)
244
-    {
245
-        $defaultSort = null;
246
-        $defaultSortDirection = null;
247
-        foreach ($table->getColumns() as $column) {
248
-            $comments = $column->getComment();
249
-            $matches = [];
250
-            if (preg_match('/@defaultSort(\((desc|asc)\))*/', $comments, $matches) != 0) {
251
-                $defaultSort = $column->getName();
252
-                if (count($matches) === 3) {
253
-                    $defaultSortDirection = $matches[2];
254
-                } else {
255
-                    $defaultSortDirection = 'ASC';
256
-                }
257
-            }
258
-        }
259
-
260
-        return [$defaultSort, $defaultSortDirection];
261
-    }
262
-
263
-    /**
264
-     * Writes the PHP bean DAO with simple functions to create/get/save objects.
265
-     *
266
-     * @param BeanDescriptor  $beanDescriptor
267
-     * @param string          $className       The name of the class
268
-     * @param string          $baseClassName
269
-     * @param string          $beanClassName
270
-     * @param Table           $table
271
-     * @param string          $daonamespace
272
-     * @param string          $beannamespace
273
-     * @param ClassNameMapper $classNameMapper
274
-     *
275
-     * @throws TDBMException
276
-     */
277
-    public function generateDao(BeanDescriptor $beanDescriptor, $className, $baseClassName, $beanClassName, Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper)
278
-    {
279
-        $tableName = $table->getName();
280
-        $primaryKeyColumns = $table->getPrimaryKeyColumns();
281
-
282
-        list($defaultSort, $defaultSortDirection) = $this->getDefaultSortColumnFromAnnotation($table);
283
-
284
-        // FIXME: lowercase tables with _ in the name should work!
285
-        $tableCamel = self::toSingular(self::toCamelCase($tableName));
286
-
287
-        $beanClassWithoutNameSpace = $beanClassName;
288
-        $beanClassName = $beannamespace.'\\'.$beanClassName;
289
-
290
-        list($usedBeans, $findByDaoCode) = $beanDescriptor->generateFindByDaoCode($beannamespace, $beanClassWithoutNameSpace);
291
-
292
-        $usedBeans[] = $beanClassName;
293
-        // Let's suppress duplicates in used beans (if any)
294
-        $usedBeans = array_flip(array_flip($usedBeans));
295
-        $useStatements = array_map(function ($usedBean) {
296
-            return "use $usedBean;\n";
297
-        }, $usedBeans);
298
-
299
-        $str = "<?php
230
+			$this->ensureDirectoryExist($possibleFileName);
231
+			file_put_contents($possibleFileName, $str);
232
+			@chmod($possibleFileName, 0664);
233
+		}
234
+	}
235
+
236
+	/**
237
+	 * Tries to find a @defaultSort annotation in one of the columns.
238
+	 *
239
+	 * @param Table $table
240
+	 *
241
+	 * @return array First item: column name, Second item: column order (asc/desc)
242
+	 */
243
+	private function getDefaultSortColumnFromAnnotation(Table $table)
244
+	{
245
+		$defaultSort = null;
246
+		$defaultSortDirection = null;
247
+		foreach ($table->getColumns() as $column) {
248
+			$comments = $column->getComment();
249
+			$matches = [];
250
+			if (preg_match('/@defaultSort(\((desc|asc)\))*/', $comments, $matches) != 0) {
251
+				$defaultSort = $column->getName();
252
+				if (count($matches) === 3) {
253
+					$defaultSortDirection = $matches[2];
254
+				} else {
255
+					$defaultSortDirection = 'ASC';
256
+				}
257
+			}
258
+		}
259
+
260
+		return [$defaultSort, $defaultSortDirection];
261
+	}
262
+
263
+	/**
264
+	 * Writes the PHP bean DAO with simple functions to create/get/save objects.
265
+	 *
266
+	 * @param BeanDescriptor  $beanDescriptor
267
+	 * @param string          $className       The name of the class
268
+	 * @param string          $baseClassName
269
+	 * @param string          $beanClassName
270
+	 * @param Table           $table
271
+	 * @param string          $daonamespace
272
+	 * @param string          $beannamespace
273
+	 * @param ClassNameMapper $classNameMapper
274
+	 *
275
+	 * @throws TDBMException
276
+	 */
277
+	public function generateDao(BeanDescriptor $beanDescriptor, $className, $baseClassName, $beanClassName, Table $table, $daonamespace, $beannamespace, ClassNameMapper $classNameMapper)
278
+	{
279
+		$tableName = $table->getName();
280
+		$primaryKeyColumns = $table->getPrimaryKeyColumns();
281
+
282
+		list($defaultSort, $defaultSortDirection) = $this->getDefaultSortColumnFromAnnotation($table);
283
+
284
+		// FIXME: lowercase tables with _ in the name should work!
285
+		$tableCamel = self::toSingular(self::toCamelCase($tableName));
286
+
287
+		$beanClassWithoutNameSpace = $beanClassName;
288
+		$beanClassName = $beannamespace.'\\'.$beanClassName;
289
+
290
+		list($usedBeans, $findByDaoCode) = $beanDescriptor->generateFindByDaoCode($beannamespace, $beanClassWithoutNameSpace);
291
+
292
+		$usedBeans[] = $beanClassName;
293
+		// Let's suppress duplicates in used beans (if any)
294
+		$usedBeans = array_flip(array_flip($usedBeans));
295
+		$useStatements = array_map(function ($usedBean) {
296
+			return "use $usedBean;\n";
297
+		}, $usedBeans);
298
+
299
+		$str = "<?php
300 300
 
301 301
 /*
302 302
  * This file has been automatically generated by TDBM.
@@ -373,9 +373,9 @@  discard block
 block discarded – undo
373 373
     }
374 374
     ";
375 375
 
376
-        if (count($primaryKeyColumns) === 1) {
377
-            $primaryKeyColumn = $primaryKeyColumns[0];
378
-            $str .= "
376
+		if (count($primaryKeyColumns) === 1) {
377
+			$primaryKeyColumn = $primaryKeyColumns[0];
378
+			$str .= "
379 379
     /**
380 380
      * Get $beanClassWithoutNameSpace specified by its ID (its primary key)
381 381
      * If the primary key does not exist, an exception is thrown.
@@ -390,8 +390,8 @@  discard block
 block discarded – undo
390 390
         return \$this->tdbmService->findObjectByPk('$tableName', ['$primaryKeyColumn' => \$id], [], \$lazyLoading);
391 391
     }
392 392
     ";
393
-        }
394
-        $str .= "
393
+		}
394
+		$str .= "
395 395
     /**
396 396
      * Deletes the $beanClassWithoutNameSpace passed in parameter.
397 397
      *
@@ -449,33 +449,33 @@  discard block
 block discarded – undo
449 449
     }
450 450
 ";
451 451
 
452
-        $str .= $findByDaoCode;
453
-        $str .= '}
452
+		$str .= $findByDaoCode;
453
+		$str .= '}
454 454
 ';
455 455
 
456
-        $possibleBaseFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\Generated\\'.$baseClassName);
457
-        if (empty($possibleBaseFileNames)) {
458
-            // @codeCoverageIgnoreStart
459
-            throw new TDBMException('Sorry, autoload namespace issue. The class "'.$baseClassName.'" is not autoloadable.');
460
-            // @codeCoverageIgnoreEnd
461
-        }
462
-        $possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0];
463
-
464
-        $this->ensureDirectoryExist($possibleBaseFileName);
465
-        file_put_contents($possibleBaseFileName, $str);
466
-        @chmod($possibleBaseFileName, 0664);
467
-
468
-        $possibleFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\'.$className);
469
-        if (empty($possibleFileNames)) {
470
-            // @codeCoverageIgnoreStart
471
-            throw new TDBMException('Sorry, autoload namespace issue. The class "'.$className.'" is not autoloadable.');
472
-            // @codeCoverageIgnoreEnd
473
-        }
474
-        $possibleFileName = $this->rootPath.$possibleFileNames[0];
475
-
476
-        // Now, let's generate the "editable" class
477
-        if (!file_exists($possibleFileName)) {
478
-            $str = "<?php
456
+		$possibleBaseFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\Generated\\'.$baseClassName);
457
+		if (empty($possibleBaseFileNames)) {
458
+			// @codeCoverageIgnoreStart
459
+			throw new TDBMException('Sorry, autoload namespace issue. The class "'.$baseClassName.'" is not autoloadable.');
460
+			// @codeCoverageIgnoreEnd
461
+		}
462
+		$possibleBaseFileName = $this->rootPath.$possibleBaseFileNames[0];
463
+
464
+		$this->ensureDirectoryExist($possibleBaseFileName);
465
+		file_put_contents($possibleBaseFileName, $str);
466
+		@chmod($possibleBaseFileName, 0664);
467
+
468
+		$possibleFileNames = $classNameMapper->getPossibleFileNames($daonamespace.'\\'.$className);
469
+		if (empty($possibleFileNames)) {
470
+			// @codeCoverageIgnoreStart
471
+			throw new TDBMException('Sorry, autoload namespace issue. The class "'.$className.'" is not autoloadable.');
472
+			// @codeCoverageIgnoreEnd
473
+		}
474
+		$possibleFileName = $this->rootPath.$possibleFileNames[0];
475
+
476
+		// Now, let's generate the "editable" class
477
+		if (!file_exists($possibleFileName)) {
478
+			$str = "<?php
479 479
 
480 480
 /*
481 481
  * This file has been automatically generated by TDBM.
@@ -494,22 +494,22 @@  discard block
 block discarded – undo
494 494
 
495 495
 }
496 496
 ";
497
-            $this->ensureDirectoryExist($possibleFileName);
498
-            file_put_contents($possibleFileName, $str);
499
-            @chmod($possibleFileName, 0664);
500
-        }
501
-    }
502
-
503
-    /**
504
-     * Generates the factory bean.
505
-     *
506
-     * @param Table[] $tableList
507
-     */
508
-    private function generateFactory(array $tableList, $daoFactoryClassName, $daoNamespace, ClassNameMapper $classNameMapper)
509
-    {
510
-        // For each table, let's write a property.
511
-
512
-        $str = "<?php
497
+			$this->ensureDirectoryExist($possibleFileName);
498
+			file_put_contents($possibleFileName, $str);
499
+			@chmod($possibleFileName, 0664);
500
+		}
501
+	}
502
+
503
+	/**
504
+	 * Generates the factory bean.
505
+	 *
506
+	 * @param Table[] $tableList
507
+	 */
508
+	private function generateFactory(array $tableList, $daoFactoryClassName, $daoNamespace, ClassNameMapper $classNameMapper)
509
+	{
510
+		// For each table, let's write a property.
511
+
512
+		$str = "<?php
513 513
 
514 514
 /*
515 515
  * This file has been automatically generated by TDBM.
@@ -518,13 +518,13 @@  discard block
 block discarded – undo
518 518
 
519 519
 namespace {$daoNamespace}\\Generated;
520 520
 ";
521
-        foreach ($tableList as $table) {
522
-            $tableName = $table->getName();
523
-            $daoClassName = $this->getDaoNameFromTableName($tableName);
524
-            $str .= "use {$daoNamespace}\\".$daoClassName.";\n";
525
-        }
521
+		foreach ($tableList as $table) {
522
+			$tableName = $table->getName();
523
+			$daoClassName = $this->getDaoNameFromTableName($tableName);
524
+			$str .= "use {$daoNamespace}\\".$daoClassName.";\n";
525
+		}
526 526
 
527
-        $str .= "
527
+		$str .= "
528 528
 /**
529 529
  * The $daoFactoryClassName provides an easy access to all DAOs generated by TDBM.
530 530
  *
@@ -533,12 +533,12 @@  discard block
 block discarded – undo
533 533
 {
534 534
 ";
535 535
 
536
-        foreach ($tableList as $table) {
537
-            $tableName = $table->getName();
538
-            $daoClassName = $this->getDaoNameFromTableName($tableName);
539
-            $daoInstanceName = self::toVariableName($daoClassName);
536
+		foreach ($tableList as $table) {
537
+			$tableName = $table->getName();
538
+			$daoClassName = $this->getDaoNameFromTableName($tableName);
539
+			$daoInstanceName = self::toVariableName($daoClassName);
540 540
 
541
-            $str .= '    /**
541
+			$str .= '    /**
542 542
      * @var '.$daoClassName.'
543 543
      */
544 544
     private $'.$daoInstanceName.';
@@ -563,158 +563,158 @@  discard block
 block discarded – undo
563 563
     }
564 564
 
565 565
 ';
566
-        }
566
+		}
567 567
 
568
-        $str .= '
568
+		$str .= '
569 569
 }
570 570
 ';
571 571
 
572
-        $possibleFileNames = $classNameMapper->getPossibleFileNames($daoNamespace.'\\Generated\\'.$daoFactoryClassName);
573
-        if (empty($possibleFileNames)) {
574
-            throw new TDBMException('Sorry, autoload namespace issue. The class "'.$daoNamespace.'\\'.$daoFactoryClassName.'" is not autoloadable.');
575
-        }
576
-        $possibleFileName = $this->rootPath.$possibleFileNames[0];
577
-
578
-        $this->ensureDirectoryExist($possibleFileName);
579
-        file_put_contents($possibleFileName, $str);
580
-        @chmod($possibleFileName, 0664);
581
-    }
582
-
583
-    /**
584
-     * Transforms a string to camelCase (except the first letter will be uppercase too).
585
-     * Underscores and spaces are removed and the first letter after the underscore is uppercased.
586
-     *
587
-     * @param $str string
588
-     *
589
-     * @return string
590
-     */
591
-    public static function toCamelCase($str)
592
-    {
593
-        $str = strtoupper(substr($str, 0, 1)).substr($str, 1);
594
-        while (true) {
595
-            if (strpos($str, '_') === false && strpos($str, ' ') === false) {
596
-                break;
597
-            }
598
-
599
-            $pos = strpos($str, '_');
600
-            if ($pos === false) {
601
-                $pos = strpos($str, ' ');
602
-            }
603
-            $before = substr($str, 0, $pos);
604
-            $after = substr($str, $pos + 1);
605
-            $str = $before.strtoupper(substr($after, 0, 1)).substr($after, 1);
606
-        }
607
-
608
-        return $str;
609
-    }
610
-
611
-    /**
612
-     * Tries to put string to the singular form (if it is plural).
613
-     * We assume the table names are in english.
614
-     *
615
-     * @param $str string
616
-     *
617
-     * @return string
618
-     */
619
-    public static function toSingular($str)
620
-    {
621
-        return Inflector::singularize($str);
622
-    }
623
-
624
-    /**
625
-     * Put the first letter of the string in lower case.
626
-     * Very useful to transform a class name into a variable name.
627
-     *
628
-     * @param $str string
629
-     *
630
-     * @return string
631
-     */
632
-    public static function toVariableName($str)
633
-    {
634
-        return strtolower(substr($str, 0, 1)).substr($str, 1);
635
-    }
636
-
637
-    /**
638
-     * Ensures the file passed in parameter can be written in its directory.
639
-     *
640
-     * @param string $fileName
641
-     *
642
-     * @throws TDBMException
643
-     */
644
-    private function ensureDirectoryExist($fileName)
645
-    {
646
-        $dirName = dirname($fileName);
647
-        if (!file_exists($dirName)) {
648
-            $old = umask(0);
649
-            $result = mkdir($dirName, 0775, true);
650
-            umask($old);
651
-            if ($result === false) {
652
-                throw new TDBMException("Unable to create directory: '".$dirName."'.");
653
-            }
654
-        }
655
-    }
656
-
657
-    /**
658
-     * Absolute path to composer json file.
659
-     *
660
-     * @param string $composerFile
661
-     */
662
-    public function setComposerFile($composerFile)
663
-    {
664
-        $this->rootPath = dirname($composerFile).'/';
665
-        $this->composerFile = basename($composerFile);
666
-    }
667
-
668
-    /**
669
-     * Transforms a DBAL type into a PHP type (for PHPDoc purpose).
670
-     *
671
-     * @param Type $type The DBAL type
672
-     *
673
-     * @return string The PHP type
674
-     */
675
-    public static function dbalTypeToPhpType(Type $type)
676
-    {
677
-        $map = [
678
-            Type::TARRAY => 'array',
679
-            Type::SIMPLE_ARRAY => 'array',
680
-            Type::JSON_ARRAY => 'array',
681
-            Type::BIGINT => 'string',
682
-            Type::BOOLEAN => 'bool',
683
-            Type::DATETIME => '\DateTimeInterface',
684
-            Type::DATETIMETZ => '\DateTimeInterface',
685
-            Type::DATE => '\DateTimeInterface',
686
-            Type::TIME => '\DateTimeInterface',
687
-            Type::DECIMAL => 'float',
688
-            Type::INTEGER => 'int',
689
-            Type::OBJECT => 'string',
690
-            Type::SMALLINT => 'int',
691
-            Type::STRING => 'string',
692
-            Type::TEXT => 'string',
693
-            Type::BINARY => 'string',
694
-            Type::BLOB => 'string',
695
-            Type::FLOAT => 'float',
696
-            Type::GUID => 'string',
697
-        ];
698
-
699
-        return isset($map[$type->getName()]) ? $map[$type->getName()] : $type->getName();
700
-    }
701
-
702
-    /**
703
-     * @param string $beanNamespace
704
-     *
705
-     * @return \string[] Returns a map mapping table name to beans name
706
-     */
707
-    public function buildTableToBeanMap($beanNamespace)
708
-    {
709
-        $tableToBeanMap = [];
710
-
711
-        $tables = $this->schema->getTables();
712
-
713
-        foreach ($tables as $table) {
714
-            $tableName = $table->getName();
715
-            $tableToBeanMap[$tableName] = $beanNamespace.'\\'.self::getBeanNameFromTableName($tableName);
716
-        }
717
-
718
-        return $tableToBeanMap;
719
-    }
572
+		$possibleFileNames = $classNameMapper->getPossibleFileNames($daoNamespace.'\\Generated\\'.$daoFactoryClassName);
573
+		if (empty($possibleFileNames)) {
574
+			throw new TDBMException('Sorry, autoload namespace issue. The class "'.$daoNamespace.'\\'.$daoFactoryClassName.'" is not autoloadable.');
575
+		}
576
+		$possibleFileName = $this->rootPath.$possibleFileNames[0];
577
+
578
+		$this->ensureDirectoryExist($possibleFileName);
579
+		file_put_contents($possibleFileName, $str);
580
+		@chmod($possibleFileName, 0664);
581
+	}
582
+
583
+	/**
584
+	 * Transforms a string to camelCase (except the first letter will be uppercase too).
585
+	 * Underscores and spaces are removed and the first letter after the underscore is uppercased.
586
+	 *
587
+	 * @param $str string
588
+	 *
589
+	 * @return string
590
+	 */
591
+	public static function toCamelCase($str)
592
+	{
593
+		$str = strtoupper(substr($str, 0, 1)).substr($str, 1);
594
+		while (true) {
595
+			if (strpos($str, '_') === false && strpos($str, ' ') === false) {
596
+				break;
597
+			}
598
+
599
+			$pos = strpos($str, '_');
600
+			if ($pos === false) {
601
+				$pos = strpos($str, ' ');
602
+			}
603
+			$before = substr($str, 0, $pos);
604
+			$after = substr($str, $pos + 1);
605
+			$str = $before.strtoupper(substr($after, 0, 1)).substr($after, 1);
606
+		}
607
+
608
+		return $str;
609
+	}
610
+
611
+	/**
612
+	 * Tries to put string to the singular form (if it is plural).
613
+	 * We assume the table names are in english.
614
+	 *
615
+	 * @param $str string
616
+	 *
617
+	 * @return string
618
+	 */
619
+	public static function toSingular($str)
620
+	{
621
+		return Inflector::singularize($str);
622
+	}
623
+
624
+	/**
625
+	 * Put the first letter of the string in lower case.
626
+	 * Very useful to transform a class name into a variable name.
627
+	 *
628
+	 * @param $str string
629
+	 *
630
+	 * @return string
631
+	 */
632
+	public static function toVariableName($str)
633
+	{
634
+		return strtolower(substr($str, 0, 1)).substr($str, 1);
635
+	}
636
+
637
+	/**
638
+	 * Ensures the file passed in parameter can be written in its directory.
639
+	 *
640
+	 * @param string $fileName
641
+	 *
642
+	 * @throws TDBMException
643
+	 */
644
+	private function ensureDirectoryExist($fileName)
645
+	{
646
+		$dirName = dirname($fileName);
647
+		if (!file_exists($dirName)) {
648
+			$old = umask(0);
649
+			$result = mkdir($dirName, 0775, true);
650
+			umask($old);
651
+			if ($result === false) {
652
+				throw new TDBMException("Unable to create directory: '".$dirName."'.");
653
+			}
654
+		}
655
+	}
656
+
657
+	/**
658
+	 * Absolute path to composer json file.
659
+	 *
660
+	 * @param string $composerFile
661
+	 */
662
+	public function setComposerFile($composerFile)
663
+	{
664
+		$this->rootPath = dirname($composerFile).'/';
665
+		$this->composerFile = basename($composerFile);
666
+	}
667
+
668
+	/**
669
+	 * Transforms a DBAL type into a PHP type (for PHPDoc purpose).
670
+	 *
671
+	 * @param Type $type The DBAL type
672
+	 *
673
+	 * @return string The PHP type
674
+	 */
675
+	public static function dbalTypeToPhpType(Type $type)
676
+	{
677
+		$map = [
678
+			Type::TARRAY => 'array',
679
+			Type::SIMPLE_ARRAY => 'array',
680
+			Type::JSON_ARRAY => 'array',
681
+			Type::BIGINT => 'string',
682
+			Type::BOOLEAN => 'bool',
683
+			Type::DATETIME => '\DateTimeInterface',
684
+			Type::DATETIMETZ => '\DateTimeInterface',
685
+			Type::DATE => '\DateTimeInterface',
686
+			Type::TIME => '\DateTimeInterface',
687
+			Type::DECIMAL => 'float',
688
+			Type::INTEGER => 'int',
689
+			Type::OBJECT => 'string',
690
+			Type::SMALLINT => 'int',
691
+			Type::STRING => 'string',
692
+			Type::TEXT => 'string',
693
+			Type::BINARY => 'string',
694
+			Type::BLOB => 'string',
695
+			Type::FLOAT => 'float',
696
+			Type::GUID => 'string',
697
+		];
698
+
699
+		return isset($map[$type->getName()]) ? $map[$type->getName()] : $type->getName();
700
+	}
701
+
702
+	/**
703
+	 * @param string $beanNamespace
704
+	 *
705
+	 * @return \string[] Returns a map mapping table name to beans name
706
+	 */
707
+	public function buildTableToBeanMap($beanNamespace)
708
+	{
709
+		$tableToBeanMap = [];
710
+
711
+		$tables = $this->schema->getTables();
712
+
713
+		foreach ($tables as $table) {
714
+			$tableName = $table->getName();
715
+			$tableToBeanMap[$tableName] = $beanNamespace.'\\'.self::getBeanNameFromTableName($tableName);
716
+		}
717
+
718
+		return $tableToBeanMap;
719
+	}
720 720
 }
Please login to merge, or discard this patch.