public class AppAdminFactory
extends java.lang.Object
AppAdmin for a designated App Engine application.| Modifier and Type | Class and Description |
|---|---|
static class |
AppAdminFactory.ApplicationProcessingOptions
Options used in preparing an application directory for upload.
|
static class |
AppAdminFactory.ConnectOptions
The options used to connect to the remote App Engine administration server.
|
static interface |
AppAdminFactory.PasswordPrompt
Callback that is invoked to prompt the user to enter a password.
|
| Constructor and Description |
|---|
AppAdminFactory() |
| Modifier and Type | Method and Description |
|---|---|
AppAdmin |
createAppAdmin(AppAdminFactory.ConnectOptions options,
Application app,
java.io.PrintWriter errorWriter)
Creates a new
AppAdmin that can be used to administer the
designated App Engine application. |
AppAdmin |
createAppAdmin(AppAdminFactory.ConnectOptions options,
com.google.appengine.tools.admin.GenericApplication app,
java.io.PrintWriter errorWriter)
Creates a new
AppAdmin that can be used to administer the
designated App Engine application. |
AppAdminFactory.ApplicationProcessingOptions |
getAppOptions() |
java.lang.Class<? extends com.google.appengine.tools.admin.AppVersionUpload> |
getAppVersionUploadClass() |
void |
setAllowAnyRuntime(boolean allowAnyRuntime)
Enables or disables validation of the runtime id provided by the user.
|
void |
setAppVersionUploadClass(java.lang.Class<? extends com.google.appengine.tools.admin.AppVersionUpload> klass)
Sets the class used for uploading the application to the server.
|
void |
setBatchMode(boolean flag)
Requests we do upload using batch
*
|
void |
setCompileEncoding(java.lang.String compileEncoding)
Sets the character encoding to use when compiling JSP files.
|
void |
setCompileJsps(boolean flag)
Requests that *.jsp files should be compiled into Java byte code, or if
false should be left untouched.
|
void |
setDeleteJSPs(boolean deleteJSPs)
Deletes or not the JSPs source files.
|
void |
setFailOnPrecompilationError(boolean fail)
Enables or disables treating (repeated) precompilation errors as fatal when
updating an application.
|
void |
setJarClassessEnabled(boolean doJarClasses)
Enables or disables jarring WEB-INF/classes content.
|
void |
setJarJSPsEnabled(boolean doJarJSPs)
Enables or disables jarring classes generated from JSPs.
|
void |
setJarSplittingEnabled(boolean doSplit)
Enables or disables jar splitting.
|
void |
setJarSplittingExcludes(java.util.Set<java.lang.String> jarSplittingExcludeSuffixes)
Sets suffixes for files to exclude when performing jar splitting.
|
void |
setJavaCompiler(java.io.File javac)
Specifies the location of a javac executable, used when compiling JSPs.
|
void |
setJavaExecutable(java.io.File java)
Specifies the location of a java executable, used when compiling JSPs.
|
void |
setRuntime(java.lang.String runtime)
Sets the runtime id to use in the generated app.yaml descriptor.
|
public AppAdmin createAppAdmin(AppAdminFactory.ConnectOptions options, Application app, java.io.PrintWriter errorWriter)
AppAdmin that can be used to administer the
designated App Engine application.options - The options used to connect to the remote server. Must not
be null.app - The application to be administered. May be null.errorWriter - A writer to which error logs can be written. The logs
can be used for diagnosis if a failure occurs during operation. May
be null.null AppAdminpublic AppAdmin createAppAdmin(AppAdminFactory.ConnectOptions options, com.google.appengine.tools.admin.GenericApplication app, java.io.PrintWriter errorWriter)
AppAdmin that can be used to administer the
designated App Engine application.options - The options used to connect to the remote server. Must not
be null.app - The application to be administered. May be null.errorWriter - A writer to which error logs can be written. The logs
can be used for diagnosis if a failure occurs during operation. May
be null.null AppAdminpublic AppAdminFactory.ApplicationProcessingOptions getAppOptions()
public java.lang.Class<? extends com.google.appengine.tools.admin.AppVersionUpload> getAppVersionUploadClass()
public void setAppVersionUploadClass(java.lang.Class<? extends com.google.appengine.tools.admin.AppVersionUpload> klass)
public void setJavaExecutable(java.io.File java)
java.home is used to identify the
currently-running JVM, and if that directory contains a file named bin/java (Unix) or bin\\java.exe (Windows), that is returned.java - the Java executable to be used.public void setJavaCompiler(java.io.File javac)
java.home is used to identify the
currently-running JVM. If that pathname ends with "jre", then its parent is
used instead as a hoped-for JDK root. If that directory contains a file
named bin/javac (Unix) or bin\\javac.exe (Windows), that is
returned.javac - the Java compiler executable to be used.public void setCompileJsps(boolean flag)
flag - true to compile .jsp filespublic void setBatchMode(boolean flag)
flag - true to use batch mode for uploadpublic void setJarSplittingEnabled(boolean doSplit)
doSplit - false to leave jars unsplit, and perhaps fail to
upload due to large files, true to split into chunks of some
uploadable size.public void setJarJSPsEnabled(boolean doJarJSPs)
doJarJSPs - true to jar the generated classes from JSPs.public void setJarClassessEnabled(boolean doJarClasses)
doJarClasses - true to jar the WEB-INF/classes content.public void setDeleteJSPs(boolean deleteJSPs)
deleteJSPs - true remove all JSPs source (not needed after compilation).public void setJarSplittingExcludes(java.util.Set<java.lang.String> jarSplittingExcludeSuffixes)
jarSplittingExcludeSuffixes - a set of filename suffixes to exclude
when performing jar splitting.public void setCompileEncoding(java.lang.String compileEncoding)
java.lang.IllegalArgumentException - If the specified encoding is illegal or
not supported.public void setRuntime(java.lang.String runtime)
runtime - the runtime id to use.public void setAllowAnyRuntime(boolean allowAnyRuntime)
allowAnyRuntime - true to allow an arbitrary runtime id value,
false to validate it against the list of supported runtimes.public void setFailOnPrecompilationError(boolean fail)
fail - true to abort an update if precompilation fails,
false to treat it as a warning and continue updating the application.