Package spock.lang
Class Specification
java.lang.Object
org.spockframework.lang.SpecInternals
spock.lang.MockingApi
spock.lang.Specification
Base class for Spock specifications. All specifications must inherit from
this class, either directly or indirectly.
- Author:
- Peter Niederwieser
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
Specifies that no exception should be thrown, failing with aUnallowedExceptionThrownError
otherwise.void
Specifies that no exception of the given type should be thrown, failing with aUnallowedExceptionThrownError
otherwise.<T> T
old
(T expression) Used in a then-block to access an expression's value at the time just before the previous where-block was entered.<T extends Throwable>
Tthrown()
Specifies that the preceding when block should throw an exception.<T extends Throwable>
TSpecifies that the preceding when block should throw an exception of the given type.void
Methods inherited from class spock.lang.MockingApi
GroovyMock, GroovyMock, GroovyMock, GroovyMock, GroovyMock, GroovyMock, GroovyMock, GroovyMock, GroovySpy, GroovySpy, GroovySpy, GroovySpy, GroovySpy, GroovySpy, GroovySpy, GroovySpy, GroovyStub, GroovyStub, GroovyStub, GroovyStub, GroovyStub, GroovyStub, GroovyStub, GroovyStub, interaction, Mock, Mock, Mock, Mock, Mock, Mock, Mock, Mock, Spy, Spy, Spy, Spy, Spy, Spy, Spy, Spy, Stub, Stub, Stub, Stub, Stub, Stub, Stub, Stub
Methods inherited from class org.spockframework.lang.SpecInternals
createMock, getSpecificationContext
-
Field Details
-
_
The wildcard symbol. Used in several places as a don't care value:- Mock interactions Example: 1 * foo.bar(_)
- Data parameterizations Example: [foo, _] << loadDataFromDb()
-
-
Constructor Details
-
Specification
public Specification()
-
-
Method Details
-
thrown
Specifies that the preceding when block should throw an exception. May only occur as the initializer expression of a typed variable declaration in a then block; the expected exception type is inferred from the variable type.This form of exception condition is typically used if the thrown exception instance is used in subsequent conditions.
Example:
when: "".charAt(0) then: IndexOutOfBoundsException e = thrown() e.message.contains(...)
- Returns:
- the thrown exception instance
-
thrown
Specifies that the preceding when block should throw an exception of the given type. May only occur in a then block.This form of exception condition is typically used if the thrown exception instance is not used in subsequent conditions.
Example:
when: "".charAt(0) then: thrown(IndexOutOfBoundsException)
- Type Parameters:
T
- the expected exception type- Parameters:
type
- the expected exception type- Returns:
- the thrown exception instance
-
notThrown
Specifies that no exception of the given type should be thrown, failing with aUnallowedExceptionThrownError
otherwise.- Parameters:
type
- the exception type that should not be thrown
-
noExceptionThrown
public void noExceptionThrown()Specifies that no exception should be thrown, failing with aUnallowedExceptionThrownError
otherwise. -
old
public <T> T old(T expression) Used in a then-block to access an expression's value at the time just before the previous where-block was entered.- Type Parameters:
T
- the expression's type- Parameters:
expression
- an arbitrary expression, except that it may not reference variables defined in the then-block- Returns:
- the expression's value at the time the previous where-block was entered
-
with
-