User: d_jencks
  Date: 02/04/05 20:34:28

  Modified:    src/main/org/jboss/resource/connectionmanager
                        BaseConnectionManager2.java
                        CachedConnectionManager.java
                        JBossManagedConnectionPool.java
                        LocalTxConnectionManager.java
                        NoTxConnectionManager.java RARDeployment.java
                        XATxConnectionManager.java
  Log:
  improved documentation
  
  Revision  Changes    Path
  1.2       +31 -14    
jbosscx/src/main/org/jboss/resource/connectionmanager/BaseConnectionManager2.java
  
  Index: BaseConnectionManager2.java
  ===================================================================
  RCS file: 
/cvsroot/jboss/jbosscx/src/main/org/jboss/resource/connectionmanager/BaseConnectionManager2.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- BaseConnectionManager2.java       24 Mar 2002 21:44:31 -0000      1.1
  +++ BaseConnectionManager2.java       6 Apr 2002 04:34:28 -0000       1.2
  @@ -44,7 +44,13 @@
   
   
   /**
  - * BaseConnectionManager2.java
  + * The BaseConnectionManager2 is an abstract base class for JBoss ConnectionManager 
  + * implementations.  It includes functionality to obtain managed connections from 
  + * a ManagedConnectionPool mbean, find the Subject from a SubjectSecurityDomain, 
  + * and interact with the CachedConnectionManager for connections held over 
  + * transaction and method boundaries.  Important mbean references are to a 
  + * ManagedConnectionPool supplier (typically a JBossManagedConnectionPool), and a 
  + * RARDeployment representing the ManagedConnectionFactory.
    *
    *
    * Created: Wed Jan  2 12:16:09 2002
  @@ -78,17 +84,16 @@
      private final Map managedConnectionToListenerMap = 
Collections.synchronizedMap(new HashMap());
   
      protected final Logger log = Logger.getLogger(getClass());
  -
  -
      /**
  -    * Creates a new <code>BaseConnectionManager2</code> instance.
  -    * Default constructor for use as mbean
  -    * @jmx:managed-constructor
  +    * Default BaseConnectionManager2 managed constructor for use by subclass mbeans.
  +    *
       */
  -   public BaseConnectionManager2() 
  +   public BaseConnectionManager2()
      {
      }
   
  +
  +
      /**
       * Creates a new <code>BaseConnectionManager2</code> instance.
       * for TESTING ONLY! not a managed operation.
  @@ -107,7 +112,10 @@
   
   
      /**
  -    * Get the ManagedConnectionFactoryName value.
  +    * ManagedConnectionFactoryName holds the ObjectName of the mbean that 
  +    * represents the ManagedConnectionFactory.  Normally this can be an 
  +    * embedded mbean in a depends element rather than a separate mbean 
  +    * reference.
       * @return the ManagedConnectionFactoryName value.
       * @jmx:managed-attribute
       */
  @@ -128,7 +136,9 @@
   
      
      /**
  -    * Get the ManagedConnectionPool value.
  +    * The ManagedConnectionPool holds the ObjectName of the mbean representing
  +    * the pool for this connection manager.  Normally it will be an embedded
  +    * mbean in a depends tag rather than an ObjectName reference to the mbean.
       * @return the ManagedConnectionPool value.
       * @jmx:managed-attribute
       */
  @@ -151,7 +161,10 @@
   
   
      /**
  -    * Describe <code>setCachecConnectionManager</code> method here.
  +    * The CachecConnectionManager holds the ObjectName of the 
  +    * CachedConnectionManager mbean used by this ConnectionManager.
  +    * Normally this will be a depends tag with the ObjectName of the 
  +    * unique CachedConnectionManager for the server.
       *
       * @param ccmName an <code>ObjectName</code> value
       * @jmx:managed-attribute
  @@ -176,7 +189,10 @@
   
   
      /**
  -    * Describe <code>setSecurityDomainJndiName</code> method here.
  +    *  The SecurityDomainJndiName holds the jndi name of the security domain 
  +    * configured for the ManagedConnectionFactory this ConnectionManager 
  +    * manages.  It is normally of the form java:/jaas/firebirdRealm,
  +    * where firebirdRealm is the name found in auth.conf or equivalent file.
       *
       * @param name an <code>String</code> value
       * @jmx:managed-attribute
  @@ -198,11 +214,12 @@
      
      
      /**
  -    * mbean get-set pair for field managedConnectionFactory
  -    * Get the value of managedConnectionFactory
  +    * ManagedConnectionFactory is an internal attribute that holds the 
  +    * ManagedConnectionFactory instance managed by this ConnectionManager.
  +    *
       * @return value of managedConnectionFactory
       *
  -    * @jmx:managed-attribute
  +    * @jmx.managed-attribute access="READ"
       */
      public ManagedConnectionFactory getManagedConnectionFactory()
      {
  
  
  
  1.2       +13 -6     
jbosscx/src/main/org/jboss/resource/connectionmanager/CachedConnectionManager.java
  
  Index: CachedConnectionManager.java
  ===================================================================
  RCS file: 
/cvsroot/jboss/jbosscx/src/main/org/jboss/resource/connectionmanager/CachedConnectionManager.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- CachedConnectionManager.java      24 Mar 2002 21:44:31 -0000      1.1
  +++ CachedConnectionManager.java      6 Apr 2002 04:34:28 -0000       1.2
  @@ -28,7 +28,11 @@
   
   
   /**
  - * CachedConnectionManager.java
  + * The CachedConnectionManager mbean manages associations between meta-aware 
objects 
  + * (those accessed through interceptor chains) and connection handles, and between
  + *  user transactions and connection handles.  Normally there should only be one 
  + * such mbean.  It is called by CachedConnectionInterceptor, UserTransaction, 
  + * and all BaseConnectionManager2 instances.
    *
    *
    * Created: Sat Jan  5 18:50:27 2002
  @@ -53,20 +57,23 @@
   
      protected final Logger log = Logger.getLogger(getClass());
   
  -   //Hopefully this will be replaced by mbean object name references
  -
  -   //private static final CachedConnectionManager instance = new 
CachedConnectionManager();
   
   
  +   /**
  +    * Default CachedConnectionManager managed constructor for mbeans. 
  +    * Remember that this mbean should be a singleton.
  +    * @jmx.managed-constructor
  +    */
      public CachedConnectionManager ()
      {
      }
   
      /**
  -    * The <code>getInstance</code> method returns this instance.
  +    * The Instance attribute simply holds the current instance,
  +    * which is normally the only instance of CachedConnectionManager.
       *
       * @return a <code>CachedConnectionManager</code> value
  -    * @jmx:managed-attribute
  +    * @jmx.managed-attribute access="READ"
       */
      public CachedConnectionManager getInstance()
      {
  
  
  
  1.2       +35 -9     
jbosscx/src/main/org/jboss/resource/connectionmanager/JBossManagedConnectionPool.java
  
  Index: JBossManagedConnectionPool.java
  ===================================================================
  RCS file: 
/cvsroot/jboss/jbosscx/src/main/org/jboss/resource/connectionmanager/JBossManagedConnectionPool.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- JBossManagedConnectionPool.java   24 Mar 2002 21:44:31 -0000      1.1
  +++ JBossManagedConnectionPool.java   6 Apr 2002 04:34:28 -0000       1.2
  @@ -29,7 +29,11 @@
   
   
   /**
  - * JBossManagedConnectionPool.java
  + * The JBossManagedConnectionPool mbean configures and supplies pooling of 
  + * ManagedConnections to the BaseConnectionManager2 mbean.  It may be 
  + * replaced by any mbean with a readable ManagedConnectionPool attribute 
  + * of type ManagedConnectionPool.  Normal pooling parameters are supplied, 
  + * and the criteria to distinguish ManagedConnections is set in the Criteria 
attribute.
    *
    *
    * Created: Sun Dec 30 21:17:36 2001
  @@ -51,15 +55,21 @@
   
      private final InternalManagedConnectionPool.PoolParams poolParams = new 
InternalManagedConnectionPool.PoolParams();
   
  +   /**
  +    * Default managed JBossManagedConnectionPool constructor for mbeans.
  +    *
  +    * @jmx.managed-constructor
  +    */
      public JBossManagedConnectionPool()
      {
      }
   
      /**
  -    * Describe <code>getManagedConnectionPool</code> method here.
  +    * ManagedConnectionPool is a read only attribute returning the pool
  +    * set up by this mbean.
       * 
  -    * @return a <code>ManagedConnectionPool</code> value
  -    * @jmx:managed-attribute
  +    * @return the ManagedConnectionPool implementing the pool configured by this 
mbean.
  +    * @jmx.managed-attribute access="READ"
       * @todo decide if this should be an attribute or an operation.
       */
      public ManagedConnectionPool getManagedConnectionPool()
  @@ -69,7 +79,11 @@
   
   
      /**
  -    * Get the MinSize value.
  +    * The MinSize attribute indicates the minimum number of connections this
  +    * pool should hold.  These are not created until a Subject is known from a
  +    * request for a connection.  MinSize connections will be created for 
  +    * each sub-pool.
  +    *
       * @return the MinSize value.
       * @jmx:managed-attribute
       */
  @@ -90,7 +104,10 @@
   
   
      /**
  -    * Get the MaxSize value.
  +    * The MaxSize attribute indicates the maximum number of connections for a 
  +    * pool. No more than MaxSize connections will be created in each 
  +    * sub-pool.
  +    *
       * @return the MaxSize value.
       * @jmx:managed-attribute
       */
  @@ -111,7 +128,12 @@
   
   
      /**
  -    * Get the BlockingTimeout value.
  +    * The BlockingTimeoutMillis attribute indicates the maximum time to block
  +    * while waiting for a connection before throwing an exception.  Note that 
  +    * this blocks only while waiting for a permit for a connection, and will
  +    * never throw an exception if creating a new connection takes an 
  +    * inordinately long time.
  +    *
       * @return the BlockingTimeout value.
       * @jmx:managed-attribute
       */
  @@ -132,7 +154,11 @@
   
   
      /**
  -    * Get the IdleTimeoutMinutes value.
  +    * The IdleTimeoutMinutes attribute indicates the maximum time a connection
  +    * may be idle before being closed.  The actual maximum time depends also 
  +    * on the IdleRemover scan time, which is 1/2 the smallest IdleTimeout of 
  +    * any pool.
  +    *
       * @return the IdleTimeoutMinutes value.
       * @jmx:managed-attribute
       */
  @@ -175,7 +201,7 @@
   
      
      /**
  -    * criteria indicates if Subject (from security domain) or app supplied
  +    * The Criteria attribute indicates if Subject (from security domain) or app 
supplied
       * parameters (such as from getConnection(user, pw)) are used to distinguish
       * connections in the pool. Choices are 
       *   ByContainerAndApplication (use both), 
  
  
  
  1.2       +26 -8     
jbosscx/src/main/org/jboss/resource/connectionmanager/LocalTxConnectionManager.java
  
  Index: LocalTxConnectionManager.java
  ===================================================================
  RCS file: 
/cvsroot/jboss/jbosscx/src/main/org/jboss/resource/connectionmanager/LocalTxConnectionManager.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- LocalTxConnectionManager.java     24 Mar 2002 21:44:31 -0000      1.1
  +++ LocalTxConnectionManager.java     6 Apr 2002 04:34:28 -0000       1.2
  @@ -38,14 +38,25 @@
   import org.jboss.system.Registry;
   
   /**
  - * LocalTxConnectionManager.java
  + * The LocalTxConnectionManager is a JBoss ConnectionManager 
  + * implementation for jca adapters implementing LocalTransaction support. 
  + * It implements a ConnectionEventListener that implements XAResource to 
  + * manage transactions through the Transaction Manager. To assure that all 
  + * work in a local transaction occurs over the same ManagedConnection, it 
  + * includes a xid to ManagedConnection map.  When a Connection is requested 
  + * or a transaction started with a connection handle in use, it checks to 
  + * see if a ManagedConnection already exists enrolled in the global 
  + * transaction and uses it if found. Otherwise a free ManagedConnection 
  + * has its LocalTransaction started and is used.  From the 
  + * BaseConnectionManager2, it includes functionality to obtain managed 
  + * connections from 
  + * a ManagedConnectionPool mbean, find the Subject from a SubjectSecurityDomain, 
  + * and interact with the CachedConnectionManager for connections held over 
  + * transaction and method boundaries.  Important mbean references are to a 
  + * ManagedConnectionPool supplier (typically a JBossManagedConnectionPool), and a 
  + * RARDeployment representing the ManagedConnectionFactory.
    *
    *
  - * Created: Thurs March 21 11:13:28 2002
  - *
  - * @author <a href="mailto:[EMAIL PROTECTED]";>David Jencks</a>
  - * @version $$
  - *
    *
    * This connection manager has to perform the following operations:
    *
  @@ -95,6 +106,12 @@
    * Entry point: ConnectionCacheListener.disconnect(Collection conns).
    * written.
    *
  + * Created: Thurs March 21 11:13:28 2002
  + *
  + * @author <a href="mailto:[EMAIL PROTECTED]";>David Jencks</a>
  + * @version $$
  + *
  + *
    * @jmx:mbean name="jboss.jca:service=LocalTxConnectionManager"
    *            extends="BaseConnectionManager2MBean"
    */
  @@ -110,7 +127,7 @@
      private final Map txToManagedConnectionMap = new HashMap();
   
      /**
  -    * Creates a new <code>LocalTxConnectionManager</code> instance.
  +    * Default managed LocalTxConnectionManager constructor for mbean instances.
       * @jmx:managed-constructor
       */
      public LocalTxConnectionManager()
  @@ -135,7 +152,8 @@
      }
      
      /**
  -    * Describe <code>setTransactionManager</code> method here.
  +    *  The TransactionManager attribute contains the jndi name of the 
  +    * TransactionManager.  This is normally java:/TransactionManager.
       *
       * @param name an <code>String</code> value
       * @jmx:managed-attribute
  
  
  
  1.2       +10 -3     
jbosscx/src/main/org/jboss/resource/connectionmanager/NoTxConnectionManager.java
  
  Index: NoTxConnectionManager.java
  ===================================================================
  RCS file: 
/cvsroot/jboss/jbosscx/src/main/org/jboss/resource/connectionmanager/NoTxConnectionManager.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- NoTxConnectionManager.java        24 Mar 2002 21:44:31 -0000      1.1
  +++ NoTxConnectionManager.java        6 Apr 2002 04:34:28 -0000       1.2
  @@ -17,7 +17,14 @@
   import javax.resource.spi.ManagedConnectionFactory;
   
   /**
  - * NoTxConnectionManager.java
  + * The NoTxConnectionManager is an simple extension class of the 
BaseConnectionManager2
  + * for use with jca adapters with no transaction support. 
  + *  It includes functionality to obtain managed connections from 
  + * a ManagedConnectionPool mbean, find the Subject from a SubjectSecurityDomain, 
  + * and interact with the CachedConnectionManager for connections held over 
  + * transaction and method boundaries.  Important mbean references are to a 
  + * ManagedConnectionPool supplier (typically a JBossManagedConnectionPool), and a 
  + * RARDeployment representing the ManagedConnectionFactory.
    *
    *
    * Created: Sat Jan 12 11:13:28 2002
  @@ -33,7 +40,7 @@
   {
   
      /**
  -    * Creates a new <code>NoTxConnectionManager</code> instance.
  +    * Creates a new NoTxConnectionManager instance.
       * @jmx:managed-constructor
       */
      public NoTxConnectionManager()
  @@ -41,7 +48,7 @@
      }
      
      /**
  -    * Creates a new <code>NoTxConnectionManager</code> instance.
  +    * Creates a new NoTxConnectionManager instance.
       * for TESTING ONLY! not a managed operation.
       * @param mcf a <code>ManagedConnectionFactory</code> value
       * @param ccm a <code>CachedConnectionManager</code> value
  
  
  
  1.2       +64 -18    
jbosscx/src/main/org/jboss/resource/connectionmanager/RARDeployment.java
  
  Index: RARDeployment.java
  ===================================================================
  RCS file: 
/cvsroot/jboss/jbosscx/src/main/org/jboss/resource/connectionmanager/RARDeployment.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- RARDeployment.java        24 Mar 2002 21:44:31 -0000      1.1
  +++ RARDeployment.java        6 Apr 2002 04:34:28 -0000       1.2
  @@ -41,7 +41,7 @@
   import org.w3c.dom.NodeList;
   
   /**
  - * RARDeployment.java
  + * The RARDeployment mbean manages instantiation and configuration of a 
ManagedConnectionFactory instance. It is intended to be configured primarily by xslt 
transformation of the ra.xml from a jca adapter. Until that is implemented, it uses 
the old RARDeployment and RARDeployer mechanism to obtain information from the ra.xml. 
 Properties for the ManagedConectionFactory should be supplied with their values in 
the ManagedConnectionFactoryProperties element.  A jndiname to bind the 
ConnectionFactory under must also be supplied.
    *
    *
    * Created: Fri Feb  8 13:44:31 2002
  @@ -84,6 +84,11 @@
      private Class mcfClass;
      private ManagedConnectionFactory mcf;
   
  +   /**
  +    * Default managed constructor for RARDeployment mbeans.
  +    *
  +    * @jmx.managed-constructor
  +    */
      public RARDeployment ()
      {
         
  @@ -93,9 +98,9 @@
      
      
      /**
  -    * mbean get-set pair for field OldRarDeployment
  +    * The OldRarDeployment attribute refers to a previous-generation RARDeployment.
       * THIS IS A HACK UNTIL XSLT DEPLOYMENT IS WRITTEN
  -    * Get the value of OldRarDeployment
  +    * 
       * @return value of OldRarDeployment
       *
       * @jmx:managed-attribute
  @@ -123,7 +128,9 @@
   
   
      /**
  -    * Get the DisplayName value.
  +    * The DisplayName attribute holds the DisplayName from the ra.xml
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the DisplayName value.
       * @jmx:managed-attribute
       */
  @@ -144,7 +151,9 @@
   
   
      /**
  -    * Get the VendorName value.
  +    * The VendorName attribute holds the VendorName from the ra.xml
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the VendorName value.
       * @jmx:managed-attribute
       */
  @@ -165,7 +174,9 @@
   
   
      /**
  -    * Get the SpecVersion value.
  +    * The SpecVersion attribute holds the SpecVersion from the ra.xml
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the SpecVersion value.
       * @jmx:managed-attribute
       */
  @@ -186,7 +197,9 @@
   
   
      /**
  -    * Get the EisType value.
  +    * The EisType attribute holds the EisType from the ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the EisType value.
       * @jmx:managed-attribute
       */
  @@ -207,7 +220,9 @@
   
   
      /**
  -    * Get the Version value.
  +    * The Version attribute holds the Version from the ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the Version value.
       * @jmx:managed-attribute
       */
  @@ -228,7 +243,9 @@
   
   
      /**
  -    * Get the ManagedConnectionFactoryClass value.
  +    * The ManagedConnectionFactoryClass attribute holds the 
ManagedConnectionFactoryClass from the ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the ManagedConnectionFactoryClass value.
        * @jmx:managed-attribute
      */
  @@ -250,7 +267,9 @@
      
   
      /**
  -    * Get the ConnectionFactoryInterface value.
  +    * The ConnectionFactoryInterface attribute holds the ConnectionFactoryInterface 
from the ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the ConnectionFactoryInterface value.
       * @jmx:managed-attribute
       */
  @@ -271,7 +290,9 @@
   
   
      /**
  -    * Get the ConnectionFactoryImplClass value.
  +    * The ConnectionFactoryImplClass attribute holds the ConnectionFactoryImplClass 
from the ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the ConnectionFactoryImplClass value.
       * @jmx:managed-attribute
       */
  @@ -292,7 +313,9 @@
   
   
      /**
  -    * Get the ConnectionInterface value.
  +    * The ConnectionInterface attribute holds the ConnectionInterface from the 
ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the ConnectionInterface value.
       * @jmx:managed-attribute
       */
  @@ -313,7 +336,9 @@
   
   
      /**
  -    * Get the ConnectionImplClass value.
  +    * The ConnectionImplClass attribute holds the ConnectionImplClass from the 
ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the connectionImplClass value.
       * @jmx:managed-attribute
       */
  @@ -334,6 +359,11 @@
   
   
      /**
  +    * The TransactionSupport attribute holds the TransactionSupport from the 
ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    * It is ignored, and choice of ConnectionManager implementations determine
  +    * transaction support.
  +    *
       * Get the TransactionSupport value.
       * @return the TransactionSupport value.
       * @jmx:managed-attribute
  @@ -355,7 +385,14 @@
   
   
      /**
  -    * Get the ManagedConnectionFactoryProperties value.
  +    * The ManagedConnectionFactoryProperties attribute holds the 
  +    * ManagedConnectionFactoryProperties from the ra.xml, together with 
  +    * user supplied values for all or some of these properties.  This must be
  +    * supplied as an element in the same format as in ra.xml, wrapped in a 
  +    * properties tag.
  +    * It should be supplied by xslt from ra.xml merged with an user
  +    * configuration xml file.
  +    *
       * @return the ManagedConnectionFactoryProperties value.
       * @jmx:managed-attribute
       */
  @@ -376,7 +413,9 @@
   
   
      /**
  -    * Get the AuthenticationMechanismType value.
  +    * The AuthenticationMechanismType attribute holds the 
AuthenticationMechanismType from the ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the AuthenticationMechanismType value.
       * @jmx:managed-attribute
       */
  @@ -397,7 +436,9 @@
   
   
      /**
  -    * Get the CredentialInterface value.
  +    * The CredentialInterface attribute holds the CredentialInterface from the 
ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the CredentialInterface value.
       * @jmx:managed-attribute
       */
  @@ -418,7 +459,9 @@
   
   
      /**
  -    * Get the ReauthenticationSupport value.
  +    * The ReauthenticationSupport attribute holds the ReauthenticationSupport from 
the ra.xml. 
  +    * It should be supplied by xslt from ra.xml
  +    *
       * @return the ReauthenticationSupport value.
       * @jmx:managed-attribute
       */
  @@ -439,7 +482,10 @@
   
   
      /**
  -    * Get the JndiName value.
  +    * The JndiName attribute holds the jndi name the ConnectionFactory
  +    * will be bound under in jndi.  Note that an entry of the form DefaultDS2
  +    * will be bound to java:/DefaultDS2.
  +    *
       * @return the JndiName value.
       * @jmx:managed-attribute
       */
  
  
  
  1.2       +18 -14    
jbosscx/src/main/org/jboss/resource/connectionmanager/XATxConnectionManager.java
  
  Index: XATxConnectionManager.java
  ===================================================================
  RCS file: 
/cvsroot/jboss/jbosscx/src/main/org/jboss/resource/connectionmanager/XATxConnectionManager.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- XATxConnectionManager.java        24 Mar 2002 21:44:31 -0000      1.1
  +++ XATxConnectionManager.java        6 Apr 2002 04:34:28 -0000       1.2
  @@ -32,16 +32,8 @@
   import org.jboss.system.Registry;
   
   /**
  - * XATxConnectionManager.java
    *
  - *
  - * Created: Sat Jan 12 11:13:28 2002
  - *
  - * @author <a href="mailto:[EMAIL PROTECTED]";>David Jencks</a>
  - * @version $$
  - *
  - *
  - * This connection manager has to perform the following operations:
  + * The XATxConnectionManager connection manager has to perform the following 
operations:
    *
    * 1. When an application component requests a new ConnectionHandle,
    *    it must find a ManagedConnection, and make sure a
  @@ -93,6 +85,19 @@
    * Entry point: ConnectionCacheListener.disconnect(Collection conns).
    * written.
    *
  + * In addition it inherits behavior from BaseConnectionManager2,  including
  + *  functionality to obtain managed connections from 
  + * a ManagedConnectionPool mbean, find the Subject from a SubjectSecurityDomain, 
  + * and interact with the CachedConnectionManager for connections held over 
  + * transaction and method boundaries.  Important mbean references are to a 
  + * ManagedConnectionPool supplier (typically a JBossManagedConnectionPool), and a 
  + * RARDeployment representing the ManagedConnectionFactory.
  + * 
  + * Created: Sat Jan 12 11:13:28 2002
  + *
  + * @author <a href="mailto:[EMAIL PROTECTED]";>David Jencks</a>
  + * @version $$
  + *
    * @jmx:mbean name="jboss.jca:service=XATxConnectionManager"
    *            extends="BaseConnectionManager2MBean"
    */
  @@ -105,7 +110,7 @@
      private TransactionManager tm;
   
      /**
  -    * Creates a new <code>XATxConnectionManager</code> instance.
  +    * Default managed XATxConnectionManager constructor for mbean instances.
       * @jmx:managed-constructor
       */
      public XATxConnectionManager()
  @@ -130,9 +135,10 @@
      }
      
      /**
  -    * Describe <code>setTransactionManager</code> method here.
  +    * The TransactionManager attribute holds the jndi name of the 
  +    * TransactionManager. This is normally java:/TransactionManager
       *
  -    * @param name an <code>String</code> value
  +    * @param name The JNDI name the transaction manager is bound under.
       * @jmx:managed-attribute
       */
      public void setTransactionManager(final String tmName)
  @@ -141,7 +147,6 @@
      }
   
      /**
  -    * Describe <code>getTransactionManager</code> method here.
       *
       * @return an <code>String</code> value
       * @jmx:managed-attribute
  @@ -226,7 +231,6 @@
      //there is one of these for each ManagedConnection instance.  It lives as long 
as the ManagedConnection.
      private class XAConnectionEventListener 
         extends BaseConnectionManager2.BaseConnectionEventListener
  -              //implements Synchronization
      {
      
         private Transaction currentTx;
  
  
  

_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development

Reply via email to