Completed
Pull Request — master (#25)
by David
08:09
created

DbRow::get()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 6
Code Lines 3

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 1
eloc 3
nc 1
nop 1
dl 0
loc 6
rs 9.4285
c 0
b 0
f 0
1
<?php
2
3
namespace TheCodingMachine\TDBM;
4
5
/*
6
 Copyright (C) 2006-2017 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
            $row = $result->fetch(\PDO::FETCH_ASSOC);
173
174
            $this->dbRow = [];
175
            $types = $this->tdbmService->_getColumnTypesForTable($this->dbTableName);
176
177
            foreach ($row as $key => $value) {
178
                $this->dbRow[$key] = $types[$key]->convertToPHPValue($value, $connection->getDatabasePlatform());
179
            }
180
181
            $result->closeCursor();
182
183
            $this->status = TDBMObjectStateEnum::STATE_LOADED;
184
        }
185
    }
186
187
    public function get($var)
188
    {
189
        $this->_dbLoadIfNotLoaded();
190
191
        return $this->dbRow[$var] ?? null;
192
    }
193
194
    /**
195
     * Returns true if a column is set, false otherwise.
196
     *
197
     * @param string $var
198
     *
199
     * @return bool
200
     */
201
    /*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...
202
        $this->_dbLoadIfNotLoaded();
203
204
        return isset($this->dbRow[$var]);
205
    }*/
206
207 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...
208
    {
209
        $this->_dbLoadIfNotLoaded();
210
211
        /*
212
        // Ok, let's start by checking the column type
213
        $type = $this->db_connection->getColumnType($this->dbTableName, $var);
214
215
        // Throws an exception if the type is not ok.
216
        if (!$this->db_connection->checkType($value, $type)) {
217
            throw new TDBMException("Error! Invalid value passed for attribute '$var' of table '$this->dbTableName'. Passed '$value', but expecting '$type'");
218
        }
219
        */
220
221
        /*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...
222
            throw new TDBMException("Error! Changing primary key value is forbidden.");*/
223
        $this->dbRow[$var] = $value;
224
        if ($this->tdbmService !== null && $this->status === TDBMObjectStateEnum::STATE_LOADED) {
225
            $this->status = TDBMObjectStateEnum::STATE_DIRTY;
226
            $this->tdbmService->_addToToSaveObjectList($this);
227
        }
228
    }
229
230
    /**
231
     * @param string             $foreignKeyName
232
     * @param AbstractTDBMObject $bean
233
     */
234 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...
235
    {
236
        $this->references[$foreignKeyName] = $bean;
237
238
        if ($this->tdbmService !== null && $this->status === TDBMObjectStateEnum::STATE_LOADED) {
239
            $this->status = TDBMObjectStateEnum::STATE_DIRTY;
240
            $this->tdbmService->_addToToSaveObjectList($this);
241
        }
242
    }
243
244
    /**
245
     * @param string $foreignKeyName A unique name for this reference
246
     *
247
     * @return AbstractTDBMObject|null
248
     */
249
    public function getRef($foreignKeyName)
250
    {
251
        if (array_key_exists($foreignKeyName, $this->references)) {
252
            return $this->references[$foreignKeyName];
253
        } elseif ($this->status === TDBMObjectStateEnum::STATE_NEW || $this->tdbmService === null) {
254
            // If the object is new and has no property, then it has to be empty.
255
            return;
256
        } else {
257
            $this->_dbLoadIfNotLoaded();
258
259
            // Let's match the name of the columns to the primary key values
260
            $fk = $this->tdbmService->_getForeignKeyByName($this->dbTableName, $foreignKeyName);
261
262
            $values = [];
263
            foreach ($fk->getLocalColumns() as $column) {
264
                if (!isset($this->dbRow[$column])) {
265
                    return;
266
                }
267
                $values[] = $this->dbRow[$column];
268
            }
269
270
            $filter = array_combine($this->tdbmService->getPrimaryKeyColumns($fk->getForeignTableName()), $values);
271
272
            return $this->tdbmService->findObjectByPk($fk->getForeignTableName(), $filter, [], true);
273
        }
274
    }
275
276
    /**
277
     * Returns the name of the table this object comes from.
278
     *
279
     * @return string
280
     */
281
    public function _getDbTableName()
282
    {
283
        return $this->dbTableName;
284
    }
285
286
    /**
287
     * Method used internally by TDBM. You should not use it directly.
288
     * This method returns the status of the TDBMObject.
289
     * This is one of TDBMObjectStateEnum::STATE_NEW, TDBMObjectStateEnum::STATE_NOT_LOADED, TDBMObjectStateEnum::STATE_LOADED, TDBMObjectStateEnum::STATE_DELETED.
290
     * $status = TDBMObjectStateEnum::STATE_NEW when a new object is created with DBMObject:getNewObject.
291
     * $status = TDBMObjectStateEnum::STATE_NOT_LOADED when the object has been retrieved with getObject but when no data has been accessed in it yet.
292
     * $status = TDBMObjectStateEnum::STATE_LOADED when the object is cached in memory.
293
     *
294
     * @return string
295
     */
296
    public function _getStatus()
297
    {
298
        return $this->status;
299
    }
300
301
    /**
302
     * Override the native php clone function for TDBMObjects.
303
     */
304
    public function __clone()
305
    {
306
        // Let's load the row (before we lose the ID!)
307
        $this->_dbLoadIfNotLoaded();
308
309
        //Let's set the status to detached
310
        $this->status = TDBMObjectStateEnum::STATE_DETACHED;
311
312
        $this->primaryKeys = [];
313
314
        //Now unset the PK from the row
315
        if ($this->tdbmService) {
316
            $pk_array = $this->tdbmService->getPrimaryKeyColumns($this->dbTableName);
317
            foreach ($pk_array as $pk) {
0 ignored issues
show
Bug introduced by
The expression $pk_array of type string|array is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
318
                $this->dbRow[$pk] = null;
319
            }
320
        }
321
    }
322
323
    /**
324
     * Returns raw database row.
325
     *
326
     * @return array
327
     *
328
     * @throws TDBMMissingReferenceException
329
     */
330
    public function _getDbRow()
331
    {
332
        // Let's merge $dbRow and $references
333
        $dbRow = $this->dbRow;
334
335
        foreach ($this->references as $foreignKeyName => $reference) {
336
            // Let's match the name of the columns to the primary key values
337
            $fk = $this->tdbmService->_getForeignKeyByName($this->dbTableName, $foreignKeyName);
338
            $localColumns = $fk->getLocalColumns();
339
340
            if ($reference !== null) {
341
                $refDbRows = $reference->_getDbRows();
342
                $firstRefDbRow = reset($refDbRows);
343
                if ($firstRefDbRow->_getStatus() == TDBMObjectStateEnum::STATE_DELETED) {
344
                    throw TDBMMissingReferenceException::referenceDeleted($this->dbTableName, $reference);
345
                }
346
                $pkValues = array_values($firstRefDbRow->_getPrimaryKeys());
347 View Code Duplication
                for ($i = 0, $count = count($localColumns); $i < $count; ++$i) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across 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...
348
                    $dbRow[$localColumns[$i]] = $pkValues[$i];
349
                }
350
            } else {
351 View Code Duplication
                for ($i = 0, $count = count($localColumns); $i < $count; ++$i) {
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated across 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...
352
                    $dbRow[$localColumns[$i]] = null;
353
                }
354
            }
355
        }
356
357
        return $dbRow;
358
    }
