Commit Graph

404 Commits

Author SHA1 Message Date
Costin Leau 1c78f37462 +SPR-7470
+ minor adjustments


git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3817 50f2f4bb-b051-0410-bef5-90022cba6387
2010-12-16 10:28:56 +00:00
Costin Leau 1feb389e27 SPR-7470
+ add basic documentation for c: namespace

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3814 50f2f4bb-b051-0410-bef5-90022cba6387
2010-12-15 16:12:54 +00:00
Costin Leau 0e94956e1e fixed mistake in jmx docs (SPR-977)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3813 50f2f4bb-b051-0410-bef5-90022cba6387
2010-12-15 15:13:23 +00:00
Arjen Poutsma 716dd4a383 Docs
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3751 50f2f4bb-b051-0410-bef5-90022cba6387
2010-10-13 14:19:48 +00:00
Oliver Gierke 5c7a62ce60 SPR-7641 - Added Principal to listing of supported method parameter types.
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3737 50f2f4bb-b051-0410-bef5-90022cba6387
2010-10-11 19:59:16 +00:00
Oliver Gierke d7f78103e7 SPR-7651 - Document limitations of @Async.
* documented that @Async can't be used in conjunction with lifecycle callbacks such as @PostConstruct
* provide sample for workaround
* added semantic markup for code

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3703 50f2f4bb-b051-0410-bef5-90022cba6387
2010-10-01 09:44:55 +00:00
Oliver Gierke e92f2d8419 Formatting for scheduling.xml.
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3702 50f2f4bb-b051-0410-bef5-90022cba6387
2010-10-01 09:44:52 +00:00
Oliver Gierke 180a9c5b00 SPR-7609 - Fixed typos in JMS documentation.
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3701 50f2f4bb-b051-0410-bef5-90022cba6387
2010-10-01 06:52:08 +00:00
Jeremy Grelle 51de2fc682 Minor correction to doc updates made as part of SPR-7545 - "cache-period" attribute was incorrectly documented as "cache-seconds".
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3690 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-17 18:50:01 +00:00
Chris Beams 32c08d1b3f Review recent documentation and default servlet changes
- Relocate and fix typos in interface-based @RequestMapping tip (SPR-7537)
- Fix typos in constructor-arg 'name' disambiguation section (SPR-7443)
- Polish whitespace in DefaultServletHttpRequestHandler (SPR-7553)

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3689 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-15 08:45:21 +00:00
Oliver Gierke a83b8cbd90 SPR-7443 - Mentioned @ConstructorProperties in doc
If you want to reference parameters by name in XML
configuration you can also use @ConstructorProperties
to name the parameters in the class.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3688 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-15 08:13:12 +00:00
Oliver Gierke 8b794385a3 SPR-7443 - Constructor arg resolution by name (doc)
Added documentation on constructor argument 
disambiguation by using the argument names.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3687 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-15 06:37:05 +00:00
Oliver Gierke 9975f5ec19 SPR-7537 - Document proxying for MVC controllers
Extended documentation to include hints on what to 
consider when working with proxied controllers.
Explained the necessity of moving @RequestMapping
annotations to the interface or use proxy-target-
class="true".

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3685 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-14 11:02:46 +00:00
Jeremy Grelle 508217e113 SPR-7545 - Reference documentation now reflects the final state of the ResourceHttpRequestHandler and references the DefaultServletHttpRequestHandler properly.
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3681 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-13 23:06:06 +00:00
Chris Beams 781e1fec1b Fix assumption about file-based Resources in PropertiesLoaderSupport (SPR-7547)
When using PropertiesLoaderSupport implementations (principally
PropertyPlaceholderConfigurer), an assumption was made that any
Resource representing a set of properties must be file-based.  SPR-7547
exposed the fact that if a non-file-based Resource implementation such
as ByteArrayResource were passed in, an IllegalStateException would be thrown
from the AbstractResource base class' implementation of getFilename().

This is now patched, and PropertiesLoaderSupport implementations treat
Resource implementations equally, regardless of file-orientation.

