[jboss-cvs] JBossAS SVN: r94221 - projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api.

[jboss-cvs-commits at lists.jboss.org]

Author: gurkanerdogdu
Date: 2009-10-01 14:44:43 -0400 (Thu, 01 Oct 2009)
New Revision: 94221

Added:
   projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java
Removed:
   projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java
Modified:
   projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/ConnectionManager.java
Log:
[JBJCA-182] ConnectionManager API Implementation Dependency

Modified: projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/ConnectionManager.java
===================================================================
--- projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/ConnectionManager.java	2009-10-01 17:38:18 UTC (rev 94220)
+++ projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/ConnectionManager.java	2009-10-01 18:44:43 UTC (rev 94221)
@@ -22,25 +22,22 @@
 
 package org.jboss.jca.core.api;
 
-import org.jboss.jca.core.connectionmanager.transaction.JTATransactionChecker;
-
-import java.io.Serializable;
-
-import org.jboss.tm.TransactionTimeoutConfiguration;
-
 /**
- * The JBoss specific connection manager interface
+ * The JBoss specific connection manager interface.
+ * 
  * @author <a href="mailto:gurkanerdogdu at yahoo.com">Gurkan Erdogdu</a>
  * @version $Rev$ $Date$
  */
 public interface ConnectionManager extends 
-   javax.resource.spi.ConnectionManager,
-   Serializable,
-   TransactionTimeoutConfiguration,
-   JTATransactionChecker
+   javax.resource.spi.ConnectionManager
 {   
    /**
     * Sets real connection manager.
+    * <p>
+    * <code>ConnectionManager</code> delegates to all connection related operations
+    * to the <code>RealConnectionManager</code>. {@link RealConnectionManager} implemetation
+    * is responsible for managing the connection pools and handling transactions over connections. 
+    * </p>
     * @param realConnectionManager real connection manager
     */
    public void setRealConnectionManager(RealConnectionManager realConnectionManager);

Deleted: projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java
===================================================================
--- projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java	2009-10-01 17:38:18 UTC (rev 94220)
+++ projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java	2009-10-01 18:44:43 UTC (rev 94221)
@@ -1,55 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source.
- * Copyright 2008-2009, Red Hat Middleware LLC, and individual contributors
- * as indicated by the @author tags. See the copyright.txt file in the
- * distribution for a full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-package org.jboss.jca.core.api;
-
-import org.jboss.jca.core.connectionmanager.listener.ConnectionCacheListener;
-import org.jboss.jca.core.connectionmanager.listener.ConnectionListenerFactory;
-import org.jboss.jca.core.connectionmanager.transaction.JTATransactionChecker;
-
-import javax.resource.ResourceException;
-import javax.resource.spi.ConnectionRequestInfo;
-import javax.resource.spi.ManagedConnectionFactory;
-
-import org.jboss.tm.TransactionTimeoutConfiguration;
-
-/**
- * Real connection manager contract.
- * @author <a href="mailto:gurkanerdogdu at yahoo.com">Gurkan Erdogdu</a> 
- * @version $Rev$ $Date$
- *
- */
-public interface RealConnectionManager extends
-   ConnectionCacheListener, 
-   ConnectionListenerFactory, 
-   TransactionTimeoutConfiguration, 
-   JTATransactionChecker
-
-{
-   /**
-    * Gets connection handle instance.
-    * @param mcf managed connection factory
-    * @param cri connection request info
-    * @return ne wconnection
-    * @throws ResourceException for exception
-    */
-   public Object allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cri) throws ResourceException;
-}

Added: projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java
===================================================================
--- projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java	                        (rev 0)
+++ projects/jboss-jca/trunk/core/src/main/java/org/jboss/jca/core/api/RealConnectionManager.java	2009-10-01 18:44:43 UTC (rev 94221)
@@ -0,0 +1,65 @@
+/*
+ * JBoss, Home of Professional Open Source.
+ * Copyright 2008-2009, Red Hat Middleware LLC, and individual contributors
+ * as indicated by the @author tags. See the copyright.txt file in the
+ * distribution for a full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+package org.jboss.jca.core.api;
+
+import org.jboss.jca.core.connectionmanager.listener.ConnectionCacheListener;
+import org.jboss.jca.core.connectionmanager.listener.ConnectionListenerFactory;
+import org.jboss.jca.core.connectionmanager.transaction.JTATransactionChecker;
+
+import javax.resource.ResourceException;
+import javax.resource.spi.ConnectionRequestInfo;
+import javax.resource.spi.ManagedConnectionFactory;
+
+import org.jboss.tm.TransactionTimeoutConfiguration;
+
+/**
+ * Real connection manager contract.
+ * <p>
+ * <ul>
+ *    <li>Responsible for managing cached connections over transactional 
+ *    components via {@link ConnectionCacheListener}</li>
+ *    <li>Responsible for managing connection instances using event listener 
+ *    via {@link ConnectionListenerFactory}</li>
+ *    <li>Responsible for managing transaction operations via 
+ *    {@link TransactionTimeoutConfiguration} and {@link JTATransactionChecker}</li>.
+ * </ul>
+ * </p> 
+ * @author <a href="mailto:gurkanerdogdu at yahoo.com">Gurkan Erdogdu</a> 
+ * @version $Rev$ $Date$
+ *
+ */
+public interface RealConnectionManager extends
+   ConnectionCacheListener, 
+   ConnectionListenerFactory, 
+   TransactionTimeoutConfiguration, 
+   JTATransactionChecker
+
+{
+   /**
+    * Gets connection handle instance.
+    * @param mcf managed connection factory
+    * @param cri connection request info
+    * @return ne wconnection
+    * @throws ResourceException for exception
+    */
+   public Object allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cri) throws ResourceException;
+}