* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Workflow; use Symfony\Component\Workflow\Exception\InvalidArgumentException; use Symfony\Component\Workflow\Exception\LogicException; /** * @author Fabien Potencier * @author Grégoire Pineau * @author Tobias Nyholm */ final class Definition { private $places = array(); private $transitions = array(); private $initialPlace; /** * @param string[] $places * @param Transition[] $transitions * @param string|null $initialPlace */ public function __construct(array $places, array $transitions, string $initialPlace = null) { foreach ($places as $place) { $this->addPlace($place); } foreach ($transitions as $transition) { $this->addTransition($transition); } $this->setInitialPlace($initialPlace); } /** * @return string|null */ public function getInitialPlace() { return $this->initialPlace; } /** * @return string[] */ public function getPlaces(): array { return $this->places; } /** * @return Transition[] */ public function getTransitions(): array { return $this->transitions; } private function setInitialPlace(string $place = null) { if (null === $place) { return; } if (!isset($this->places[$place])) { throw new LogicException(sprintf('Place "%s" cannot be the initial place as it does not exist.', $place)); } $this->initialPlace = $place; } private function addPlace(string $place) { if (!preg_match('{^[\w_-]+$}', $place)) { throw new InvalidArgumentException(sprintf('The place "%s" contains invalid characters.', $place)); } if (!count($this->places)) { $this->initialPlace = $place; } $this->places[$place] = $place; } private function addTransition(Transition $transition) { $name = $transition->getName(); foreach ($transition->getFroms() as $from) { if (!isset($this->places[$from])) { throw new LogicException(sprintf('Place "%s" referenced in transition "%s" does not exist.', $from, $name)); } } foreach ($transition->getTos() as $to) { if (!isset($this->places[$to])) { throw new LogicException(sprintf('Place "%s" referenced in transition "%s" does not exist.', $to, $name)); } } $this->transitions[] = $transition; } }