diff --git a/src/reference/docbook/beans-annotation-config.xml b/src/reference/docbook/beans-annotation-config.xml index 47b7d728cf1..64d6af9933e 100644 --- a/src/reference/docbook/beans-annotation-config.xml +++ b/src/reference/docbook/beans-annotation-config.xml @@ -73,14 +73,14 @@ </beans> (The implicitly registered post-processors include AutowiredAnnotationBeanPostProcessor, CommonAnnotationBeanPostProcessor, PersistenceAnnotationBeanPostProcessor, as well as the aforementioned RequiredAnnotationBeanPostProcessor.) @@ -639,7 +639,7 @@ public @interface MovieQualifier { <classname>CustomAutowireConfigurer</classname> The CustomAutowireConfigurer is a BeanFactoryPostProcessor that enables you to register your own custom qualifier annotation types even if they are @@ -720,7 +720,7 @@ public @interface MovieQualifier { the ApplicationContext of which the CommonAnnotationBeanPostProcessor is aware. The names can be resolved through JNDI if you configure Spring's SimpleJndiBeanFactory explicitly. However, it is recommended that you rely on the default behavior and simply use Spring's JNDI lookup capabilities to preserve the level of diff --git a/src/reference/docbook/beans-classpath-scanning.xml b/src/reference/docbook/beans-classpath-scanning.xml index b16d9ac5860..3baafde5d7f 100644 --- a/src/reference/docbook/beans-classpath-scanning.xml +++ b/src/reference/docbook/beans-classpath-scanning.xml @@ -391,7 +391,7 @@ public class MovieFinderImpl implements MovieFinder { If you do not want to rely on the default bean-naming strategy, you can provide a custom bean-naming strategy. First, implement the BeanNameGenerator interface, and be sure to include a default no-arg constructor. Then, provide the fully-qualified class name when configuring the scanner: @@ -428,7 +428,7 @@ public class MovieFinderImpl implements MovieFinder { To provide a custom strategy for scope resolution rather than relying on the annotation-based approach, implement the ScopeMetadataResolver interface, and be sure to include a default no-arg constructor. Then, provide the fully-qualified class name when configuring the scanner: diff --git a/src/reference/docbook/beans-context-additional.xml b/src/reference/docbook/beans-context-additional.xml index 52ed2593856..a1538434a62 100644 --- a/src/reference/docbook/beans-context-additional.xml +++ b/src/reference/docbook/beans-context-additional.xml @@ -13,7 +13,7 @@ functionality for managing and manipulating beans, including in a programmatic way. The org.springframework.context package adds the ApplicationContext interface, which extends the BeanFactory interface, in addition to extending other interfaces to provide additional functionality @@ -635,7 +635,7 @@ argument.required=Ebagum lad, the '{0}' argument is required, I say, required.TaskExecutor abstraction. Check out the JavaDoc of the SpringContextResourceAdapter class for the configuration details involved in RAR deployment. diff --git a/src/reference/docbook/beans-extension-points.xml b/src/reference/docbook/beans-extension-points.xml index 3d6bf22f586..5b0688fd399 100644 --- a/src/reference/docbook/beans-extension-points.xml +++ b/src/reference/docbook/beans-extension-points.xml @@ -231,7 +231,7 @@ org.springframework.scripting.groovy.GroovyMessenger@272961 Using callback interfaces or annotations in conjunction with a custom BeanPostProcessor implementation is a common means of extending the Spring IoC container. An example is - Spring's RequiredAnnotationBeanPostProcessor — a + Spring's RequiredAnnotationBeanPostProcessor — a BeanPostProcessor implementation that ships with the Spring distribution which ensures that JavaBean properties on beans that are marked with an (arbitrary) annotation are diff --git a/src/reference/docbook/beans-scopes.xml b/src/reference/docbook/beans-scopes.xml index c87fde5cb56..2806813e302 100644 --- a/src/reference/docbook/beans-scopes.xml +++ b/src/reference/docbook/beans-scopes.xml @@ -95,7 +95,7 @@ As of Spring 3.0, a thread scope is available, but is not registered by default. For more information, see the documentation for SimpleThreadScope. For instructions on how to register this or any other custom scope, see . @@ -118,7 +118,8 @@ - + @@ -163,7 +164,8 @@ - + @@ -556,7 +558,7 @@ implement your own scopes, see the Scope implementations that are supplied with the Spring Framework itself and the Scope Javadoc, which explains the methods you need to implement in more detail. diff --git a/src/reference/docbook/beans-standard-annotations.xml b/src/reference/docbook/beans-standard-annotations.xml index 3f5d82bd5ff..44d06ead956 100644 --- a/src/reference/docbook/beans-standard-annotations.xml +++ b/src/reference/docbook/beans-standard-annotations.xml @@ -150,7 +150,7 @@ component-scanning in the exact same way as when using Spring annotations: @Component @Named - + @Scope("singleton") @@ -174,21 +174,21 @@ component-scanning in the exact same way as when using Spring annotations: @Qualifier @Named - + @Value - + no equivalent @Required - + no equivalent @Lazy - + no equivalent diff --git a/src/reference/docbook/beans.xml b/src/reference/docbook/beans.xml index 046abb49851..7d560c035da 100644 --- a/src/reference/docbook/beans.xml +++ b/src/reference/docbook/beans.xml @@ -29,11 +29,11 @@ The footnote should x-ref to first section in that chapter but I can't find the The org.springframework.beans and org.springframework.context packages are the basis for Spring Framework's IoC container. The BeanFactory interface provides an advanced configuration mechanism capable of managing any type of object. ApplicationContext is a sub-interface of BeanFactory. It adds easier integration with Spring's AOP features; message resource handling (for use in @@ -80,9 +80,9 @@ The footnote should x-ref to first section in that chapter but I can't find the ApplicationContext interface are supplied out-of-the-box with Spring. In standalone applications it is common to create an instance of ClassPathXmlApplicationContext or FileSystemXmlApplicationContext. While XML has been the traditional format for defining configuration metadata you can instruct the container to use @@ -109,7 +109,7 @@ The footnote should x-ref to first section in that chapter but I can't find the + format="PNG" width="400" /> The Spring IoC container @@ -1170,7 +1170,7 @@ cfg.postProcessBeanFactory(factory); a single ApplicationContext as a parent to WebApplicationContexts across WAR files. In this case you should look into using the utility class ContextSingletonBeanFactoryLocator locator that is described in this - - + + + + + + diff --git a/src/reference/docbook/index.xml b/src/reference/docbook/index.xml index 40d3c881f9d..5ff08474ad8 100644 --- a/src/reference/docbook/index.xml +++ b/src/reference/docbook/index.xml @@ -4,11 +4,11 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink"> - Reference Documentation + Spring Framework Reference Manual Spring Framework - 3.1 + ${version} @@ -182,7 +182,7 @@ - 2004-2011 + 2004-2012 Rod Johnson, Juergen Hoeller, Keith Donald, Colin Sampaleanu, Rob Harrop, Alef Arendsen, Thomas Risberg, Darren Davison, Dmitriy @@ -509,9 +509,8 @@ - diff --git a/src/reference/docbook/jdbc.xml b/src/reference/docbook/jdbc.xml index 1f274f3a7af..74524e03d9c 100644 --- a/src/reference/docbook/jdbc.xml +++ b/src/reference/docbook/jdbc.xml @@ -2600,93 +2600,74 @@ public class TitlesAfterDateStoredProcedure extends StoredProcedure { of a DefaultLobHandler. You typically set this value through dependency injection. - +clobReader.close();]]> + + + + Pass in the lobHandler that in this example is a plain + DefaultLobHandler + + + + Using the method + setClobAsCharacterStream, pass in the + contents of the CLOB. + + + + Using the method + setBlobAsBinaryStream, pass in the contents + of the BLOB. + + Now it's time to read the LOB data from the database. Again, you use a JdbcTemplate with the same instance variable lobHandler and a reference to a DefaultLobHandler. - + + + Using the method getClobAsString, + retrieve the contents of the CLOB. + + + + Using the method getBlobAsBytes, + retrieve the contents of the BLOB. + + +
diff --git a/src/reference/docbook/mvc.xml b/src/reference/docbook/mvc.xml index b26c0808852..452eea7b386 100644 --- a/src/reference/docbook/mvc.xml +++ b/src/reference/docbook/mvc.xml @@ -232,7 +232,8 @@ - + @@ -290,7 +291,7 @@ + format="GIF" width="400" /> diff --git a/src/reference/docbook/overview.xml b/src/reference/docbook/overview.xml index 41a980aec9e..e5db12efb31 100644 --- a/src/reference/docbook/overview.xml +++ b/src/reference/docbook/overview.xml @@ -97,7 +97,7 @@ TR: This section doesn't read well and I think we should try to rewrite it.-->Nu + format="PNG" width="400" /> @@ -259,7 +259,7 @@ TR: OK. Added to diagram.--> + format="PNG" width="400" /> @@ -289,7 +289,8 @@ TR: OK. Added to diagram.--> + fileref="images/overview-thirdparty-web.png" format="PNG" + width="400"/> @@ -315,7 +316,7 @@ TR: OK. Added to diagram.--> + format="PNG" width="400" /> @@ -335,7 +336,7 @@ TR: OK. Added to diagram.--> + format="PNG" width="400" /> @@ -620,7 +621,7 @@ TR: OK. Added to diagram.--> <repositories> <repository> <id>com.springsource.repository.maven.release</id> - <url>http://maven.springframework.org/release/</url> + <url>http://repo.springsource.org/release/</url> <snapshots><enabled>false</enabled></snapshots> </repository> </repositories> @@ -630,7 +631,7 @@ TR: OK. Added to diagram.--> <repositories> <repository> <id>com.springsource.repository.maven.milestone</id> - <url>http://maven.springframework.org/milestone/</url> + <url>http://repo.springsource.org/milestone/</url> <snapshots><enabled>false</enabled></snapshots> </repository> </repositories> @@ -640,7 +641,7 @@ TR: OK. Added to diagram.--> <repositories> <repository> <id>com.springsource.repository.maven.snapshot</id> - <url>http://maven.springframework.org/snapshot/</url> + <url>http://repo.springsource.org/snapshot/</url> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories> diff --git a/src/reference/docbook/oxm.xml b/src/reference/docbook/oxm.xml index cf1c9a329bb..a710e808b02 100644 --- a/src/reference/docbook/oxm.xml +++ b/src/reference/docbook/oxm.xml @@ -185,8 +185,19 @@ public interface Unmarshaller { The O/X Mapping exception hierarchy is shown in the following figure: - - + + + + + + O/X Mapping exception hierarchy + + + + + @@ -680,7 +691,7 @@ public class Application { This will make sure that only the registered classes are eligible for unmarshalling. - Additionally, you can register + Additionally, you can register custom converters to make sure that only your supported classes can be unmarshalled. diff --git a/src/reference/docbook/preface.xml b/src/reference/docbook/preface.xml index 4913cb1a280..1ba9be14afa 100644 --- a/src/reference/docbook/preface.xml +++ b/src/reference/docbook/preface.xml @@ -31,9 +31,8 @@ use and also on the Spring libraries, but these dependencies should be easy to isolate from the rest of your code base. - This document provides a reference guide to Spring's features. Since - this document is still to be considered very much work-in-progress, if you - have any requests or comments, please post them on the user mailing list or - on the support forums at . + This document provides a reference guide to Spring's features. If you + have any requests or comments, please add an issue at + . diff --git a/src/reference/docbook/remoting.xml b/src/reference/docbook/remoting.xml index fc81c0ab45c..18c6aed7c0b 100644 --- a/src/reference/docbook/remoting.xml +++ b/src/reference/docbook/remoting.xml @@ -1275,28 +1275,28 @@ if (HttpStatus.SC_CREATED == post.getStatusCode()) { DELETE delete + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#delete(String,%20Object...)">delete GET getForObject + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#getForObject(String,%20Class,%20Object...)">getForObject getForEntity + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#getForEntity(String,%20Class,%20Object...)">getForEntity HEAD headForHeaders(String + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#headForHeaders(String,%20Object...)">headForHeaders(String url, String… urlVariables) @@ -1304,7 +1304,7 @@ if (HttpStatus.SC_CREATED == post.getStatusCode()) { OPTIONS optionsForAllow(String + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#optionsForAllow(String,%20Object...)">optionsForAllow(String url, String… urlVariables) @@ -1312,7 +1312,7 @@ if (HttpStatus.SC_CREATED == post.getStatusCode()) { POST postForLocation(String + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#postForLocation(String,%20Object,%20Object...)">postForLocation(String url, Object request, String… urlVariables) @@ -1320,7 +1320,7 @@ if (HttpStatus.SC_CREATED == post.getStatusCode()) { postForObject(String + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#postForObject(java.lang.String,%20java.lang.Object,%20java.lang.Class,%20java.lang.String...)">postForObject(String url, Object request, Class<T> responseType, String… uriVariables) @@ -1329,7 +1329,7 @@ if (HttpStatus.SC_CREATED == post.getStatusCode()) { PUT put(String + url="http://static.springsource.org/spring/docs/current/api/org/springframework/web/client/RestTemplate.html#put(String,%20Object,%20Object...)">put(String url, Object request, String…urlVariables) diff --git a/src/reference/docbook/scheduling.xml b/src/reference/docbook/scheduling.xml index 28aff0638b0..922a4a413fd 100644 --- a/src/reference/docbook/scheduling.xml +++ b/src/reference/docbook/scheduling.xml @@ -821,7 +821,7 @@ public class ExampleJob extends QuartzJobBean { SchedulerFactoryBean for you to set, such as the calendars used by the job details, properties to customize Quartz with, etc. Have a look at the SchedulerFactoryBean + url="http://static.springframework.org/spring/docs/current/api/org/springframework/scheduling/quartz/SchedulerFactoryBean.html">SchedulerFactoryBean Javadoc for more information.
diff --git a/src/reference/docbook/spring-form.tld.xml b/src/reference/docbook/spring-form.tld.xml index 93e94d2e630..0aac4e18a1c 100644 --- a/src/reference/docbook/spring-form.tld.xml +++ b/src/reference/docbook/spring-form.tld.xml @@ -63,7 +63,7 @@ Renders an HTML 'input' tag with type 'checkbox'. Attributes - + @@ -464,7 +464,7 @@ Renders multiple HTML 'input' tags with type 'checkbox'.
Attributes - + @@ -907,7 +907,7 @@ Renders field errors in an HTML 'span' tag.
Attributes - + @@ -1224,7 +1224,7 @@ Renders an HTML 'form' tag and exposes a binding path to inner tags for binding.
Attributes - + @@ -1627,7 +1627,7 @@ Renders an HTML 'input' tag with type 'hidden' using the bound value.
Attributes - + @@ -1692,7 +1692,7 @@ Renders an HTML 'input' tag with type 'text' using the bound value.
Attributes - + @@ -2149,7 +2149,7 @@ Renders a form field label in an HTML 'label' tag.
Attributes - + @@ -2466,7 +2466,7 @@ Renders a single HTML 'option'. Sets 'selected' as appropriate based on bound value.
Attributes - + @@ -2797,7 +2797,7 @@ Renders a list of HTML 'option' tags. Sets 'selected' as appropriate based on bound value.
Attributes - + @@ -3142,7 +3142,7 @@ Renders an HTML 'input' tag with type 'password' using the bound value.
Attributes - + @@ -3613,7 +3613,7 @@ Renders an HTML 'input' tag with type 'radio'.
Attributes - + @@ -4014,7 +4014,7 @@ Renders multiple HTML 'input' tags with type 'radio'.
Attributes - + @@ -4457,7 +4457,7 @@ Renders an HTML 'select' element. Supports databinding to the selected option.
Attributes - + @@ -4900,7 +4900,7 @@ Renders an HTML 'textarea'.
Attributes - + diff --git a/src/reference/docbook/transaction.xml b/src/reference/docbook/transaction.xml index 349bfed4617..00f4a90c58b 100644 --- a/src/reference/docbook/transaction.xml +++ b/src/reference/docbook/transaction.xml @@ -718,7 +718,8 @@ TR: OK AS IS. images don't show up in the editor, but they do show up in the gen - + @@ -1847,13 +1848,18 @@ TR: REVISED, PLS REVIEW - changed it back; it's not just settings, the section d Required - + + format="PNG" width="400"/> - - + + + + + + When the propagation setting is PROPAGATION_REQUIRED, a diff --git a/src/reference/docbook/validation.xml b/src/reference/docbook/validation.xml index 9a619bce204..f6a0c5177d6 100644 --- a/src/reference/docbook/validation.xml +++ b/src/reference/docbook/validation.xml @@ -211,9 +211,9 @@ More information on the MessageCodesResolver and the default strategy can be found online with the Javadocs for MessageCodesResolver and DefaultMessageCodesResolver respectively. diff --git a/src/reference/docbook/view.xml b/src/reference/docbook/view.xml index 5ca53a2e02d..8629a256928 100644 --- a/src/reference/docbook/view.xml +++ b/src/reference/docbook/view.xml @@ -1141,7 +1141,7 @@ findOwnersForm.url=/WEB-INF/jsp/findOwners.jsp </bean> Refer to the API + url="http://static.springframework.org/spring/docs/current/api/org/springframework/ui/velocity/VelocityEngineFactory.html">API documentation for Spring configuration of Velocity, or the Velocity documentation for examples and definitions of the 'velocity.properties' file itself. diff --git a/src/reference/docbook/web-integration.xml b/src/reference/docbook/web-integration.xml index 583f19295eb..fda197ddb1d 100644 --- a/src/reference/docbook/web-integration.xml +++ b/src/reference/docbook/web-integration.xml @@ -84,7 +84,7 @@ contains all of the 'business beans' in one's application.On to specifics: all that one need do is to declare a ContextLoaderListener + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/context/ContextLoaderListener.html">ContextLoaderListener in the standard Java EE servlet web.xml file of one's web application, and add a contextConfigLocation <context-param/> section (in the same file) that defines which set @@ -107,7 +107,7 @@ context parameter, the ContextLoaderListener will look for a file called /WEB-INF/applicationContext.xml to load. Once the context files are loaded, Spring creates a WebApplicationContext + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/context/WebApplicationContext.html">WebApplicationContext object based on the bean definitions and stores it in the ServletContext of the web application. @@ -119,7 +119,7 @@ WebApplicationContext ctx = WebApplicationContextUtils.getWebApplicationContext(servletContext);The WebApplicationContextUtils + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/context/support/WebApplicationContextUtils.html">WebApplicationContextUtils class is for convenience, so you don't have to remember the name of the ServletContext attribute. Its getWebApplicationContext() method will return @@ -177,7 +177,7 @@ The easiest way to integrate one's Spring middle-tier with one's JSF web layer is to use the + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/jsf/DelegatingVariableResolver.html"> DelegatingVariableResolver class. To configure this variable resolver in one's application, one will need to edit one's faces-context.xml file. After the @@ -275,7 +275,7 @@ well when mapping one's properties to beans in faces-config.xml, but at times one may need to grab a bean explicitly. The + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/jsf/FacesContextUtils.html"> FacesContextUtils class makes this easy. It is similar to WebApplicationContextUtils, except that it takes a FacesContext parameter @@ -334,7 +334,7 @@ ContextLoaderPlugin The ContextLoaderPlugin + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/ContextLoaderPlugIn.html">ContextLoaderPlugin is a Struts 1.1+ plug-in that loads a Spring context file for the Struts ActionServlet. This context refers to the root WebApplicationContext (loaded by the @@ -405,7 +405,7 @@ DelegatingRequestProcessor To configure the + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/DelegatingRequestProcessor.html"> DelegatingRequestProcessor in your struts-config.xml file, override the "processorClass" property in the <controller> element. These @@ -433,7 +433,7 @@ If you are using Tiles in your Struts application, you must configure your <controller> with the DelegatingTilesRequestProcessor + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/DelegatingTilesRequestProcessor.html">DelegatingTilesRequestProcessor instead. @@ -445,7 +445,7 @@ can't use the DelegatingRequestProcessor or DelegatingTilesRequestProcessor approaches, you can use the + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/DelegatingActionProxy.html"> DelegatingActionProxy as the type in your action-mapping. @@ -483,7 +483,7 @@ is to extend Spring's Action classes for Struts. For example, instead of subclassing Struts' Action class, you can subclass Spring's + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/ActionSupport.html"> ActionSupport class. The ActionSupport class provides additional @@ -512,23 +512,23 @@ to the name: ActionSupport, + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/ActionSupport.html">ActionSupport, DispatchActionSupport, + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/DispatchActionSupport.html">DispatchActionSupport, LookupDispatchActionSupport + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/LookupDispatchActionSupport.html">LookupDispatchActionSupport and MappingDispatchActionSupport. + url="http://static.springframework.org/spring/docs/current/api/org/springframework/web/struts/MappingDispatchActionSupport.html">MappingDispatchActionSupport. diff --git a/src/reference/docbook/xsd-configuration.xml b/src/reference/docbook/xsd-configuration.xml index 576da4c31d1..71c34aef80f 100644 --- a/src/reference/docbook/xsd-configuration.xml +++ b/src/reference/docbook/xsd-configuration.xml @@ -140,7 +140,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
Setting a bean property or constructor arg from a field value - FieldRetrievingFactoryBean + FieldRetrievingFactoryBean is a FactoryBean which retrieves a static or non-static field value. It is typically used for retrieving public static @@ -149,7 +149,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem Find below an example which shows how a static field is exposed, by - using the staticField + using the staticField property: It is also possible to access a non-static (instance) field of another bean, as described in the API documentation for the - FieldRetrievingFactoryBean + FieldRetrievingFactoryBean class.
PROPAGATION_REQUIREDPROPAGATION_REQUIRED