<?php
+/**
+ * @copyright Copyright (C) 2010-2021, the Friendica project
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
namespace Friendica;
use Psr\Log\LoggerInterface;
/**
- * Class BaseModel
- *
* The Model classes inheriting from this abstract class are meant to represent a single database record.
* The associated table name has to be provided in the child class, and the table is expected to have a unique `id` field.
*
* @property int id
*/
-abstract class BaseModel
+abstract class BaseModel extends BaseDataTransferObject
{
- protected static $table_name;
-
/** @var Database */
protected $dba;
/** @var LoggerInterface */
*/
private $data = [];
- public function __construct(Database $dba, LoggerInterface $logger, $data = [])
+ /**
+ * Used to limit/avoid updates if no data was changed.
+ *
+ * @var array
+ */
+ private $originalData = [];
+
+ /**
+ * @param Database $dba
+ * @param LoggerInterface $logger
+ * @param array $data Table row attributes
+ */
+ public function __construct(Database $dba, LoggerInterface $logger, array $data = [])
{
$this->dba = $dba;
$this->logger = $logger;
$this->data = $data;
+ $this->originalData = $data;
+ }
+
+ public function getOriginalData(): array
+ {
+ return $this->originalData;
+ }
+
+ public function resetOriginalData()
+ {
+ $this->originalData = $this->data;
+ }
+
+ /**
+ * Performance-improved model creation in a loop
+ *
+ * @param BaseModel $prototype
+ * @param array $data
+ * @return BaseModel
+ */
+ public static function createFromPrototype(BaseModel $prototype, array $data): BaseModel
+ {
+ $model = clone $prototype;
+ $model->data = $data;
+ $model->originalData = $data;
+
+ return $model;
+ }
+
+ /**
+ * Magic isset method. Returns true if the field exists, either in the data prperty array or in any of the local properties.
+ * Used by array_column() on an array of objects.
+ *
+ * @param $name
+ * @return bool
+ */
+ public function __isset($name): bool
+ {
+ return in_array($name, array_merge(array_keys($this->data), array_keys(get_object_vars($this))));
}
/**
*/
public function __get($name)
{
- if (empty($this->data['id'])) {
- throw new HTTPException\InternalServerErrorException(static::class . ' record uninitialized');
- }
+ $this->checkValid();
if (!array_key_exists($name, $this->data)) {
throw new HTTPException\InternalServerErrorException('Field ' . $name . ' not found in ' . static::class);
}
/**
- * Fetches a single model record. The condition array is expected to contain a unique index (primary or otherwise).
+ * * Magic setter. This allows to set model fields with the following syntax:
+ * - $model->field = $value (outside of class)
+ * - $this->field = $value (inside of class)
*
- * Chainable.
- *
- * @param array $condition
- * @return BaseModel
- * @throws HTTPException\NotFoundException
+ * @param string $name
+ * @param mixed $value
*/
- public function fetch(array $condition)
+ public function __set(string $name, $value)
{
- $data = $this->dba->selectFirst(static::$table_name, [], $condition);
-
- if (!$data) {
- throw new HTTPException\NotFoundException(static::class . ' record not found.');
- }
+ $this->data[$name] = $value;
+ }
- return new static($this->dba, $this->logger, $data);
+ public function toArray(): array
+ {
+ return $this->data;
}
- /**
- * Deletes the model record from the database.
- * Prevents further methods from being called by wiping the internal model data.
- */
- public function delete()
+ protected function checkValid()
{
- if ($this->dba->delete(static::$table_name, ['id' => $this->id])) {
- $this->data = [];
+ if (!isset($this->data['id']) || is_null($this->data['id'])) {
+ throw new HTTPException\InternalServerErrorException(static::class . ' record uninitialized');
}
}
}