com.google.appengine.tools.admin
Class Application

java.lang.Object
  extended by com.google.appengine.tools.admin.Application

public class Application
extends java.lang.Object

An App Engine application. You can read an Application from a path, and create an AppAdmin to upload, create indexes, or otherwise manage it.


Method Summary
 void cleanStagingDirectory()
          deletes the staging directory, if one was created.
 AppEngineWebXml getAppEngineWebXml()
          Returns the AppEngineWebXml describing the application.
 java.lang.String getAppId()
          Returns the application identifier, from the AppEngineWebXml config
 CronXml getCronXml()
          Returns the CronXml describing the applications' cron jobs.
 IndexesXml getIndexesXml()
          Returns the CronXml describing the applications' cron jobs.
 java.lang.String getPath()
          Returns a path to an exploded WAR directory for the application.
 QueueXml getQueueXml()
          Returns the QueueXml describing the applications' task queues.
 java.io.File getStagingDir()
          Returns the staging directory, or null if none has been created.
 java.lang.String getVersion()
          Returns the application version, from the AppEngineWebXml config
 WebXml getWebXml()
          Returns the WebXml describing the applications' servlets and generic web application information.
static Application readApplication(java.lang.String path)
          Reads the App Engine application from path.
static void recursiveDelete(java.io.File dead)
          Recursive directory deletion.
 void statusUpdate(java.lang.String message)
           
 void statusUpdate(java.lang.String message, int amount)
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

readApplication

public static Application readApplication(java.lang.String path)
                                   throws java.io.IOException
Reads the App Engine application from path. The path may either be a WAR file or the root of an exploded WAR directory.

Parameters:
path - a not null path.
Throws:
java.io.IOException - if an error occurs while trying to read the Application
com.google.apphosting.utils.config.AppEngineConfigException - if the Application's appengine-web.xml file is malformed.

getAppId

public java.lang.String getAppId()
Returns the application identifier, from the AppEngineWebXml config

Returns:
application identifier

getVersion

public java.lang.String getVersion()
Returns the application version, from the AppEngineWebXml config

Returns:
application version

getAppEngineWebXml

public AppEngineWebXml getAppEngineWebXml()
Returns the AppEngineWebXml describing the application.

Returns:
a not null deployment descriptor

getCronXml

public CronXml getCronXml()
Returns the CronXml describing the applications' cron jobs.

Returns:
a cron descriptor, possibly empty or null

getQueueXml

public QueueXml getQueueXml()
Returns the QueueXml describing the applications' task queues.

Returns:
a queue descriptor, possibly empty or null

getIndexesXml

public IndexesXml getIndexesXml()
Returns the CronXml describing the applications' cron jobs.

Returns:
a cron descriptor, possibly empty or null

getWebXml

public WebXml getWebXml()
Returns the WebXml describing the applications' servlets and generic web application information.

Returns:
a WebXml descriptor, possibly empty but not null

getPath

public java.lang.String getPath()
Returns a path to an exploded WAR directory for the application. This may be a temporary directory.

Returns:
a not null path pointing to a directory

getStagingDir

public java.io.File getStagingDir()
Returns the staging directory, or null if none has been created.


cleanStagingDirectory

public void cleanStagingDirectory()
deletes the staging directory, if one was created.


recursiveDelete

public static void recursiveDelete(java.io.File dead)
Recursive directory deletion.


statusUpdate

public void statusUpdate(java.lang.String message,
                         int amount)

statusUpdate

public void statusUpdate(java.lang.String message)