RubyGems - appengine-sdk - Versions diffs - 1.2.2 → 1.2.6 - Mend

appengine-sdk 1.2.2 → 1.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (251) hide show

data/{appengine-java-sdk-1.2.2 → appengine-java-sdk-1.2.6}/docs/tools/javadoc/com/google/appengine/tools/development/AbstractContainerService.html RENAMED Viewed

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:57 CDT 2009 -->
+<!-- Generated by javadoc (build 1.6.0-google-internal) on Wed Oct 07 12:27:20 CDT 2009 -->
 <TITLE>
 AbstractContainerService
 </TITLE>
-<META NAME="date" CONTENT="2009-07-12">
+<META NAME="date" CONTENT="2009-10-07">
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">
@@ -167,7 +167,7 @@ Common implementation for the <A HREF="../../../../../com/google/appengine/tools
           int&nbsp;port)</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set up the necessary configuration parameters.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets up the necessary configuration parameters.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -175,7 +175,8 @@ Common implementation for the <A HREF="../../../../../com/google/appengine/tools
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/AbstractContainerService.html#getAddress()">getAddress</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the listener network address, however it's decided during
+ the servlet container deployment.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -183,7 +184,7 @@ Common implementation for the <A HREF="../../../../../com/google/appengine/tools
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/AbstractContainerService.html#getAppDirectory()">getAppDirectory</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This allows us to recover the application directory from the container.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the root directory of the application.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -191,16 +192,8 @@ Common implementation for the <A HREF="../../../../../com/google/appengine/tools
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/AbstractContainerService.html#getPort()">getPort</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>&nbsp;java.security.Permissions</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/AbstractContainerService.html#getUserPermissions()">getUserPermissions</A></B>()</CODE>
-<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a <CODE>Permissions</CODE> object containing <CODE>UnresolvedPermission</CODE> instances for every
- permission that was requested by the user in their <code>appengine-web.xml</code> file.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the listener port number, however it's decided during the servlet
+ container deployment.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -208,7 +201,7 @@ Common implementation for the <A HREF="../../../../../com/google/appengine/tools
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/AbstractContainerService.html#setEnvironmentVariableMismatchSeverity(com.google.appengine.tools.development.ContainerService.EnvironmentVariableMismatchSeverity)">setEnvironmentVariableMismatchSeverity</A></B>(<A HREF="../../../../../com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html" title="enum in com.google.appengine.tools.development">ContainerService.EnvironmentVariableMismatchSeverity</A>&nbsp;val)</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Override the default EnvironmentVariableMismatchSeverity setting, to
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Overrides the default EnvironmentVariableMismatchSeverity setting, to
  disable exceptions during the testing.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
@@ -217,7 +210,7 @@ Common implementation for the <A HREF="../../../../../com/google/appengine/tools
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/AbstractContainerService.html#shutdown()">shutdown</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Shut down the servlet container.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Shuts down the servlet container.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -244,7 +237,7 @@ Common implementation for the <A HREF="../../../../../com/google/appengine/tools
 <TH ALIGN="left"><B>Methods inherited from interface com.google.appengine.tools.development.<A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html" title="interface in com.google.appengine.tools.development">ContainerService</A></B></TH>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getWebAppContext()">getWebAppContext</A></CODE></TD>
+<TD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAppContext()">getAppContext</A></CODE></TD>
 </TR>
 </TABLE>
 &nbsp;
@@ -288,7 +281,7 @@ public final void <B>configure</B>(java.lang.String&nbsp;devAppServerVersion,
                             int&nbsp;port)</PRE>
 <DL>
 <DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#configure(java.lang.String, java.io.File, java.lang.String, AppEngineWebXmlReader, java.lang.String, int)">ContainerService</A></CODE></B></DD>
-<DD>Set up the necessary configuration parameters.
+<DD>Sets up the necessary configuration parameters.
 <P>
 <DD><DL>
 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#configure(java.lang.String, java.io.File, java.lang.String, AppEngineWebXmlReader, java.lang.String, int)">configure</A></CODE> in interface <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html" title="interface in com.google.appengine.tools.development">ContainerService</A></CODE></DL>
@@ -330,7 +323,7 @@ public final void <B>shutdown</B>()
                     throws java.lang.Exception</PRE>
 <DL>
 <DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#shutdown()">ContainerService</A></CODE></B></DD>
-<DD>Shut down the servlet container.
+<DD>Shuts down the servlet container.
 <P>
 <DD><DL>
 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#shutdown()">shutdown</A></CODE> in interface <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html" title="interface in com.google.appengine.tools.development">ContainerService</A></CODE></DL>
