svn commit: r1513323 - in /commons/sandbox/convert/trunk/src: main/java/org/apache/commons/convert/LocalizedConverter.java test/java/org/apache/commons/convert/TestDateTimeConverters.java

[ad...@apache.org]

Author: adrianc
Date: Tue Aug 13 02:16:18 2013
New Revision: 1513323

URL: http://svn.apache.org/r1513323
Log:
JavaDocs - no functional change.

Modified:
    commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java
    commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java

Modified: commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java
URL: http://svn.apache.org/viewvc/commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java?rev=1513323&r1=1513322&r2=1513323&view=diff
==============================================================================
--- commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java (original)
+++ commons/sandbox/convert/trunk/src/main/java/org/apache/commons/convert/LocalizedConverter.java Tue Aug 13 02:16:18 2013
@@ -24,6 +24,12 @@ import java.util.TimeZone;
 /** Localized converter interface. Classes implement this interface
  * to convert one object type to another. Methods are provided to
  * localize the conversion.
+ * <p>Localized converters are necessary for things like dates, times, and numbers. Those
+ * conversions are dependent on a locale and/or time zone. Java's default conversions
+ * (<code>toString</code>, <code>valueOf</code>) use the JVM's default locale and
+ * time zone - which might not be what the application requires. Implementations of
+ * <code>LocalizedConverter</code> will use the specified locale and time zone instead of
+ * the JVM defaults.</p>
  */
 public interface LocalizedConverter<S, T> extends Converter<S, T> {
     /** Converts <code>obj</code> to <code>T</code>.

Modified: commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java
URL: http://svn.apache.org/viewvc/commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java?rev=1513323&r1=1513322&r2=1513323&view=diff
==============================================================================
--- commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java (original)
+++ commons/sandbox/convert/trunk/src/test/java/org/apache/commons/convert/TestDateTimeConverters.java Tue Aug 13 02:16:18 2013
@@ -46,7 +46,7 @@ public class TestDateTimeConverters exte
             reflectiveConverter = (Converter<T, S>) Converters.getConverter(target.getClass(), source.getClass());
             assertEquals(label + " reflection converted", source, reflectiveConverter.convert(target));
         } catch (ClassNotFoundException e) {
-            System.out.println(converter.getClass() + " not reflective");
+            System.out.println(converter.getClass() + " is not reflective");
         }
         try {
             LocalizedConverter<S,T> localizedConverter = (LocalizedConverter) converter;