. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * * Neither the name of Sebastian Bergmann nor the names of his * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * * @category Testing * @package PHPUnit * @author Jan Borsodi * @author Sebastian Bergmann * @copyright 2002-2009 Sebastian Bergmann * @license http://www.opensource.org/licenses/bsd-license.php BSD License * @link http://www.phpunit.de/ * @since File available since Release 3.0.0 */ require_once 'PHPUnit/Framework.php'; require_once 'PHPUnit/Util/Filter.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/Invocation.php'; require_once 'PHPUnit/Framework/MockObject/Invocation.php'; PHPUnit_Util_Filter::addFileToFilter(__FILE__, 'PHPUNIT'); /** * Main matcher which defines a full expectation using method, parameter and invocation matchers. * * This matcher encapsulates all the other matchers and allows the builder to set * the specific matchers when the appropriate methods are called (once(), where() * etc.). * * All properties are public so that they can easily be accessed by the builder. * * @category Testing * @package PHPUnit * @author Jan Borsodi * @author Sebastian Bergmann * @copyright 2002-2009 Sebastian Bergmann * @license http://www.opensource.org/licenses/bsd-license.php BSD License * @version Release: 3.3.17 * @link http://www.phpunit.de/ * @since Class available since Release 3.0.0 */ class PHPUnit_Framework_MockObject_Matcher implements PHPUnit_Framework_MockObject_Matcher_Invocation { public $invocationMatcher; public $afterMatchBuilderId = NULL; public $afterMatchBuilderIsInvoked = FALSE; public $methodNameMatcher = NULL; public $parametersMatcher = NULL; public $stub = NULL; public function __construct(PHPUnit_Framework_MockObject_Matcher_Invocation $invocationMatcher) { $this->invocationMatcher = $invocationMatcher; } public function toString() { $list = array(); if ($this->invocationMatcher !== NULL) { $list[] = $this->invocationMatcher->toString(); } if ($this->methodNameMatcher !== NULL) { $list[] = 'where ' . $this->methodNameMatcher->toString(); } if ($this->parametersMatcher !== NULL) { $list[] = 'and ' . $this->parametersMatcher->toString(); } if ($this->afterMatchBuilderId !== NULL) { $list[] = 'after ' . $this->afterMatchBuilderId; } if ($this->stub !== NULL) { $list[] = 'will ' . $this->stub->toString(); } return join(' ', $list); } public function invoked(PHPUnit_Framework_MockObject_Invocation $invocation) { if ($this->invocationMatcher === NULL) { throw new RuntimeException('No invocation matcher is set'); } if ($this->methodNameMatcher === NULL) { throw new RuntimeException('No method matcher is set'); } if ($this->afterMatchBuilderId !== NULL) { $builder = $invocation->object->__phpunit_getInvocationMocker()->lookupId($this->afterMatchBuilderId); if (!$builder) { throw new RuntimeException( sprintf( 'No builder found for match builder identification <%s>', $this->afterMatchBuilderId ) ); } $matcher = $builder->getMatcher(); if ($matcher && $matcher->invocationMatcher->hasBeenInvoked()) { $this->afterMatchBuilderIsInvoked = TRUE; } } $this->invocationMatcher->invoked($invocation); try { if ( $this->parametersMatcher !== NULL && !$this->parametersMatcher->matches($invocation)) { $this->parametersMatcher->verify(); } } catch (PHPUnit_Framework_ExpectationFailedException $e) { throw new PHPUnit_Framework_ExpectationFailedException( sprintf( "Expectation failed for %s when %s\n%s", $this->methodNameMatcher->toString(), $this->invocationMatcher->toString(), $e->getDescription() ), $e->getComparisonFailure() ); } if ($this->stub) { return $this->stub->invoke($invocation); } return NULL; } public function matches(PHPUnit_Framework_MockObject_Invocation $invocation) { if ($this->afterMatchBuilderId !== NULL) { $builder = $invocation->object->__phpunit_getInvocationMocker()->lookupId($this->afterMatchBuilderId); if (!$builder) { throw new RuntimeException( sprintf( 'No builder found for match builder identification <%s>', $this->afterMatchBuilderId ) ); } $matcher = $builder->getMatcher(); if (!$matcher) { return FALSE; } if (!$matcher->invocationMatcher->hasBeenInvoked()) { return FALSE; } } if ($this->invocationMatcher === NULL) { throw new RuntimeException('No invocation matcher is set'); } if ($this->methodNameMatcher === NULL) { throw new RuntimeException('No method matcher is set'); } if (!$this->invocationMatcher->matches($invocation)) { return FALSE; } try { if (!$this->methodNameMatcher->matches($invocation)) { return FALSE; } } catch (PHPUnit_Framework_ExpectationFailedException $e) { throw new PHPUnit_Framework_ExpectationFailedException( sprintf( "Expectation failed for %s when %s\n%s", $this->methodNameMatcher->toString(), $this->invocationMatcher->toString(), $e->getDescription() ), $e->getComparisonFailure() ); } return TRUE; } public function verify() { if ($this->invocationMatcher === NULL) { throw new RuntimeException('No invocation matcher is set'); } if ($this->methodNameMatcher === NULL) { throw new RuntimeException('No method matcher is set'); } try { $this->invocationMatcher->verify(); if ($this->parametersMatcher !== NULL) { $this->parametersMatcher->verify(); } } catch (PHPUnit_Framework_ExpectationFailedException $e) { throw new PHPUnit_Framework_ExpectationFailedException( sprintf( "Expectation failed for %s when %s.\n%s", $this->methodNameMatcher->toString(), $this->invocationMatcher->toString(), $e->getDescription() ) ); } } } require_once 'PHPUnit/Framework/MockObject/Matcher/AnyInvokedCount.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/AnyParameters.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/InvokedAtIndex.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/InvokedAtLeastOnce.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/InvokedCount.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/InvokedRecorder.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/MethodName.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/Parameters.php'; require_once 'PHPUnit/Framework/MockObject/Matcher/StatelessInvocation.php'; ?>