See also SPR-7552.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3680 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-13 20:23:26 +00:00
Chris Beams ea1ab292b4 Comment xsd-config-setup doc pending overhaul (SPR-7521)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3671 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-09 10:16:43 +00:00
Chris Beams fa3d7adac3 Polish whitespace in docs
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3670 50f2f4bb-b051-0410-bef5-90022cba6387
2010-09-09 10:16:39 +00:00
Ben Hale 82e5f5f5d6 Publishing license and notice files
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3612 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-23 13:17:31 +00:00
Chris Beams 49dd9b04ab Split IoC chapter DocBook XML into multiple files (SPR-7467)
All <section/> elements in beans.xml >=~ 500 lines have been broken out
into separate documents with DOCTYPE 'section'. This refactoring makes
working with these files much easier in wysiwyg editors (namely
oXygen Author).

For consistency, this same refactoring should be applied to all other
chapters much larger than 1500 lines, such as aop.xml (3861), mvc.xml
(3466), jdbc.xml (3042), and so on.

beans.xml and the new section files have also been formatted for
consistency and to avoid whitespace diffs as much as possible into the
future.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3605 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-18 10:37:35 +00:00
Chris Beams 1bcaef2b9a Document BeanFactoryPostProcessor implementation constraints (SPR-7466)
JavaDoc and reference docs now warn developers against interacting with
bean instances within BeanFactoryPostProcessor implementations in order
to avoid premature bean instantiation.

