blob: bfab3048d96906d3703f1c1f82fc8518d14323c7 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd">
<HTML>
<HEAD>
<meta name="generator" content="JDiff v1.1.1">
<!-- Generated by the JDiff Javadoc doclet -->
<!-- (http://www.jdiff.org) -->
<meta name="description" content="JDiff is a Javadoc doclet which generates an HTML report of all the packages, classes, constructors, methods, and fields which have been removed, added or changed in any way, including their documentation, when two APIs are compared.">
<meta name="keywords" content="diff, jdiff, javadiff, java diff, java difference, API difference, difference between two APIs, API diff, Javadoc, doclet">
<LINK REL="stylesheet" TYPE="text/css" HREF="../stylesheet-jdiff.css" TITLE="Style">
<TITLE>
com.google.inject.servlet Documentation Differences
</TITLE>
</HEAD>
<BODY>
<!-- Start of nav bar -->
<TABLE summary="Navigation bar" BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<TABLE summary="Navigation bar" BORDER="0" CELLPADDING="0" CELLSPACING="3">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="http://google-guice.googlecode.com/svn/trunk/latest-api-diffs/4.0/javadoc/com/google/inject/servlet/package-summary.html" target="_top"><FONT CLASS="NavBarFont1"><B><tt>4.0</tt></B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="changes-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> &nbsp;<FONT CLASS="NavBarFont1">Package</FONT>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1"> &nbsp;<FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="docdiffs_index.html"><FONT CLASS="NavBarFont1"><B>Text Changes</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="jdiff_statistics.html"><FONT CLASS="NavBarFont1"><B>Statistics</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="jdiff_help.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Generated by<br><a href="http://www.jdiff.org" class="staysblack" target="_top">JDiff</a></b></EM></TD>
</TR>
<TR>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="docdiffs_com.google.inject.multibindings.html"><B>PREV PACKAGE</B></A> &nbsp;
&nbsp;<A HREF="docdiffs_com.google.inject.spi.html"><B>NEXT PACKAGE</B></A>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<A HREF="../changes.html" TARGET="_top"><B>FRAMES</B></A> &nbsp;
&nbsp;<A HREF="docdiffs_com.google.inject.servlet.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell2">&nbsp;</TD>
</TR>
</TABLE>
<HR>
<!-- End of nav bar -->
<h2>
com.google.inject.servlet Documentation Differences
</h2>
<blockquote>
This file contains all the changes in documentation in the package <code>com.google.inject.servlet</code> as colored differences.
Deletions are shown <strike>like this</strike>, and
additions are shown <span style="background: #FFFF00">like this</span>.
</blockquote>
<blockquote>
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The <i>new</i> HTML tags are shown in the differences.
If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here.
Similarly, documentation which was inherited from another class or interface is not shown here.
</blockquote>
<blockquote>
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a &lt;code&gt; tag will cause all subsequent paragraphs to be displayed differently.
</blockquote>
<hr>
<A NAME="com.google.inject.servlet.ServletScopes.dmethod.continueRequest(Callable&lt;T&gt;, Map&lt;Key&lt;?&gt;, Object&gt;)"></A><a href="com.google.inject.servlet.ServletScopes.html" class="hiddenlink">Class <b>ServletScopes</b></a>, <a href="com.google.inject.servlet.ServletScopes.html#com.google.inject.servlet.ServletScopes.continueRequest_changed(java.util.concurrent.Callable<T>, java.util.Map<com.google.inject.Key<?>, java.lang.Object>)" class="hiddenlink">Callable&lt;T&gt; <b>continueRequest(Callable&lt;T&gt;, Map&lt;Key&lt;?&gt;, Object&gt;)</b></a><br><br><blockquote>Wraps the given callable in a contextual callable that "continues" the
HTTP request in another thread. This acts as a way of transporting
request context data from the request processing thread to to worker
threads.
<p>
There are some limitations:
<ul>
<li>Derived objects (i.e. anything marked @RequestScoped will not be
transported.</li>
<li>State changes to the HttpServletRequest after this method is called
will not be seen in the continued thread.</li>
<li>Only the HttpServletRequest, ServletContext and request parameter
map are available in the continued thread. The response and session
are not available.</li>
</ul>
<p><span style="background: #FFFF00">The returned callable will throw a <A HREF="http://google-guice.googlecode.com/svn/trunk/latest-api-diffs/4.0/javadoc/ScopingException.html"><TT>ScopingException</TT></A> when called
if the HTTP request scope is still active on the current thread.
</span>@param callable code to be executed in another thread, which depends on
the request scope.
@param seedMap the initial set of scoped instances for Guice to seed the
request scope with. To seed a key with null, use {@code null} as
the value.
@return a callable that will invoke the given callable, making the request
context available to it.
@throws OutOfScopeException if this method is called from a non-request
thread, or if the request has completed.
@since 3.0</blockquote>
<A NAME="com.google.inject.servlet.ServletScopes.dmethod.scopeRequest(Callable&lt;T&gt;, Map&lt;Key&lt;?&gt;, Object&gt;)"></A><a href="com.google.inject.servlet.ServletScopes.html" class="hiddenlink">Class <b>ServletScopes</b></a>, <a href="com.google.inject.servlet.ServletScopes.html#com.google.inject.servlet.ServletScopes.scopeRequest_changed(java.util.concurrent.Callable<T>, java.util.Map<com.google.inject.Key<?>, java.lang.Object>)" class="hiddenlink">Callable&lt;T&gt; <b>scopeRequest(Callable&lt;T&gt;, Map&lt;Key&lt;?&gt;, Object&gt;)</b></a><br><br><blockquote>Scopes the given callable inside a request scope. This is not the same
as the HTTP request scope, but is used if no HTTP request scope is in
progress. In this way, keys can be scoped as @RequestScoped and exist
in non-HTTP requests (for example: RPC requests) as well as in HTTP
request threads.
<p><span style="background: #FFFF00">The returned callable will throw a <A HREF="http://google-guice.googlecode.com/svn/trunk/latest-api-diffs/4.0/javadoc/ScopingException.html"><TT>ScopingException</TT></A> when called
if there is a request scope already active on the current thread.
</span>@param callable code to be executed which depends on the request scope.
Typically in another thread, but not necessarily so.
@param seedMap the initial set of scoped instances for Guice to seed the
request scope with. To seed a key with null, use {@code null} as
the value.
@return a callable that when called will run inside the a request scope
that exposes the instances in the {@code seedMap} as scoped keys.
@since 3.0</blockquote>
<hr align="left" width="100%">
</BODY>
</HTML>