public class DevAppServerFactory
extends java.lang.Object
DevAppServers
which can be used to launch
web applications.
TODO(maxr): Describe the difference between standalone and testing servers.Constructor and Description |
---|
DevAppServerFactory() |
Modifier and Type | Method and Description |
---|---|
DevAppServer |
createDevAppServer(java.io.File appDir,
java.io.File webXmlLocation,
java.io.File appEngineWebXmlLocation,
java.lang.String address,
int port,
boolean useCustomStreamHandler,
boolean installSecurityManager,
java.util.Collection<java.net.URL> classpath)
Creates a new
DevAppServer with a custom classpath for the web
app. |
DevAppServer |
createDevAppServer(java.io.File appDir,
java.io.File webXmlLocation,
java.io.File appEngineWebXmlLocation,
java.lang.String address,
int port,
boolean useCustomStreamHandler,
boolean installSecurityManager,
java.util.Collection<java.net.URL> classpath,
boolean noJavaAgent)
Creates a new
DevAppServer with a custom classpath for the web
app. |
DevAppServer |
createDevAppServer(java.io.File appDir,
java.io.File externalResourceDir,
java.lang.String address,
int port)
Creates a new
DevAppServer ready to start serving. |
DevAppServer |
createDevAppServer(java.io.File appDir,
java.io.File externalResourceDir,
java.lang.String address,
int port,
boolean noJavaAgent)
Creates a new
DevAppServer ready to start serving. |
DevAppServer |
createDevAppServer(java.io.File appDir,
java.lang.String address,
int port)
Creates a new
DevAppServer ready to start serving. |
public DevAppServer createDevAppServer(java.io.File appDir, java.lang.String address, int port)
DevAppServer
ready to start serving.appDir
- The top-level directory of the web application to be runaddress
- Address to bind toport
- Port to bind toDevAppServer
public DevAppServer createDevAppServer(java.io.File appDir, java.io.File externalResourceDir, java.lang.String address, int port)
DevAppServer
ready to start serving.appDir
- The top-level directory of the web application to be runexternalResourceDir
- If not null
, a resource directory external to the appDir.
This will be searched before appDir when looking for resources.address
- Address to bind toport
- Port to bind toDevAppServer
public DevAppServer createDevAppServer(java.io.File appDir, java.io.File externalResourceDir, java.lang.String address, int port, boolean noJavaAgent)
DevAppServer
ready to start serving.appDir
- The top-level directory of the web application to be runexternalResourceDir
- If not null
, a resource directory external to the appDir.
This will be searched before appDir when looking for resources.address
- Address to bind toport
- Port to bind tonoJavaAgent
- whether to disable detection of the Java agent or notDevAppServer
public DevAppServer createDevAppServer(java.io.File appDir, java.io.File webXmlLocation, java.io.File appEngineWebXmlLocation, java.lang.String address, int port, boolean useCustomStreamHandler, boolean installSecurityManager, java.util.Collection<java.net.URL> classpath)
DevAppServer
with a custom classpath for the web
app.appDir
- The top-level directory of the web application to be runwebXmlLocation
- The location of a file whose format complies with
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd. If null
,
defaults to appEngineWebXmlLocation
- The name of the app engine config file. If
null
, defaults to address
- Address to bind toport
- Port to bind touseCustomStreamHandler
- If true
, install
StreamHandlerFactory
. This is "normal" behavior for the dev
app server but tests may want to disable this since there are some
compatibility issues with our custom handler and Selenium.installSecurityManager
- Whether or not to install the dev appserver
security manager. It is strongly recommended you pass true
unless
there is something in your test environment that prevents you from
installing a security manager.classpath
- The classpath of the test and all its dependencies
(possibly the entire app).DevAppServer
public DevAppServer createDevAppServer(java.io.File appDir, java.io.File webXmlLocation, java.io.File appEngineWebXmlLocation, java.lang.String address, int port, boolean useCustomStreamHandler, boolean installSecurityManager, java.util.Collection<java.net.URL> classpath, boolean noJavaAgent)
DevAppServer
with a custom classpath for the web
app.appDir
- The top-level directory of the web application to be runwebXmlLocation
- The location of a file whose format complies with
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd. If null
,
defaults to appEngineWebXmlLocation
- The name of the app engine config file. If
null
, defaults to address
- Address to bind toport
- Port to bind touseCustomStreamHandler
- If true
, install
StreamHandlerFactory
. This is "normal" behavior for the dev
app server but tests may want to disable this since there are some
compatibility issues with our custom handler and Selenium.installSecurityManager
- Whether or not to install the dev appserver
security manager. It is strongly recommended you pass true
unless
there is something in your test environment that prevents you from
installing a security manager.classpath
- The classpath of the test and all its dependencies
(possibly the entire app).noJavaAgent
- whether to disable detection of the Java agent or notDevAppServer