net.serenitybdd.screenplay

Class Actor

java.lang.Object

net.serenitybdd.screenplay.Actor

All Implemented Interfaces:

net.serenitybdd.core.SkipNested, PerformsTasks

public class Actor
extends java.lang.Object
implements PerformsTasks, net.serenitybdd.core.SkipNested

An actor represents the person or system using the application under test. Actors can have Abilities, which allows them to perform Tasks and Interactions.

Constructor Summary

Constructors

Constructor and Description
Actor(java.lang.String name)

Method Summary

Modifier and Type	Method and Description
<T extends Ability> T	abilityTo(java.lang.Class<? extends T> doSomething)
<ANSWER> ANSWER	asksFor(Question<ANSWER> question)
void	assignDescriptionToActor(java.lang.String description)
void	assignName(java.lang.String name)
void	attemptsTo(Performable... tasks)
void	can(Consequence... consequences)
<T extends Ability> Actor	can(T doSomething)
Actor	describedAs(java.lang.String description)
void	entersTheScene() A method used to declare that an actor is now the actor in the spotlight, without having them perform any tasks.
<T> T	gaveAsThe(java.lang.String key)
<C> C	getAbilityThatExtends(java.lang.Class<C> extendedClass) Return an ability that extends the given class.
java.lang.String	getDescription()
java.lang.String	getName()
java.lang.String	getNameOrPronoun()
java.util.List<HasTeardown>	getTeardowns() Return a list of all Abilitys which implement HasTeardown
void	has(Fact... facts)
void	has(Performable... todos)
static Actor	named(java.lang.String name)
<T> T	recall(java.lang.String key)
java.util.Map<java.lang.String,java.lang.Object>	recallAll()
void	remember(java.lang.String key, java.lang.Object value)
<ANSWER> void	remember(java.lang.String key, Question<ANSWER> question)
<T> T	sawAsThe(java.lang.String key)
void	should(Consequence... consequences)
void	should(java.lang.String groupStepName, Consequence... consequences)
java.lang.String	toString()
<T extends Ability> T	usingAbilityTo(java.lang.Class<? extends T> doSomething) A more readable way to access an actor's abilities.
Actor	usingPronoun(java.lang.String pronoun)
void	wasAbleTo(Performable... todos) A tense-neutral synonym for addFact() for use with given() clauses
<T extends Ability> Actor	whoCan(T doSomething)
Actor	withNoPronoun()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Actor

public Actor(java.lang.String name)

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

named

public static Actor named(java.lang.String name)

describedAs

public Actor describedAs(java.lang.String description)

getName

public java.lang.String getName()

getDescription

public java.lang.String getDescription()

getNameOrPronoun

public java.lang.String getNameOrPronoun()

can

public <T extends Ability> Actor can(T doSomething)

whoCan

public <T extends Ability> Actor whoCan(T doSomething)

abilityTo

public <T extends Ability> T abilityTo(java.lang.Class<? extends T> doSomething)

getAbilityThatExtends

public <C> C getAbilityThatExtends(java.lang.Class<C> extendedClass)

Return an ability that extends the given class. Can be a Superclass or an Interface. If there are multiple candidate Abilities, the first one found will be returned.

Type Parameters:

C - the matching Ability cast to extendedClass or null if none match

Parameters:

extendedClass - the Interface class that we expect to find

getTeardowns

public java.util.List<HasTeardown> getTeardowns()

Return a list of all Abilitys which implement HasTeardown

usingAbilityTo

public <T extends Ability> T usingAbilityTo(java.lang.Class<? extends T> doSomething)

A more readable way to access an actor's abilities.

entersTheScene

public final void entersTheScene()

A method used to declare that an actor is now the actor in the spotlight, without having them perform any tasks.

has

public final void has(Performable... todos)

has

public final void has(Fact... facts)

wasAbleTo

public final void wasAbleTo(Performable... todos)

A tense-neutral synonym for addFact() for use with given() clauses

attemptsTo

public final void attemptsTo(Performable... tasks)

Specified by:

attemptsTo in interface PerformsTasks

asksFor

public <ANSWER> ANSWER asksFor(Question<ANSWER> question)

Specified by:

asksFor in interface PerformsTasks

can

public final void can(Consequence... consequences)

should

public final void should(java.lang.String groupStepName,
                         Consequence... consequences)

should

public final void should(Consequence... consequences)

remember

public <ANSWER> void remember(java.lang.String key,
                              Question<ANSWER> question)

remember

public void remember(java.lang.String key,
                     java.lang.Object value)

recall

public <T> T recall(java.lang.String key)

recallAll

public java.util.Map<java.lang.String,java.lang.Object> recallAll()

sawAsThe

public <T> T sawAsThe(java.lang.String key)

gaveAsThe

public <T> T gaveAsThe(java.lang.String key)

usingPronoun

public Actor usingPronoun(java.lang.String pronoun)

withNoPronoun

public Actor withNoPronoun()

assignDescriptionToActor

public void assignDescriptionToActor(java.lang.String description)

assignName

public void assignName(java.lang.String name)