com.google.gwt.junit

Class JUnitShell

java.lang.Object

com.google.gwt.dev.DevModeBase

com.google.gwt.dev.DevMode

com.google.gwt.junit.JUnitShell

All Implemented Interfaces:

com.google.gwt.dev.ui.DoneCallback, com.google.gwt.dev.ui.RestartServerCallback, com.google.gwt.dev.ui.UiCallback

public class JUnitShell
extends com.google.gwt.dev.DevMode

This class is responsible for hosting JUnit test case execution. There are three main pieces to the JUnit system.

• Test environment
• Client classes
• Server classes

The test environment consists of this class and the non-translatable version of GWTTestCase. These two classes integrate directly into the real JUnit test process.

The client classes consist of the translatable version of GWTTestCase, translatable JUnit classes, and the user's own GWTTestCase-derived class. The client communicates to the server via RPC.

The server consists of com.google.gwt.junit.server.JUnitHostImpl, an RPC servlet which communicates back to the test environment through a JUnitMessageQueue, thus closing the loop.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	JUnitShell.Strategy A strategy for running the test.

Nested classes/interfaces inherited from class com.google.gwt.dev.DevMode

com.google.gwt.dev.DevMode.ArgHandlerServer, com.google.gwt.dev.DevMode.ArgHandlerStartupURLs, com.google.gwt.dev.DevMode.HostedModeOptions, com.google.gwt.dev.DevMode.HostedModeOptionsImpl

Nested classes/interfaces inherited from class com.google.gwt.dev.DevModeBase

com.google.gwt.dev.DevModeBase.ArgHandlerBindAddress, com.google.gwt.dev.DevModeBase.ArgHandlerBlacklist, com.google.gwt.dev.DevModeBase.ArgHandlerCodeServerPort, com.google.gwt.dev.DevModeBase.ArgHandlerLogDir, com.google.gwt.dev.DevModeBase.ArgHandlerNoServerFlag, com.google.gwt.dev.DevModeBase.ArgHandlerPort, com.google.gwt.dev.DevModeBase.ArgHandlerRemoteUI, com.google.gwt.dev.DevModeBase.ArgHandlerWhitelist, com.google.gwt.dev.DevModeBase.HostedModeBaseOptions, com.google.gwt.dev.DevModeBase.HostedModeBaseOptionsImpl, com.google.gwt.dev.DevModeBase.OptionBindAddress, com.google.gwt.dev.DevModeBase.OptionCodeServerPort, com.google.gwt.dev.DevModeBase.OptionLogDir, com.google.gwt.dev.DevModeBase.OptionNoServer, com.google.gwt.dev.DevModeBase.OptionPort, com.google.gwt.dev.DevModeBase.OptionRemoteUI, com.google.gwt.dev.DevModeBase.OptionStartupURLs, com.google.gwt.dev.DevModeBase.UiBrowserWidgetHostImpl

Field Summary

Fields inherited from class com.google.gwt.dev.DevMode

options

Fields inherited from class com.google.gwt.dev.DevModeBase

baseLogLevelForUI, bindAddress, codeServerPort, connectAddress, isHttps, listener, ui

Method Summary

Methods

Modifier and Type	Method and Description
protected long	checkForUpdatesInterval() Check for updates once a minute.
protected boolean	doStartup()
protected void	ensureCodeServerListener()
static com.google.gwt.junit.JUnitMessageQueue	getMessageQueue() Called by com.google.gwt.junit.server.JUnitHostImpl to get an interface into the test process.
String	getModuleUrl(String moduleName)
static String[]	getRemoteUserAgents() Get the list of remote user agents to compile.
protected void	inferStartupUrls()
protected com.google.gwt.dev.cfg.ModuleDef	loadModule(com.google.gwt.core.ext.TreeLogger logger, String moduleName, boolean refresh)
static boolean	mustNotExecuteTest(com.google.gwt.junit.client.impl.JUnitHost.TestInfo testInfo) Checks if a testCase should not be executed.
protected boolean	notDone() Checks to see if this test run is complete.
static void	runTest(com.google.gwt.junit.client.GWTTestCase testCase, junit.framework.TestResult testResult) Entry point for GWTTestCase.
static void	runTest(String moduleName, junit.framework.TestCase testCase, junit.framework.TestResult testResult) Deprecated. use runTest(GWTTestCase, TestResult) instead
static void	runTest(String moduleName, junit.framework.TestCase testCase, junit.framework.TestResult testResult, JUnitShell.Strategy strategy) Deprecated. use runTest(GWTTestCase, TestResult) instead
protected void	warnAboutNoStartupUrls()

