Arguments.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Extbase\Mvc\Controller;

class Arguments extends \ArrayObject {

    protected $objectManager;

    protected $argumentNames = array();

    protected $argumentShortNames = array();

    public function __construct() {
        parent::__construct();
    }

    public function offsetSet($offset, $value) {
        if (!$value instanceof \TYPO3\CMS\Extbase\Mvc\Controller\Argument) {
            throw new \InvalidArgumentException('Controller arguments must be valid TYPO3\\CMS\\Extbase\\Mvc\\Controller\\Argument objects.', 1187953786);
        }
        $argumentName = $value->getName();
        parent::offsetSet($argumentName, $value);
        $this->argumentNames[$argumentName] = TRUE;
    }

    public function append($value) {
        if (!$value instanceof \TYPO3\CMS\Extbase\Mvc\Controller\Argument) {
            throw new \InvalidArgumentException('Controller arguments must be valid TYPO3\\CMS\\Extbase\\Mvc\\Controller\\Argument objects.', 1187953787);
        }
        $this->offsetSet(NULL, $value);
    }

    public function offsetUnset($offset) {
        $translatedOffset = $this->translateToLongArgumentName($offset);
        parent::offsetUnset($translatedOffset);
        unset($this->argumentNames[$translatedOffset]);
        if ($offset != $translatedOffset) {
            unset($this->argumentShortNames[$offset]);
        }
    }

    public function offsetExists($offset) {
        $translatedOffset = $this->translateToLongArgumentName($offset);
        return parent::offsetExists($translatedOffset);
    }

    public function offsetGet($offset) {
        $translatedOffset = $this->translateToLongArgumentName($offset);
        if ($translatedOffset === '') {
            throw new \TYPO3\CMS\Extbase\Mvc\Exception\NoSuchArgumentException('The argument "' . $offset . '" does not exist.', 1216909923);
        }
        return parent::offsetGet($translatedOffset);
    }

    public function addNewArgument($name, $dataType = 'Text', $isRequired = FALSE, $defaultValue = NULL) {
        $argument = $this->objectManager->get('TYPO3\\CMS\\Extbase\\Mvc\\Controller\\Argument', $name, $dataType);
        $argument->setRequired($isRequired);
        $argument->setDefaultValue($defaultValue);
        $this->addArgument($argument);
        return $argument;
    }

    public function addArgument(\TYPO3\CMS\Extbase\Mvc\Controller\Argument $argument) {
        $this->offsetSet(NULL, $argument);
    }

    public function getArgument($argumentName) {
        if (!$this->offsetExists($argumentName)) {
            throw new \TYPO3\CMS\Extbase\Mvc\Exception\NoSuchArgumentException('An argument "' . $argumentName . '" does not exist.', 1195815178);
        }
        return $this->offsetGet($argumentName);
    }

    public function hasArgument($argumentName) {
        return $this->offsetExists($argumentName);
    }

    public function getArgumentNames() {
        return array_keys($this->argumentNames);
    }

    public function getArgumentShortNames() {
        $argumentShortNames = array();
        foreach ($this as $argument) {
            $argumentShortNames[$argument->getShortName()] = TRUE;
        }
        return array_keys($argumentShortNames);
    }

    public function __call($methodName, array $arguments) {
        if (substr($methodName, 0, 3) !== 'set') {
            throw new \LogicException('Unknown method "' . $methodName . '".', 1210858451);
        }
        $firstLowerCaseArgumentName = $this->translateToLongArgumentName(strtolower($methodName[3]) . substr($methodName, 4));
        $firstUpperCaseArgumentName = $this->translateToLongArgumentName(ucfirst(substr($methodName, 3)));
        if (in_array($firstLowerCaseArgumentName, $this->getArgumentNames())) {
            $argument = parent::offsetGet($firstLowerCaseArgumentName);
            $argument->setValue($arguments[0]);
        } elseif (in_array($firstUpperCaseArgumentName, $this->getArgumentNames())) {
            $argument = parent::offsetGet($firstUpperCaseArgumentName);
            $argument->setValue($arguments[0]);
        }
    }

    protected function translateToLongArgumentName($argumentName) {
        if (in_array($argumentName, $this->getArgumentNames())) {
            return $argumentName;
        }
        foreach ($this as $argument) {
            if ($argumentName === $argument->getShortName()) {
                return $argument->getName();
            }
        }
        return '';
    }

    public function removeAll() {
        foreach ($this->argumentNames as $argumentName => $booleanValue) {
            parent::offsetUnset($argumentName);
        }
        $this->argumentNames = array();
    }

    public function getValidationResults() {
        $results = new \TYPO3\CMS\Extbase\Error\Result();
        foreach ($this as $argument) {
            $argumentValidationResults = $argument->getValidationResults();
            if ($argumentValidationResults === NULL) {
                continue;
            }
            $results->forProperty($argument->getName())->merge($argumentValidationResults);
        }
        return $results;
    }
}