Completed
Push — 4.0 ( e1def4...8f8e98 )
by David
15:31
created

DbRow::setTDBMObject()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 4
Code Lines 2

Duplication

Lines 0
Ratio 0 %

Importance

Changes 1
Bugs 0 Features 0
Metric Value
c 1
b 0
f 0
dl 0
loc 4
rs 10
cc 1
eloc 2
nc 1
nop 1
1
<?php
2
3
namespace Mouf\Database\TDBM;
4
5
/*
6
 Copyright (C) 2006-2016 David Négrier - THE CODING MACHINE
7
8
 This program is free software; you can redistribute it and/or modify
9
 it under the terms of the GNU General Public License as published by
10
 the Free Software Foundation; either version 2 of the License, or
11
 (at your option) any later version.
12
13
 This program is distributed in the hope that it will be useful,
14
 but WITHOUT ANY WARRANTY; without even the implied warranty of
15
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16
 GNU General Public License for more details.
17
18
 You should have received a copy of the GNU General Public License
19
 along with this program; if not, write to the Free Software
20
 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
21
 */
22
23
/**
24
 * Instances of this class represent a row in a database.
25
 *
26
 * @author David Negrier
27
 */
28
class DbRow
29
{
30
    /**
31
     * The service this object is bound to.
32
     *
33
     * @var TDBMService
34
     */
35
    protected $tdbmService;
36
37
    /**
38
     * The object containing this db row.
39
     *
40
     * @var AbstractTDBMObject
41
     */
42
    private $object;
43
44
    /**
45
     * The name of the table the object if issued from.
46
     *
47
     * @var string
48
     */
49
    private $dbTableName;
50
51
    /**
52
     * The array of columns returned from database.
53
     *
54
     * @var array
55
     */
56
    private $dbRow = array();
57
58
    /**
59
     * @var AbstractTDBMObject[]
60
     */
61
    private $references = array();
62
63
    /**
64
     * One of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED.
65
     * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject.
66
     * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet.
67
     * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory.
68
     *
69
     * @var string
70
     */
71
    private $status;
72
73
    /**
74
     * The values of the primary key.
75
     * This is set when the object is in "loaded" state.
76
     *
77
     * @var array An array of column => value
78
     */
79
    private $primaryKeys;
80
81
    /**
82
     * You should never call the constructor directly. Instead, you should use the
83
     * TDBMService class that will create TDBMObjects for you.
84
     *
85
     * Used with id!=false when we want to retrieve an existing object
86
     * and id==false if we want a new object
87
     *
88
     * @param AbstractTDBMObject $object      The object containing this db row.
89
     * @param string             $table_name
90
     * @param array              $primaryKeys
91
     * @param TDBMService        $tdbmService
92
     *
93
     * @throws TDBMException
94
     * @throws TDBMInvalidOperationException
95
     */
96
    public function __construct(AbstractTDBMObject $object, $table_name, array $primaryKeys = array(), TDBMService $tdbmService = null, array $dbRow = array())
97
    {
98
        $this->object = $object;
99
        $this->dbTableName = $table_name;
100
101
        $this->status = TDBMObjectStateEnum::STATE_DETACHED;
102
103
        if ($tdbmService === null) {
104
            if (!empty($primaryKeys)) {
105
                throw new TDBMException('You cannot pass an id to the DbRow constructor without passing also a TDBMService.');
106
            }
107
        } else {
108
            $this->tdbmService = $tdbmService;
109
110
            if (!empty($primaryKeys)) {
111
                $this->_setPrimaryKeys($primaryKeys);
112
                if (!empty($dbRow)) {
113
                    $this->dbRow = $dbRow;
114
                    $this->status = TDBMObjectStateEnum::STATE_LOADED;
115
                } else {
116
                    $this->status = TDBMObjectStateEnum::STATE_NOT_LOADED;
117
                }
118
                $tdbmService->_addToCache($this);
119
            } else {
120
                $this->status = TDBMObjectStateEnum::STATE_NEW;
121
                $this->tdbmService->_addToToSaveObjectList($this);
122
            }
123
        }
124
    }
125
126
    public function _attach(TDBMService $tdbmService)
127
    {
128
        if ($this->status !== TDBMObjectStateEnum::STATE_DETACHED) {
129
            throw new TDBMInvalidOperationException('Cannot attach an object that is already attached to TDBM.');
130
        }
131
        $this->tdbmService = $tdbmService;
132
        $this->status = TDBMObjectStateEnum::STATE_NEW;
133
        $this->tdbmService->_addToToSaveObjectList($this);
134
    }
135
136
    /**
137
     * Sets the state of the TDBM Object
138
     * One of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED.
139
     * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject.
140
     * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet.
141
     * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory.
142
     *
143
     * @param string $state
144
     */
145
    public function _setStatus($state)
146
    {
147
        $this->status = $state;
148
    }
149
150
    /**
151
     * This is an internal method. You should not call this method yourself. The TDBM library will do it for you.
152
     * If the object is in state 'not loaded', this method performs a query in database to load the object.
153
     *
154
     * A TDBMException is thrown is no object can be retrieved (for instance, if the primary key specified
155
     * cannot be found).
156
     */
157
    public function _dbLoadIfNotLoaded()
158
    {
159
        if ($this->status == TDBMObjectStateEnum::STATE_NOT_LOADED) {
160
            $connection = $this->tdbmService->getConnection();
161
162
            /// buildFilterFromFilterBag($filter_bag)
0 ignored issues
show
Unused Code Comprehensibility introduced by
50% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
163
            list($sql_where, $parameters) = $this->tdbmService->buildFilterFromFilterBag($this->primaryKeys);
164
165
            $sql = 'SELECT * FROM '.$connection->quoteIdentifier($this->dbTableName).' WHERE '.$sql_where;
0 ignored issues
show
Security introduced by
'SELECT * FROM ' . $conn... ' WHERE ' . $sql_where is used as a query on line 166. If $sql_where can contain user-input, it is usually preferable to use a parameter placeholder like :paramName and pass the dynamic input as second argument array('param' => $sql_where).

Instead of embedding dynamic parameters in SQL, Doctrine also allows you to pass them separately and insert a placeholder instead:

function findUser(Doctrine\DBAL\Connection $con, $email) {
    // Unsafe
    $con->executeQuery("SELECT * FROM users WHERE email = '".$email."'");

    // Safe
    $con->executeQuery(
        "SELECT * FROM users WHERE email = :email",
        array('email' => $email)
    );
}
Loading history...
166
            $result = $connection->executeQuery($sql, $parameters);
167
168
            if ($result->rowCount() === 0) {
169
                throw new TDBMException("Could not retrieve object from table \"$this->dbTableName\" using filter \"\".");
170
            }
171
172
            $this->dbRow = $result->fetch(\PDO::FETCH_ASSOC);
173
174
            $result->closeCursor();
175
176
            $this->status = TDBMObjectStateEnum::STATE_LOADED;
177
        }
178
    }
179
180
    public function get($var)
181
    {
182
        $this->_dbLoadIfNotLoaded();
183
184
        // Let's first check if the key exist.
185
        if (!isset($this->dbRow[$var])) {
186
            /*
187
            // Unable to find column.... this is an error if the object has been retrieved from database.
188
            // If it's a new object, well, that may not be an error after all!
189
            // Let's check if the column does exist in the table
190
            $column_exist = $this->db_connection->checkColumnExist($this->dbTableName, $var);
191
            // If the column DOES exist, then the object is new, and therefore, we should
192
            // return null.
193
            if ($column_exist === true) {
194
                return null;
195
            }
196
197
            // Let's try to be accurate in error reporting. The checkColumnExist returns an array of closest matches.
198
            $result_array = $column_exist;
199
200
            if (count($result_array)==1)
201
            $str = "Could not find column \"$var\" in table \"$this->dbTableName\". Maybe you meant this column: '".$result_array[0]."'";
202
            else
203
            $str = "Could not find column \"$var\" in table \"$this->dbTableName\". Maybe you meant one of those columns: '".implode("', '",$result_array)."'";
204
205
            throw new TDBMException($str);*/
206
            return;
207
        }
208
209
        return $this->dbRow[$var];
210
    }
211
212
    /**
213
     * Returns true if a column is set, false otherwise.
214
     *
215
     * @param string $var
216
     *
217
     * @return bool
218
     */
219
    /*public function has($var) {
0 ignored issues
show
Unused Code Comprehensibility introduced by
67% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
220
        $this->_dbLoadIfNotLoaded();
221
222
        return isset($this->dbRow[$var]);
223
    }*/
224
225 View Code Duplication
    public function set($var, $value)
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
226
    {
227
        $this->_dbLoadIfNotLoaded();
228
229
        /*
230
        // Ok, let's start by checking the column type
231
        $type = $this->db_connection->getColumnType($this->dbTableName, $var);
232
233
        // Throws an exception if the type is not ok.
234
        if (!$this->db_connection->checkType($value, $type)) {
235
            throw new TDBMException("Error! Invalid value passed for attribute '$var' of table '$this->dbTableName'. Passed '$value', but expecting '$type'");
236
        }
237
        */
238
239
        /*if ($var == $this->getPrimaryKey() && isset($this->dbRow[$var]))
0 ignored issues
show
Unused Code Comprehensibility introduced by
66% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
240
            throw new TDBMException("Error! Changing primary key value is forbidden.");*/
241
        $this->dbRow[$var] = $value;
242
        if ($this->tdbmService !== null && $this->status === TDBMObjectStateEnum::STATE_LOADED) {
243
            $this->status = TDBMObjectStateEnum::STATE_DIRTY;
244
            $this->tdbmService->_addToToSaveObjectList($this);
245
        }
246
    }
247
248
    /**
249
     * @param string             $foreignKeyName
250
     * @param AbstractTDBMObject $bean
251
     */
252 View Code Duplication
    public function setRef($foreignKeyName, AbstractTDBMObject $bean = null)
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
253
    {
254
        $this->references[$foreignKeyName] = $bean;
255
256
        if ($this->tdbmService !== null && $this->status === TDBMObjectStateEnum::STATE_LOADED) {
257
            $this->status = TDBMObjectStateEnum::STATE_DIRTY;
258
            $this->tdbmService->_addToToSaveObjectList($this);
259
        }
260
    }
261
262
    /**
263
     * @param string $foreignKeyName A unique name for this reference
264
     *
265
     * @return AbstractTDBMObject|null
266
     */
267
    public function getRef($foreignKeyName)
268
    {
269
        if (isset($this->references[$foreignKeyName])) {
270
            return $this->references[$foreignKeyName];
271
        } elseif ($this->status === TDBMObjectStateEnum::STATE_NEW) {
272
            // If the object is new and has no property, then it has to be empty.
273
            return;
274
        } else {
275
            $this->_dbLoadIfNotLoaded();
276
277
            // Let's match the name of the columns to the primary key values
278
            $fk = $this->tdbmService->_getForeignKeyByName($this->dbTableName, $foreignKeyName);
279
280
            $values = [];
281
            foreach ($fk->getLocalColumns() as $column) {
282
                $values[] = $this->dbRow[$column];
283
            }
284
285
            $filter = array_combine($this->tdbmService->getPrimaryKeyColumns($fk->getForeignTableName()), $values);
286
287
            return $this->tdbmService->findObjectByPk($fk->getForeignTableName(), $filter, [], true);
288
        }
289
    }
290
291
    /**
292
     * Returns the name of the table this object comes from.
293
     *
294
     * @return string
295
     */
296
    public function _getDbTableName()
297
    {
298
        return $this->dbTableName;
299
    }
300
301
    /**
302
     * Method used internally by TDBM. You should not use it directly.
303
     * This method returns the status of the TDBMObject.
304
     * This is one of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED.
305
     * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject.
306
     * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet.
307
     * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory.
308
     *
309
     * @return string
310
     */
311
    public function _getStatus()
312
    {
313
        return $this->status;
314
    }
315
316
    /**
317
     * Override the native php clone function for TDBMObjects.
318
     */
319
    public function __clone()
320
    {
321
        // Let's load the row (before we lose the ID!)
322
        $this->_dbLoadIfNotLoaded();
323
324
        //Let's set the status to detached
325
        $this->status = TDBMObjectStateEnum::STATE_DETACHED;
326
327
        $this->primaryKeys = [];
328
329
        //Now unset the PK from the row
330
        if ($this->tdbmService) {
331
            $pk_array = $this->tdbmService->getPrimaryKeyColumns($this->dbTableName);
332
            foreach ($pk_array as $pk) {
333
                $this->dbRow[$pk] = null;
334
            }
335
        }
336
    }
337
338
    /**
339
     * Returns raw database row.
340
     *
341
     * @return array
342
     */
343
    public function _getDbRow()
344
    {
345
        // Let's merge $dbRow and $references
346
        $dbRow = $this->dbRow;
347
348
        foreach ($this->references as $foreignKeyName => $reference) {
349
            // Let's match the name of the columns to the primary key values
350
            $fk = $this->tdbmService->_getForeignKeyByName($this->dbTableName, $foreignKeyName);
351
            $refDbRows = $reference->_getDbRows();
352
            $firstRefDbRow = reset($refDbRows);
353
            $pkValues = array_values($firstRefDbRow->_getPrimaryKeys());
354
            $localColumns = $fk->getLocalColumns();
355
356
            for ($i = 0, $count = count($localColumns); $i < $count; ++$i) {
357
                $dbRow[$localColumns[$i]] = $pkValues[$i];
358
            }
359
        }
360
361
        return $dbRow;
362
    }
363
364
    /**
365
     * Returns references array.
366
     *
367
     * @return AbstractTDBMObject[]
368
     */
369
    public function _getReferences()
370
    {
371
        return $this->references;
372
    }
373
374
    /**
375
     * Returns the values of the primary key.
376
     * This is set when the object is in "loaded" state.
377
     *
378
     * @return array
379
     */
380
    public function _getPrimaryKeys()
381
    {
382
        return $this->primaryKeys;
383
    }
384
385
    /**
386
     * Sets the values of the primary key.
387
     * This is set when the object is in "loaded" state.
388
     *
389
     * @param array $primaryKeys
390
     */
391
    public function _setPrimaryKeys(array $primaryKeys)
392
    {
393
        $this->primaryKeys = $primaryKeys;
394
        foreach ($this->primaryKeys as $column => $value) {
395
            $this->dbRow[$column] = $value;
396
        }
397
    }
398
399
    /**
400
     * Returns the TDBMObject this bean is associated to.
401
     *
402
     * @return AbstractTDBMObject
403
     */
404
    public function getTDBMObject()
405
    {
406
        return $this->object;
407
    }
408
409
    /**
410
     * Sets the TDBMObject this bean is associated to.
411
     * Only used when cloning.
412
     *
413
     * @param AbstractTDBMObject $object
414
     */
415
    public function setTDBMObject(AbstractTDBMObject $object)
416
    {
417
        $this->object = $object;
418
    }
419
}
420