Improvements for registering custom SQL exception translators in app contexts.

Adding a static CustomSQLExceptionTranslatorRegistry and a CustomSQLExceptionTranslatorRegistrar that can be used to register custom SQLExceptionTranslator implementations for specific databases from any application context.

This can be used in application contexts like this:

  <bean class="org.springframework.jdbc.support.CustomSQLExceptionTranslatorRegistrar">
    <property name="sqlExceptionTranslators">
      <map>
        <entry key="H2">
          <bean class="com.yourcompany.data.CustomSqlExceptionTranslator"/>
        </entry>
      </map>
    </property>
  </bean>

Issue: SPR-7675

org.springframework.jdbc/src/test/java/org/springframework/jdbc/support/CustomSQLExceptionTranslatorRegistrarTests.java

@@ -0,0 +1,67 @@
+/*
+ * Copyright 2002-2012 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.jdbc.support;
+
+import java.sql.SQLException;
+import java.util.HashMap;
+import java.util.Map;
+
+import org.junit.Before;
+import org.junit.Test;
+
+import org.springframework.context.support.ClassPathXmlApplicationContext;
+import org.springframework.dao.DataAccessException;
+import org.springframework.dao.TransientDataAccessResourceException;
+import org.springframework.jdbc.BadSqlGrammarException;
+
+import static org.junit.Assert.*;
+
+/**
+ * Tests for custom translator.
+ *
+ * @author Thomas Risberg
+ */
+public class CustomSQLExceptionTranslatorRegistrarTests {
+
+	@Before
+	public void setUp() {
+		new ClassPathXmlApplicationContext("test-custom-translators-context.xml",
+				CustomSQLExceptionTranslatorRegistrarTests.class);
+	}
+
+	@Test
+	public void testCustomErrorCodeTranslation() {
+
+		SQLErrorCodes codes = SQLErrorCodesFactory.getInstance().getErrorCodes("H2");
+		SQLErrorCodeSQLExceptionTranslator sext = new SQLErrorCodeSQLExceptionTranslator();
+		sext.setSqlErrorCodes(codes);
+
+		DataAccessException exFor4200 = sext.doTranslate("", "", new SQLException("Ouch", "42000", 42000));
+		assertNotNull("Should have been translated", exFor4200);
+		assertTrue("Should have been instance of BadSqlGrammarException",
+				BadSqlGrammarException.class.isAssignableFrom(exFor4200.getClass()));
+
+		DataAccessException exFor2 = sext.doTranslate("", "", new SQLException("Ouch", "42000", 2));
+		assertNotNull("Should have been translated", exFor2);
+		assertTrue("Should have been instance of TransientDataAccessResourceException",
+				TransientDataAccessResourceException.class.isAssignableFrom(exFor2.getClass()));
+
+		DataAccessException exFor3 = sext.doTranslate("", "", new SQLException("Ouch", "42000", 3));
+		assertNull("Should not have been translated", exFor3);
+	}
+
+}

org.springframework.jdbc/src/test/resources/org/springframework/jdbc/support/test-custom-translators-context.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<beans xmlns="http://www.springframework.org/schema/beans"
+    xmlns:jdbc="http://www.springframework.org/schema/jdbc"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
+		http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-3.0.xsd">
+
+	<jdbc:embedded-database id="dataSource" type="H2"/>
+
+	<bean class="org.springframework.jdbc.support.CustomSQLExceptionTranslatorRegistrar">
+		<property name="sqlExceptionTranslators">
+			<map>
+				<entry key="H2">
+					<bean class="org.springframework.jdbc.support.CustomSqlExceptionTranslator"/>
+				</entry>
+			</map>
+		</property>
+	</bean>
+
+</beans>