Release of v3.2.2-alpha5

Add repositories for better integration with gitea. Refactored the Data classes. Add new Data classes.
2024-06-21 01:32:05 +02:00
parent 894d691897
commit 7a680bb734
159 changed files with 12830 additions and 7619 deletions
--- a/libraries/vendor_jcb/VDM.Joomla/src/Data/Action/Load.php
+++ b/libraries/vendor_jcb/VDM.Joomla/src/Data/Action/Load.php
@@ -0,0 +1,197 @@
+<?php
+/**
+ * @package    Joomla.Component.Builder
+ *
+ * @created    4th September, 2022
+ * @author     Llewellyn van der Merwe <https://dev.vdm.io>
+ * @git        Joomla Component Builder <https://git.vdm.dev/joomla/Component-Builder>
+ * @copyright  Copyright (C) 2015 Vast Development Method. All rights reserved.
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace VDM\Joomla\Data\Action;
+
+
+use VDM\Joomla\Interfaces\ModelInterface as Model;
+use VDM\Joomla\Interfaces\LoadInterface as Database;
+use VDM\Joomla\Interfaces\Data\LoadInterface;
+
+
+/**
+ * Data Load (GUID)
+ * 
+ * @since 3.2.2
+ */
+class Load implements LoadInterface
+{
+	/**
+	 * Model Load
+	 *
+	 * @var    Model
+	 * @since 2.0.1
+	 */
+	protected Model $model;
+
+	/**
+	 * Database Load
+	 *
+	 * @var    Database
+	 * @since 2.0.1
+	 */
+	protected Database $load;
+
+	/**
+	 * Table Name
+	 *
+	 * @var    string
+	 * @since 3.2.1
+	 */
+	protected string $table;
+
+	/**
+	 * Constructor
+	 *
+	 * @param Model       $model     The model object.
+	 * @param Database    $load      The database object.
+	 * @param string|null $table     The table name.
+	 *
+	 * @since 2.0.1
+	 */
+	public function __construct(Model $model, Database $load, ?string $table = null)
+	{
+		$this->model = $model;
+		$this->load = $load;
+		if ($table !== null)
+		{
+			$this->table = $table;
+		}
+	}
+
+	/**
+	 * Set the current active table
+	 *
+	 * @param string|null $table The table that should be active
+	 *
+	 * @return self
+	 * @since 3.2.2
+	 */
+	public function table(?string $table): self
+	{
+		if ($table !== null)
+		{
+			$this->table = $table;
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Get a value from a given table
+	 *          Example: $this->value(
+	 *                        [
+	 *                           'guid' => 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+	 *                        ], 'value_key'
+	 *                    );
+	 *
+	 * @param   array      $keys      The item keys
+	 * @param   string     $field     The field key
+	 *
+	 * @return  mixed
+	 * @since 2.0.1
+	 */
+	public function value(array $keys, string $field)
+	{
+		return $this->model->value(
+			$this->load->value(
+				["a.{$field}" => $field],
+				['a' => $this->getTable()],
+				$this->prefix($keys)
+			),
+			$field,
+			$this->getTable()
+		);
+	}
+
+	/**
+	 * Get values from a given table
+	 *          Example: $this->item(
+	 *                        [
+	 *                           'guid' => 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+	 *                        ]
+	 *                    );
+	 *
+	 * @param   array    $keys      The item keys
+	 *
+	 * @return  object|null
+	 * @since 2.0.1
+	 */
+	public function item(array $keys): ?object
+	{
+		return $this->model->item(
+			$this->load->item(
+				['all' => 'a.*'],
+				['a' => $this->getTable()],
+				$this->prefix($keys)
+			),
+			$this->getTable()
+		);
+	}
+ 
+	/**
+	 * Get values from a given table
+	 *          Example: $this->items(
+	 *                        [
+	 *                           'guid' => [
+	 *                              'operator' => 'IN',
+	 *                              'value' => [''xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'', ''xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'']
+	 *                           ]
+	 *                        ]
+	 *                    );
+	 *          Example: $this->items($ids);
+	 *
+	 * @param   array    $keys    The item keys
+	 *
+	 * @return  array|null
+	 * @since 2.0.1
+	 */
+	public function items(array $keys): ?array
+	{
+		return $this->model->items(
+			$this->load->items(
+				['all' => 'a.*'], ['a' => $this->getTable()], $this->prefix($keys)
+			),
+			$this->getTable()
+		);
+	}
+
+	/**
+	 * Get the current active table
+	 *
+	 * @return  string
+	 * @since 3.2.2
+	 */
+	public function getTable(): string
+	{
+		return $this->table;
+	}
+
+	/**
+	 * Add prefix to the keys
+	 *
+	 * @param   array    $keys The query keys
+	 *
+	 * @return  array
+	 * @since 2.0.1
+	 */
+	private function prefix(array &$keys): array
+	{
+		// update the key values
+		$bucket = [];
+		foreach ($keys as $k => $v)
+		{
+			$bucket['a.' . $k] = $v;
+		}
+		return $bucket;
+	}
+}
+