@@ -348,13 +341,15 @@ getAddress</H3>
 <PRE>
 public java.lang.String <B>getAddress</B>()</PRE>
 <DL>
+<DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAddress()">ContainerService</A></CODE></B></DD>
+<DD>Returns the listener network address, however it's decided during
+ the servlet container deployment.
+<P>
 <DD><DL>
 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAddress()">getAddress</A></CODE> in interface <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html" title="interface in com.google.appengine.tools.development">ContainerService</A></CODE></DL>
 </DD>
 <DD><DL>
-<DT><B>Returns:</B><DD>the listener network address, however it's decided during
- the servlet container deployment.</DL>
+</DL>
 </DD>
 </DL>
 <HR>
@@ -365,7 +360,7 @@ getAppDirectory</H3>
 public java.io.File <B>getAppDirectory</B>()</PRE>
 <DL>
 <DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAppDirectory()">ContainerService</A></CODE></B></DD>
-<DD>This allows us to recover the application directory from the container.
+<DD>Returns the root directory of the application.
 <P>
 <DD><DL>
 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAppDirectory()">getAppDirectory</A></CODE> in interface <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html" title="interface in com.google.appengine.tools.development">ContainerService</A></CODE></DL>
@@ -381,13 +376,15 @@ getPort</H3>
 <PRE>
 public int <B>getPort</B>()</PRE>
 <DL>
+<DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getPort()">ContainerService</A></CODE></B></DD>
+<DD>Returns the listener port number, however it's decided during the servlet
+ container deployment.
+<P>
 <DD><DL>
 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getPort()">getPort</A></CODE> in interface <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html" title="interface in com.google.appengine.tools.development">ContainerService</A></CODE></DL>
 </DD>
 <DD><DL>
-<DT><B>Returns:</B><DD>the listener port number, however it's decided during the servlet
- container deployment.</DL>
+</DL>
 </DD>
 </DL>
 <HR>
@@ -398,7 +395,7 @@ setEnvironmentVariableMismatchSeverity</H3>
 public void <B>setEnvironmentVariableMismatchSeverity</B>(<A HREF="../../../../../com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html" title="enum in com.google.appengine.tools.development">ContainerService.EnvironmentVariableMismatchSeverity</A>&nbsp;val)</PRE>
 <DL>
 <DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#setEnvironmentVariableMismatchSeverity(com.google.appengine.tools.development.ContainerService.EnvironmentVariableMismatchSeverity)">ContainerService</A></CODE></B></DD>
-<DD>Override the default EnvironmentVariableMismatchSeverity setting, to
+<DD>Overrides the default EnvironmentVariableMismatchSeverity setting, to
  disable exceptions during the testing.
 <P>
 <DD><DL>