Methods inherited from class com.google.gwt.dev.DevMode

createOptions, doShutDownServer, doSlowStartup, doStartUpServer, getWebServerName, main, onRestartServer, produceOutput

Methods inherited from class com.google.gwt.dev.DevModeBase

addStartupURL, doCreateShellModuleSpaceHost, doStartup, getBaseLogLevelForUI, getHost, getPort, getTopLogger, isHeadless, link, normalizeURL, onDone, processUrl, randomString, run, setDone, setHeadless, setPort, setRunTomcat, shutDown, startUp

Methods inherited from class java.lang.Object

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

Method Detail

getMessageQueue

public static com.google.gwt.junit.JUnitMessageQueue getMessageQueue()

Called by com.google.gwt.junit.server.JUnitHostImpl to get an interface into the test process.

Returns:

The JUnitMessageQueue interface that belongs to the singleton JUnitShell, or null if no such singleton exists.

getRemoteUserAgents

public static String[] getRemoteUserAgents()

Get the list of remote user agents to compile. This method returns null until all clients have connected.

Returns:

the list of remote user agents

mustNotExecuteTest

public static boolean mustNotExecuteTest(com.google.gwt.junit.client.impl.JUnitHost.TestInfo testInfo)

Checks if a testCase should not be executed. Currently, a test is either executed on all clients (mentioned in this test) or on no clients.

Parameters:

testInfo - the test info to check

Returns:

true iff the test should not be executed on any of the specified clients.

runTest

public static void runTest(com.google.gwt.junit.client.GWTTestCase testCase,
           junit.framework.TestResult testResult)
                    throws com.google.gwt.core.ext.UnableToCompleteException

Entry point for GWTTestCase. Gets or creates the singleton JUnitShell and invokes its runTestImpl(GWTTestCase, TestResult).

Throws:

com.google.gwt.core.ext.UnableToCompleteException

runTest

@Deprecated
public static void runTest(String moduleName,
                      junit.framework.TestCase testCase,
                      junit.framework.TestResult testResult)
                    throws com.google.gwt.core.ext.UnableToCompleteException

Deprecated. use runTest(GWTTestCase, TestResult) instead

Entry point for GWTTestCase. Gets or creates the singleton JUnitShell and invokes its runTestImpl(GWTTestCase, TestResult).

Throws:

com.google.gwt.core.ext.UnableToCompleteException

runTest

@Deprecated
public static void runTest(String moduleName,
                      junit.framework.TestCase testCase,
                      junit.framework.TestResult testResult,
                      JUnitShell.Strategy strategy)
                    throws com.google.gwt.core.ext.UnableToCompleteException

Deprecated. use runTest(GWTTestCase, TestResult) instead

Throws:

com.google.gwt.core.ext.UnableToCompleteException

getModuleUrl

public String getModuleUrl(String moduleName)

checkForUpdatesInterval

protected long checkForUpdatesInterval()

Check for updates once a minute.

Overrides:

checkForUpdatesInterval in class com.google.gwt.dev.DevModeBase

doStartup

protected boolean doStartup()

Overrides:

doStartup in class com.google.gwt.dev.DevMode

ensureCodeServerListener

protected void ensureCodeServerListener()

Overrides:

ensureCodeServerListener in class com.google.gwt.dev.DevModeBase

inferStartupUrls

protected void inferStartupUrls()

Overrides:

inferStartupUrls in class com.google.gwt.dev.DevMode

loadModule

protected com.google.gwt.dev.cfg.ModuleDef loadModule(com.google.gwt.core.ext.TreeLogger logger,
                                          String moduleName,
                                          boolean refresh)
                                               throws com.google.gwt.core.ext.UnableToCompleteException

Overrides:

loadModule in class com.google.gwt.dev.DevMode

Throws:

com.google.gwt.core.ext.UnableToCompleteException

notDone

protected boolean notDone()

Checks to see if this test run is complete.

warnAboutNoStartupUrls

protected void warnAboutNoStartupUrls()

Overrides:

warnAboutNoStartupUrls in class com.google.gwt.dev.DevMode