2017-10-30 06:24:47 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This file is part of the Symfony package.
|
|
|
|
*
|
|
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
|
|
|
*
|
|
|
|
* For the full copyright and license information, please view the LICENSE
|
|
|
|
* file that was distributed with this source code.
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace Symfony\Component\Workflow;
|
|
|
|
|
2017-10-29 17:58:58 +00:00
|
|
|
use Symfony\Component\Workflow\Exception\BlockedTransitionException;
|
2017-10-30 06:24:47 +00:00
|
|
|
use Symfony\Component\Workflow\Exception\LogicException;
|
2017-10-29 17:58:58 +00:00
|
|
|
use Symfony\Component\Workflow\Exception\UndefinedTransitionException;
|
2017-10-30 06:24:47 +00:00
|
|
|
use Symfony\Component\Workflow\MarkingStore\MarkingStoreInterface;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @author Amrouche Hamza <hamza.simperfit@gmail.com>
|
|
|
|
*/
|
|
|
|
interface WorkflowInterface
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* Returns the object's Marking.
|
|
|
|
*
|
|
|
|
* @param object $subject A subject
|
|
|
|
*
|
|
|
|
* @return Marking The Marking
|
|
|
|
*
|
|
|
|
* @throws LogicException
|
|
|
|
*/
|
|
|
|
public function getMarking($subject);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns true if the transition is enabled.
|
|
|
|
*
|
|
|
|
* @param object $subject A subject
|
|
|
|
* @param string $transitionName A transition
|
|
|
|
*
|
|
|
|
* @return bool true if the transition is enabled
|
|
|
|
*
|
|
|
|
* @throws LogicException
|
|
|
|
*/
|
|
|
|
public function can($subject, $transitionName);
|
|
|
|
|
2017-10-29 17:58:58 +00:00
|
|
|
/**
|
|
|
|
* Returns transition blockers explaining why a transition cannot be made.
|
|
|
|
*
|
|
|
|
* @param object $subject A subject
|
|
|
|
* @param string $transitionName A transition
|
|
|
|
*
|
|
|
|
* @return TransitionBlockerList Empty if the transition is possible
|
|
|
|
*/
|
|
|
|
public function buildTransitionBlockerList($subject, string $transitionName): TransitionBlockerList;
|
|
|
|
|
2017-10-30 06:24:47 +00:00
|
|
|
/**
|
|
|
|
* Fire a transition.
|
|
|
|
*
|
|
|
|
* @param object $subject A subject
|
|
|
|
* @param string $transitionName A transition
|
|
|
|
*
|
|
|
|
* @return Marking The new Marking
|
|
|
|
*
|
2017-10-29 17:58:58 +00:00
|
|
|
* @throws BlockedTransitionException If the transition is not applicable
|
|
|
|
* @throws UndefinedTransitionException If the transition does not exist
|
2017-10-30 06:24:47 +00:00
|
|
|
*/
|
2017-10-29 17:58:58 +00:00
|
|
|
public function apply($subject, string $transitionName);
|
2017-10-30 06:24:47 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns all enabled transitions.
|
|
|
|
*
|
|
|
|
* @param object $subject A subject
|
|
|
|
*
|
|
|
|
* @return Transition[] All enabled transitions
|
|
|
|
*/
|
|
|
|
public function getEnabledTransitions($subject);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getName();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return Definition
|
|
|
|
*/
|
|
|
|
public function getDefinition();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return MarkingStoreInterface
|
|
|
|
*/
|
|
|
|
public function getMarkingStore();
|
|
|
|
}
|