@@ -408,30 +405,6 @@ public void <B>setEnvironmentVariableMismatchSeverity</B>(<A HREF="../../../../.
 <DT><B>Parameters:</B><DD><CODE>val</CODE> - The new EnvironmentVariableMismatchSeverity.<DT><B>See Also:</B><DD><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html" title="enum in com.google.appengine.tools.development"><CODE>ContainerService.EnvironmentVariableMismatchSeverity</CODE></A></DL>
 </DD>
 </DL>
-<HR>
-<A NAME="getUserPermissions()"><!-- --></A><H3>
-getUserPermissions</H3>
-<PRE>
-public java.security.Permissions <B>getUserPermissions</B>()</PRE>
-<DL>
-<DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getUserPermissions()">ContainerService</A></CODE></B></DD>
-<DD>Returns a <CODE>Permissions</CODE> object containing <CODE>UnresolvedPermission</CODE> instances for every
- permission that was requested by the user in their <code>appengine-web.xml</code> file.
- <p>Note that user code will not actually running with these
- permissions.  However, to user-provided code that calls <code>SecurityManager.checkPermission</code> directly it will appear that it
- is.  This is designed primarily for third-party libraries that
- introduce their own <CODE>Permission</CODE> subclasses
- that are not used by any other classes.
-<P>
-<DD><DL>
-<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getUserPermissions()">getUserPermissions</A></CODE> in interface <CODE><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html" title="interface in com.google.appengine.tools.development">ContainerService</A></CODE></DL>
-</DD>
-<DD><DL>
-</DL>
-</DD>
-</DL>
 <!-- ========= END OF CLASS DATA ========= -->
 <HR>

data/{appengine-java-sdk-1.2.2 → appengine-java-sdk-1.2.6}/docs/tools/javadoc/com/google/appengine/tools/development/ApiProxyLocal.html RENAMED Viewed

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:58 CDT 2009 -->
+<!-- Generated by javadoc (build 1.6.0-google-internal) on Wed Oct 07 12:27:20 CDT 2009 -->
 <TITLE>
 ApiProxyLocal
 </TITLE>
-<META NAME="date" CONTENT="2009-07-12">
+<META NAME="date" CONTENT="2009-10-07">
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">

data/{appengine-java-sdk-1.2.2 → appengine-java-sdk-1.2.6}/docs/tools/javadoc/com/google/appengine/tools/development/ApiProxyLocalFactory.html RENAMED Viewed

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:58 CDT 2009 -->
+<!-- Generated by javadoc (build 1.6.0-google-internal) on Wed Oct 07 12:27:20 CDT 2009 -->
 <TITLE>
 ApiProxyLocalFactory
 </TITLE>
-<META NAME="date" CONTENT="2009-07-12">
+<META NAME="date" CONTENT="2009-10-07">
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">

data/{appengine-java-sdk-1.2.2 → appengine-java-sdk-1.2.6}/docs/tools/javadoc/com/google/appengine/tools/development/ApiProxyLocalImpl.html RENAMED Viewed

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:58 CDT 2009 -->
+<!-- Generated by javadoc (build 1.6.0-google-internal) on Wed Oct 07 12:27:21 CDT 2009 -->
 <TITLE>
 ApiProxyLocalImpl
 </TITLE>
-<META NAME="date" CONTENT="2009-07-12">
+<META NAME="date" CONTENT="2009-10-07">
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">
@@ -128,7 +128,8 @@ Implements ApiProxy.Delegate such that the requests are dispatched
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ApiProxyLocalImpl.html#getService(java.lang.String)">getService</A></B>(java.lang.String&nbsp;pkg)</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the <code>LocalRpcService</code> identified by the given package.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Method needs to be synchronized to ensure that we don't end up starting
+ multiple instances of the same service.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -292,9 +293,21 @@ getService</H3>
 <PRE>
 public final com.google.appengine.tools.development.LocalRpcService <B>getService</B>(java.lang.String&nbsp;pkg)</PRE>
 <DL>
-<DD><B>Description copied from interface: <CODE><A HREF="../../../../../com/google/appengine/tools/development/ApiProxyLocal.html#getService(java.lang.String)">ApiProxyLocal</A></CODE></B></DD>
-<DD>Get the <code>LocalRpcService</code> identified by the given package.
- This method should really only be used by tests.
+<DD>Method needs to be synchronized to ensure that we don't end up starting
+ multiple instances of the same service.  As an example, we've seen a
+ race condition where the local datastore service has not yet been
+ initialized and two datastore requests come in at the exact same time.
+ The first request looks in the service cache, doesn't find it, starts
+ a new local datastore service, registers it in the service cache,
+ and uses that local datastore service
+ to handle the first request.  Meanwhile the second request looks in the
+ service cache, doesn't find it, starts a new local datastore service,
+ registers it in the service cache (stomping on the original one), and
+ uses that local datastore service to handle the second request.  If both
+ of these requests start txns we can end up with 2 requests receiving the
+ same txn id, and that yields all sorts of exciting behavior.  So,
+ we synchronize this method to ensure that we only register a single
+ instance of each service type.
 <P>
 <DD><DL>
 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/google/appengine/tools/development/ApiProxyLocal.html#getService(java.lang.String)">getService</A></CODE> in interface <CODE><A HREF="../../../../../com/google/appengine/tools/development/ApiProxyLocal.html" title="interface in com.google.appengine.tools.development">ApiProxyLocal</A></CODE></DL>

data/{appengine-java-sdk-1.2.2 → appengine-java-sdk-1.2.6}/docs/tools/javadoc/com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html RENAMED Viewed

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:58 CDT 2009 -->
+<!-- Generated by javadoc (build 1.6.0-google-internal) on Wed Oct 07 12:27:21 CDT 2009 -->
 <TITLE>
 ContainerService.EnvironmentVariableMismatchSeverity
 </TITLE>
-<META NAME="date" CONTENT="2009-07-12">
+<META NAME="date" CONTENT="2009-10-07">
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">

data/{appengine-java-sdk-1.2.2 → appengine-java-sdk-1.2.6}/docs/tools/javadoc/com/google/appengine/tools/development/ContainerService.html RENAMED Viewed

@@ -2,12 +2,12 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:58 CDT 2009 -->
+<!-- Generated by javadoc (build 1.6.0-google-internal) on Wed Oct 07 12:27:21 CDT 2009 -->
 <TITLE>
 ContainerService
 </TITLE>
-<META NAME="date" CONTENT="2009-07-12">
+<META NAME="date" CONTENT="2009-10-07">
 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">
@@ -99,11 +99,10 @@ Interface ContainerService</H2>
 </PRE>
 <P>
-Implementation of this interface provides the actual servlet container
- support for the <A HREF="../../../../../com/google/appengine/tools/development/DevAppServer.html" title="interface in com.google.appengine.tools.development"><CODE>DevAppServer</CODE></A>, as discovered via the
- <CODE>ServiceProvider</CODE>.
- More specifically, we encapsulate the interactions between the
+Provides the backing servlet container support for the <A HREF="../../../../../com/google/appengine/tools/development/DevAppServer.html" title="interface in com.google.appengine.tools.development"><CODE>DevAppServer</CODE></A>,
+ as discovered via <CODE>ServiceProvider</CODE>.
+ <p>
+ More specifically, this interface encapsulates the interactions between the
  <A HREF="../../../../../com/google/appengine/tools/development/DevAppServer.html" title="interface in com.google.appengine.tools.development"><CODE>DevAppServer</CODE></A> and the underlying servlet container, which by default
  uses Jetty.
 <P>
@@ -149,7 +148,7 @@ Implementation of this interface provides the actual servlet container
           int&nbsp;port)</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set up the necessary configuration parameters.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets up the necessary configuration parameters.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -157,41 +156,33 @@ Implementation of this interface provides the actual servlet container
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAddress()">getAddress</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the listener network address, however it's decided during
+ the servlet container deployment.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>&nbsp;java.io.File</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAppDirectory()">getAppDirectory</A></B>()</CODE>
+<CODE>&nbsp;com.google.appengine.tools.development.AppContext</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAppContext()">getAppContext</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This allows us to recover the application directory from the container.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the context representing the currently executing webapp.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>&nbsp;int</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getPort()">getPort</A></B>()</CODE>
-<BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>&nbsp;java.security.Permissions</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getUserPermissions()">getUserPermissions</A></B>()</CODE>
+<CODE>&nbsp;java.io.File</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getAppDirectory()">getAppDirectory</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a <CODE>Permissions</CODE> object containing <CODE>UnresolvedPermission</CODE> instances for every
- permission that was requested by the user in their <code>appengine-web.xml</code> file.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the root directory of the application.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>&nbsp;java.lang.Object</CODE></FONT></TD>
-<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getWebAppContext()">getWebAppContext</A></B>()</CODE>
+<CODE>&nbsp;int</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#getPort()">getPort</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This allows us to access the "raw" WebAppContext API as provided by the
- container implementation, e.g.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the listener port number, however it's decided during the servlet
+ container deployment.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -199,7 +190,7 @@ Implementation of this interface provides the actual servlet container
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#setEnvironmentVariableMismatchSeverity(com.google.appengine.tools.development.ContainerService.EnvironmentVariableMismatchSeverity)">setEnvironmentVariableMismatchSeverity</A></B>(<A HREF="../../../../../com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html" title="enum in com.google.appengine.tools.development">ContainerService.EnvironmentVariableMismatchSeverity</A>&nbsp;val)</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Override the default EnvironmentVariableMismatchSeverity setting, to
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Overrides the default EnvironmentVariableMismatchSeverity setting, to
  disable exceptions during the testing.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
