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

Clarify exception handling in converter 

Issue: SPR-11500
This commit is contained in:
Stephane Nicoll 2014-03-03 10:02:39 +01:00
parent 8f3a897502
commit 035d9d5af0
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
src/asciidoc/index.adoc
View File

@ -9760,9 +9760,9 @@ The SPI to implement type conversion logic is simple and strongly typed:
To create your own Converter, simply implement the interface above. Parameterize S as To create your own Converter, simply implement the interface above. Parameterize S as
the type you are converting from, and T as the type you are converting to. For each call the type you are converting from, and T as the type you are converting to. For each call
to convert(S), the source argument is guaranteed to be NOT null. Your Converter may to convert(S), the source argument is guaranteed to be NOT null. Your Converter may
throw any Exception if conversion fails. An IllegalArgumentException should be thrown to throw any unchecked exception if conversion fails. An `IllegalArgumentException` should
report an invalid source value. Take care to ensure your Converter implementation is be thrown to report an invalid source value. Take care to ensure your Converter implementation
thread-safe. is thread-safe.
Several converter implementations are provided in the `core.convert.support` package as Several converter implementations are provided in the `core.convert.support` package as
a convenience. These include converters from Strings to Numbers and other common types. a convenience. These include converters from Strings to Numbers and other common types.