grails.plugin.spock
[Groovy] Class UnitSpec

java.lang.Object
  spock.lang.Specification
      grails.plugin.spock.UnitSpec

class UnitSpec
extends Specification

Support class for writing unit tests in Grails. It mainly provides access to various mocking options, while making sure that the meta- class magic does not leak outside of a single test.

errorsMap

protected java.lang.Object errorsMap

domainClassesInfo

DefaultArtefactInfo domainClassesInfo

Keeps track of the domain classes mocked within a single test so that the relationships can be configured for cascading validation.

addConverters

protected void addConverters(java.lang.Class clazz)

cleanup

java.lang.Object cleanup()

cleanupSpec

java.lang.Object cleanupSpec()

enableCascadingValidation

protected void enableCascadingValidation()

Enables the cascading validation support for domain classes. This should be called after all the relevant domain classes have been mocked.

loadCodec

protected void loadCodec(java.lang.Class codecClass)

Loads the given codec, adding the "encodeAs...()" and "decode...()" methods to objects.

Parameters:

codecClass - The codec to load, e.g. HTMLCodec.

mockConfig

protected java.lang.Object mockConfig(java.lang.String config)

mockController

protected java.lang.Object mockController(java.lang.Class controllerClass)

Mocks a controller class, providing implementations of standard methods like render and redirect

mockDomain

protected java.lang.Object mockDomain(java.lang.Class domainClass, java.util.List instances = [])

Mocks a domain class, providing working implementations of the standard dynamic methods. A list of domain instances can be provided as a source of data for the methods, in particular the queries.

Parameters:

domainClass - The class to mock.

instances - An optional list of domain instances to use as the data backing the dynamic methods.

mockFor

protected GrailsMock mockFor(java.lang.Class clazz, boolean loose = false)

Creates a new Grails mock for the given class. Use it as you would use MockFor and StubFor.

Parameters:

clazz - The class to mock.

loose - If true, the method returns a loose- expectation mock, otherwise it returns a strict one. The default is a strict mock.

mockForConstraintsTests

protected void mockForConstraintsTests(java.lang.Class clazz, java.util.List instances = [])

Mocks the given class (either a domain class or a command object) so that a "validate()" method is added. This can then be used to test the constraints on the class.

mockLogging

protected java.lang.Object mockLogging(java.lang.Class clazz, boolean enableDebug = false)

Provides a mock implementation of the "log" property for the given class. By default, debug and trace levels are ignored but you can enable printing of debug statements via the enableDebug argument.

Parameters:

clazz - The class to add the log method to.

enableDebug - An optional flag to switch on printing of debug statements.

mockTagLib

protected java.lang.Object mockTagLib(java.lang.Class tagLibClass)

Mocks a tag library, providing the common web properties as well as "out", "throwTagError()", and an implementation of the "render" tag.

registerMetaClass

protected void registerMetaClass(java.lang.Class clazz)

Use this method when you plan to perform some meta-programming on a class. It ensures that any modifications you make will be cleared at the end of the test.

Parameters:

clazz - The class to register.

setup

java.lang.Object setup()

setupSpec

java.lang.Object setupSpec()

Groovy Documentation