提交 b29a278b 编写于 作者: J Jay Bryant 提交者: Brian Clozel

Edit Data Access part of the reference documentation

I edited the Data Access chapter for spelling, punctuation,
grammar, usage, corporate voice, and clarity.

I also added links and cross-references.
上级 95ff22cb
......@@ -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.
<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).
====
此差异已折叠。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册