@@ -208,7 +199,7 @@ Implementation of this interface provides the actual servlet container
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#shutdown()">shutdown</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Shut down the servlet container.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Shuts down the servlet container.</TD>
 </TR>
 <TR BGCOLOR="white" CLASS="TableRowColor">
 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -216,7 +207,7 @@ Implementation of this interface provides the actual servlet container
 <TD><CODE><B><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.html#startup()">startup</A></B>()</CODE>
 <BR>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Start up the servlet container.</TD>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Starts up the servlet container.</TD>
 </TR>
 </TABLE>
 &nbsp;
@@ -242,7 +233,7 @@ void <B>configure</B>(java.lang.String&nbsp;devAppServerVersion,
                java.lang.String&nbsp;address,
                int&nbsp;port)</PRE>
 <DL>
-<DD>Set up the necessary configuration parameters.
+<DD>Sets up the necessary configuration parameters.
 <P>
 <DD><DL>
 <DT><B>Parameters:</B><DD><CODE>devAppServerVersion</CODE> - Version of the devAppServer.<DD><CODE>appDir</CODE> - The location of the application to run.<DD><CODE>webXmlLocation</CODE> - The location of a file whose format complies with
@@ -260,7 +251,7 @@ startup</H3>
 void <B>startup</B>()
              throws java.lang.Exception</PRE>
 <DL>
