Converter interface explicitly documents null values

jhoeller · jhoeller · commit ff76be2d1665 · 2015-03-06T19:30:05.000+01:00
Issue: SPR-12780 (cherry picked from commit 5f30575)
diff --git a/spring-core/src/main/java/org/springframework/core/convert/converter/Converter.java b/spring-core/src/main/java/org/springframework/core/convert/converter/Converter.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2012 the original author or authors.
+ * Copyright 2002-2015 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,16 +24,15 @@
  *
  * @author Keith Donald
  * @since 3.0
- * @see ConditionalConverter
  * @param <S> The source type
  * @param <T> The target type
  */
 public interface Converter<S, T> {
 
 	/**
 	 * Convert the source of type S to target type T.
-	 * @param source the source object to convert, which must be an instance of S
-	 * @return the converted object, which must be an instance of T
+	 * @param source the source object to convert, which must be an instance of S (never {@code null})
+	 * @return the converted object, which must be an instance of T (potentially {@code null})
 	 * @throws IllegalArgumentException if the source could not be converted to the desired target type
 	 */
 	T convert(S source);
