From dcb1145354fc0f59e7a9a4037017ea887ce29839 Mon Sep 17 00:00:00 2001 From: Juergen Hoeller Date: Thu, 5 Mar 2015 18:52:38 +0100 Subject: [PATCH] Converter interface explicitly documents null values Issue: SPR-12780 --- .../springframework/core/convert/converter/Converter.java | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) 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 index 6710b666ab..cfb578c11a 100644 --- 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,7 +24,6 @@ package org.springframework.core.convert.converter; * * @author Keith Donald * @since 3.0 - * @see ConditionalConverter * @param The source type * @param The target type */ @@ -32,8 +31,8 @@ public interface Converter { /** * 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);