|
|
|
|
@ -6,7 +6,7 @@
@@ -6,7 +6,7 @@
|
|
|
|
|
<title>XML Schema-based configuration</title> |
|
|
|
|
<section id="xsd-config-introduction"> |
|
|
|
|
<title>Introduction</title> |
|
|
|
|
<para>This appendix details the XML Schema-based configuration introduced in Spring 2.0.</para> |
|
|
|
|
<para>This appendix details the XML Schema-based configuration introduced in Spring 2.0 and enhanced and extended in Spring 2.5 and 3.0.</para> |
|
|
|
|
<sidebar> |
|
|
|
|
<title>DTD support?</title> |
|
|
|
|
<para>Authoring Spring configuration files using the older DTD style |
|
|
|
|
@ -68,7 +68,7 @@
@@ -68,7 +68,7 @@
|
|
|
|
|
<beans xmlns="http://www.springframework.org/schema/beans" |
|
|
|
|
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-2.5.xsd"> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -106,8 +106,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -106,8 +106,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
]]><emphasis role="bold">xmlns:util="http://www.springframework.org/schema/util"</emphasis><![CDATA[ |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-2.5.xsd"</emphasis><![CDATA[> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd"</emphasis><![CDATA[> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -471,8 +471,8 @@ public class Client {
@@ -471,8 +471,8 @@ public class Client {
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
]]><emphasis role="bold">xmlns:jee="http://www.springframework.org/schema/jee"</emphasis><![CDATA[ |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-2.5.xsd"</emphasis><![CDATA[> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-3.0.xsd"</emphasis><![CDATA[> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -630,8 +630,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -630,8 +630,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
]]><emphasis role="bold">xmlns:lang="http://www.springframework.org/schema/lang"</emphasis><![CDATA[ |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/lang http://www.springframework.org/schema/lang/spring-lang-2.5.xsd"</emphasis><![CDATA[> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/lang http://www.springframework.org/schema/lang/spring-lang-3.0.xsd"</emphasis><![CDATA[> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -655,8 +655,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -655,8 +655,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
]]><emphasis role="bold">xmlns:jms="http://www.springframework.org/schema/jms"</emphasis><![CDATA[ |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/jms http://www.springframework.org/schema/jms/spring-jms-2.5.xsd"</emphasis><![CDATA[> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/jms http://www.springframework.org/schema/jms/spring-jms-3.0.xsd"</emphasis><![CDATA[> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -669,7 +669,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -669,7 +669,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
covered in the chapter entitled <xref linkend="transaction"/>.</para> |
|
|
|
|
<tip> |
|
|
|
|
<para>You are strongly encouraged to look at the |
|
|
|
|
<filename>'spring-tx-2.5.xsd'</filename> file that ships with the Spring |
|
|
|
|
<filename>'spring-tx-3.0.xsd'</filename> 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 |
|
|
|
|
<literal>tx</literal> namespace, including attribute defaults and |
|
|
|
|
@ -688,9 +688,9 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -688,9 +688,9 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
xmlns:aop="http://www.springframework.org/schema/aop" |
|
|
|
|
]]><emphasis role="bold">xmlns:tx="http://www.springframework.org/schema/tx"</emphasis><![CDATA[ |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd</emphasis><![CDATA[ |
|
|
|
|
http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd"> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd</emphasis><![CDATA[ |
|
|
|
|
http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -718,8 +718,8 @@ http://www.springframework.org/schema/aop http://www.springframework.org/schema/
@@ -718,8 +718,8 @@ http://www.springframework.org/schema/aop http://www.springframework.org/schema/
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
]]><emphasis role="bold">xmlns:aop="http://www.springframework.org/schema/aop"</emphasis><![CDATA[ |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd"</emphasis><![CDATA[> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"</emphasis><![CDATA[> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -738,8 +738,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -738,8 +738,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
]]><emphasis role="bold">xmlns:context="http://www.springframework.org/schema/context"</emphasis><![CDATA[ |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd"</emphasis><![CDATA[> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
]]><emphasis role="bold">http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd"</emphasis><![CDATA[> |
|
|
|
|
|
|
|
|
|
]]><lineannotation><!-- <literal><bean/></literal> definitions here --></lineannotation><![CDATA[ |
|
|
|
|
|
|
|
|
|
@ -802,7 +802,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -802,7 +802,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
Spring as they are currently undergoing review. If you are a third party tool |
|
|
|
|
vendor and you would like to contribute to this review process, then do mail |
|
|
|
|
the Spring mailing list. The currently supported <literal>tool</literal> |
|
|
|
|
tags can be found in the file <literal>'spring-tool-2.5.xsd'</literal> in the |
|
|
|
|
tags can be found in the file <literal>'spring-tool-3.0.xsd'</literal> in the |
|
|
|
|
<literal>'src/org/springframework/beans/factory/xml'</literal> directory of the |
|
|
|
|
Spring source distribution.</para> |
|
|
|
|
</section> |
|
|
|
|
@ -826,7 +826,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -826,7 +826,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
<beans xmlns="http://www.springframework.org/schema/beans" |
|
|
|
|
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-2.5.xsd"> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"> |
|
|
|
|
|
|
|
|
|
<bean id="foo" class="x.y.Foo"> |
|
|
|
|
]]><emphasis role="bold"><![CDATA[<meta key="cacheName" value="foo"/>]]></emphasis><![CDATA[ |
|
|
|
|
@ -870,8 +870,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
@@ -870,8 +870,8 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
xmlns:util="http://www.springframework.org/schema/util" |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-2.5.xsd"> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd"> |
|
|
|
|
|
|
|
|
|
</beans>]]></programlisting> |
|
|
|
|
<para> |
|
|
|
|
@ -992,8 +992,8 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
@@ -992,8 +992,8 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
|
|
|
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
|
|
|
xmlns:util="http://www.springframework.org/schema/util" |
|
|
|
|
xsi:schemaLocation=" |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd |
|
|
|
|
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-2.5.xsd"> |
|
|
|
|
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd |
|
|
|
|
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd"> |
|
|
|
|
|
|
|
|
|
</beans>]]></programlisting> |
|
|
|
|
<para> |
|
|
|
|
@ -1077,7 +1077,7 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
@@ -1077,7 +1077,7 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
|
|
|
|
|
relevant XSD file. As can be seen in the following screenshot, the |
|
|
|
|
<literal>'http://www.springframework.org/schema/util'</literal> namespace |
|
|
|
|
is being associated with the file resource |
|
|
|
|
<literal>'C:\bench\spring\src\org\springframework\beans\factory\xml\spring-util-2.5.xsd'</literal>.</para> |
|
|
|
|
<literal>'C:\bench\spring\src\org\springframework\beans\factory\xml\spring-util-3.0.xsd'</literal>.</para> |
|
|
|
|
<para> |
|
|
|
|
<mediaobject> |
|
|
|
|
<imageobject role="fo"> |
|
|
|
|
@ -1115,7 +1115,7 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
@@ -1115,7 +1115,7 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
|
|
|
|
|
<section id="xsd-config-integration"> |
|
|
|
|
<title>Integration issues</title> |
|
|
|
|
<para>This final section details integration issues that may arise when you switch over |
|
|
|
|
to using the above XSD-style for Spring 2.0 configuration.</para> |
|
|
|
|
to using the above XSD-style for Spring 2.0 and later configuration.</para> |
|
|
|
|
<para>This section is quite small at the moment (and hopefully it will stay that way). |
|
|
|
|
It has been included in the Spring documentation as a convenience to Spring users |
|
|
|
|
so that if you encounter an issue when switching over to the XSD-style in some |
|
|
|
|
|