connectionfactory.html

来自「SUN公司官方J2EE中文帮助文档 应该不错 有兴趣的下来看看 html格式的」· HTML 代码 · 共 329 行 · 第 1/2 页

<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getConnection()"><!-- --></A><H3>
getConnection</H3>
<PRE>
public <A HREF="../../../javax/resource/cci/Connection.html">Connection</A> <B>getConnection</B>()
                         throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD>Gets a connection to an EIS instance. This getConnection variant
  should be used when a component wants the container to manage EIS 
  sign-on. This case is termed container-managed sign-on. The 
  component does not pass any security information.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>Connection instance<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - Failed to get a connection to
                                the EIS instance. Examples of
                                error cases are:
          <UL>
          <LI> Invalid configuration of ManagedConnectionFactory--
               example: invalid server name
          <LI> Application server-internal error--example:
               connection pool related error
          <LI> Communication error 
          <LI> EIS-specific error--example: EIS not active
          <LI> Resource adapter-internal error
          <LI> Security related error; example: invalid user
          <LI> Failure to allocate system resources
         </UL></DL>
</DD>
</DL>
<HR>

<A NAME="getConnection(javax.resource.cci.ConnectionSpec)"><!-- --></A><H3>
getConnection</H3>
<PRE>
public <A HREF="../../../javax/resource/cci/Connection.html">Connection</A> <B>getConnection</B>(<A HREF="../../../javax/resource/cci/ConnectionSpec.html">ConnectionSpec</A>&nbsp;properties)
                         throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD>Gets a connection to an EIS instance. A component should use 
  the getConnection variant with javax.resource.cci.ConnectionSpec
  parameter, if it needs to pass any resource adapter specific 
  security information and connection parameters. In the component-
  managed sign-on case, an application component passes security 
  information (example: username, password) through the 
  ConnectionSpec instance.
 
  <p>It is important to note that the properties passed through 
  the getConnection method should be client-specific (example: 
  username, password, language) and not related to the 
  configuration of a target EIS instance (example: port number, 
  server name). The ManagedConnectionFactory instance is configured
  with complete set of properties required for the creation of a 
  connection to an EIS instance.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>properties</CODE> - Connection parameters and security
                              information specified as 
                              ConnectionSpec instance<DT><B>Returns:</B><DD>Connection instance<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - Failed to get a connection to
                              the EIS instance. Examples of
                              error cases are:
          <UL>
          <LI> Invalid specification of input parameters
          <LI> Invalid configuration of ManagedConnectionFactory--
               example: invalid server name
          <LI> Application server-internal error--example:
               connection pool related error
          <LI> Communication error 
          <LI> EIS-specific error--example: EIS not active
          <LI> Resource adapter-internal error
          <LI> Security related error; example: invalid user
          <LI> Failure to allocate system resources
         </UL><DT><B>See Also: </B><DD><A HREF="../../../javax/resource/cci/ConnectionSpec.html"><CODE>ConnectionSpec</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getRecordFactory()"><!-- --></A><H3>
getRecordFactory</H3>
<PRE>
public <A HREF="../../../javax/resource/cci/RecordFactory.html">RecordFactory</A> <B>getRecordFactory</B>()
                               throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD>Gets a RecordFactory instance. The RecordFactory is used for
  the creation of generic Record instances.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>RecordFactory         RecordFactory instance<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - Failed to create a RecordFactory<DD><CODE><A HREF="../../../javax/resource/NotSupportedException.html">NotSupportedException</A></CODE> - Operation not supported</DL>
</DD>
</DL>
<HR>

<A NAME="getMetaData()"><!-- --></A><H3>
getMetaData</H3>
<PRE>
public <A HREF="../../../javax/resource/cci/ResourceAdapterMetaData.html">ResourceAdapterMetaData</A> <B>getMetaData</B>()
                                    throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD>Gets metadata for the Resource Adapter. Note that the metadata
  information is about the ResourceAdapter and not the EIS instance.
  An invocation of this method does not require that an active
  connection to an EIS instance should have been established.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - Failed to get metadata information 
                              about the resource adapter</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <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>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/resource/cci/Connection.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/resource/cci/ConnectionMetaData.html"><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="ConnectionFactory.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&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>
<!-- =========== END OF NAVBAR =========== -->

<HR>

</BODY>
</HTML>