Mouf\Database\TDBM\StandardObjectStorage

Complexity

Total Complexity

8

Size/Duplication

Total Lines	77
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Importance

Changes	2
Bugs	0	Features	0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	set()	0	4	1
A	has()	0	4	1
A	get()	0	8	2
A	remove()	0	4	1
A	apply()	0	8	3

<?php

/*
 Copyright (C) 2006-2014 David Négrier - THE CODING MACHINE

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
*/

namespace Mouf\Database\TDBM;

/**
 * The StandardObjectStorage class is used to reference all beans that have been fetched from the database.
 * If a bean is requested twice from TDBM, the StandardObjectStorage is used to "cache" the bean.
 * The StandardObjectStorage acts like a big array. It is used if the "weakref" extension is not available.
 * Otherwise, the WeakrefObjectStorage is used instead.
 *
 * @author David Negrier
 */
class StandardObjectStorage
{
    /**
     * An array of fetched object, accessible via table name and primary key.
     * If the primary key is split on several columns, access is done by an array of columns, serialized.
     *
     * @var array<string, array<string, TDBMObject>>
     */
    private $objects = array();

    /**
     * Sets an object in the storage.
     *
     * @param string     $tableName
     * @param string     $id
     * @param TDBMObject $dbRow
     */
    public function set($tableName, $id, DbRow $dbRow)
    {
        $this->objects[$tableName][$id] = $dbRow;
    }

    /**
     * Checks if an object is in the storage.
     *
     * @param string $tableName
     * @param string $id
     *
     * @return bool
     */
    public function has($tableName, $id)
    {
        return isset($this->objects[$tableName][$id]);
    }

    /**
     * Returns an object from the storage (or null if no object is set).
     *
     * @param string $tableName
     * @param string $id
     *
     * @return DbRow
     */
    public function get($tableName, $id)
    {
        if (isset($this->objects[$tableName][$id])) {
            return $this->objects[$tableName][$id];
        } else {
            return;
        }
    }

    /**
     * Removes an object from the storage.
     *
     * @param string $tableName
     * @param string $id
     */
    public function remove($tableName, $id)
    {
        unset($this->objects[$tableName][$id]);
    }

    /**
     * Applies the callback to all objects.
     *
     * @param callable $callback
     */
    public function apply(callable $callback)
    {
        foreach ($this->objects as $tableName => $table) {
            foreach ($table as $id => $obj) {
                $callback($obj, $tableName, $id);
            }
        }
    }
}