public interface TestContext
Modifier and Type | Method and Description |
---|---|
TestContext |
assertEquals(Object expected,
Object actual)
Assert the
expected argument is equals to the actual argument. |
TestContext |
assertEquals(Object expected,
Object actual,
String message)
Assert the
expected argument is equals to the actual argument. |
TestContext |
assertFalse(boolean condition)
Assert the specified
condition is false . |
TestContext |
assertFalse(boolean condition,
String message)
Assert the specified
condition is false . |
TestContext |
assertInRange(double expected,
double actual,
double delta)
Asserts that the
expected double argument is equals to the actual double argument
within a positive delta. |
TestContext |
assertInRange(double expected,
double actual,
double delta,
String message)
Asserts that the
expected double argument is equals to the actual double argument
within a positive delta. |
TestContext |
assertNotEquals(Object first,
Object second)
Assert the
first argument is not equals to the second argument. |
TestContext |
assertNotEquals(Object first,
Object second,
String message)
Assert the
first argument is not equals to the second argument. |
TestContext |
assertNotNull(Object expected)
Assert the
expected argument is not null . |
TestContext |
assertNotNull(Object expected,
String message)
Assert the
expected argument is not null . |
TestContext |
assertNull(Object expected)
Assert the
expected argument is null . |
TestContext |
assertNull(Object expected,
String message)
Assert the
expected argument is null . |
TestContext |
assertTrue(boolean condition)
Assert the specified
condition is true . |
TestContext |
assertTrue(boolean condition,
String message)
Assert the specified
condition is true . |
Async |
async()
Create and returns a new async object, the returned async controls the completion of the test.
|
Async |
async(int count)
Create and returns a new async object, the returned async controls the completion of the test.
|
<T> Handler<AsyncResult<T>> |
asyncAssertFailure()
Creates and returns a new async handler, the returned handler controls the completion of the test.
When the returned handler is called back with a failed result it completes the async operation.
When the returned handler is called back with a succeeded result it fails the test.
|
<T> Handler<AsyncResult<T>> |
asyncAssertFailure(Handler<Throwable> causeHandler)
Creates and returns a new async handler, the returned handler controls the completion of the test.
When the returned handler is called back with a failed result it completes the async operation.
When the returned handler is called back with a succeeded result it fails the test.
|
<T> Handler<AsyncResult<T>> |
asyncAssertSuccess()
Creates and returns a new async handler, the returned handler controls the completion of the test.
When the returned handler is called back with a succeeded result it completes the async operation.
When the returned handler is called back with a failed result it fails the test with the cause of the failure.
|
<T> Handler<AsyncResult<T>> |
asyncAssertSuccess(Handler<T> resultHandler)
Creates and returns a new async handler, the returned handler controls the completion of the test.
When the returned handler is called back with a succeeded result it invokes the
resultHandler argument
with the async result. |
Handler<Throwable> |
exceptionHandler() |
void |
fail()
Throw a failure.
|
void |
fail(String message)
Throw a failure with the specified failure
message . |
void |
fail(Throwable cause)
Throw a failure with the specified failure
cause . |
<T> T |
get(String key)
Get some data from the context.
|
<T> T |
put(String key,
Object value)
Put some data in the context.
|
<T> T |
remove(String key)
Remove some data from the context.
|
Async |
strictAsync(int count)
Create and returns a new async object, the returned async controls the completion of the test.
|
TestContext |
verify(Handler<Void> block)
Execute the provided handler, which may contain assertions, possibly from any third-party assertion framework.
|
<T> T get(String key)
T
- the type of the datakey
- the key of the data<T> T put(String key, Object value)
This can be used to share data between different tests and before/after phases.
key
- the key of the datavalue
- the data<T> T remove(String key)
key
- the key to removeTestContext assertNull(Object expected)
expected
argument is null
. If the argument is not, an assertion error is thrown
otherwise the execution continue.expected
- the argument being asserted to be nullTestContext assertNull(Object expected, String message)
expected
argument is null
. If the argument is not, an assertion error is thrown
otherwise the execution continue.expected
- the argument being asserted to be nullmessage
- the failure messageTestContext assertNotNull(Object expected)
expected
argument is not null
. If the argument is null
, an assertion error is thrown
otherwise the execution continue.expected
- the argument being asserted to be not nullTestContext assertNotNull(Object expected, String message)
expected
argument is not null
. If the argument is null
, an assertion error is thrown
otherwise the execution continue.expected
- the argument being asserted to be not nullmessage
- the failure messageTestContext assertTrue(boolean condition)
condition
is true
. If the condition is false
, an assertion error is thrown
otherwise the execution continue.condition
- the condition to assertTestContext assertTrue(boolean condition, String message)
condition
is true
. If the condition is false
, an assertion error is thrown
otherwise the execution continue.condition
- the condition to assertmessage
- the failure messageTestContext assertFalse(boolean condition)
condition
is false
. If the condition is true
, an assertion error is thrown
otherwise the execution continue.condition
- the condition to assertTestContext assertFalse(boolean condition, String message)
condition
is false
. If the condition is true
, an assertion error is thrown
otherwise the execution continue.condition
- the condition to assertmessage
- the failure messageTestContext assertEquals(Object expected, Object actual)
expected
argument is equals to the actual
argument. If the arguments are not equals
an assertion error is thrown otherwise the execution continue.expected
- the object the actual object is supposedly equals toactual
- the actual object to testTestContext assertEquals(Object expected, Object actual, String message)
expected
argument is equals to the actual
argument. If the arguments are not equals
an assertion error is thrown otherwise the execution continue.expected
- the object the actual object is supposedly equals toactual
- the actual object to testmessage
- the failure messageTestContext assertInRange(double expected, double actual, double delta)
expected
double argument is equals to the actual
double argument
within a positive delta. If the arguments do not satisfy this, an assertion error is thrown otherwise
the execution continue.expected
- the object the actual object is supposedly equals toactual
- the actual object to testdelta
- the maximum deltaTestContext assertInRange(double expected, double actual, double delta, String message)
expected
double argument is equals to the actual
double argument
within a positive delta. If the arguments do not satisfy this, an assertion error is thrown otherwise
the execution continue.expected
- the object the actual object is supposedly equals toactual
- the actual object to testdelta
- the maximum deltamessage
- the failure messageTestContext assertNotEquals(Object first, Object second)
first
argument is not equals to the second
argument. If the arguments are equals
an assertion error is thrown otherwise the execution continue.first
- the first object to testsecond
- the second object to testTestContext assertNotEquals(Object first, Object second, String message)
first
argument is not equals to the second
argument. If the arguments are equals
an assertion error is thrown otherwise the execution continue.first
- the first object to testsecond
- the second object to testmessage
- the failure messageTestContext verify(Handler<Void> block)
AssertionError
thrown will be caught (and propagated) in order to fulfill potential expected async
completeness.block
- block of code to be executedvoid fail()
void fail(String message)
message
.message
- the failure messagevoid fail(Throwable cause)
cause
.cause
- the failure causeAsync async()
Async.complete()
completes the async operation.
The test case will complete when all the async objects have their Async.complete()
method called at least once.
This method shall be used for creating asynchronous exit points for the executed test.Async async(int count)
Async.countDown()
is called count
times.
The test case will complete when all the async objects have their Async.complete()
method called at least once.
This method shall be used for creating asynchronous exit points for the executed test.Async strictAsync(int count)
Async.countDown()
is called count
times.
If Async.countDown()
is called more than count
times, an IllegalStateException
is thrown.
The test case will complete when all the async objects have their Async.complete()
method called at least once.
This method shall be used for creating asynchronous exit points for the executed test.<T> Handler<AsyncResult<T>> asyncAssertSuccess()
<T> Handler<AsyncResult<T>> asyncAssertSuccess(Handler<T> resultHandler)
resultHandler
argument
with the async result. The test completes after the result handler is invoked and does not fails.
When the returned handler is called back with a failed result it fails the test with the cause of the failure.
Note that the result handler can create other async objects during its invocation that would postpone
the completion of the test case until those objects are resolved.resultHandler
- the result handler<T> Handler<AsyncResult<T>> asyncAssertFailure()
<T> Handler<AsyncResult<T>> asyncAssertFailure(Handler<Throwable> causeHandler)
causeHandler
- the cause handlerCopyright © 2021 Eclipse. All rights reserved.