propelorm/Propel2

View on GitHub
src/Propel/Generator/Model/Domain.php

Summary

Maintainability
A
3 hrs
Test Coverage
<?php

/**
 * MIT License. This file is part of the Propel package.
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Propel\Generator\Model;

use DOMDocument;
use DOMNode;
use Propel\Generator\Exception\EngineException;

/**
 * A class for holding data about a domain used in the schema.
 *
 * @author Hans Lellelid <hans@xmpl.org> (Propel)
 * @author Martin Poeschl <mpoeschl@marmot.at> (Torque)
 * @author Hugo Hamon <webmaster@apprendre-php.com> (Propel)
 */
class Domain extends MappingModel
{
    /**
     * @var string|null
     */
    private $name;

    /**
     * @var string|null
     */
    private $description;

    /**
     * @var int|null
     */
    private $size;

    /**
     * @var int|null
     */
    private $scale;

    /**
     * @var string|null
     */
    private $mappingType;

    /**
     * @var string|null
     */
    private $sqlType;

    /**
     * @var \Propel\Generator\Model\ColumnDefaultValue|null
     */
    private $defaultValue;

    /**
     * @var \Propel\Generator\Model\Database|null
     */
    private $database;

    /**
     * Creates a new Domain object.
     *
     * If this domain needs a name, it must be specified manually.
     *
     * @param string|null $type Propel type.
     * @param string|null $sqlType SQL type.
     * @param int|null $size
     * @param int|null $scale
     */
    public function __construct(?string $type = null, ?string $sqlType = null, ?int $size = null, ?int $scale = null)
    {
        if ($type !== null) {
            $this->setType($type);
        }

        if ($size !== null) {
            $this->setSize($size);
        }

        if ($scale !== null) {
            $this->setScale($scale);
        }

        $this->setSqlType($sqlType ?? $type);
    }

    /**
     * Copies the values from current object into passed-in Domain.
     *
     * @param \Propel\Generator\Model\Domain $domain Domain to copy values into.
     *
     * @return void
     */
    public function copy(Domain $domain): void
    {
        $this->defaultValue = $domain->getDefaultValue();
        $this->description = $domain->getDescription();
        $this->name = $domain->getName();
        $this->scale = $domain->getScale();
        $this->size = $domain->getSize();
        $this->sqlType = $domain->getSqlType();
        $this->mappingType = $domain->getType();
    }

    /**
     * @return void
     */
    protected function setupObject(): void
    {
        $schemaType = !$this->getAttribute('type')
            ? ''
            : strtoupper($this->getAttribute('type'));

        $this->copy($this->database->getPlatform()->getDomainForType($schemaType));

        // Name
        $this->name = $this->getAttribute('name');

        // Default value
        $defval = $this->getAttribute('defaultValue', $this->getAttribute('default'));
        if ($defval !== null) {
            $this->setDefaultValue(new ColumnDefaultValue($defval, ColumnDefaultValue::TYPE_VALUE));
        } elseif ($this->getAttribute('defaultExpr') !== null) {
            $this->setDefaultValue(new ColumnDefaultValue($this->getAttribute('defaultExpr'), ColumnDefaultValue::TYPE_EXPR));
        }

        $this->size = $this->getAttribute('size') ? (int)$this->getAttribute('size') : null;
        $this->scale = $this->getAttribute('scale') ? (int)$this->getAttribute('scale') : null;
        $this->description = $this->getAttribute('description');
    }

    /**
     * Sets the owning database object (if this domain is being setup via XML).
     *
     * @param \Propel\Generator\Model\Database $database
     *
     * @return void
     */
    public function setDatabase(Database $database): void
    {
        $this->database = $database;
    }

    /**
     * Returns the owning database object (if this domain was setup via XML).
     *
     * @return \Propel\Generator\Model\Database|null
     */
    public function getDatabase(): ?Database
    {
        return $this->database;
    }

    /**
     * Returns the domain description.
     *
     * @return string|null
     */
    public function getDescription(): ?string
    {
        return $this->description;
    }

    /**
     * Sets the domain description.
     *
     * @param string|null $description
     *
     * @return void
     */
    public function setDescription(?string $description): void
    {
        $this->description = $description;
    }

    /**
     * Returns the domain description.
     *
     * @return string|null
     */
    public function getName(): ?string
    {
        return $this->name;
    }

    /**
     * Sets the domain name.
     *
     * @param string|null $name
     *
     * @return void
     */
    public function setName(?string $name): void
    {
        $this->name = $name;
    }

    /**
     * Returns the scale value.
     *
     * @return int|null
     */
    public function getScale(): ?int
    {
        return $this->scale;
    }

    /**
     * Sets the scale value.
     *
     * @param int|null $scale
     *
     * @return void
     */
    public function setScale(?int $scale): void
    {
        $this->scale = $scale;
    }

    /**
     * Replaces the size if the new value is not null.
     *
     * @param int|null $scale
     *
     * @return void
     */
    public function replaceScale(?int $scale): void
    {
        if ($scale !== null) {
            $this->scale = $scale;
        }
    }

    /**
     * Returns the size.
     *
     * @return int|null
     */
    public function getSize(): ?int
    {
        return $this->size;
    }

