FixtureScripts

Provides the mechanism to execute FixtureScript s from the UI of a domain app; and can also be used within integration testing.

API

FixtureScripts.java

class FixtureScripts {
  // secman seeding
public static final String LOGICAL_TYPE_NAME;
  public static final String PACKAGE_PREFIX;     (1)
  FixtureScripts(FixtureScriptsSpecificationProvider fixtureScriptsSpecificationProvider, ServiceRegistry serviceRegistry)
  List<FixtureResult> runFixtureScript(String fixtureScriptName, String parameters)     (2)
  List<FixtureResult> runFixtureScript(FixtureScript fixtureScript, String parameters)
  boolean hideRunFixtureScript()
  String disableRunFixtureScript()
  String default0RunFixtureScript()
  Set<String> choices0RunFixtureScript()
  String validateRunFixtureScript(String fixtureScriptName, String parameters)
  Object recreateObjectsAndReturnFirst()     (3)
  boolean hideRecreateObjectsAndReturnFirst()
  void run(FixtureScript... fixtureScriptList)
  void runPersonas(PersonaWithBuilderScript<?, ? extends BuilderScriptAbstract<?>>... personaScripts)
  T runPersona(PersonaWithBuilderScript<T, ? extends BuilderScriptAbstract<? extends T>> persona)
  T runBuilder(BuilderScriptAbstract<T> builderScript)     (4)
  T runBuilderScriptNonTransactional(BuilderScriptAbstract<T> builderScript)     (5)
  String findFixtureScriptNameFor(Class<? extends FixtureScript> fixtureScriptClass)
  FixtureScript.ExecutionContext newExecutionContext(String parameters)
  String mementoFor(FixtureScript fs)
  void initOf(String xml, FixtureScript fs)
  FixtureResult newFixtureResult(FixtureScript script, String subkey, Object object, boolean firstTime)
  String titleOf(FixtureResult fixtureResult)
}

1	PACKAGE_PREFIX The package prefix to search for fixture scripts. This default value will result in no fixture scripts being found. However, normally it will be overridden.
2	runFixtureScript(String, String) Main action - as exposed in the UI - to execute the specified fixture script.
3	recreateObjectsAndReturnFirst() Convenience action - exposed through the UI - to execute the specified "recreate" FixtureScript and return/show the first object returned by that fixture script.
4	runBuilder(BuilderScriptAbstract) Runs the builderScript within its own transactional boundary.
5	runBuilderScriptNonTransactional(BuilderScriptAbstract) Runs the builderScript without its own transactional boundary.The caller is responsible to provide a transactional context/boundary.

Members

PACKAGE_PREFIX

The package prefix to search for fixture scripts. This default value will result in no fixture scripts being found. However, normally it will be overridden.

runFixtureScript(String, String)

Main action - as exposed in the UI - to execute the specified fixture script.

Also allows arbitrary parameters to be specified for said fixture script.

recreateObjectsAndReturnFirst()

Convenience action - exposed through the UI - to execute the specified "recreate" FixtureScript and return/show the first object returned by that fixture script.

runBuilder(BuilderScriptAbstract)

Runs the builderScript within its own transactional boundary.

runBuilderScriptNonTransactional(BuilderScriptAbstract)

Runs the builderScript without its own transactional boundary.The caller is responsible to provide a transactional context/boundary.

Configuration Properties

The configuration properties used by this domain service can be found in the relevant section of the config guide.