mirror of
https://github.com/spring-projects/spring-framework.git
synced 2026-09-17 16:39:29 +00:00
Sam Brannen
15d7a3b327
Prior to this commit, some same-page links in our Antora-based docs were written using the `xref:` macro, which Antora resolves as a cross-page reference. However, a same-page target can be misread as a page reference and break the site build (as nearly happened in gh-37152), whereas `<<id,text>>` only ever resolves against the current page's own anchors. To address that inconsistency and avoid potential future bugs (broken links), this commit converts all such same-page `xref:` links to `<<id,text>>`, leaving genuine cross-page `xref:` links are unaffected. Closes gh-37161
90 lines
3.6 KiB
Plaintext
90 lines
3.6 KiB
Plaintext
[[appendix]]
|
|
= Appendix
|
|
|
|
|
|
[[xsd-schemas]]
|
|
== XML Schemas
|
|
|
|
This part of the appendix lists XML schemas for data access, including the following:
|
|
|
|
* <<xsd-schemas-tx,The `tx` Schema>>
|
|
* <<xsd-schemas-jdbc,The `jdbc` Schema>>
|
|
|
|
[[xsd-schemas-tx]]
|
|
=== 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
|
|
xref:data-access/transaction.adoc[Transaction Management].
|
|
|
|
TIP: We strongly encourage 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 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:
|
|
|
|
[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:tx="http://www.springframework.org/schema/tx" <1>
|
|
xmlns:aop="http://www.springframework.org/schema/aop"
|
|
xsi:schemaLocation="
|
|
http://www.springframework.org/schema/beans
|
|
https://www.springframework.org/schema/beans/spring-beans.xsd
|
|
http://www.springframework.org/schema/tx
|
|
https://www.springframework.org/schema/tx/spring-tx.xsd <2>
|
|
http://www.springframework.org/schema/aop
|
|
https://www.springframework.org/schema/aop/spring-aop.xsd">
|
|
|
|
<!-- bean definitions here -->
|
|
|
|
</beans>
|
|
----
|
|
<1> Declare usage of the `tx` namespace.
|
|
<2> Specify the location (with other schema locations).
|
|
|
|
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 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` elements let you quickly configure an embedded database or initialize an
|
|
existing data source. These elements are documented in
|
|
xref:data-access/jdbc/embedded-database-support.adoc[Embedded Database Support] and
|
|
xref:data-access/jdbc/initializing-datasource.adoc[Initializing a DataSource], respectively.
|
|
|
|
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" <1>
|
|
xsi:schemaLocation="
|
|
http://www.springframework.org/schema/beans
|
|
https://www.springframework.org/schema/beans/spring-beans.xsd
|
|
http://www.springframework.org/schema/jdbc
|
|
https://www.springframework.org/schema/jdbc/spring-jdbc.xsd"> <2>
|
|
|
|
<!-- bean definitions here -->
|
|
|
|
</beans>
|
|
----
|
|
<1> Declare usage of the `jdbc` namespace.
|
|
<2> Specify the location (with other schema locations).
|