359
360
    /**
361
     * Returns references array.
362
     *
363
     * @return AbstractTDBMObject[]
364
     */
365
    public function _getReferences()
366
    {
367
        return $this->references;
368
    }
369
370
    /**
371
     * Returns the values of the primary key.
372
     * This is set when the object is in "loaded" state.
373
     *
374
     * @return array
375
     */
376
    public function _getPrimaryKeys()
377
    {
378
        return $this->primaryKeys;
379
    }
380
381
    /**
382
     * Sets the values of the primary key.
383
     * This is set when the object is in "loaded" state.
384
     *
385
     * @param array $primaryKeys
386
     */
387
    public function _setPrimaryKeys(array $primaryKeys)
388
    {
389
        $this->primaryKeys = $primaryKeys;
390
        foreach ($this->primaryKeys as $column => $value) {
391
            $this->dbRow[$column] = $value;
392
        }
393
    }
394
395
    /**
396
     * Returns the TDBMObject this bean is associated to.
397
     *
398
     * @return AbstractTDBMObject
399
     */
400
    public function getTDBMObject()
401
    {
402
        return $this->object;
403
    }
404
405
    /**
406
     * Sets the TDBMObject this bean is associated to.
407
     * Only used when cloning.
408
     *
409
     * @param AbstractTDBMObject $object
410
     */
411
    public function setTDBMObject(AbstractTDBMObject $object)
412
    {
413
        $this->object = $object;
414
    }
415
}
416