Deprecate JCA CCI support

Closes gh-25287

Author: jhoeller

spring-tx/src/main/java/org/springframework/jca/cci/CannotCreateRecordException.java

@@ -26,7 +26,10 @@
  *
  * @author Juergen Hoeller
  * @since 1.2
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class CannotCreateRecordException extends DataAccessResourceFailureException {
 

spring-tx/src/main/java/org/springframework/jca/cci/CannotGetCciConnectionException.java

@@ -26,7 +26,10 @@
  * @author Thierry Templier
  * @author Juergen Hoeller
  * @since 1.2
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class CannotGetCciConnectionException extends DataAccessResourceFailureException {
 

spring-tx/src/main/java/org/springframework/jca/cci/CciOperationNotSupportedException.java

@@ -25,7 +25,10 @@
  *
  * @author Juergen Hoeller
  * @since 1.2
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class CciOperationNotSupportedException extends InvalidDataAccessResourceUsageException {
 

spring-tx/src/main/java/org/springframework/jca/cci/InvalidResultSetAccessException.java

@@ -30,7 +30,10 @@
  * @author Juergen Hoeller
  * @since 1.2
  * @see javax.resource.cci.ResultSet
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class InvalidResultSetAccessException extends InvalidDataAccessResourceUsageException {
 

spring-tx/src/main/java/org/springframework/jca/cci/RecordTypeNotSupportedException.java

@@ -26,7 +26,10 @@
  *
  * @author Juergen Hoeller
  * @since 1.2
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class RecordTypeNotSupportedException extends InvalidDataAccessResourceUsageException {
 

spring-tx/src/main/java/org/springframework/jca/cci/connection/CciLocalTransactionManager.java

@@ -61,7 +61,10 @@
  * @see ConnectionFactoryUtils#releaseConnection
  * @see TransactionAwareConnectionFactoryProxy
  * @see org.springframework.jca.cci.core.CciTemplate
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class CciLocalTransactionManager extends AbstractPlatformTransactionManager
 		implements ResourceTransactionManager, InitializingBean {

spring-tx/src/main/java/org/springframework/jca/cci/connection/ConnectionFactoryUtils.java

@@ -24,7 +24,6 @@
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
 
-import org.springframework.jca.cci.CannotGetCciConnectionException;
 import org.springframework.lang.Nullable;
 import org.springframework.transaction.support.ResourceHolderSynchronization;
 import org.springframework.transaction.support.TransactionSynchronizationManager;
@@ -49,7 +48,10 @@
  * @see CciLocalTransactionManager
  * @see org.springframework.transaction.jta.JtaTransactionManager
  * @see org.springframework.transaction.support.TransactionSynchronizationManager
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 public abstract class ConnectionFactoryUtils {
 
 	private static final Log logger = LogFactory.getLog(ConnectionFactoryUtils.class);
@@ -68,7 +70,9 @@ public abstract class ConnectionFactoryUtils {
 	 * if the attempt to get a Connection failed
 	 * @see #releaseConnection
 	 */
-	public static Connection getConnection(ConnectionFactory cf) throws CannotGetCciConnectionException {
+	public static Connection getConnection(ConnectionFactory cf)
+			throws org.springframework.jca.cci.CannotGetCciConnectionException {
+
 		return getConnection(cf, null);
 	}
 
@@ -89,7 +93,7 @@ public static Connection getConnection(ConnectionFactory cf) throws CannotGetCci
 	 * @see #releaseConnection
 	 */
 	public static Connection getConnection(ConnectionFactory cf, @Nullable ConnectionSpec spec)
-			throws CannotGetCciConnectionException {
+			throws org.springframework.jca.cci.CannotGetCciConnectionException {
 		try {
 			if (spec != null) {
 				Assert.notNull(cf, "No ConnectionFactory specified");
@@ -100,7 +104,7 @@ public static Connection getConnection(ConnectionFactory cf, @Nullable Connectio
 			}
 		}
 		catch (ResourceException ex) {
-			throw new CannotGetCciConnectionException("Could not get CCI Connection", ex);
+			throw new org.springframework.jca.cci.CannotGetCciConnectionException("Could not get CCI Connection", ex);
 		}
 	}
 

spring-tx/src/main/java/org/springframework/jca/cci/connection/ConnectionHolder.java

@@ -32,7 +32,10 @@
  * @since 1.2
  * @see CciLocalTransactionManager
  * @see ConnectionFactoryUtils
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 public class ConnectionHolder extends ResourceHolderSupport {
 
 	private final Connection connection;

spring-tx/src/main/java/org/springframework/jca/cci/connection/ConnectionSpecConnectionFactoryAdapter.java

@@ -64,7 +64,10 @@
  * @author Juergen Hoeller
  * @since 1.2
  * @see #getConnection
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class ConnectionSpecConnectionFactoryAdapter extends DelegatingConnectionFactory {
 

spring-tx/src/main/java/org/springframework/jca/cci/connection/DelegatingConnectionFactory.java

@@ -40,7 +40,10 @@
  * @author Juergen Hoeller
  * @since 1.2
  * @see #getConnection
+ * @deprecated as of 5.3, in favor of specific data access APIs
+ * (or native CCI usage if there is no alternative)
  */
+@Deprecated
 @SuppressWarnings("serial")
 public class DelegatingConnectionFactory implements ConnectionFactory, InitializingBean {