src/Builder/InCase.php
<?php
declare(strict_types=1);
namespace Stratadox\TableLoader\Builder;
use function array_merge;
use function count;
use function is_null;
use Stratadox\Hydration\Mapper\Mapper;
use Stratadox\Hydrator\ArrayHydrator;
use Stratadox\Hydrator\Hydrates;
use Stratadox\Hydrator\SimpleHydrator;
use Stratadox\Hydrator\VariadicConstructor;
use Stratadox\TableLoader\Loader\From;
use Stratadox\TableLoader\Loader\HasMany;
use Stratadox\TableLoader\Loader\HasOne;
use Stratadox\TableLoader\Loader\Identified;
use Stratadox\TableLoader\Loader\WiresObjects;
use Stratadox\TableLoader\Loader\To;
use Stratadox\TableLoader\Loader\Wire;
use Stratadox\TableLoader\Loader\Wired;
/**
* Builds the required infrastructure to produce a particular subclass.
* @see Decide
*
* @author Stratadox
*/
final class InCase implements LoadsWhenTriggered
{
private $trigger;
private $class;
private $identityColumnsFor = [];
private $properties = [];
private $relation = [];
private $label;
private function __construct(string $trigger)
{
$this->trigger = $trigger;
}
public static function of(
string $trigger
): LoadsWhenTriggered {
return new self($trigger);
}
/** @inheritdoc */
public function as(
string $class,
array $properties = []
): LoadsWhenTriggered {
$new = clone $this;
$new->class = $class;
$new->properties = $properties;
return $new;
}
/** @inheritdoc */
public function with(array $properties): LoadsWhenTriggered
{
$new = clone $this;
$new->properties = array_merge($this->properties, $properties);
return $new;
}
/** @inheritdoc */
public function havingOne(
string $property,
string $label = null
): LoadsWhenTriggered {
$new = clone $this;
$new->relation[$label ?: $property] = HasOne::in($property);
return $new;
}
/** @inheritdoc */
public function havingMany(
string $property,
string $label,
string $collectionClass = null
): LoadsWhenTriggered {
$hydrator = $collectionClass ?
VariadicConstructor::forThe($collectionClass) :
ArrayHydrator::create();
$new = clone $this;
$new->relation[$label] = HasMany::in($property, $hydrator);
return $new;
}
/** @inheritdoc */
public function identifying(
string $label,
string ...$columns
): LoadsWhenTriggered {
$new = clone $this;
$new->identityColumnsFor[$label] = $columns;
return $new;
}
/** @inheritdoc */
public function labeled(string $label): LoadsWhenTriggered
{
$new = clone $this;
$new->label = $label;
return $new;
}
/** @inheritdoc */
public function decisionTrigger(): string
{
return $this->trigger;
}
/** @inheritdoc */
public function hydrator(): Hydrates
{
if (empty($this->properties)) {
return SimpleHydrator::forThe($this->class);
}
$mapper = Mapper::forThe($this->class);
foreach ($this->properties as $name => $instruction) {
$mapper = $mapper->property($name, $instruction);
}
return $mapper->finish();
}
/** @inheritdoc */
public function wiring(): WiresObjects
{
$ownLabel = $this->label;
if (is_null($ownLabel)) {
throw CannotMakeMapping::missingTheLabelFor($this->trigger);
}
$ownId = $this->identityColumnsFor[$ownLabel];
$wires = [];
foreach ($this->relation as $otherLabel => $connectThem) {
$this->mustKnowTheIdentityColumnsFor($otherLabel);
$otherId = $this->identityColumnsFor[$otherLabel];
$wires[] = Wire::it(
From::onlyThe($this->class, $ownLabel, Identified::by(...$ownId)),
To::the($otherLabel, Identified::by(...$otherId)),
$connectThem
);
}
if (count($wires) === 1) {
return $wires[0];
}
return Wired::together(...$wires);
}
/** @throws CannotMakeTableMapping */
private function mustKnowTheIdentityColumnsFor(string $label): void
{
if (!isset($this->identityColumnsFor[$label])) {
throw CannotMakeMapping::missingTheIdentityColumns($label, $this->label);
}
}
}