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

appengine-sdk 1.2.2 → 1.2.6

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>