-<DD>Start up the servlet container.
+<DD>Starts up the servlet container.
 <P>
 <DD><DL>
@@ -276,7 +267,7 @@ shutdown</H3>
 void <B>shutdown</B>()
               throws java.lang.Exception</PRE>
 <DL>
-<DD>Shut down the servlet container.
+<DD>Shuts down the servlet container.
 <P>
 <DD><DL>
@@ -291,10 +282,11 @@ getAddress</H3>
 <PRE>
 java.lang.String <B>getAddress</B>()</PRE>
 <DL>
+<DD>Returns the listener network address, however it's decided during
+ the servlet container deployment.
+<P>
 <DD><DL>
-<DT><B>Returns:</B><DD>the listener network address, however it's decided during
- the servlet container deployment.</DL>
+</DL>
 </DD>
 </DL>
 <HR>
@@ -304,22 +296,21 @@ getPort</H3>
 <PRE>
 int <B>getPort</B>()</PRE>
 <DL>
+<DD>Returns the listener port number, however it's decided during the servlet
+ container deployment.
+<P>
 <DD><DL>
-<DT><B>Returns:</B><DD>the listener port number, however it's decided during the servlet
- container deployment.</DL>
+</DL>
 </DD>
 </DL>
 <HR>
-<A NAME="getWebAppContext()"><!-- --></A><H3>
-getWebAppContext</H3>
+<A NAME="getAppContext()"><!-- --></A><H3>
+getAppContext</H3>
 <PRE>
-java.lang.Object <B>getWebAppContext</B>()</PRE>
+com.google.appengine.tools.development.AppContext <B>getAppContext</B>()</PRE>
 <DL>
-<DD>This allows us to access the "raw" WebAppContext API as provided by the
- container implementation, e.g. to programmatically install servlets or
- filters.
+<DD>Returns the context representing the currently executing webapp.
 <P>
 <DD><DL>
 </DL>
@@ -332,7 +323,7 @@ getAppDirectory</H3>
 <PRE>
 java.io.File <B>getAppDirectory</B>()</PRE>
 <DL>
-<DD>This allows us to recover the application directory from the container.
+<DD>Returns the root directory of the application.
 <P>
 <DD><DL>
 </DL>
@@ -345,33 +336,13 @@ setEnvironmentVariableMismatchSeverity</H3>
 <PRE>
 void <B>setEnvironmentVariableMismatchSeverity</B>(<A HREF="../../../../../com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html" title="enum in com.google.appengine.tools.development">ContainerService.EnvironmentVariableMismatchSeverity</A>&nbsp;val)</PRE>
 <DL>
-<DD>Override the default EnvironmentVariableMismatchSeverity setting, to
+<DD>Overrides the default EnvironmentVariableMismatchSeverity setting, to
  disable exceptions during the testing.
 <P>
 <DD><DL>
 <DT><B>Parameters:</B><DD><CODE>val</CODE> - The new EnvironmentVariableMismatchSeverity.<DT><B>See Also:</B><DD><A HREF="../../../../../com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html" title="enum in com.google.appengine.tools.development"><CODE>ContainerService.EnvironmentVariableMismatchSeverity</CODE></A></DL>
 </DD>
 </DL>
-<HR>
-<A NAME="getUserPermissions()"><!-- --></A><H3>
-getUserPermissions</H3>
-<PRE>
-java.security.Permissions <B>getUserPermissions</B>()</PRE>
-<DL>
-<DD>Returns a <CODE>Permissions</CODE> object containing <CODE>UnresolvedPermission</CODE> instances for every
- permission that was requested by the user in their <code>appengine-web.xml</code> file.
- <p>Note that user code will not actually running with these
- permissions.  However, to user-provided code that calls <code>SecurityManager.checkPermission</code> directly it will appear that it
- is.  This is designed primarily for third-party libraries that
- introduce their own <CODE>Permission</CODE> subclasses
- that are not used by any other classes.
-<P>
-<DD><DL>
-</DL>
-</DD>
-</DL>
 <!-- ========= END OF CLASS DATA ========= -->
 <HR>