managedconnectionfactory.html

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

<HR>

<A NAME="createConnectionFactory()"><!-- --></A><H3>
createConnectionFactory</H3>
<PRE>
public java.lang.Object <B>createConnectionFactory</B>()
                                         throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD>Creates a Connection Factory instance. The Connection Factory 
  instance gets initialized with a default ConnectionManager provided
  by the resource adapter.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>EIS-specific Connection Factory instance or
            javax.resource.cci.ConnectionFactory instance<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - Generic exception<DD><CODE><A HREF="../../../javax/resource/spi/ResourceAdapterInternalException.html">ResourceAdapterInternalException</A></CODE> - Resource adapter related error condition</DL>
</DD>
</DL>
<HR>

<A NAME="createManagedConnection(javax.security.auth.Subject, javax.resource.spi.ConnectionRequestInfo)"><!-- --></A><H3>
createManagedConnection</H3>
<PRE>
public <A HREF="../../../javax/resource/spi/ManagedConnection.html">ManagedConnection</A> <B>createManagedConnection</B>(<A HREF="../../../javax/security/auth/Subject.html">Subject</A>&nbsp;subject,
                                                 <A HREF="../../../javax/resource/spi/ConnectionRequestInfo.html">ConnectionRequestInfo</A>&nbsp;cxRequestInfo)
                                          throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD><p>Creates a new physical connection to the underlying EIS 
  resource manager,

  <p>ManagedConnectionFactory uses the security information (passed as
  Subject) and additional ConnectionRequestInfo (which is specific to
  ResourceAdapter and opaque to application server) to create this new
  connection.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>Subject</CODE> - Caller's security information<DD><CODE>cxRequestInfo</CODE> - Additional resource adapter specific connection
                          request information<DT><B>Returns:</B><DD>ManagedConnection instance<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - generic exception<DD><CODE><A HREF="../../../javax/resource/spi/SecurityException.html">SecurityException</A></CODE> - security related error<DD><CODE><A HREF="../../../javax/resource/spi/ResourceAllocationException.html">ResourceAllocationException</A></CODE> - failed to allocate system resources for
                                 connection request<DD><CODE><A HREF="../../../javax/resource/spi/ResourceAdapterInternalException.html">ResourceAdapterInternalException</A></CODE> - resource adapter related error condition<DD><CODE><A HREF="../../../javax/resource/spi/EISSystemException.html">EISSystemException</A></CODE> - internal error condition in EIS instance</DL>
</DD>
</DL>
<HR>

<A NAME="matchManagedConnections(java.util.Set, javax.security.auth.Subject, javax.resource.spi.ConnectionRequestInfo)"><!-- --></A><H3>
matchManagedConnections</H3>
<PRE>
public <A HREF="../../../javax/resource/spi/ManagedConnection.html">ManagedConnection</A> <B>matchManagedConnections</B>(java.util.Set&nbsp;connectionSet,
                                                 <A HREF="../../../javax/security/auth/Subject.html">Subject</A>&nbsp;subject,
                                                 <A HREF="../../../javax/resource/spi/ConnectionRequestInfo.html">ConnectionRequestInfo</A>&nbsp;cxRequestInfo)
                                          throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD><p>Returns a matched connection from the candidate set of connections. 
  </p>
  
  <p>ManagedConnectionFactory uses the security info (as in Subject)
  and information provided through ConnectionRequestInfo and additional
  Resource Adapter specific criteria to do matching. Note that criteria
  used for matching is specific to a resource adapter and is not
  prescribed by the Connector specification.</p>

  <p>This method returns a ManagedConnection instance that is the best 
  match for handling the connection allocation request.</p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>connectionSet</CODE> - candidate connection set<DD><CODE>Subject</CODE> - caller's security information<DD><CODE>cxRequestInfo</CODE> - additional resource adapter specific connection
                           request information<DT><B>Returns:</B><DD>ManagedConnection     if resource adapter finds an
                                 acceptable match otherwise null<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - generic exception<DD><CODE><A HREF="../../../javax/resource/spi/SecurityException.html">SecurityException</A></CODE> - security related error<DD><CODE><A HREF="../../../javax/resource/spi/ResourceAdapterInternalException.html">ResourceAdapterInternalException</A></CODE> - resource adapter related error condition<DD><CODE>NotSupportedException</CODE> - if operation is not supported</DL>
</DD>
</DL>
<HR>

<A NAME="setLogWriter(java.io.PrintWriter)"><!-- --></A><H3>
setLogWriter</H3>
<PRE>
public void <B>setLogWriter</B>(java.io.PrintWriter&nbsp;out)
                  throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD><p>Set the log writer for this ManagedConnectionFactory instance.</p>

  <p>The log writer is a character output stream to which all logging and
  tracing messages for this ManagedConnectionfactory instance will be 
  printed.</p>

 <p>ApplicationServer manages the association of output stream with the
  ManagedConnectionFactory. When a ManagedConnectionFactory object is 
  created the log writer is initially null, in other words, logging is 
  disabled. Once a log writer is associated with a ManagedConnectionFactory,
  logging and tracing for ManagedConnectionFactory instance is enabled. 

  <p>The ManagedConnection instances created by ManagedConnectionFactory
  "inherits" the log writer, which can be overridden by ApplicationServer
  using ManagedConnection.setLogWriter to set ManagedConnection specific
  logging and tracing.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>out</CODE> - PrintWriter - an out stream for
                                 error logging and tracing<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - generic exception<DD><CODE><A HREF="../../../javax/resource/spi/ResourceAdapterInternalException.html">ResourceAdapterInternalException</A></CODE> - resource adapter related error condition</DL>
</DD>
</DL>
<HR>

<A NAME="getLogWriter()"><!-- --></A><H3>
getLogWriter</H3>
<PRE>
public java.io.PrintWriter <B>getLogWriter</B>()
                                 throws <A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></PRE>
<DL>
<DD>Get the log writer for this ManagedConnectionFactory instance.

  <p>The log writer is a character output stream to which all logging and
  tracing messages for this ManagedConnectionFactory instance will be 
  printed

  <p>ApplicationServer manages the association of output stream with the
  ManagedConnectionFactory. When a ManagedConnectionFactory object is 
  created the log writer is initially null, in other words, logging is 
  disabled.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>PrintWriter<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/resource/ResourceException.html">ResourceException</A></CODE> - generic exception</DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>Returns the hash code for the ManagedConnectionFactory<DD><DL>
<DT><B>Overrides:</B><DD><CODE>hashCode</CODE> in class <CODE>java.lang.Object</CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>hash code for the ManagedConnectionFactory</DL>
</DD>
</DL>
<HR>

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(java.lang.Object&nbsp;other)</PRE>
<DL>
<DD>Check if this ManagedConnectionFactory is equal to another
  ManagedConnectionFactory.<DD><DL>
<DT><B>Overrides:</B><DD><CODE>equals</CODE> in class <CODE>java.lang.Object</CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>true if two instances are equal</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/spi/ManagedConnection.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/resource/spi/ManagedConnectionMetaData.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="ManagedConnectionFactory.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>