javadoc

org.springframework.core/src/main/java/org/springframework/core/convert/support/GenericConverter.java

@@ -1,9 +1,36 @@
+/*
+ * Copyright 2002-2009 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.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package org.springframework.core.convert.support;
 
 import org.springframework.core.convert.TypeDescriptor;
 
+/**
+ * Uniform Converter interface used by GenericConversionService.
+ * This interface is an internal detail of the GenericConversionService implementation.
+ * It should generally not be implemented directly.
+ * @author Keith Donald
+ */
 public interface GenericConverter {
 	
+	/**
+	 * Convert the source object to the target type requested.
+	 * @param source the source
+	 * @param type the target type descriptor
+	 * @return the converted object
+	 */
 	Object convert(Object source, TypeDescriptor type);
 	
 }