blob: 37e4b3a13a40dcfb5454fb32003228af24eb544e [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>AsyncEndpoint (Apache Axis2)</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="AsyncEndpoint (Apache Axis2)";
}
}
catch(err) {
}
//-->
var methods = {"i0":6,"i1":6};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</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="class-use/AsyncEndpoint.html">Use</a></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>Prev&nbsp;Class</li>
<li><a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpointAdapter.html" title="class in org.apache.axis2.transport.testkit.endpoint"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../index.html?org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html" target="_top">Frames</a></li>
<li><a href="AsyncEndpoint.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../../allclasses-noframe.html">All&nbsp;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:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.axis2.transport.testkit.endpoint</div>
<h2 title="Interface AsyncEndpoint" class="title">Interface AsyncEndpoint&lt;M&gt;</h2>
</div>
<div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt><span class="paramLabel">Type Parameters:</span></dt>
<dd><code>M</code> - </dd>
</dl>
<dl>
<dt>All Known Implementing Classes:</dt>
<dd><a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpointAdapter.html" title="class in org.apache.axis2.transport.testkit.endpoint">AsyncEndpointAdapter</a>, <a href="../../../../../../org/apache/axis2/transport/testkit/axis2/endpoint/AxisAsyncEndpoint.html" title="class in org.apache.axis2.transport.testkit.axis2.endpoint">AxisAsyncEndpoint</a>, <a href="../../../../../../org/apache/axis2/transport/testkit/http/JettyAsyncEndpoint.html" title="class in org.apache.axis2.transport.testkit.http">JettyAsyncEndpoint</a>, <a href="../../../../../../org/apache/axis2/transport/testkit/http/JettyByteArrayAsyncEndpoint.html" title="class in org.apache.axis2.transport.testkit.http">JettyByteArrayAsyncEndpoint</a>, <a href="../../../../../../org/apache/axis2/transport/testkit/http/JettyRESTAsyncEndpoint.html" title="class in org.apache.axis2.transport.testkit.http">JettyRESTAsyncEndpoint</a></dd>
</dl>
<hr>
<br>
<pre>public interface <span class="typeNameLabel">AsyncEndpoint&lt;M&gt;</span></pre>
<div class="block">Interface implemented by in-only test endpoints.
<p>
The endpoint must be ready to receive messages immediately after it
has been set up. In particular implementations must not make the
assumption that messages are only during a call to <a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html#waitForMessage-int-"><code>waitForMessage(int)</code></a>.
Indeed, a typical test case will set up the endpoint, send a message and only
afterwards call <a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html#waitForMessage-int-"><code>waitForMessage(int)</code></a>.
<p>
There are two strategies to guarantee this behavior:
<ul>
<li>The underlying transport internally queues incoming messages.
In that case <a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html#waitForMessage-int-"><code>waitForMessage(int)</code></a> should simply poll
for new messages. An example of this type of transport is
the mail transport.</li>
<li>The underlying transport requires that incoming messages are
processed immediately. In that case the implementation should
set up the required receiver or message processor and add
incoming messages to an internal queue that is polled
when <a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html#waitForMessage-int-"><code>waitForMessage(int)</code></a> is called. An example of
this kind of transport is HTTP. Implementations can use
<a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/InOnlyEndpointSupport.html" title="class in org.apache.axis2.transport.testkit.endpoint"><code>InOnlyEndpointSupport</code></a> to manage the message queue.</li>
</ul></div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/package-summary.html"><code>org.apache.axis2.transport.testkit.endpoint</code></a></dd>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html#clear--">clear</a></span>()</code>
<div class="block">Discard any pending messages.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/axis2/transport/testkit/message/IncomingMessage.html" title="class in org.apache.axis2.transport.testkit.message">IncomingMessage</a>&lt;<a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html" title="type parameter in AsyncEndpoint">M</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html#waitForMessage-int-">waitForMessage</a></span>(int&nbsp;timeout)</code>&nbsp;</td>
</tr>
</table>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="clear--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>clear</h4>
<pre>void&nbsp;clear()
throws <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></pre>
<div class="block">Discard any pending messages.</div>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</a></code></dd>
</dl>
</li>
</ul>
<a name="waitForMessage-int-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>waitForMessage</h4>
<pre><a href="../../../../../../org/apache/axis2/transport/testkit/message/IncomingMessage.html" title="class in org.apache.axis2.transport.testkit.message">IncomingMessage</a>&lt;<a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html" title="type parameter in AsyncEndpoint">M</a>&gt;&nbsp;waitForMessage(int&nbsp;timeout)
throws <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="https://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></code></dd>
</dl>
</li>
</ul>
</li>
</ul>
</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="class-use/AsyncEndpoint.html">Use</a></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>Prev&nbsp;Class</li>
<li><a href="../../../../../../org/apache/axis2/transport/testkit/endpoint/AsyncEndpointAdapter.html" title="class in org.apache.axis2.transport.testkit.endpoint"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../index.html?org/apache/axis2/transport/testkit/endpoint/AsyncEndpoint.html" target="_top">Frames</a></li>
<li><a href="AsyncEndpoint.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../../allclasses-noframe.html">All&nbsp;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:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &copy; <a href="https://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.</small></p>
</body>
</html>