Join GitHub today
Document null input requirements in Converter [SPR-12780] #17378
Looking at the JavaDocs for Converter, I see no mention about whether an implementation of the interface should expect to handle null values. However, the Spring Framework documentation indicates that "for each call to convert(S), the source argument is guaranteed to be NOT null."
It would be therefore useful if the expected null input behavior was called out explicitly in the Javadoc, so that implementors of the interface would know they should not put in null checks. Instead, they currently have to look in another source of documentation (not linked from the JavaDoc) to determine how they are expected to implement the interface.
Affects: 3.2.13, 4.1.5
Backported to: 3.2.14