Onionmixer: PHPUnit 4.3 예외 테스트 페이지 추가

2013-06-06T10:07:30Z

PHPUnit 4.3 예외 테스트 페이지 추가

New page

;4.3 예외테스트

==예외 테스트==

예제 4.7 "@expectedException 주석의 사용법" 은, 테스트할 코드 안에 예외가 throw 되었는지를 @expectedException 주석을 사용하여 조사하는 방법입니다.

예제 4.7 "@expectedException 주석의 사용법"

<syntaxhighlight lang="php">
<?php
class ExceptionTest extends PHPUnit_Framework_TestCase
{
/**
* @expectedException InvalidArgumentException
*/
public function testException()
{
}
}
?>
</syntaxhighlight>

<syntaxhighlight lang="text">
PHPUnit 3.7.0 by Sebastian Bergmann.
F
Time: 0 seconds, Memory: 4.75Mb
There was 1 failure:
1) ExceptionTest::testException
Expected exception InvalidArgumentException
FAILURES!
Tests: 1, Assertions: 1, Failures: 1.phpunit ExceptionTest
PHPUnit 3.7.0 by Sebastian Bergmann.
F
Time: 0 seconds, Memory: 4.75Mb
There was 1 failure:
1) ExceptionTest::testException
Expected exception InvalidArgumentException
FAILURES!
Tests: 1, Assertions: 1, Failures: 1.
</syntaxhighlight>

또한, @expectedExceptionMessage 나 @expectedExceptionCode 를 @expectedException 과 조합하여 사용하면, 예외 메세지나 예외 코드를 예제 4.8 "@expectedExceptionMessage 및 @expectedExceptionCode 선언의 사용법" 에 나와 있는 것처럼 테스트할 수 있습니다.

예제 4.8 @expectedExceptionMessage 및 @expectedExceptionCode 선언의 사용법

<syntaxhighlight lang="php">
<?php
class ExceptionTest extends PHPUnit_Framework_TestCase
{
/**
* @expectedException
InvalidArgumentException
* @expectedExceptionMessage Right Message
*/
public function testExceptionHasRightMessage()
{
throw new InvalidArgumentException('Some Message', 10);
}
/**
* @expectedException
InvalidArgumentException
* @expectedExceptionCode 20
*/
public function testExceptionHasRightCode()
{
throw new InvalidArgumentException('Some Message', 10);
}
}
?>
</syntaxhighlight>

<syntaxhighlight lang="text">
PHPUnit 3.7.0 by Sebastian Bergmann.
FF
Time: 0 seconds, Memory: 3.00Mb
There were 2 failures:
1) ExceptionTest::testExceptionHasRightMessage
Failed asserting that exception message 'Some Message' contains 'Right Message'.
2) ExceptionTest::testExceptionHasRightCode
Failed asserting that expected exception code 20 is equal to 10.
FAILURES!
Tests: 2, Assertions: 4, Failures: 2.phpunit ExceptionTest
PHPUnit 3.7.0 by Sebastian Bergmann.
FF
Time: 0 seconds, Memory: 3.00Mb
There were 2 failures:
1) ExceptionTest::testExceptionHasRightMessage
Failed asserting that exception message 'Some Message' contains 'Right Message'.
2) ExceptionTest::testExceptionHasRightCode
Failed asserting that expected exception code 20 is equal to 10.
FAILURES!
Tests: 2, Assertions: 4, Failures: 2.
</syntaxhighlight>

@expectedExceptionMessage 나 @expectedExceptionCode 를 사용한 다른 예가 "@expectedExceptionMessage" 와 "@expectedExceptionCode" 에 있습니다.

한편, setExpectedException() 메소드를 사용하여 발생할 예외를 지정할 수도 있습니다. 지정하는 방법이 예제 4.9 "테스트 대상 코드에서 발생할 예외의 지정" 에 나와 있습니다.

예제 4.9 테스트 대상 코드에서 발생할 예외의 지정

<syntaxhighlight lang="php">
<?php
class ExceptionTest extends PHPUnit_Framework_TestCase
{
public function testException()
{
$this->setExpectedException('InvalidArgumentException');
}
public function testExceptionHasRightMessage()
{
$this->setExpectedException(
'InvalidArgumentException', 'Right Message'
);
throw new InvalidArgumentException('Some Message', 10);
}
public function testExceptionHasRightCode()
{
$this->setExpectedException(
'InvalidArgumentException', 'Right Message', 20
);
throw new InvalidArgumentException('The Right Message', 10);
}
}?>
</syntaxhighlight>

<syntaxhighlight lang="text">
PHPUnit 3.7.0 by Sebastian Bergmann.
FFF
Time: 0 seconds, Memory: 3.00Mb
There were 3 failures:
1) ExceptionTest::testException
Expected exception InvalidArgumentException
2) ExceptionTest::testExceptionHasRightMessage
Failed asserting that exception message 'Some Message' contains 'Right Message'.
3) ExceptionTest::testExceptionHasRightCode
Failed asserting that expected exception code 20 is equal to 10.
FAILURES!
Tests: 3, Assertions: 6, Failures: 3.phpunit ExceptionTest
PHPUnit 3.7.0 by Sebastian Bergmann.
FFF
Time: 0 seconds, Memory: 3.00Mb
There were 3 failures:
1) ExceptionTest::testException
Expected exception InvalidArgumentException
2) ExceptionTest::testExceptionHasRightMessage
Failed asserting that exception message 'Some Message' contains 'Right Message'.
3) ExceptionTest::testExceptionHasRightCode
Failed asserting that expected exception code 20 is equal to 10.
FAILURES!
Tests: 3, Assertions: 6, Failures: 3.
</syntaxhighlight>

표4.1 "예외 테스트용 메소드" 는 예외를 테스트하기 위해 준비된 메소드들을 정리한 것입니다.

{| style="border: 1px solid black;"
|- style="color: white; background-color: black;"
|'''메소드'''||'''의미'''
|- style="vertical-align:top;"
|void setExpectedException(string $exceptionName[, string $exceptionMessage = '', integer $exceptionCode = NULL])||예상되는 $exceptionName, $exceptionMessage 및 $exceptionCode 를 설정합니다.
|- style="vertical-align:top;"
|String getExpectedException()||발생할 것이 예상되는 예외의 이름을 반환합니다
|- style="color: black; background-color: gray;"
| colspan="2" |표4.1 예외 테스트용 메소드
|}

한편, 예제 4.10 "예외를 테스트하는 다른 방법" 과 같은 방법으로 예외를 테스트할 수도 있습니다.

예제 4.10 예외를 테스트하는 다른 방법

<syntaxhighlight lang="php">
<?php
class ExceptionTest extends PHPUnit_Framework_TestCase {
public function testException() {
try {
// ... 예외를 발생시키는 코드 ...
}
catch (InvalidArgumentException $expected) {
return;
}
$this->fail('예상한 예외가 발생하지 않았습니다.');
}
}
?>
</syntaxhighlight>

예외가 발생할 예정인 예 4.10 "예외를 테스트하는 다른 방법" 에서 예외가 발생하지 않은 경우, 이어지는 fail() 로 인해 테스트가 종료하여 문제가 보고됩니다. 예상대로 예외가 발생한 경우, catch 블록이 실행되어 테스트가 정상 종료됩니다

==Notes==
<references />

[[Category:PHPUnitManual]]

PHPUnitManual:4.3 - Revision history

Onionmixer: PHPUnit 4.3 예외 테스트 페이지 추가