    /**
     * Sets the size.
     *
     * @param int|null $size
     *
     * @return void
     */
    public function setSize(?int $size): void
    {
        $this->size = $size;
    }

    /**
     * Replaces the size if the new value is not null.
     *
     * @param int|null $size
     *
     * @return void
     */
    public function replaceSize(?int $size): void
    {
        if ($size !== null) {
            $this->size = $size;
        }
    }

    /**
     * Returns the mapping type.
     *
     * @return string
     */
    public function getType(): string
    {
        // For some reason we're supporting null, but there are many functions that rely on the
        // return value being a string.
        return $this->mappingType ?: '';
    }

    /**
     * Sets the mapping type.
     *
     * @param string|null $mappingType
     *
     * @return void
     */
    public function setType(?string $mappingType): void
    {
        $this->mappingType = $mappingType;
    }

    /**
     * Replaces the mapping type if the new value is not null.
     *
     * @param string|null $mappingType
     *
     * @return void
     */
    public function replaceType(?string $mappingType): void
    {
        if ($mappingType !== null) {
            $this->mappingType = $mappingType;
        }
    }

    /**
     * Returns the default value object.
     *
     * @return \Propel\Generator\Model\ColumnDefaultValue|null
     */
    public function getDefaultValue(): ?ColumnDefaultValue
    {
        return $this->defaultValue;
    }

    /**
     * Returns the default value, type-casted for use in PHP OM.
     *
     * @throws \Propel\Generator\Exception\EngineException
     *
     * @return array|string|int|bool|null
     */
    public function getPhpDefaultValue()
    {
        if ($this->defaultValue === null) {
            return null;
        }

        if ($this->defaultValue->isExpression()) {
            throw new EngineException('Cannot get PHP version of default value for default value EXPRESSION.');
        }

        if (in_array($this->mappingType, [PropelTypes::BOOLEAN, PropelTypes::BOOLEAN_EMU], true)) {
            return $this->booleanValue($this->defaultValue->getValue());
        }

        if ($this->mappingType === PropelTypes::PHP_ARRAY) {
            return $this->getDefaultValueForArray((string)$this->defaultValue->getValue());
        }
        if ($this->mappingType === PropelTypes::SET) {
            return $this->getDefaultValueForSet((string)$this->defaultValue->getValue());
        }

        return $this->defaultValue->getValue();
    }

    /**
     * Sets the default value.
     *
     * @param \Propel\Generator\Model\ColumnDefaultValue $value
     *
     * @return void
     */
    public function setDefaultValue(ColumnDefaultValue $value): void
    {
        $this->defaultValue = $value;
    }

    /**
     * Replaces the default value if the new value is not null.
     *
     * @param \Propel\Generator\Model\ColumnDefaultValue|null $value
     *
     * @return void
     */
    public function replaceDefaultValue(?ColumnDefaultValue $value = null): void
    {
        if ($value !== null) {
            $this->defaultValue = $value;
        }
    }

    /**
     * Returns the SQL type.
     *
     * @return string|null
     */
    public function getSqlType(): ?string
    {
        return $this->sqlType;
    }

    /**
     * Sets the SQL type.
     *
     * @param string|null $sqlType
     *
     * @return void
     */
    public function setSqlType(?string $sqlType): void
    {
        $this->sqlType = $sqlType;
    }

    /**
     * Replaces the SQL type if the new value is not null.
     *
     * @param string|null $sqlType
     *
     * @return void
     */
    public function replaceSqlType(?string $sqlType): void
    {
        if ($sqlType !== null) {
            $this->sqlType = $sqlType;
        }
    }

    /**
     * Returns the size and scale in brackets for use in an sql schema.
     *
     * @return string
     */
    public function getSizeDefinition(): string
    {
        if ($this->size === null) {
            return '';
        }

        if ($this->scale !== null) {
            return sprintf('(%u,%u)', $this->size, $this->scale);
        }

        return sprintf('(%u)', $this->size);
    }

    /**
     * @return void
     */
    public function __clone()
    {
        if ($this->defaultValue) {
            $this->defaultValue = clone $this->defaultValue;
        }
    }

    /**
     * @todo Remove? This method is never called.
     *
     * @param \DOMNode $node
     *
     * @return void
     */
    public function appendXml(DOMNode $node): void
    {
        $doc = ($node instanceof DOMDocument) ? $node : $node->ownerDocument;

        /** @var \DOMElement $domainNode */
        $domainNode = $node->appendChild($doc->createElement('domain'));
        $domainNode->setAttribute('type', $this->getType());
        $domainNode->setAttribute('name', $this->getName());

        if ($this->getType() !== $this->sqlType) {
            $domainNode->setAttribute('sqlType', $this->sqlType);
        }

        $def = $this->getDefaultValue();
        if ($def) {
            $domainNode->setAttribute(
                $def->isExpression() ? 'defaultExpr' : 'defaultValue',
                (string)$def->getValue(),
            );
        }

        if ($this->size) {
            $domainNode->setAttribute('size', (string)$this->size);
        }

        if ($this->scale) {
            $domainNode->setAttribute('scale', (string)$this->scale);
        }

        if ($this->description) {
            $domainNode->setAttribute('description', $this->description);
        }
    }
}