|
|
|
|
@ -5,33 +5,34 @@
@@ -5,33 +5,34 @@
|
|
|
|
|
[[xsd-schemas]] |
|
|
|
|
== XML Schemas |
|
|
|
|
|
|
|
|
|
This part of the appendix lists XML schemas for data access. |
|
|
|
|
This part of the appendix lists XML schemas for data access, including the following: |
|
|
|
|
|
|
|
|
|
* <<xsd-schemas-tx>> |
|
|
|
|
* <<xsd-schemas-jdbc>> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[[xsd-schemas-tx]] |
|
|
|
|
=== The `tx` schema |
|
|
|
|
=== The `tx` Schema |
|
|
|
|
|
|
|
|
|
The `tx` tags deal with configuring all of those beans in Spring's comprehensive support |
|
|
|
|
for transactions. These tags are covered in the chapter entitled |
|
|
|
|
<<data-access.adoc#transaction,Transaction Management>>. |
|
|
|
|
|
|
|
|
|
[TIP] |
|
|
|
|
==== |
|
|
|
|
|
|
|
|
|
You are strongly encouraged to look at the `'spring-tx.xsd'` file that ships with the |
|
|
|
|
Spring distribution. This file is (of course), the XML Schema for Spring's transaction |
|
|
|
|
configuration, and covers all of the various tags in the `tx` namespace, including |
|
|
|
|
attribute defaults and suchlike. This file is documented inline, and thus the |
|
|
|
|
TIP: We strongly encourag you to look at the `'spring-tx.xsd'` file that ships with the |
|
|
|
|
Spring distribution. This file contains the XML Schema for Spring's transaction |
|
|
|
|
configuration and covers all of the various elements in the `tx` namespace, including |
|
|
|
|
attribute defaults and similar information. This file is documented inline, and, thus, the |
|
|
|
|
information is not repeated here in the interests of adhering to the DRY (Don't Repeat |
|
|
|
|
Yourself) principle. |
|
|
|
|
==== |
|
|
|
|
|
|
|
|
|
In the interest of completeness, to use the tags in the `tx` schema, you need to have |
|
|
|
|
the following preamble at the top of your Spring XML configuration file; the text in the |
|
|
|
|
In the interest of completeness, to use the elements in the `tx` schema, you need to have |
|
|
|
|
the following preamble at the top of your Spring XML configuration file. The text in the |
|
|
|
|
following snippet references the correct schema so that the tags in the `tx` namespace |
|
|
|
|
are available to you. |
|
|
|
|
are available to you: |
|
|
|
|
|
|
|
|
|
==== |
|
|
|
|
[source,xml,indent=0] |
|
|
|
|
[subs="verbatim,quotes"] |
|
|
|
|
---- |
|
|
|
|
@ -39,45 +40,49 @@ are available to you.
@@ -39,45 +40,49 @@ are available to you.
|
|
|
|
|
<beans xmlns="http://www.springframework.org/schema/beans" |
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
xmlns:aop="http://www.springframework.org/schema/aop" |
|
|
|
|
__xmlns:tx="http://www.springframework.org/schema/tx"__ xsi:schemaLocation=" |
|
|
|
|
xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation=" <1> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd |
|
|
|
|
__http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd__ |
|
|
|
|
http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd <2> |
|
|
|
|
http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd"> <!-- bean definitions here --> |
|
|
|
|
|
|
|
|
|
</beans> |
|
|
|
|
---- |
|
|
|
|
|
|
|
|
|
[NOTE] |
|
|
|
|
<1> Specify the namespace. |
|
|
|
|
<2> Specify the location (with other schema locations). |
|
|
|
|
==== |
|
|
|
|
Often when using the tags in the `tx` namespace you will also be using the tags from the |
|
|
|
|
|
|
|
|
|
NOTE: Often, when you use the elements in the `tx` namespace, you are also using the elements from the |
|
|
|
|
`aop` namespace (since the declarative transaction support in Spring is implemented |
|
|
|
|
using AOP). The above XML snippet contains the relevant lines needed to reference the |
|
|
|
|
`aop` schema so that the tags in the `aop` namespace are available to you. |
|
|
|
|
==== |
|
|
|
|
by using AOP). The preceding XML snippet contains the relevant lines needed to reference the |
|
|
|
|
`aop` schema so that the elements in the `aop` namespace are available to you. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[[xsd-schemas-jdbc]] |
|
|
|
|
=== The `jdbc` schema |
|
|
|
|
=== The `jdbc` Schema |
|
|
|
|
|
|
|
|
|
The `jdbc` tags allow you to quickly configure an embedded database or initialize an |
|
|
|
|
existing data source. These tags are documented in |
|
|
|
|
<<data-access.adoc#jdbc-embedded-database-support,Embedded database support>> |
|
|
|
|
and <<data-access.adoc#jdbc-initializing-datasource,Initializing a DataSource>> respectively. |
|
|
|
|
The `jdbc` elements let you quickly configure an embedded database or initialize an |
|
|
|
|
existing data source. These elements are documented in |
|
|
|
|
<<data-access.adoc#jdbc-embedded-database-support,Embedded Database Support>> |
|
|
|
|
and <<data-access.adoc#jdbc-initializing-datasource,Initializing a DataSource>>, respectively. |
|
|
|
|
|
|
|
|
|
To use the tags in the `jdbc` schema, you need to have the following preamble at the top |
|
|
|
|
of your Spring XML configuration file; the text in the following snippet references the |
|
|
|
|
correct schema so that the tags in the `jdbc` namespace are available to you. |
|
|
|
|
To use the elements in the `jdbc` schema, you need to have the following preamble at the top |
|
|
|
|
of your Spring XML configuration file. The text in the following snippet references the |
|
|
|
|
correct schema so that the elements in the `jdbc` namespace are available to you: |
|
|
|
|
|
|
|
|
|
==== |
|
|
|
|
[source,xml,indent=0] |
|
|
|
|
[subs="verbatim,quotes"] |
|
|
|
|
---- |
|
|
|
|
<?xml version="1.0" encoding="UTF-8"?> |
|
|
|
|
<beans xmlns="http://www.springframework.org/schema/beans" |
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
__xmlns:jdbc="http://www.springframework.org/schema/jdbc"__ xsi:schemaLocation=" |
|
|
|
|
xmlns:jdbc="http://www.springframework.org/schema/jdbc" xsi:schemaLocation=" <2> |
|
|
|
|
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.xsd"__> <!-- bean definitions here --> |
|
|
|
|
http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc.xsd"> <!-- bean definitions here --> <2> |
|
|
|
|
|
|
|
|
|
</beans> |
|
|
|
|
---- |
|
|
|
|
<1> Specify the namespace. |
|
|
|
|
<2> Specify the location (with other schema locations). |
|
|
|
|
==== |
|
|
|
|
|