T
- the type of object this condition accepts.public abstract class Condition<T> extends Object implements Descriptable<Condition<T>>
Constructor and Description |
---|
Condition()
Creates a new
Condition . |
Condition(Description description)
Creates a new
Condition . |
Condition(String description)
Creates a new
Condition . |
Modifier and Type | Method and Description |
---|---|
Condition<T> |
as(Description newDescription)
Sets the description of the assertion that is going to be called after.
|
Condition<T> |
as(String newDescription,
Object... args)
Sets the description of the assertion that is going to be called after.
|
Condition<T> |
describedAs(Description newDescription)
Sets the description of the assertion that is going to be called after.
|
Condition<T> |
describedAs(String newDescription,
Object... args)
Sets the description of the assertion that is going to be called after.
|
Description |
description()
Returns the description of this condition.
|
abstract boolean |
matches(T value)
Verifies that the given value satisfies this condition.
|
String |
toString() |
public Condition()
Condition
. The default description of this condition will the simple name of the
condition's class.public Condition(String description)
Condition
.description
- the description of this condition.NullPointerException
- if the given description is null
.public Condition(Description description)
Condition
.description
- the description of this condition.NullPointerException
- if the given description is null
.public Condition<T> describedAs(String newDescription, Object... args)
You must set it before calling the assertion otherwise it is ignored as the failing assertion breaks the chained call by throwing an AssertionError.
Alias for
since "as" is a keyword in Groovy.Descriptable.as(String, Object...)
describedAs
in interface Descriptable<Condition<T>>
newDescription
- the new description to set.this
object.public Condition<T> as(String newDescription, Object... args)
You must set it before calling the assertion otherwise it is ignored as the failing assertion breaks the chained call by throwing an AssertionError.
The description follows String.format(String, Object...)
syntax.
Example :
try {
// set a bad age to Mr Frodo which is really 33 years old.
frodo.setAge(50);
// specify a test description (call as() before the assertion !), it supports String format syntax.
assertThat(frodo.getAge()).as("check %s's age", frodo.getName()).isEqualTo(33);
} catch (AssertionError e) {
assertThat(e).hasMessage("[check Frodo's age] expected:<[33]> but was:<[50]>");
}
as
in interface Descriptable<Condition<T>>
newDescription
- the new description to set.args
- optional parameter if description is a format String.this
object.Descriptable.describedAs(String, Object...)
public Condition<T> describedAs(Description newDescription)
You must set it before calling the assertion otherwise it is ignored as the failing assertion breaks the chained call by throwing an AssertionError.
This overloaded version of "describedAs" offers more flexibility than the one taking a String
by allowing
users to pass their own implementation of a description. For example, a description that creates its value lazily,
only when an assertion failure occurs.
describedAs
in interface Descriptable<Condition<T>>
newDescription
- the new description to set.this
object.public Condition<T> as(Description newDescription)
You must set it before calling the assertion otherwise it is ignored as the failing assertion breaks the chained call by throwing an AssertionError.
This overloaded version of "describedAs" offers more flexibility than the one taking a String
by allowing
users to pass their own implementation of a description. For example, a description that creates its value lazily,
only when an assertion failure occurs.
as
in interface Descriptable<Condition<T>>
newDescription
- the new description to set.this
object.Descriptable.describedAs(Description)
public Description description()
public abstract boolean matches(T value)
value
- the value to verify.true
if the given value satisfies this condition; false
otherwise.Copyright © 2013–2016 AssertJ. All rights reserved.