Author: tchemit Date: 2010-05-11 13:24:21 +0200 (Tue, 11 May 2010) New Revision: 1851 Url: http://nuiton.org/repositories/revision/nuiton-utils/1851 Log: Evolution #594: Creates a org.nuiton.util.converter to move Converter api + deprecates Converter api in org.nuiton.util Modified: trunk/src/main/java/org/nuiton/util/ConverterUtil.java trunk/src/main/java/org/nuiton/util/EnumConverter.java trunk/src/main/java/org/nuiton/util/FormatConverter.java trunk/src/main/java/org/nuiton/util/FormatConverterFactory.java trunk/src/main/java/org/nuiton/util/FormatMap.java trunk/src/main/java/org/nuiton/util/URIConverter.java trunk/src/main/java/org/nuiton/util/URLConverter.java trunk/src/main/java/org/nuiton/util/VersionConverter.java trunk/src/main/java/org/nuiton/util/converter/ConverterUtil.java trunk/src/main/java/org/nuiton/util/converter/EnumConverter.java trunk/src/main/java/org/nuiton/util/converter/FormatConverter.java trunk/src/main/java/org/nuiton/util/converter/FormatConverterFactory.java trunk/src/main/java/org/nuiton/util/converter/FormatMap.java trunk/src/main/java/org/nuiton/util/converter/URIConverter.java trunk/src/main/java/org/nuiton/util/converter/URLConverter.java trunk/src/main/java/org/nuiton/util/converter/VersionConverter.java trunk/src/test/java/org/nuiton/util/ConverterUtilTest.java trunk/src/test/java/org/nuiton/util/VersionConverterTest.java trunk/src/test/java/org/nuiton/util/converter/ConverterUtilTest.java trunk/src/test/java/org/nuiton/util/converter/VersionConverterTest.java Modified: trunk/src/main/java/org/nuiton/util/ConverterUtil.java =================================================================== --- trunk/src/main/java/org/nuiton/util/ConverterUtil.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/ConverterUtil.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -36,7 +36,9 @@ * Une classe contenant des méthodes utiles sur les converters et les conversions * * @author tchemit <chemit@codelutin.com> + * @deprecated since 1.3, use now the {@link org.nuiton.util.converter.ConverterUtil} class. */ +@Deprecated public class ConverterUtil { /** to use log facility, just put in your code: log.info(\"...\"); */ Modified: trunk/src/main/java/org/nuiton/util/EnumConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/EnumConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/EnumConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -40,13 +40,15 @@ * Il est possible aussi de convertir une Enum à partir de sa valeur ordinal. * <p/> * Pour enregister un nouveau convertissemnt pour un type d'Enum utiliser les - * méthodes * {@link ConverterUtil#registerEnumConverter(Class)}, - * et {@link ConverterUtil#registerEnumConverter(Class,Object)} . + * méthodes {@link ConverterUtil#registerEnumConverter(Class)}, et + * {@link ConverterUtil#registerEnumConverter(Class,Object)}. * * @author tchemit <chemit@codelutin.com> * @see Enum * @see Enum#ordinal() + * @deprecated since 1.3, use now the {@link org.nuiton.util.converter.EnumConverter} class. */ +@Deprecated public class EnumConverter implements Converter { /** to use log facility, just put in your code: log.info(\"...\"); */ Modified: trunk/src/main/java/org/nuiton/util/FormatConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/FormatConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/FormatConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -47,7 +47,10 @@ * pour eviter une conversion supplémentaire qui pourrait-etre couteuse. * * @param <A> le type de l'objet a convertir + * + * @deprecated since 1.3, use the class {@link org.nuiton.util.converter.FormatConverter}. */ +@Deprecated public interface FormatConverter<A> { // FormatConverter Format FORMAT_JAVA = new Format("Format Java"); Modified: trunk/src/main/java/org/nuiton/util/FormatConverterFactory.java =================================================================== --- trunk/src/main/java/org/nuiton/util/FormatConverterFactory.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/FormatConverterFactory.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -62,7 +62,10 @@ * values, AppContext); * </pre> * Dans ce cas pour des raisons d'optimisation + * + * @deprecated since 1.3, use the class {@link org.nuiton.util.converter.FormatConverterFactory}. */ +@Deprecated public class FormatConverterFactory { // FormatConverterFactory /** to use log facility, just put in your code: log.info(\"...\"); */ Modified: trunk/src/main/java/org/nuiton/util/FormatMap.java =================================================================== --- trunk/src/main/java/org/nuiton/util/FormatMap.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/FormatMap.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -68,7 +68,10 @@ * Il est souvent plus simple de faire une petite classe avec les methodes * getSQL() et getXML(), qui retourne les valeurs directement dans le bon type * et qui n'ont pas besoin d'argument. + * + * @deprecated since 1.3, use the class {@link org.nuiton.util.converter.FormatMap}. */ +@Deprecated public class FormatMap extends HashMap<Format, Object> { // FormatMap /** */ Modified: trunk/src/main/java/org/nuiton/util/URIConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/URIConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/URIConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -38,7 +38,9 @@ * classe pour convertir une chaine en un objet URI. * * @author tchemit <chemit@codelutin.com> + * @deprecated since 1.3, use now the {@link org.nuiton.util.converter.URIConverter} class. */ +@Deprecated public class URIConverter implements Converter { /** to use log facility, just put in your code: log.info(\"...\"); */ Modified: trunk/src/main/java/org/nuiton/util/URLConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/URLConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/URLConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -38,7 +38,9 @@ * classe pour convertir une chaine en un objet URL. * * @author tchemit <chemit@codelutin.com> + * @deprecated since 1.3, use now the {@link org.nuiton.util.converter.URLConverter} class. */ +@Deprecated public class URLConverter implements Converter { /** to use log facility, just put in your code: log.info(\"...\"); */ Modified: trunk/src/main/java/org/nuiton/util/VersionConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/VersionConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/VersionConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -36,7 +36,9 @@ * * @author tchemit <chemit@codelutin.com> * @see Version + * @deprecated since 1.3, use now the {@link org.nuiton.util.converter.VersionConverter} class. */ +@Deprecated public class VersionConverter implements Converter { /** to use log facility, just put in your code: log.info(\"...\"); */ Modified: trunk/src/main/java/org/nuiton/util/converter/ConverterUtil.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/ConverterUtil.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/ConverterUtil.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,7 +23,7 @@ * #L% */ -package org.nuiton.util; +package org.nuiton.util.converter; import java.lang.reflect.Method; import java.util.ServiceLoader; @@ -36,6 +36,7 @@ * Une classe contenant des méthodes utiles sur les converters et les conversions * * @author tchemit <chemit@codelutin.com> + * @since 1.3 (replace {@code org.nuiton.util.ConverterUtil}). */ public class ConverterUtil { Modified: trunk/src/main/java/org/nuiton/util/converter/EnumConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/EnumConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/EnumConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,7 +23,7 @@ * #L% */ -package org.nuiton.util; +package org.nuiton.util.converter; import org.apache.commons.beanutils.ConversionException; import static org.apache.commons.logging.LogFactory.getLog; Modified: trunk/src/main/java/org/nuiton/util/converter/FormatConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/FormatConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/FormatConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -34,9 +34,9 @@ * Last update: $Date$ * by : */ -package org.nuiton.util; +package org.nuiton.util.converter; -import org.nuiton.util.FormatMap.Format; +import org.nuiton.util.converter.FormatMap.Format; /** * Un converter est un objet qui permet de passé d'une representation d'un Modified: trunk/src/main/java/org/nuiton/util/converter/FormatConverterFactory.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/FormatConverterFactory.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/FormatConverterFactory.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,23 +23,12 @@ * #L% */ -/* * - * FormatConverterFactory.java - * - * Created: 14 septembre 2005 00:19:51 CEST - * - * @author Benjamin POUSSIN <poussin@codelutin.com> - * @version $Revision$ - * - * Last update: $Date$ - * by : */ +package org.nuiton.util.converter; -package org.nuiton.util; - import org.apache.commons.collections.map.MultiKeyMap; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; -import org.nuiton.util.FormatMap.Format; +import org.nuiton.util.converter.FormatMap.Format; import java.util.Collections; import java.util.Iterator; @@ -62,6 +51,12 @@ * values, AppContext); * </pre> * Dans ce cas pour des raisons d'optimisation + * <p/> + * Created: 14 septembre 2005 00:19:51 CEST + * + * @author Benjamin POUSSIN <poussin@codelutin.com> + * @version $Id$ + * @since 1.3 replace the class {@code org.nuiton.util.FormatConverterFactory}. */ public class FormatConverterFactory { // FormatConverterFactory @@ -69,6 +64,7 @@ static private Log log = LogFactory.getLog(FormatConverterFactory.class); static protected FormatConverterFactory instance; + /** <Class, from, to -> FormatConverter> */ protected MultiKeyMap converters = new MultiKeyMap(); @@ -102,7 +98,7 @@ * @return le converter souhaité ou defaultConverter */ public FormatConverter<?> getConverter(Class<?> clazz, Format format, - FormatConverter<?> defaultConverter) { + FormatConverter<?> defaultConverter) { FormatConverter<?> result = (FormatConverter<?>) converters.get(clazz, format); if (result == null) { result = defaultConverter; @@ -112,7 +108,7 @@ /** * @param clazz - * @param format + * @param format * @return retourne null si aucun converter trouvé * @see #getConverter(Class, Format, FormatConverter) */ @@ -131,7 +127,7 @@ * @return le converter souhaité ou defaultConverter */ public FormatConverter<?> findConverter(Class<?> clazz, Format format, - FormatConverter<?> defaultConverter) { + FormatConverter<?> defaultConverter) { FormatConverter<?> result = null; LinkedList<Class<?>> interfaces = new LinkedList<Class<?>>(); Modified: trunk/src/main/java/org/nuiton/util/converter/FormatMap.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/FormatMap.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/FormatMap.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -22,21 +22,8 @@ * <http://www.gnu.org/licenses/lgpl-3.0.html>. * #L% */ +package org.nuiton.util.converter; -/* * - * FormatMap.java - * - * Created: 16 septembre 2005 10:41:58 CEST - * - * @author Benjamin POUSSIN <poussin@codelutin.com> - * @version $Revision$ - * - * Last update: $Date$ - * by : */ -package org.nuiton.util; - -import org.nuiton.util.FormatMap.Format; - import java.util.HashMap; import java.util.Map; @@ -68,11 +55,17 @@ * Il est souvent plus simple de faire une petite classe avec les methodes * getSQL() et getXML(), qui retourne les valeurs directement dans le bon type * et qui n'ont pas besoin d'argument. + * <p/> + * <p/> + * Created: 16 septembre 2005 10:41:58 CEST + * + * @author Benjamin POUSSIN <poussin@codelutin.com> + * @version $Id$ + * @since 1.3 (replace {@code org.nuiton.util.FormatMap} class). */ -public class FormatMap extends HashMap<Format, Object> { // FormatMap +public class FormatMap extends HashMap<FormatMap.Format, Object> { // FormatMap - /** */ - private static final long serialVersionUID = -3386611811885092898L; + private static final long serialVersionUID = 1L; static public class Format { @@ -87,6 +80,7 @@ return name; } } + protected Class<?> clazz; public FormatMap(Class<?> clazz) { @@ -100,7 +94,7 @@ /** * Met a jour la valeur de l'objet. Toutes les autres valeurs calculées * sont oubliées et seront recalculé en fonction de cette nouvelle valeur - * + * * @param format le format a utiliser * @param value */ @@ -113,7 +107,7 @@ * Utilise le FormatConverterFactory par defaut pour la conversion * * @param format le format a utiliser - * @param args les arguments + * @param args les arguments * @return l'objet converti */ public Object convert(Format format, Object... args) { @@ -129,7 +123,7 @@ * @return l'objet converti */ public Object convert(FormatConverterFactory factory, Format format, - Object... args) { + Object... args) { Object result = null; Map<Format, Object> values = this; //if (!values.containsKey(format) || @@ -156,7 +150,9 @@ return result; } - /** Utilise le FormatConverterFactory par defaut pour la conversion + /** + * Utilise le FormatConverterFactory par defaut pour la conversion + * * @param format le format utilise * @param args * @return l'objet java @@ -175,11 +171,11 @@ * @return l'objet java */ public Object unconvert(FormatConverterFactory factory, Format format, - Object... args) { + Object... args) { Object result = null; Map<Format, Object> values = this; if (!values.containsKey(format) && - !values.containsKey(FormatConverter.FORMAT_JAVA)) { + !values.containsKey(FormatConverter.FORMAT_JAVA)) { throw new IllegalArgumentException("Aucun valeur disponible"); } Modified: trunk/src/main/java/org/nuiton/util/converter/URIConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/URIConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/URIConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,7 +23,7 @@ * #L% */ -package org.nuiton.util; +package org.nuiton.util.converter; import org.apache.commons.beanutils.ConversionException; import static org.apache.commons.logging.LogFactory.getLog; @@ -38,6 +38,7 @@ * classe pour convertir une chaine en un objet URI. * * @author tchemit <chemit@codelutin.com> + * @since 1.3 (replace {@code org.nuiton.util.URIConverter}). */ public class URIConverter implements Converter { Modified: trunk/src/main/java/org/nuiton/util/converter/URLConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/URLConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/URLConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,7 +23,7 @@ * #L% */ -package org.nuiton.util; +package org.nuiton.util.converter; import org.apache.commons.beanutils.ConversionException; import static org.apache.commons.logging.LogFactory.getLog; @@ -38,6 +38,7 @@ * classe pour convertir une chaine en un objet URL. * * @author tchemit <chemit@codelutin.com> + * @since 1.3 (replace {@code org.nuiton.util.URLConverter}). */ public class URLConverter implements Converter { Modified: trunk/src/main/java/org/nuiton/util/converter/VersionConverter.java =================================================================== --- trunk/src/main/java/org/nuiton/util/converter/VersionConverter.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/main/java/org/nuiton/util/converter/VersionConverter.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,18 +23,22 @@ * #L% */ -package org.nuiton.util; +package org.nuiton.util.converter; import org.apache.commons.beanutils.ConversionException; import org.apache.commons.beanutils.Converter; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; +import org.nuiton.util.Version; +import org.nuiton.util.VersionUtil; + import static org.nuiton.i18n.I18n._; /** * classe pour convertir une chaine en un objet Version. * * @author tchemit <chemit@codelutin.com> + * @since 1.3 (replace {@code org.nuiton.util.VersionConverter}). * @see Version */ public class VersionConverter implements Converter { Modified: trunk/src/test/java/org/nuiton/util/ConverterUtilTest.java =================================================================== --- trunk/src/test/java/org/nuiton/util/ConverterUtilTest.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/test/java/org/nuiton/util/ConverterUtilTest.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -36,7 +36,9 @@ * @author tchemit <chemit@codelutin.com> * @version 1.0 * @since <pre>02/13/2008</pre> + * @deprecated since 1.3, use now the {@link org.nuiton.util.converter.ConverterUtilTest} class. */ +@Deprecated public class ConverterUtilTest { @Test Modified: trunk/src/test/java/org/nuiton/util/VersionConverterTest.java =================================================================== --- trunk/src/test/java/org/nuiton/util/VersionConverterTest.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/test/java/org/nuiton/util/VersionConverterTest.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -35,7 +35,9 @@ /** * * @author tchemit <chemit@codelutin.com> + * @deprecated since 1.3, use now the {@link org.nuiton.util.converter.VersionConverterTest} class. */ +@Deprecated public class VersionConverterTest { VersionConverter converter; Modified: trunk/src/test/java/org/nuiton/util/converter/ConverterUtilTest.java =================================================================== --- trunk/src/test/java/org/nuiton/util/converter/ConverterUtilTest.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/test/java/org/nuiton/util/converter/ConverterUtilTest.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,18 +23,19 @@ * #L% */ -package org.nuiton.util; +package org.nuiton.util.converter; import org.apache.commons.beanutils.ConvertUtils; import org.apache.commons.beanutils.Converter; import org.junit.Assert; import org.junit.Test; +import org.nuiton.util.Version; /** * ConverterUtil Tester. * * @author tchemit <chemit@codelutin.com> - * @version 1.0 + * @version 1.3 (replace class {@code org.nuiton.util.ConverterUtilTest}). * @since <pre>02/13/2008</pre> */ public class ConverterUtilTest { Modified: trunk/src/test/java/org/nuiton/util/converter/VersionConverterTest.java =================================================================== --- trunk/src/test/java/org/nuiton/util/converter/VersionConverterTest.java 2010-05-11 11:20:39 UTC (rev 1850) +++ trunk/src/test/java/org/nuiton/util/converter/VersionConverterTest.java 2010-05-11 11:24:21 UTC (rev 1851) @@ -23,18 +23,21 @@ * #L% */ -package org.nuiton.util; +package org.nuiton.util.converter; import org.junit.After; import org.junit.AfterClass; import org.junit.Before; import org.junit.BeforeClass; import org.junit.Test; +import org.nuiton.util.Version; + import static org.junit.Assert.*; /** * * @author tchemit <chemit@codelutin.com> + * @since 1.3 (replace class {@code org.nuiton.util.VersionConverterTest}). */ public class VersionConverterTest {