[jboss-cvs] JBossAS SVN: r111828 - in projects/jboss-jca/branches/Branch_1_0: doc/userguide/en-US/modules and 1 other directory.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Mon Jul 25 11:07:22 EDT 2011
Author: jesper.pedersen
Date: 2011-07-25 11:07:21 -0400 (Mon, 25 Jul 2011)
New Revision: 111828
Modified:
projects/jboss-jca/branches/Branch_1_0/common/src/main/resources/schema/datasources_1_0.xsd
projects/jboss-jca/branches/Branch_1_0/doc/userguide/en-US/modules/deployment.xml
Log:
Datasource extensions
Modified: projects/jboss-jca/branches/Branch_1_0/common/src/main/resources/schema/datasources_1_0.xsd
===================================================================
--- projects/jboss-jca/branches/Branch_1_0/common/src/main/resources/schema/datasources_1_0.xsd 2011-07-25 15:05:03 UTC (rev 111827)
+++ projects/jboss-jca/branches/Branch_1_0/common/src/main/resources/schema/datasources_1_0.xsd 2011-07-25 15:07:21 UTC (rev 111828)
@@ -404,7 +404,7 @@
a SQLException isValidConnection(Connection e) method to validate is a connection
is valid. An exception means the connection is destroyed. This overrides
the check-valid-connection-sql when present. Ex:
- <exception-sorter-class-name>org.jboss.jca.adapters.jdbc.vendor.OracleValidConnectionChecker</exception-sorter-class-name>
+ <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.vendor.OracleValidConnectionChecker"/>
]]>
</xs:documentation>
</xs:annotation>
@@ -471,7 +471,7 @@
a boolean isStaleConnection(SQLException e) method which if it it returns
true will wrap the exception in an org.jboss.jca.adapters.jdbc.StaleConnectionException
which is a subclass of SQLException. Ex:
- <stale-connection-checker-class-name>org.jboss.jca.adapters.jdbc.vendor.OracleStaleConnectionChecker</stale-connection-checker-class-name>
+ <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.vendor.OracleStaleConnectionChecker"/>
]]>
</xs:documentation>
</xs:annotation>
@@ -484,7 +484,7 @@
boolean isExceptionFatal(SQLException e) method to validate is an exception
should be broadcast to all javax.resource.spi.ConnectionEventListener as
a connectionErrorOccurred message. Ex:
- <exception-sorter-class-name>org.jboss.jca.adapters.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
+ <exception-sorter class-name="org.jboss.jca.adapters.jdbc.vendor.OracleExceptionSorter"/>
]]>
</xs:documentation>
</xs:annotation>
Modified: projects/jboss-jca/branches/Branch_1_0/doc/userguide/en-US/modules/deployment.xml
===================================================================
--- projects/jboss-jca/branches/Branch_1_0/doc/userguide/en-US/modules/deployment.xml 2011-07-25 15:05:03 UTC (rev 111827)
+++ projects/jboss-jca/branches/Branch_1_0/doc/userguide/en-US/modules/deployment.xml 2011-07-25 15:07:21 UTC (rev 111828)
@@ -1419,6 +1419,169 @@
</section>
+ <section id="deployingds_extensions">
+ <title>Datasource extensions</title>
+
+ <para>
+ The datasource deployments can make use of a couple of extensions in the JDBC resource adapter
+ to improve the connection validation and checking if an exception should reestablish
+ the connection in question.
+ </para>
+
+ <para>
+ The extensions include
+
+ <itemizedlist>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.spi.ExceptionSorter</code>: Plugin to check if a
+ <code>SQLException</code> is fatal for the connection on which it was thrown.
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.spi.StaleConnection</code>: Plugin to wrap stale
+ <code>SQLException</code>'s in a <code>org.jboss.jca.adapters.jdbc.StaleConnectionException</code>.
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.spi.ValidConnection</code>: Plugin to Check if a connection is
+ valid for use by the application.
+ </listitem>
+ </itemizedlist>
+
+ </para>
+
+ <para>
+ Configuration of the extensions are done by using
+
+ <itemizedlist>
+ <listitem>
+ The <code><exception-sorter></code> tag for an <code>ExceptionSorter</code>
+ </listitem>
+ <listitem>
+ The <code><stale-connection-checker></code> tag for a <code>StaleConnection</code>
+ </listitem>
+ <listitem>
+ The <code><valid-connection-checker></code> tag for a <code>ValidConnection</code>
+ </listitem>
+ </itemizedlist>
+
+ </para>
+
+ <para>
+ IronJacamar features implementations of these extensions for a couple of popular databases.
+ Contributions in this area are most welcome either generic solutions or for a specific database.
+ </para>
+
+ <para>
+ Informix:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.informix.InformixExceptionSorter</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ Microsoft SQLServer:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ PostgreSQL:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ MySQL:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLReplicationValidConnectionChecker</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ IBM DB2:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.db2.DB2ExceptionSorter</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.db2.DB2StaleConnectionChecker</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.db2.DB2ValidConnectionChecker</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ Generic:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.novendor.NullExceptionSorter</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.novendor.NullStaleConnectionChecker</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.novendor.NullValidConnectionChecker</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ Sybase:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseExceptionSorter</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseValidConnectionChecker</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <para>
+ Oracle:
+
+ <itemizedlist spacing="compact">
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker</code>
+ </listitem>
+ <listitem>
+ <code>org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker</code>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ </section>
+
</section>
</chapter>
More information about the jboss-cvs-commits
mailing list