root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

Polish whitespace in docs

This commit is contained in:
Chris Beams 2010-09-09 10:16:39 +00:00
parent 5f2d88f74a
commit 4b89069cab
1 changed files with 247 additions and 247 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

474
spring-framework-reference/src/xsd-configuration.xml
View File

@ -140,18 +140,18 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
<section id="xsd-config-body-schemas-util-frfb"> <section id="xsd-config-body-schemas-util-frfb">
<title>Setting a bean property or constructor arg from a field value</title> <title>Setting a bean property or constructor arg from a field value</title>
<para> <para>
<ulink url="http://static.springframework.org/spring/docs/3.0.x/javadoc-api/org/springframework/beans/factory/config/FieldRetrievingFactoryBean.html"><classname>FieldRetrievingFactoryBean</classname></ulink> <ulink url="http://static.springframework.org/spring/docs/3.0.x/javadoc-api/org/springframework/beans/factory/config/FieldRetrievingFactoryBean.html"><classname>FieldRetrievingFactoryBean</classname></ulink>
is a <interfacename>FactoryBean</interfacename> which retrieves a is a <interfacename>FactoryBean</interfacename> which retrieves a
<literal>static</literal> or non-static field value. It is typically <literal>static</literal> or non-static field value. It is typically
used for retrieving <literal>public</literal> <literal>static</literal> used for retrieving <literal>public</literal> <literal>static</literal>
<literal>final</literal> constants, which may then be used to set a <literal>final</literal> constants, which may then be used to set a
property value or constructor arg for another bean. property value or constructor arg for another bean.
</para> </para>
<para> <para>
Find below an example which shows how a <literal>static</literal> field is exposed, by Find below an example which shows how a <literal>static</literal> field is exposed, by
using the <ulink url="http://static.springframework.org/spring/docs/3.0.x/javadoc-api/org/springframework/beans/factory/config/FieldRetrievingFactoryBean.html#setStaticField(java.lang.String)"><literal>staticField</literal></ulink> using the <ulink url="http://static.springframework.org/spring/docs/3.0.x/javadoc-api/org/springframework/beans/factory/config/FieldRetrievingFactoryBean.html#setStaticField(java.lang.String)"><literal>staticField</literal></ulink>
property: property:
</para> </para>
<programlisting language="xml"><![CDATA[<bean id="myField" <programlisting language="xml"><![CDATA[<bean id="myField"
class="org.springframework.beans.factory.config.FieldRetrievingFactoryBean"> class="org.springframework.beans.factory.config.FieldRetrievingFactoryBean">
<property name="staticField" value="java.sql.Connection.TRANSACTION_SERIALIZABLE"/> <property name="staticField" value="java.sql.Connection.TRANSACTION_SERIALIZABLE"/>
@ -161,12 +161,12 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
<programlisting language="xml"><![CDATA[<bean id="java.sql.Connection.TRANSACTION_SERIALIZABLE" <programlisting language="xml"><![CDATA[<bean id="java.sql.Connection.TRANSACTION_SERIALIZABLE"
class="org.springframework.beans.factory.config.FieldRetrievingFactoryBean"/>]]></programlisting> class="org.springframework.beans.factory.config.FieldRetrievingFactoryBean"/>]]></programlisting>
<para> <para>
This does mean that there is no longer any choice in what the bean id is (so This does mean that there is no longer any choice in what the bean id is (so
any other bean that refers to it will also have to use this longer name), any other bean that refers to it will also have to use this longer name),
but this form is very concise to define, and very convenient to use as an but this form is very concise to define, and very convenient to use as an
inner bean since the id doesn't have to be specified for the bean inner bean since the id doesn't have to be specified for the bean
reference: reference:
</para> </para>
<programlisting language="xml"><![CDATA[<bean id="..." class="..."> <programlisting language="xml"><![CDATA[<bean id="..." class="...">
<property name="isolation"> <property name="isolation">
<bean id="java.sql.Connection.TRANSACTION_SERIALIZABLE" <bean id="java.sql.Connection.TRANSACTION_SERIALIZABLE"
@ -174,18 +174,18 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
</property> </property>
</bean>]]></programlisting> </bean>]]></programlisting>
<para> <para>
It is also possible to access a non-static (instance) field of another bean, It is also possible to access a non-static (instance) field of another bean,
as described in the API documentation for the as described in the API documentation for the
<ulink url="http://static.springframework.org/spring/docs/3.0.x/javadoc-api/org/springframework/beans/factory/config/FieldRetrievingFactoryBean.html"><classname>FieldRetrievingFactoryBean</classname></ulink> <ulink url="http://static.springframework.org/spring/docs/3.0.x/javadoc-api/org/springframework/beans/factory/config/FieldRetrievingFactoryBean.html"><classname>FieldRetrievingFactoryBean</classname></ulink>
class. class.
</para> </para>
<para> <para>
Injecting enum values into beans as either property or constructor arguments is very Injecting enum values into beans as either property or constructor arguments is very
easy to do in Spring, in that you don't actually have to <emphasis>do</emphasis> easy to do in Spring, in that you don't actually have to <emphasis>do</emphasis>
anything or know anything about the Spring internals (or even about classes such anything or know anything about the Spring internals (or even about classes such
as the <classname>FieldRetrievingFactoryBean</classname>). Let's look at an example as the <classname>FieldRetrievingFactoryBean</classname>). Let's look at an example
to see how easy injecting an enum value is; consider this JDK 5 enum: to see how easy injecting an enum value is; consider this JDK 5 enum:
</para> </para>
<programlisting language="java"><![CDATA[package javax.persistence; <programlisting language="java"><![CDATA[package javax.persistence;
public enum PersistenceContextType { public enum PersistenceContextType {
@ -210,10 +210,10 @@ public class Client {
<property name="persistenceContextType" value="TRANSACTION" /> <property name="persistenceContextType" value="TRANSACTION" />
</bean>]]></programlisting> </bean>]]></programlisting>
<para> <para>
This works for classic type-safe emulated enums (on JDK 1.4 and JDK 1.3) as well; This works for classic type-safe emulated enums (on JDK 1.4 and JDK 1.3) as well;
Spring will automatically attempt to match the string property value to a constant Spring will automatically attempt to match the string property value to a constant
on the enum class. on the enum class.
</para> </para>
</section> </section>
</section> </section>
<section id="xsd-config-body-schemas-util-property-path"> <section id="xsd-config-body-schemas-util-property-path">
@ -255,12 +255,12 @@ public class Client {
<section id="xsd-config-body-schemas-util-property-path-dependency"> <section id="xsd-config-body-schemas-util-property-path-dependency">
<title>Using <literal>&lt;util:property-path/&gt;</literal> to set a bean property or constructor-argument</title> <title>Using <literal>&lt;util:property-path/&gt;</literal> to set a bean property or constructor-argument</title>
<para><classname>PropertyPathFactoryBean</classname> is a <para><classname>PropertyPathFactoryBean</classname> is a
<interfacename>FactoryBean</interfacename> that evaluates a property path on a given <interfacename>FactoryBean</interfacename> that evaluates a property path on a given
target object. The target object can be specified directly or via a bean target object. The target object can be specified directly or via a bean
name. This value may then be used in another bean definition as a property name. This value may then be used in another bean definition as a property
value or constructor argument.</para> value or constructor argument.</para>
<para>Here's an example where a path is used against another bean, by name:</para> <para>Here's an example where a path is used against another bean, by name:</para>
<programlisting language="xml"><![CDATA[// target bean to be referenced by name <programlisting language="xml"><![CDATA[// target bean to be referenced by name
<bean id="person" class="org.springframework.beans.TestBean" scope="prototype"> <bean id="person" class="org.springframework.beans.TestBean" scope="prototype">
<property name="age" value="10"/> <property name="age" value="10"/>
<property name="spouse"> <property name="spouse">
@ -287,23 +287,23 @@ public class Client {
</property> </property>
<property name="propertyPath" value="age"/> <property name="propertyPath" value="age"/>
</bean>]]></programlisting> </bean>]]></programlisting>
<para>There is also a shortcut form, where the bean name is the property path.</para> <para>There is also a shortcut form, where the bean name is the property path.</para>
<programlisting language="xml"><lineannotation>&lt;!-- will result in 10, which is the value of property 'age' of bean 'person' --&gt;</lineannotation><![CDATA[ <programlisting language="xml"><lineannotation>&lt;!-- will result in 10, which is the value of property 'age' of bean 'person' --&gt;</lineannotation><![CDATA[
<bean id="person.age" <bean id="person.age"
class="org.springframework.beans.factory.config.PropertyPathFactoryBean"/>]]></programlisting> class="org.springframework.beans.factory.config.PropertyPathFactoryBean"/>]]></programlisting>
<para>This form does mean that there is no choice in the name of the bean. <para>This form does mean that there is no choice in the name of the bean.
Any reference to it will also have to use the same id, which is the path. Any reference to it will also have to use the same id, which is the path.
Of course, if used as an inner bean, there is no need to refer to it at Of course, if used as an inner bean, there is no need to refer to it at
all:</para> all:</para>
<programlisting language="xml"><![CDATA[<bean id="..." class="..."> <programlisting language="xml"><![CDATA[<bean id="..." class="...">
<property name="age"> <property name="age">
<bean id="person.age" <bean id="person.age"
class="org.springframework.beans.factory.config.PropertyPathFactoryBean"/> class="org.springframework.beans.factory.config.PropertyPathFactoryBean"/>
</property> </property>
</bean>]]></programlisting> </bean>]]></programlisting>
<para>The result type may be specifically set in the actual definition. <para>The result type may be specifically set in the actual definition.
This is not necessary for most use cases, but can be of use for some. This is not necessary for most use cases, but can be of use for some.
Please see the Javadocs for more info on this feature.</para> Please see the Javadocs for more info on this feature.</para>
</section> </section>
</section> </section>
<section id="xsd-config-body-schemas-util-properties"> <section id="xsd-config-body-schemas-util-properties">
@ -646,9 +646,9 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
<section id="xsd-config-body-schemas-jms"> <section id="xsd-config-body-schemas-jms">
<title>The <literal>jms</literal> schema</title> <title>The <literal>jms</literal> schema</title>
<para>The <literal>jms</literal> tags deal with configuring JMS-related <para>The <literal>jms</literal> tags deal with configuring JMS-related
beans such as Spring's <link linkend="jms-mdp">MessageListenerContainers</link>. beans such as Spring's <link linkend="jms-mdp">MessageListenerContainers</link>.
These tags are detailed in the section of the <link linkend="jms">JMS chapter</link> These tags are detailed in the section of the <link linkend="jms">JMS chapter</link>
entitled <xref linkend="jms-namespace"/>. Please do consult that entitled <xref linkend="jms-namespace"/>. Please do consult that
chapter for full details on this support and the <literal>jms</literal> tags chapter for full details on this support and the <literal>jms</literal> tags
themselves.</para> themselves.</para>
<para>In the interest of completeness, to use the tags in the <literal>jms</literal> <para>In the interest of completeness, to use the tags in the <literal>jms</literal>
@ -690,10 +690,10 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
available to you.</para> available to you.</para>
<programlisting language="xml"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> <programlisting language="xml"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" <beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:aop="http://www.springframework.org/schema/aop" xmlns:aop="http://www.springframework.org/schema/aop"
]]><emphasis role="bold">xmlns:tx="http://www.springframework.org/schema/tx"</emphasis><![CDATA[ ]]><emphasis role="bold">xmlns:tx="http://www.springframework.org/schema/tx"</emphasis><![CDATA[
xsi:schemaLocation=" xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.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[ ]]><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"> http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd">
@ -721,9 +721,9 @@ http://www.springframework.org/schema/aop http://www.springframework.org/schema/
available to you.</para> available to you.</para>
<programlisting language="xml"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> <programlisting language="xml"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" <beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
]]><emphasis role="bold">xmlns:aop="http://www.springframework.org/schema/aop"</emphasis><![CDATA[ ]]><emphasis role="bold">xmlns:aop="http://www.springframework.org/schema/aop"</emphasis><![CDATA[
xsi:schemaLocation=" xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.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/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"</emphasis><![CDATA[> ]]><emphasis role="bold">http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"</emphasis><![CDATA[>
@ -735,70 +735,70 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
<section id="xsd-config-body-schemas-context"> <section id="xsd-config-body-schemas-context">
<title>The <literal>context</literal> schema</title> <title>The <literal>context</literal> schema</title>
<para>The <literal>context</literal> tags deal with <interfacename>ApplicationContext</interfacename> <para>The <literal>context</literal> tags deal with <interfacename>ApplicationContext</interfacename>
configuration that relates to plumbing - that is, not usually beans that are important to an end-user configuration that relates to plumbing - that is, not usually beans that are important to an end-user
but rather beans that do a lot of grunt work in Spring, such as <interfacename>BeanfactoryPostProcessors</interfacename>. but rather beans that do a lot of grunt work in Spring, such as <interfacename>BeanfactoryPostProcessors</interfacename>.
The following snippet references the correct schema so that the tags in the <literal>context</literal> The following snippet references the correct schema so that the tags in the <literal>context</literal>
namespace are available to you.</para> namespace are available to you.</para>
<programlisting language="xml"><![CDATA[<?xml version="1.0" encoding="UTF-8"?> <programlisting language="xml"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" <beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
]]><emphasis role="bold">xmlns:context="http://www.springframework.org/schema/context"</emphasis><![CDATA[ ]]><emphasis role="bold">xmlns:context="http://www.springframework.org/schema/context"</emphasis><![CDATA[
xsi:schemaLocation=" xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.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/context http://www.springframework.org/schema/context/spring-context-3.0.xsd"</emphasis><![CDATA[> ]]><emphasis role="bold">http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd"</emphasis><![CDATA[>
]]><lineannotation>&lt;!-- <literal>&lt;bean/&gt;</literal> definitions here --&gt;</lineannotation><![CDATA[ ]]><lineannotation>&lt;!-- <literal>&lt;bean/&gt;</literal> definitions here --&gt;</lineannotation><![CDATA[
</beans>]]></programlisting> </beans>]]></programlisting>
<note> <note>
<para>The <literal>context</literal> schema was only introduced in Spring 2.5.</para> <para>The <literal>context</literal> schema was only introduced in Spring 2.5.</para>
</note> </note>
<section id="xsd-config-body-schemas-context-pphc"> <section id="xsd-config-body-schemas-context-pphc">
<title><literal>&lt;property-placeholder/&gt;</literal></title> <title><literal>&lt;property-placeholder/&gt;</literal></title>
<para>This element activates the replacement of <literal>${...}</literal> placeholders, resolved <para>This element activates the replacement of <literal>${...}</literal> placeholders, resolved
against the specified properties file (as a <link linkend="resources">Spring resource location</link>). against the specified properties file (as a <link linkend="resources">Spring resource location</link>).
This element is a convenience mechanism that sets up a This element is a convenience mechanism that sets up a
<link linkend="beans-factory-placeholderconfigurer"><classname>PropertyPlaceholderConfigurer</classname></link> <link linkend="beans-factory-placeholderconfigurer"><classname>PropertyPlaceholderConfigurer</classname></link>
for you; if you need more control over the <classname>PropertyPlaceholderConfigurer</classname>, just for you; if you need more control over the <classname>PropertyPlaceholderConfigurer</classname>, just
define one yourself explicitly.</para> define one yourself explicitly.</para>
</section> </section>
<section id="xsd-config-body-schemas-context-ac"> <section id="xsd-config-body-schemas-context-ac">
<title><literal>&lt;annotation-config/&gt;</literal></title> <title><literal>&lt;annotation-config/&gt;</literal></title>
<para>Activates the Spring infrastructure for various annotations to be detected in bean classes: <para>Activates the Spring infrastructure for various annotations to be detected in bean classes:
Spring's <link linkend="beans-required-annotation"><interfacename>@Required</interfacename></link> Spring's <link linkend="beans-required-annotation"><interfacename>@Required</interfacename></link>
and <link linkend="beans-annotation-config"><interfacename>@Autowired</interfacename></link>, as well as and <link linkend="beans-annotation-config"><interfacename>@Autowired</interfacename></link>, as well as
JSR 250's <interfacename>@PostConstruct</interfacename>, <interfacename>@PreDestroy</interfacename> and JSR 250's <interfacename>@PostConstruct</interfacename>, <interfacename>@PreDestroy</interfacename> and
<interfacename>@Resource</interfacename> (if available), and JPA's <interfacename>@Resource</interfacename> (if available), and JPA's
<interfacename>@PersistenceContext</interfacename> and <interfacename>@PersistenceUnit</interfacename> <interfacename>@PersistenceContext</interfacename> and <interfacename>@PersistenceUnit</interfacename>
(if available). Alternatively, you can choose to activate the individual (if available). Alternatively, you can choose to activate the individual
<interfacename>BeanPostProcessors</interfacename> for those annotations explictly.</para> <interfacename>BeanPostProcessors</interfacename> for those annotations explictly.</para>
<note> <note>
<para>This element does <emphasis>not</emphasis> activate processing of Spring's <para>This element does <emphasis>not</emphasis> activate processing of Spring's
<link linkend="transaction-declarative-annotations"><interfacename>@Transactional</interfacename></link> <link linkend="transaction-declarative-annotations"><interfacename>@Transactional</interfacename></link>
annotation. Use the annotation. Use the
<link linkend="tx-decl-explained"><literal>&lt;tx:annotation-driven/&gt;</literal></link> element <link linkend="tx-decl-explained"><literal>&lt;tx:annotation-driven/&gt;</literal></link> element
for that purpose.</para> for that purpose.</para>
</note> </note>
</section> </section>
<section id="xsd-config-body-schemas-context-component-scan"> <section id="xsd-config-body-schemas-context-component-scan">
<title><literal>&lt;component-scan/&gt;</literal></title> <title><literal>&lt;component-scan/&gt;</literal></title>
<para>This element is detailed in <xref linkend="beans-annotation-config"/>.</para> <para>This element is detailed in <xref linkend="beans-annotation-config"/>.</para>
</section> </section>
<section id="xsd-config-body-schemas-context-ltw"> <section id="xsd-config-body-schemas-context-ltw">
<title><literal>&lt;load-time-weaver/&gt;</literal></title> <title><literal>&lt;load-time-weaver/&gt;</literal></title>
<para>This element is detailed in <xref linkend="aop-aj-ltw"/>.</para> <para>This element is detailed in <xref linkend="aop-aj-ltw"/>.</para>
</section> </section>
<section id="xsd-config-body-schemas-context-sc"> <section id="xsd-config-body-schemas-context-sc">
<title><literal>&lt;spring-configured/&gt;</literal></title> <title><literal>&lt;spring-configured/&gt;</literal></title>
<para>This element is detailed in <xref linkend="aop-atconfigurable"/>.</para> <para>This element is detailed in <xref linkend="aop-atconfigurable"/>.</para>
</section> </section>
<section id="xsd-config-body-schemas-context-mbe"> <section id="xsd-config-body-schemas-context-mbe">
<title><literal>&lt;mbean-export/&gt;</literal></title> <title><literal>&lt;mbean-export/&gt;</literal></title>
<para>This element is detailed in <xref linkend="jmx-context-mbeanexport"/>.</para> <para>This element is detailed in <xref linkend="jmx-context-mbeanexport"/>.</para>
</section> </section>
</section> </section>
<section id="xsd-config-body-schemas-tool"> <section id="xsd-config-body-schemas-tool">
<title>The <literal>tool</literal> schema</title> <title>The <literal>tool</literal> schema</title>
<para>The <literal>tool</literal> tags are for use when you want to add <para>The <literal>tool</literal> tags are for use when you want to add
tooling-specific metadata to your custom configuration elements. This metadata tooling-specific metadata to your custom configuration elements. This metadata
@ -850,10 +850,10 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
<para>This final section documents the steps involved in setting up a number of <para>This final section documents the steps involved in setting up a number of
popular Java IDEs to effect the easier editing of Spring's XML Schema-based popular Java IDEs to effect the easier editing of Spring's XML Schema-based
configuration files. If your favourite Java IDE or editor is not included in the configuration files. If your favourite Java IDE or editor is not included in the
list of documented IDEs, then please do list of documented IDEs, then please do
<ulink url="http://opensource.atlassian.com/projects/spring/secure/Dashboard.jspa">raise an issue</ulink> <ulink url="http://opensource.atlassian.com/projects/spring/secure/Dashboard.jspa">raise an issue</ulink>
and an example with your favorite IDE/editor <emphasis>may</emphasis> be included and an example with your favorite IDE/editor <emphasis>may</emphasis> be included
in the next release.</para> in the next release.</para>
<section id="xsd-config-setup-eclipse"> <section id="xsd-config-setup-eclipse">
<title>Setting up Eclipse</title> <title>Setting up Eclipse</title>
<procedure> <procedure>
@ -880,16 +880,16 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd"> http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd">
</beans>]]></programlisting> </beans>]]></programlisting>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/eclipse-setup-1.png" format="PNG" align="center" /> <imagedata fileref="images/eclipse-setup-1.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/eclipse-setup-1.png" format="PNG" align="center" /> <imagedata fileref="images/eclipse-setup-1.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<step> <step>
<title>Step Two</title> <title>Step Two</title>
@ -898,36 +898,36 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
as plain text. There is no XML editing support out of the box in Eclipse, as plain text. There is no XML editing support out of the box in Eclipse,
and as such there is not even any syntax highlighting of elements and attributes. and as such there is not even any syntax highlighting of elements and attributes.
To address this, you will have to install an XML editor plugin for Eclipse...</para> To address this, you will have to install an XML editor plugin for Eclipse...</para>
<table id="xsd-config-setup-eclipse-plugins"> <table id="xsd-config-setup-eclipse-plugins">
<title>Eclipse XML editors</title> <title>Eclipse XML editors</title>
<tgroup cols="2"> <tgroup cols="2">
<colspec align="left" /> <colspec align="left" />
<thead> <thead>
<row> <row>
<entry align="center">XML Editor</entry> <entry align="center">XML Editor</entry>
<entry align="center">Link</entry> <entry align="center">Link</entry>
</row> </row>
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry> <entry>
<para>The Eclipse Web Tools Platform (WTP)</para> <para>The Eclipse Web Tools Platform (WTP)</para>
</entry> </entry>
<entry> <entry>
<ulink url="http://www.eclipse.org/webtools/"/> <ulink url="http://www.eclipse.org/webtools/"/>
</entry> </entry>
</row> </row>
<row> <row>
<entry> <entry>
<para>A list of Eclipse XML plugins</para> <para>A list of Eclipse XML plugins</para>
</entry> </entry>
<entry> <entry>
<ulink url="http://eclipse-plugins.2y.net/eclipse/plugins.jsp?category=XML"/> <ulink url="http://eclipse-plugins.2y.net/eclipse/plugins.jsp?category=XML"/>
</entry> </entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
<sidebar> <sidebar>
<title>Contributing documentation...</title> <title>Contributing documentation...</title>
<para>Patches showing how to configure an Eclipse XML editor are <para>Patches showing how to configure an Eclipse XML editor are
@ -946,38 +946,38 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
<step> <step>
<title>Spring IDE</title> <title>Spring IDE</title>
<para>There is a dedicated Spring Framework plugin for Eclipse called <para>There is a dedicated Spring Framework plugin for Eclipse called
<ulink url="http://springide.org/blog/">Spring IDE</ulink> and it is pretty darn cool. (There's a <ulink url="http://springide.org/blog/">Spring IDE</ulink> and it is pretty darn cool. (There's a
considered and non-biased opinion for you!) This plugin makes using Spring even easier, and it has more considered and non-biased opinion for you!) This plugin makes using Spring even easier, and it has more
than just support for the core Spring Framework... Spring Web Flow is supported too. Details of how to than just support for the core Spring Framework... Spring Web Flow is supported too. Details of how to
install Spring IDE can be found on the install Spring IDE can be found on the
<ulink url="http://springide.org/project/wiki/SpringideInstall">Spring IDE installation page</ulink>.</para> <ulink url="http://springide.org/project/wiki/SpringideInstall">Spring IDE installation page</ulink>.</para>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/eclipse-setup-3.png" format="PNG" align="center" /> <imagedata fileref="images/eclipse-setup-3.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/eclipse-setup-3.png" format="PNG" align="center" /> <imagedata fileref="images/eclipse-setup-3.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<step> <step>
<title>Web Tools Platform (WTP) for Eclipse</title> <title>Web Tools Platform (WTP) for Eclipse</title>
<para>If you are using the Web Tools Platform (WTP) for Eclipse, you don't need to <para>If you are using the Web Tools Platform (WTP) for Eclipse, you don't need to
do anything other than open a Spring XML configuration file using the WTP platform's do anything other than open a Spring XML configuration file using the WTP platform's
XML editor. As can be seen in the screenshot below, you immediately get some slick XML editor. As can be seen in the screenshot below, you immediately get some slick
IDE-level support for autocompleting tags and suchlike.</para> IDE-level support for autocompleting tags and suchlike.</para>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/eclipse-setup-2.png" format="PNG" align="center" /> <imagedata fileref="images/eclipse-setup-2.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/eclipse-setup-2.png" format="PNG" align="center" /> <imagedata fileref="images/eclipse-setup-2.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
</procedure> </procedure>
</section> </section>
@ -1002,16 +1002,16 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd"> http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.0.xsd">
</beans>]]></programlisting> </beans>]]></programlisting>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/idea-setup-1.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-1.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/idea-setup-1.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-1.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<step> <step>
<title>Step Two</title> <title>Step Two</title>
@ -1022,20 +1022,20 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
area (see the screenshot below); then press the <keycombo action='open'> area (see the screenshot below); then press the <keycombo action='open'>
<keycap>Alt</keycap> <keycap>Alt</keycap>
<keycap>Enter</keycap> <keycap>Enter</keycap>
</keycombo> keystroke combination, and press the <keycombo action='open'> </keycombo> keystroke combination, and press the <keycombo action='open'>
<keycap>Enter</keycap> <keycap>Enter</keycap>
</keycombo> key again when the popup becomes active to fetch the external </keycombo> key again when the popup becomes active to fetch the external
resource.</para> resource.</para>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/idea-setup-6.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-6.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/idea-setup-6.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-6.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<step> <step>
<title>Step Three</title> <title>Step Three</title>
@ -1048,16 +1048,16 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
<keycap>S</keycap> <keycap>S</keycap>
</keycombo> keystroke combination or via the <literal>'File|Settings'</literal> menu), </keycombo> keystroke combination or via the <literal>'File|Settings'</literal> menu),
and click on the <literal>'Resources'</literal> button.</para> and click on the <literal>'Resources'</literal> button.</para>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/idea-setup-2.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-2.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/idea-setup-2.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-2.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<step> <step>
<title>Step Four</title> <title>Step Four</title>
@ -1065,16 +1065,16 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
that allows you to add an explicit reference to a local copy of the that allows you to add an explicit reference to a local copy of the
<literal>util</literal> schema file. (You can find all of the various Spring <literal>util</literal> schema file. (You can find all of the various Spring
XSD files in the <literal>'src'</literal> directory of the Spring distribution.)</para> XSD files in the <literal>'src'</literal> directory of the Spring distribution.)</para>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/idea-setup-3.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-3.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/idea-setup-3.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-3.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<step> <step>
<title>Step Five</title> <title>Step Five</title>
@ -1084,16 +1084,16 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
<literal>'http://www.springframework.org/schema/util'</literal> namespace <literal>'http://www.springframework.org/schema/util'</literal> namespace
is being associated with the file resource is being associated with the file resource
<literal>'C:\bench\spring\src\org\springframework\beans\factory\xml\spring-util-3.0.xsd'</literal>.</para> <literal>'C:\bench\spring\src\org\springframework\beans\factory\xml\spring-util-3.0.xsd'</literal>.</para>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/idea-setup-4.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-4.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/idea-setup-4.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-4.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<step> <step>
<title>Step Six</title> <title>Step Six</title>
@ -1103,16 +1103,16 @@ http://www.springframework.org/schema/util http://www.springframework.org/schema
the <literal>'&lt;'</literal> character into the editing window now also the <literal>'&lt;'</literal> character into the editing window now also
brings up a handy dropdown box that contains all of the imported tags from brings up a handy dropdown box that contains all of the imported tags from
the <literal>util</literal> namespace.</para> the <literal>util</literal> namespace.</para>
<para> <para>
<mediaobject> <mediaobject>
<imageobject role="fo"> <imageobject role="fo">
<imagedata fileref="images/idea-setup-5.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-5.png" format="PNG" align="center" />
</imageobject> </imageobject>
<imageobject role="html"> <imageobject role="html">
<imagedata fileref="images/idea-setup-5.png" format="PNG" align="center" /> <imagedata fileref="images/idea-setup-5.png" format="PNG" align="center" />
</imageobject> </imageobject>
</mediaobject> </mediaobject>
</para> </para>
</step> </step>
<para>Repeat as required for setting up IDEA to reference the other Spring XSD files.</para> <para>Repeat as required for setting up IDEA to reference the other Spring XSD files.</para>
</procedure> </procedure>