com.google.appengine.tools.admin
Class AppAdminFactory

java.lang.Object
  com.google.appengine.tools.admin.AppAdminFactory

public class AppAdminFactory
extends java.lang.Object

Creates a new AppAdmin for a designated App Engine application.

Nested Class Summary

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 Summary

AppAdminFactory()

Method Summary

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.
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	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	setJarSplittingEnabled(boolean doSplit) Enables or disables 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.

Methods inherited from class java.lang.Object

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

Constructor Detail

AppAdminFactory

public AppAdminFactory()

Method Detail

createAppAdmin

public 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.

Parameters:

options - The options used to connect to the remote server. Must not be null.

app - The application to be administered

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

Returns:

a not null AppAdmin

setAppVersionUploadClass

public void setAppVersionUploadClass(java.lang.Class<? extends com.google.appengine.tools.admin.AppVersionUpload> klass)

Sets the class used for uploading the application to the server. Should only be used for advanced customization of the upload process.

setJavaExecutable

public void setJavaExecutable(java.io.File java)

Specifies the location of a java executable, used when compiling JSPs. By default, the system property 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.

Parameters:

java - the Java executable to be used.

setJavaCompiler

public void setJavaCompiler(java.io.File javac)

Specifies the location of a javac executable, used when compiling JSPs. By default, the system property 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.

Parameters:

javac - the Java compiler executable to be used.

setCompileJsps

public void setCompileJsps(boolean flag)

Requests that *.jsp files should be compiled into Java byte code, or if false should be left untouched.

Parameters:

doJsps - true to compile .jsp files

setJarSplittingEnabled

public void setJarSplittingEnabled(boolean doSplit)

Enables or disables jar splitting.

Parameters:

doSplit - false to leave jars unsplit, and perhaps fail to upload due to large files, true to split into chunks of some uploadable size.

setCompileEncoding

public void setCompileEncoding(java.lang.String compileEncoding)

Sets the character encoding to use when compiling JSP files.

Throws:

java.lang.IllegalArgumentException - If the specified encoding is illegal or not supported.