org.jbehave.core

Class ConfigurableEmbedder

java.lang.Object

org.jbehave.core.ConfigurableEmbedder

All Implemented Interfaces:

Embeddable

Direct Known Subclasses:

JUnitStories, JUnitStory, JUnitStoryMaps

public abstract class ConfigurableEmbedder
extends Object
implements Embeddable

Abstract implementation of Embeddable which allows to configure the Embedder used to run the stories, using the Configuration and the InjectableStepsFactory specified.

The instances of the Configuration and the InjectableStepsFactory can be provided either via the useConfiguration(Configuration) and useStepsFactory(InjectableStepsFactory) methods or overriding the configuration() and stepsFactory() methods.

If overriding the configuration() method and providing an InjectableStepsFactory which requires a Configuration, then care must be taken to avoid re-instantiating the Configuration. E.g.:

 
 public Configuration configuration() {
   if ( super.hasConfiguration() ){
     return super.configuration();
   }
   return new MostUsefulConfiguration()...;
 }
 

Note that no defaults are provided by this implementation. If no values are set by the subclasses, then null values are passed to the configured {@link Embedder}, which is responsible for setting the default values.

Typically, users that use JUnit will find it easier to extend other implementations, such as {@link JUnitStory} or {@link JUnitStories}, which implement the {@link#run()} using the configured {@link Embedder} and annotate it with JUnit's annotations.

Constructor Summary

Constructors

Constructor and Description
ConfigurableEmbedder()

Method Summary

Modifier and Type	Method and Description
void	addSteps(CandidateSteps... steps) Deprecated. Use useStepsFactory(InjectableStepsFactory)
void	addSteps(List<CandidateSteps> steps) Deprecated. Use useStepsFactory(InjectableStepsFactory)
List<CandidateSteps>	candidateSteps() Deprecated. Use stepsFactory()
Configuration	configuration()
Embedder	configuredEmbedder()
boolean	hasConfiguration()
boolean	hasStepsFactory()
InjectableStepsFactory	stepsFactory()
void	useConfiguration(Configuration configuration)
void	useEmbedder(Embedder embedder)
void	useStepsFactory(InjectableStepsFactory stepsFactory)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jbehave.core.Embeddable

run

Constructor Detail

ConfigurableEmbedder

public ConfigurableEmbedder()

Method Detail

useEmbedder

public void useEmbedder(Embedder embedder)

Specified by:

useEmbedder in interface Embeddable

useConfiguration

public void useConfiguration(Configuration configuration)

configuration

public Configuration configuration()

hasConfiguration

public boolean hasConfiguration()

addSteps

public void addSteps(CandidateSteps... steps)

Deprecated. Use useStepsFactory(InjectableStepsFactory)

addSteps

public void addSteps(List<CandidateSteps> steps)

Deprecated. Use useStepsFactory(InjectableStepsFactory)

candidateSteps

public List<CandidateSteps> candidateSteps()

Deprecated. Use stepsFactory()

useStepsFactory

public void useStepsFactory(InjectableStepsFactory stepsFactory)

stepsFactory

public InjectableStepsFactory stepsFactory()

hasStepsFactory

public boolean hasStepsFactory()

configuredEmbedder

public Embedder configuredEmbedder()