com.google.gwt.junit

Class RunStyle

java.lang.Object

com.google.gwt.junit.RunStyle

Direct Known Subclasses:

RunStyleHtmlUnit, RunStyleSelenium

public abstract class RunStyle
extends Object

An abstract class that handles the details of launching a browser.

Field Summary

Fields

Modifier and Type	Field and Description
protected JUnitShell	shell The containing shell.

Constructor Summary

Constructors

Constructor and Description
RunStyle(JUnitShell shell) Constructor for RunStyle.

Method Summary

Modifier and Type	Method and Description
String[]	getInterruptedHosts() Tests whether the test was interrupted.
String	getLocalHostName() Get the host name of the local system to use in URLs.
protected com.google.gwt.core.ext.TreeLogger	getLogger() Gets the shell logger.
Set<Platform>	getPlatforms() Returns the platforms specific to this run style.
int	getTries() Returns the number of times this test should be tried to run.
Set<String>	getUserAgents() Returns user agents for this run style.
abstract int	initialize(String args) Initialize the runstyle with any supplied arguments, and return the number of clients this runstyle controls.
abstract void	launchModule(String moduleName) Requests initial launch of the browser.
void	setTries(int tries) Sets the number of times a test should be tried -- it succeeds if any attempt succeeds.
boolean	setupMode(com.google.gwt.core.ext.TreeLogger logger, boolean developmentMode) Setup this RunStyle for the selected mode.
void	setUserAgents(Set<String> userAgents) Sets the associated user agents for this run style.
boolean	shouldAutoGenerateResources() Whether the embedded server should ever generate resources.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Field Detail

shell

protected final JUnitShell shell

The containing shell.

Constructor Detail

RunStyle

public RunStyle(JUnitShell shell)

Constructor for RunStyle. Any subclass must provide a constructor with the same signature since this will be how the RunStyle is created via reflection.

Parameters:

shell - the containing shell

Method Detail

getInterruptedHosts

public String[] getInterruptedHosts()

Tests whether the test was interrupted.

Returns:

the interrupted hosts, or null if not interrupted

getLocalHostName

public String getLocalHostName()

Get the host name of the local system to use in URLs. This method returns the host address instead of the host name in case the test target cannot resolve the host name.

Returns:

the host name of the local system

getPlatforms

public Set<Platform> getPlatforms()

Returns the platforms specific to this run style.

getUserAgents

public Set<String> getUserAgents()

Returns user agents for this run style.

Returns:

the user agents, or null if unknown

getTries

public int getTries()

Returns the number of times this test should be tried to run. A test succeeds if it succeeds even once.

Returns:

the number of attempts

initialize

public abstract int initialize(String args)

Initialize the runstyle with any supplied arguments, and return the number of clients this runstyle controls.

Parameters:

args - arguments passed in -runStyle option, null if none supplied

Returns:

the number of clients, or -1 if initialization was unsuccessful

launchModule

public abstract void launchModule(String moduleName)
                           throws com.google.gwt.core.ext.UnableToCompleteException

Requests initial launch of the browser. This should only be called once per instance of RunStyle.

Parameters:

moduleName - the module to run

Throws:

com.google.gwt.core.ext.UnableToCompleteException

setTries

public void setTries(int tries)

Sets the number of times a test should be tried -- it succeeds if any attempt succeeds.

Parameters:

tries - number of attempts

setUserAgents

public void setUserAgents(Set<String> userAgents)

Sets the associated user agents for this run style.

setupMode

public boolean setupMode(com.google.gwt.core.ext.TreeLogger logger,
                         boolean developmentMode)

Setup this RunStyle for the selected mode.

Parameters:

logger - TreeLogger to use for any messages

developmentMode - true if we are running in development mode rather that web/production mode

Returns:

false if we should abort processing due to an unsupported mode or an error setting up for that mode

shouldAutoGenerateResources

public boolean shouldAutoGenerateResources()

Whether the embedded server should ever generate resources. Development mode needs this, but not with -noserver.

Returns:

true if resources should be automatically generated by the server.

getLogger

protected com.google.gwt.core.ext.TreeLogger getLogger()

Gets the shell logger.