resourceadapter.html

j2ee api,很好的api。我这现在有

<DL>
<DD>This is called when a resource adapter instance is bootstrapped. This
 may be during resource adapter deployment or application server startup.
 This is a startup notification from the application server, and this 
 method is called by an application server thread. The application server
 thread executes in an unspecified context.

 <p>During this method call a ResourceAdapter JavaBean is
 responsible for initializing the resource adapter
 instance. Any exception thrown during this method
 call causes the application server to abort the bootstrap procedure 
 for this specific resource adapter instance.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ctx</CODE> - a bootstrap context containing references to
 useful facilities that could be used by a resource adapter instance.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/resource/spi/ResourceAdapterInternalException.html" title="class in javax.resource.spi">ResourceAdapterInternalException</A></CODE> - indicates bootstrap failure.
 The resource adapter instance is unusable and must be discarded.</DL>
</DD>
</DL>
<HR>

<A NAME="stop()"><!-- --></A><H3>
stop</H3>
<PRE>
public void <B>stop</B>()</PRE>
<DL>
<DD>This is called when a resource adapter instance is undeployed or
 during application server shutdown. This is a shutdown notification 
 from the application server, and this method is called by an 
 application server thread.  The application server
 thread executes in an unspecified context.

 <p>During this method call, a ResourceAdapter 
 JavaBean is responsible for performing an orderly shutdown of the
 resource adapter instance. Any exception thrown by this 
 method call does not alter the 
 processing of the application server shutdown or resource 
 adapter undeployment that caused this method call. The application 
 server may log the exception information for error reporting purposes.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="endpointActivation(javax.resource.spi.endpoint.MessageEndpointFactory, javax.resource.spi.ActivationSpec)"><!-- --></A><H3>
endpointActivation</H3>
<PRE>
public void <B>endpointActivation</B>(<A HREF="../../../javax/resource/spi/endpoint/MessageEndpointFactory.html" title="interface in javax.resource.spi.endpoint">MessageEndpointFactory</A>&nbsp;endpointFactory,
                               <A HREF="../../../javax/resource/spi/ActivationSpec.html" title="interface in javax.resource.spi">ActivationSpec</A>&nbsp;spec)
                        throws <A HREF="../../../javax/resource/ResourceException.html" title="class in javax.resource">ResourceException</A></PRE>
<DL>
<DD>This is called during the activation of a message endpoint. This causes
 the resource adapter instance to do the necessary setup (ie., setup
 message delivery for the message endpoint with a message provider).
 Note that message delivery to the message endpoint might start even 
 before this method returns.

 <p>Endpoint activation is deemed successful only when this method 
 completes successfully without throwing any exceptions.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>endpointFactory</CODE> - a message endpoint factory instance.<DD><CODE>spec</CODE> - an activation spec JavaBean instance.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/resource/NotSupportedException.html" title="class in javax.resource">NotSupportedException</A></CODE> - indicates message endpoint 
 activation rejection due to incorrect activation 
 setup information.
<DD><CODE><A HREF="../../../javax/resource/ResourceException.html" title="class in javax.resource">ResourceException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="endpointDeactivation(javax.resource.spi.endpoint.MessageEndpointFactory, javax.resource.spi.ActivationSpec)"><!-- --></A><H3>
endpointDeactivation</H3>
<PRE>
public void <B>endpointDeactivation</B>(<A HREF="../../../javax/resource/spi/endpoint/MessageEndpointFactory.html" title="interface in javax.resource.spi.endpoint">MessageEndpointFactory</A>&nbsp;endpointFactory,
                                 <A HREF="../../../javax/resource/spi/ActivationSpec.html" title="interface in javax.resource.spi">ActivationSpec</A>&nbsp;spec)</PRE>
<DL>
<DD>This is called when a message endpoint is deactivated. The instances
 passed as arguments to this method call should be identical to those
 passed in for the corresponding </code>endpointActivation</code> call.
 This causes the resource adapter to stop delivering messages to the
 message endpoint. 

 <p>Any exception thrown by this method is ignored. After
 this method call, the endpoint is deemed inactive.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>endpointFactory</CODE> - a message endpoint factory instance.<DD><CODE>spec</CODE> - an activation spec JavaBean instance.</DL>
</DD>
</DL>
<HR>

<A NAME="getXAResources(javax.resource.spi.ActivationSpec[])"><!-- --></A><H3>
getXAResources</H3>
<PRE>
public <A HREF="../../../javax/transaction/xa/XAResource.html" title="interface in javax.transaction.xa">XAResource</A>[] <B>getXAResources</B>(<A HREF="../../../javax/resource/spi/ActivationSpec.html" title="interface in javax.resource.spi">ActivationSpec</A>[]&nbsp;specs)
                            throws <A HREF="../../../javax/resource/ResourceException.html" title="class in javax.resource">ResourceException</A></PRE>
<DL>
<DD>This method is called by the application server during crash recovery.
 This method takes in an array of <code>ActivationSpec</code> JavaBeans 
 and returns an array of <code>XAResource</code> objects each of which 
 represents a unique resource manager.

 The resource adapter may return null if it does not implement the 
 <code>XAResource</code> interface. Otherwise, it must return an array 
 of <code>XAResource</code> objects, each of which represents a unique 
 resource manager that was used by the endpoint applications. 
 
 The application server uses the <code>XAResource</code> objects to 
 query each resource manager for a list of in-doubt transactions.
 It then completes each pending transaction by sending the commit 
 decision to the participating resource managers.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>specs</CODE> - an array of <code>ActivationSpec</code> JavaBeans each of 
 which corresponds to an deployed endpoint application that was 
 active prior to the system crash.
<DT><B>Returns:</B><DD>an array of <code>XAResource</code> objects each of which 
 represents a unique resource manager.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/resource/ResourceException.html" title="class in javax.resource">ResourceException</A></CODE> - generic exception if operation fails due to an
 error condition.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Ent. Ed. v1.4</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/resource/spi/ManagedConnectionMetaData.html" title="interface in javax.resource.spi"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/resource/spi/ResourceAdapterAssociation.html" title="interface in javax.resource.spi"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="ResourceAdapter.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1"><a href="http://java.sun.com/webapps/bugreport">Submit a bug or feature</a> <p>Copyright 2003 Sun Microsystems, Inc. All rights reserved.</font>
</BODY>
</HTML>