blob: 401d4ac5c7fe243f269b75a68b181f3eb37bd447 [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>
<title>InteractionSpec</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="InteractionSpec";
}
}
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="../../../jakarta/resource/cci/Interaction.html" title="interface in jakarta.resource.cci"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../jakarta/resource/cci/LocalTransaction.html" title="interface in jakarta.resource.cci"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../index.html?jakarta/resource/cci/InteractionSpec.html" target="_top">Frames</a></li>
<li><a href="InteractionSpec.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><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li>Method</li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li>Method</li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">jakarta.resource.cci</div>
<h2 title="Interface InteractionSpec" class="title">Interface InteractionSpec</h2>
</div>
<div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Superinterfaces:</dt>
<dd>java.io.Serializable</dd>
</dl>
<hr>
<br>
<pre>public interface <span class="typeNameLabel">InteractionSpec</span>
extends java.io.Serializable</pre>
<div class="block">An InteractionSpec holds properties for driving an Interaction
with an EIS instance. An InteractionSpec is used by an Interaction
to execute the specified function on an underlying EIS.
<p>The CCI specification defines a set of standard properties for
an InteractionSpec. An InteractionSpec implementation is not
required to support a standard property if that property does
not apply to its underlying EIS.
<p>The InteractionSpec implementation class must provide getter and
setter methods for each of its supported properties. The getter and
setter methods convention should be based on the Java Beans design
pattern.
<p>The standard properties are as follows:
<UL>
<LI>FunctionName: name of an EIS function
<LI>InteractionVerb: mode of interaction with an EIS instance:
SYNC_SEND, SYNC_SEND_RECEIVE, SYNC_RECEIVE
<LI>ExecutionTimeout: the number of milliseconds an Interaction
will wait for an EIS to execute the specified function
</UL>
<p>The following standard properties are used to give hints to an
Interaction instance about the ResultSet requirements:
<UL>
<LI>FetchSize
<LI>FetchDirection
<LI>MaxFieldSize
<LI>ResultSetType
<LI>ResultSetConcurrency
</UL>
<p>A CCI implementation can provide additional properties beyond
that described in the InteractionSpec interface. Note that the
format and type of the additional properties is specific to an EIS
and is outside the scope of the CCI specification.
<p>It is required that the InteractionSpec interface be implemented
as a JavaBean for the toolability support. The properties on the
InteractionSpec implementation class should be defined through the
getter and setter methods pattern. An implementation class for
InteractionSpec interface is required to implement the
java.io.Serializable interface.</div>
<dl>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.8</dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../jakarta/resource/cci/Interaction.html" title="interface in jakarta.resource.cci"><code>Interaction</code></a></dd>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
<caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../jakarta/resource/cci/InteractionSpec.html#SYNC_RECEIVE">SYNC_RECEIVE</a></span></code>
<div class="block">The execution of an Interaction results in a synchronous
receive of an output Record.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../jakarta/resource/cci/InteractionSpec.html#SYNC_SEND">SYNC_SEND</a></span></code>
<div class="block">Interaction Verb type: The execution of an Interaction does only a
send to the target EIS instance.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../jakarta/resource/cci/InteractionSpec.html#SYNC_SEND_RECEIVE">SYNC_SEND_RECEIVE</a></span></code>
<div class="block">Interaction Verb type: The execution of an Interaction sends a
request to the EIS instance and receives response synchronously.</div>
</td>
</tr>
</table>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- -->
</a>
<h3>Field Detail</h3>
<a name="SYNC_SEND">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>SYNC_SEND</h4>
<pre>static final&nbsp;int SYNC_SEND</pre>
<div class="block">Interaction Verb type: The execution of an Interaction does only a
send to the target EIS instance. The input record is sent to the
EIS instance without any synchronous response in terms of an
output Record or ResultSet.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../constant-values.html#jakarta.resource.cci.InteractionSpec.SYNC_SEND">Constant Field Values</a></dd>
</dl>
</li>
</ul>
<a name="SYNC_SEND_RECEIVE">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>SYNC_SEND_RECEIVE</h4>
<pre>static final&nbsp;int SYNC_SEND_RECEIVE</pre>
<div class="block">Interaction Verb type: The execution of an Interaction sends a
request to the EIS instance and receives response synchronously.
The input record is sent to the EIS instance with the output
received either as Record or CCIResultSet.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../constant-values.html#jakarta.resource.cci.InteractionSpec.SYNC_SEND_RECEIVE">Constant Field Values</a></dd>
</dl>
</li>
</ul>
<a name="SYNC_RECEIVE">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>SYNC_RECEIVE</h4>
<pre>static final&nbsp;int SYNC_RECEIVE</pre>
<div class="block">The execution of an Interaction results in a synchronous
receive of an output Record. An example is: a session bean gets
a method invocation and it uses this SEND_RECEIVE form of
interaction to retrieve messages that have been delivered to a
message queue.</div>
<dl>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../constant-values.html#jakarta.resource.cci.InteractionSpec.SYNC_RECEIVE">Constant Field Values</a></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="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="../../../jakarta/resource/cci/Interaction.html" title="interface in jakarta.resource.cci"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../jakarta/resource/cci/LocalTransaction.html" title="interface in jakarta.resource.cci"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../index.html?jakarta/resource/cci/InteractionSpec.html" target="_top">Frames</a></li>
<li><a href="InteractionSpec.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><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li>Method</li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li>Method</li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</body>
</html>