See SPR-7450 for an example of a third-party BFPP
(OAuthTokenLifecycleRegistryPostProcessor) prematurely instantiating
a FactoryBean instance, such that bean post-processing is bypassed
and autowired injection (via @Inject) never occurs.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3602 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-17 09:50:22 +00:00
Chris Beams 326359f297 Link to Spring Integration at end of event coverage
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3562 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-11 06:36:00 +00:00
Chris Beams e74a86cd9e Remove XFire reference documentation (SPR-7434)
XFire is now CXF (per http://xfire.codehaus.org), and given that Spring
does not actually ship with any explicit XFire support, it makes sense
to remove the documentation completely.  CXF does provide support for
writing services with Spring, and they provide their own documentation.

See http://cxf.apache.org/docs/writing-a-service-with-spring.html

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3561 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 23:10:35 +00:00
Chris Beams 4bd891ac22 Remove Chapter 27 from reference documentation (SPR-7433)
Chapter 27 covered @Required and RequiredAnnotationBeanPostProcessor but
did not hold together as a chapter unto itself.  The IoC chapter already
makes mention of @Required and RequiredAnnotationBeanPostProcessor,
though not in quite as much detail as Chapter 27 did.  Links have been
updated throughout to reference these sections and Chatper 27 has been
eliminated entirely.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3559 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 22:13:55 +00:00
Chris Beams 3755e488f0 Apply parentheses consistently within <methodname/>
Prior to change, there were 175 instances of <methodname/> elements
including parentheses (e.g.: <methodname>foo()</methodname>, and
36 instances without.

Now all 211 instances include parentheses for consistency.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3558 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 22:13:50 +00:00
Chris Beams f9be7f32c9 Overhaul custom ApplicationEvent documentation (SPR-7422, SPR-7395)
Documentation now:

- Reflects generic use of ApplicationListener interface

- Demonstrates use of ApplicationEventPublisher(Aware) instead of
  ApplicationContext(Aware) for publishing custom events

- Provides a more complete narrative as to how each of the publisher,
  listener, and event objects interact with one another

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3556 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 20:59:36 +00:00
Chris Beams 17037021ff Polish validation chapter program listings
<programlisting/> elements must contain no newlines at beginning or end.
The following is an example of what not to do:

    <programlisting><![CDATA[
package com.foo.bar;

class XFoo implements Foo<X> {
}]]>
    </programlisting>

This leaves newlines at the beginning and end of the programlisting
panel within the PDF. Instead, do it like this:

    <programlisting><![CDATA[package com.foo.bar;

class XFoo implements Foo<X> {
}]]></programlisting>

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3555 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 13:48:48 +00:00
Chris Beams 563274ec6a Clarify ConversionServiceFactoryBean documentation (SPR-7362)
- The sentence at the end of section 5.5.5 now refers to the
  <mvc:annotation-driven conversion-service="..."/> example at the end
  of section 5.6.

- The sentence at the end of section 5.5.5 refers to the
  FormatterConversionServiceFactoryBean section that follows.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3554 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 13:48:44 +00:00
Chris Beams a8210a5dfa Fix typo in validation chapter
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3553 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 13:48:41 +00:00
Chris Beams 257fd4268e Format validation chapter docbook source
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3552 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 13:48:34 +00:00
Chris Beams f43512c381 Remove dependency-check coverage from reference docs (SPR-7303)
- 'dependency-check' attribute of the <bean/> element was removed
  in the spring-beans-3.0 XSD; documentation now reflects this change.

- 'autodetect' was removed from the enumeration of possible values
  for autowire mode in the spring-beans-3.0 XSD; documentation now
  reflects this change.

Note that the underlying functionality for these values has not been
removed from Spring Core.  Users of Spring 3.0 who still need this
support may choose to use spring-beans-2.5.xsd in order to preserve
backward-compatibility.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3551 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-10 13:48:26 +00:00
Chris Beams 69b608bb2b Typo fix 'a enterprise' -> 'an enterprise'
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3544 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 22:47:32 +00:00
Chris Beams 78ee247ac3 Replace 'Java EE' with 'enterprise Java' as appropriate
Also change 'JEE' -> 'Java EE'

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3539 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 14:47:17 +00:00
Chris Beams 9cee0bc7e1 Add missing equals sign to code snippet (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3538 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:28 +00:00
Chris Beams 73ede99e14 Change 'lastName*' -> 'lastName' for error display (SPR-7339)
It's not clear why the asterisk would be necessary, as 'lastName'
alone should match all errors associated with that field.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3537 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:26 +00:00
Chris Beams 9d514b6d59 Fix typos (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3536 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:23 +00:00
Chris Beams d1fbb74a74 Fix typos in Chapter 27 (SPR-7339)
Note that SPR-7433 has also been created to consider removing this
chapter entirely.

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3535 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:18 +00:00
Chris Beams dec9cdcb4a Replace 'recourse' with simpler terms (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3534 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:16 +00:00
Chris Beams 4410126eeb Fix typo 'type form'->'type from' (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3533 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:14 +00:00
Chris Beams 3aa7e67ce7 Consistently refer to 'default no-arg constructor' (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3532 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:12 +00:00
Chris Beams f14a0c26e2 Distinguish JMS remoting from JMS messaging support (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3531 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:09 +00:00
Chris Beams e820dda201 Clarify ServletException is thrown when no view is resolved (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3530 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:07 +00:00
Chris Beams e1dfe5ca69 Add @Repository use to JdbcTemplate Best Practices (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3529 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:03 +00:00
Chris Beams 22271d0466 Improve explanation re DAOs and persistence resources (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3528 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:57:01 +00:00
Chris Beams 1be185c8e4 Replace 'tropes' language (SPR-7339)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3527 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-07 13:56:58 +00:00
Jeremy Grelle 3d413d4f55 SPR-7116 - Added documentation for <mvc:default-servlet-handler>
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3521 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-03 16:14:37 +00:00
Michael Isvy 9063e729bb SPR-7416
Typo on the name of the @Autowired annotation:  @Autowire -> @Autowired
Usage of the @Value annotation: ${jdbcProperties.url} -> ${jdbc.url} (inside section "Declaring @Configuration classes as plain Spring <bean/> elements").

git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3520 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-03 07:14:29 +00:00
Jeremy Grelle 12c4f7ccca SPR-7116 - Added documentation for <mvc:resources>
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3519 50f2f4bb-b051-0410-bef5-90022cba6387
2010-08-03 01:23:24 +00:00
Arjen Poutsma 3a821047d5 Fixed execute -> exchange
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3502 50f2f4bb-b051-0410-bef5-90022cba6387
2010-07-26 08:00:43 +00:00
Andy Clement 8ac0faff06 SpEL documentation (!) on @Bean referencing, inline lists and array construction
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3474 50f2f4bb-b051-0410-bef5-90022cba6387
2010-07-06 21:40:25 +00:00
Juergen Hoeller 372f54cf98 fixed typos (SPR-7332)
git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@3469 50f2f4bb-b051-0410-bef5-90022cba6387
2010-06-29 10:22:49 +00:00