| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <!-- NewPage --> |
| <html lang="en"> |
| <head> |
| <title>Suspended</title> |
| <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style"> |
| <script type="text/javascript" src="../../../../script.js"></script> |
| </head> |
| <body> |
| <script type="text/javascript"><!-- |
| try { |
| if (location.href.indexOf('is-external=true') == -1) { |
| parent.document.title="Suspended"; |
| } |
| } |
| catch(err) { |
| } |
| //--> |
| </script> |
| <noscript> |
| <div>JavaScript is disabled on your browser.</div> |
| </noscript> |
| <!-- ========= START OF TOP NAVBAR ======= --> |
| <div class="topNav"><a name="navbar.top"> |
| <!-- --> |
| </a> |
| <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div> |
| <a name="navbar.top.firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../../overview-summary.html">Overview</a></li> |
| <li><a href="package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../../index-all.html">Index</a></li> |
| <li><a href="../../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li><a href="../../../../javax/ws/rs/container/ResourceInfo.html" title="interface in javax.ws.rs.container"><span class="typeNameLink">Prev Class</span></a></li> |
| <li><a href="../../../../javax/ws/rs/container/TimeoutHandler.html" title="interface in javax.ws.rs.container"><span class="typeNameLink">Next Class</span></a></li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../../index.html?javax/ws/rs/container/Suspended.html" target="_top">Frames</a></li> |
| <li><a href="Suspended.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_top"> |
| <li><a href="../../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_top"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Field | </li> |
| <li>Required | </li> |
| <li>Optional</li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li>Element</li> |
| </ul> |
| </div> |
| <a name="skip.navbar.top"> |
| <!-- --> |
| </a></div> |
| <!-- ========= END OF TOP NAVBAR ========= --> |
| <!-- ======== START OF CLASS DATA ======== --> |
| <div class="header"> |
| <div class="subTitle">javax.ws.rs.container</div> |
| <h2 title="Annotation Type Suspended" class="title">Annotation Type Suspended</h2> |
| </div> |
| <div class="contentContainer"> |
| <div class="description"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <hr> |
| <br> |
| <pre>@Target(value=PARAMETER) |
| @Retention(value=RUNTIME) |
| @Documented |
| public @interface <span class="memberNameLabel">Suspended</span></pre> |
| <div class="block">Inject a suspended <a href="../../../../javax/ws/rs/container/AsyncResponse.html" title="interface in javax.ws.rs.container"><code>AsyncResponse</code></a> into a parameter of an invoked |
| <a href="../../../../javax/ws/rs/HttpMethod.html" title="annotation in javax.ws.rs"><code>resource or sub-resource method</code></a>. |
| |
| The injected <code>AsyncResponse</code> instance is bound to the processing |
| of the active request and can be used to resume the request processing when |
| a response is available. |
| <p> |
| By default there is <a href="../../../../javax/ws/rs/container/AsyncResponse.html#NO_TIMEOUT"><code>no suspend timeout set</code></a> and |
| the asynchronous response is suspended indefinitely. The suspend timeout as well |
| as a custom <a href="../../../../javax/ws/rs/container/TimeoutHandler.html" title="interface in javax.ws.rs.container"><code>timeout handler</code></a> can be specified programmatically |
| using the <a href="../../../../javax/ws/rs/container/AsyncResponse.html#setTimeout-long-java.util.concurrent.TimeUnit-"><code>AsyncResponse.setTimeout(long, TimeUnit)</code></a> and |
| <a href="../../../../javax/ws/rs/container/AsyncResponse.html#setTimeoutHandler-javax.ws.rs.container.TimeoutHandler-"><code>AsyncResponse.setTimeoutHandler(TimeoutHandler)</code></a> methods. For example: |
| <p/> |
| <pre> |
| @Stateless |
| @Path("/") |
| public class MyEjbResource { |
| … |
| @GET |
| @Asynchronous |
| public void longRunningOperation(@Suspended AsyncResponse ar) { |
| ar.setTimeoutHandler(customHandler); |
| ar.setTimeout(10, TimeUnit.SECONDS); |
| final String result = executeLongRunningOperation(); |
| ar.resume(result); |
| } |
| |
| private String executeLongRunningOperation() { … } |
| } |
| </pre> |
| <p> |
| A resource or sub-resource method that injects a suspended instance of an |
| <code>AsyncResponse</code> using the <code>@Suspended</code> annotation is expected |
| be declared to return <code>void</code> type. Methods that inject asynchronous |
| response instance using the <code>@Suspended</code> annotation and declare a |
| return type other than <code>void</code> MUST be detected by the the runtime and |
| a warning message MUST be logged. Any response value returned from such resource |
| or sub-resource method MUST be ignored by the framework: |
| </p> |
| <pre> |
| @Path("/messages/next") |
| public class MessagingResource { |
| … |
| @GET |
| public String readMessage(@Suspended AsyncResponse ar) { |
| suspended.put(ar); |
| return "This response will be ignored."; |
| } |
| … |
| } |
| </pre></div> |
| <dl> |
| <dt><span class="simpleTagLabel">Since:</span></dt> |
| <dd>2.0</dd> |
| </dl> |
| </li> |
| </ul> |
| </div> |
| </div> |
| <!-- ========= END OF CLASS DATA ========= --> |
| <!-- ======= START OF BOTTOM NAVBAR ====== --> |
| <div class="bottomNav"><a name="navbar.bottom"> |
| <!-- --> |
| </a> |
| <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> |
| <a name="navbar.bottom.firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../../overview-summary.html">Overview</a></li> |
| <li><a href="package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../../index-all.html">Index</a></li> |
| <li><a href="../../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li><a href="../../../../javax/ws/rs/container/ResourceInfo.html" title="interface in javax.ws.rs.container"><span class="typeNameLink">Prev Class</span></a></li> |
| <li><a href="../../../../javax/ws/rs/container/TimeoutHandler.html" title="interface in javax.ws.rs.container"><span class="typeNameLink">Next Class</span></a></li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../../index.html?javax/ws/rs/container/Suspended.html" target="_top">Frames</a></li> |
| <li><a href="Suspended.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_bottom"> |
| <li><a href="../../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_bottom"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Field | </li> |
| <li>Required | </li> |
| <li>Optional</li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li>Element</li> |
| </ul> |
| </div> |
| <a name="skip.navbar.bottom"> |
| <!-- --> |
| </a></div> |
| <!-- ======== END OF BOTTOM NAVBAR ======= --> |
| </body> |
| </html> |