- Nuiton-utils-commits - mailman.cloud.codelutin.com

r2115 - trunk/nuiton-utils/src/main/java/org/nuiton/util
by sletellier＠users.nuiton.org April 26, 2011

April 26, 2011

Author: sletellier Date: 2011-04-26 11:27:29 +0200 (Tue, 26 Apr 2011) New Revision: 2115 Url: http://nuiton.org/repositories/revision/nuiton-utils/2115 Log: Fix ApplicationConfig documentation Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-22 16:36:21 UTC (rev 2114) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-26 09:27:29 UTC (rev 2115) @@ -90,7 +90,7 @@ * * <h3>Bonnes pratiques</h3> * - * Vous devez créer une factory pour créer les ApplicationConfig qui contiendra par exemple une méthode : + * Vous devez créer une factory pour créer les instances d'{@link ApplicationConfig} qui contiendra par exemple une méthode : * * <pre> * @@ -717,7 +717,7 @@ * * @param alias the alias to add for the given method action * @param actionMethod must be fully qualified method path: - * package.Class.method + * package.Class#method */ public void addActionAlias(String alias, String actionMethod) { addAlias(alias, "--" + actionMethod); @@ -2031,11 +2031,15 @@ public interface ActionDef extends Serializable { /** + * Must return fully qualified method path : package.Class#method + * * @return action to run */ String getAction(); /** + * Return all alias used to execute action. + * * @return aliases used to execute action */ String[] getAliases();

1 0

r2114 - trunk/nuiton-utils/src/main/java/org/nuiton/util
by sletellier＠users.nuiton.org April 22, 2011

April 22, 2011

Author: sletellier Date: 2011-04-22 18:36:21 +0200 (Fri, 22 Apr 2011) New Revision: 2114 Url: http://nuiton.org/repositories/revision/nuiton-utils/2114 Log: Fix and update configuration with best practice and simple exemple Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-16 13:12:15 UTC (rev 2113) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-22 16:36:21 UTC (rev 2114) @@ -85,26 +85,45 @@ * il y a un bout des actions qui sont des chaines (nom de la methode). Il faudrait * faire un plugin maven qui check que l'action existe bien durant la compilation. * Il est simple de le faire a l'execution mais c trop tard :( + * <li>Ajouter de la documentation pour {@link #getOptionAsList(String)} * </ul> * - * <h3>Usage</h3> - * Create subclass of {@link ApplicationConfig}, where in constructor you call - * {@link #setConfigFileName(String)}, {@link #setDefaultOption(String, String)}, - * {@link #addAlias(String, String...)}, {@link #addActionAlias(String, String)}, - * to have properly value. - * <pre> - * conf = new MonAppConfig(); - * conf.parse(args); - * here you can used conf.getOption(key); - * conf.doAction(0); - * ... - * conf.doAction(n); + * <h3>Bonnes pratiques</h3> + * + * Vous devez créer une factory pour créer les ApplicationConfig qui contiendra par exemple une méthode : + * + * <pre> + * + * static public ApplicationConfig getConfig( + * Properties props, String configFilename, String ... args) { + * + * ApplicationConfig conf = new ApplicationConfig( + * MyAppConfigOption.class, MyAppConfigAction.class, + * props, configFilename); + * + * try { + * conf.parse(args); + * } catch (ArgumentsParserException eee) { + * if (log.isErrorEnabled()) { + * log.error("Can't load app configuration", eee); + * } + * } + * return conf; + * } + * * </pre> - * + * + * <ul> + * <li>MyAppConfigOption doit étendre {@link OptionDef} et décrir la configuration de l'application. + * <li>MyAppConfigAction doit étendre {@link ActionDef} et décrir la liste des options + * et de leur alias disponible pour l'application. + * </ul> + * * <h3>Lecture des fichiers de configuration</h3> * * La lecture des fichiers de configuration se fait durant l'appel de la methode - * {@link #parse} en utilisant la valeur de {@link #getConfigFileName} pour + * {@link #parse(String...)} en utilisant la valeur de qui doit être définit + * dans les options avec pour clef {@link ApplicationConfig#CONFIG_FILE_NAME} pour * trouver les fichiers (voir Les options de configuration pour l'ordre de * chargement des fichiers) * @@ -112,13 +131,13 @@ * La sauvegarde des options se fait via une des trois methodes disponibles : * <ul> * <li> {@link #save(File, boolean,String...)} sauve les données dans le fichier demandé - * <li> {@link #saveForSystem} sauvegarde les donnees dans /etc - * <li> {@link #saveForUser} sauvegarde les donnees dans $HOME + * <li> {@link #saveForSystem(String...)} sauvegarde les donnees dans /etc + * <li> {@link #saveForUser(String...)} sauvegarde les donnees dans $HOME * </ul> * - * Lors de l'utilisation de la methode {@link #saveForSystem} ou - * {@link #saveForUser} seules les options lues dans un fichier ou modifiées par - * programmation ({@link #setOption} seront sauvegardées. Par exemple les + * Lors de l'utilisation de la methode {@link #saveForSystem(String...)} ou + * {@link #saveForUser(String...)} seules les options lues dans un fichier ou modifiées par + * programmation ({@link #setOption(String, String)} seront sauvegardées. Par exemple les * options passees sur la ligne de commande ne seront pas sauvees. * * <h3>Les options de configuration</h3> @@ -185,7 +204,7 @@ * d'utiliser une methode avec des arguments variants * <p/> * Les actions ne sont pas execute mais seulement parsees. Pour les executer - * il faut utiliser la méthode {@link #doAction} qui prend en argument un numero + * il faut utiliser la méthode {@link #doAction(int)} qui prend en argument un numero * de 'step'. Par defaut toutes les actions sont de niveau 0 et sont executee * dans l'ordre d'apparition sur la ligne de commande. Si l'on souhaite * distinguer les actions il est possible d'utiliser l'annotation @@ -215,7 +234,7 @@ * On voit qu'aussi bien pour les actions que pour les options, le nom de la * methode doit etre utilise. Pour eviter ceci il est possible de definir * des alias ce qui permet de creer des options courtes par exemple. Pour cela, - * on utilise la methode {@link #addAlias}. + * on utilise la methode {@link #addAlias(String, String...)}. * <pre> * addAlias("-v", "--option", "verbose", "true"); * addAlias("-o", "--option", "outputfile"); @@ -404,7 +423,7 @@ * * @param configFilename name of config to use */ - public ApplicationConfig(String configFilename) throws ArgumentsParserException { + public ApplicationConfig(String configFilename) { this(null, null, null, configFilename); } @@ -428,7 +447,6 @@ * @param actionClass class that describe action, can be null * @param defaults properties that override default value of optionClass, can be null * @param configFilename override default config filename, can be null - * @param args command line argument can be empty */ public <O extends OptionDef, A extends ActionDef> ApplicationConfig( Class<O> optionClass, Class<A> actionClass, @@ -1278,7 +1296,7 @@ /** * Set manually options when you don't want to use parse method to check - * properties file configured by {@link #setConfigFileName}. + * properties file configured by {@link #setConfigFileName(String)}. * * @param options Properties which contains all options to set */ @@ -1494,6 +1512,7 @@ * Load configuration file and prepare Action. * * @param args argument as main(String[] args) + * @return ApplicationConfig instance * @throws ArgumentsParserException if parsing failed */ public ApplicationConfig parse(String... args) throws ArgumentsParserException { @@ -1838,6 +1857,85 @@ * Le contrat de marquage des options, on utilise cette interface pour * caracteriser une option de configuration. * + * <pre> + * public enum MyConfigOption implements OptionDef { + * + * APP_CONFIG_FILE( + * ApplicationConfig.CONFIG_FILE_NAME, + * "Main configuration app file", + * "myApp-config.properties", + * String.class, true, true), + * + * APP_NAME( + * ApplicationConfig.CONFIG_FILE_NAME, + * Application name, + * "MyApp", + * String.class, true, true); + * + * public String key; + * public String description; + * public String defaultValue; + * public Class<?> type; + * public boolean isTransient; + * public boolean isFinal; + * + * private WikittyConfigOption(String key, String description, + * String defaultValue, Class<?> type, boolean isTransient, boolean isFinal) { + * this.key = key; + * this.description = description; + * this.defaultValue = defaultValue; + * this.type = type; + * this.isTransient = isTransient; + * this.isFinal = isFinal; + * } + * + * @Override + * public boolean isFinal() { + * return isFinal; + * } + * + * @Override + * public boolean isTransient() { + * return isTransient; + * } + * + * @Override + * public String getDefaultValue() { + * return defaultValue; + * } + * + * @Override + * public String getDescription() { + * return description; + * } + * + * @Override + * public String getKey() { + * return key; + * } + * + * @Override + * public Class<?> getType() { + * return type; + * } + * + * @Override + * public void setDefaultValue(String defaultValue) { + * this.defaultValue = defaultValue; + * } + * + * @Override + * public void setTransient(boolean isTransient) { + * this.isTransient = isTransient; + * } + * + * @Override + * public void setFinal(boolean isFinal) { + * this.isFinal = isFinal; + * } + * } + * </pre> + * * @since 1.0.0-rc-9 */ public interface OptionDef extends Serializable { @@ -1901,6 +1999,32 @@ * Le contrat de marquage des action, on utilise cette interface pour * caracteriser une action. * + * Ex : + * + * <pre> + * public enum MyAppConfigAction implements ActionDef { + * HELP(MyAppHelpAction.class.getName() + "#show", "-h", "--help"); + * public String action; + * public String[] aliases; + * + * private WikittyConfigAction(String action, String... aliases) { + * this.action = action; + * this.aliases = aliases; + * } + * + * @Override + * public String getAction() { + * return action; + * } + * + * @Override + * public String[] getAliases() { + * return aliases; + * } + * + * } + * </pre> + * * @author sletellier * @since 1.5.2 */

1 0

r2113 - trunk/src/site/apt
by fdesbois＠users.nuiton.org April 16, 2011

April 16, 2011

Author: fdesbois Date: 2011-04-16 15:12:15 +0200 (Sat, 16 Apr 2011) New Revision: 2113 Url: http://nuiton.org/repositories/revision/nuiton-utils/2113 Log: missing spaces Modified: trunk/src/site/apt/index.apt Modified: trunk/src/site/apt/index.apt =================================================================== --- trunk/src/site/apt/index.apt 2011-04-16 10:58:37 UTC (rev 2112) +++ trunk/src/site/apt/index.apt 2011-04-16 13:12:15 UTC (rev 2113) @@ -48,8 +48,11 @@ des sources. Les fonctionnalités supportés sont : * nombre d'appels aux méthodes + * temps min, max, moyen d'exécution d'une méthode (sans les sous-méthodes) + * temps total d'exécution d'une méthode (avec les sous-méthodes) + * temps d'appel des sous-méthodes {{{./nuiton-profiling}Plus d'infos}}

1 0

r2112 - trunk/nuiton-utils/src/site/apt
by fdesbois＠users.nuiton.org April 16, 2011

April 16, 2011

Author: fdesbois Date: 2011-04-16 12:58:37 +0200 (Sat, 16 Apr 2011) New Revision: 2112 Url: http://nuiton.org/repositories/revision/nuiton-utils/2112 Log: It's not a binary file Modified: trunk/nuiton-utils/src/site/apt/index.apt Property changes on: trunk/nuiton-utils/src/site/apt/index.apt ___________________________________________________________________ Deleted: svn:mime-type - application/octet-stream Deleted: svn:mergeinfo -

1 0

r2111 - in trunk: nuiton-utils/src/main/java/org/nuiton/util nuiton-utils/src/site nuiton-utils/src/site/apt src/site/apt
by fdesbois＠users.nuiton.org April 16, 2011

April 16, 2011

Author: fdesbois Date: 2011-04-16 12:56:44 +0200 (Sat, 16 Apr 2011) New Revision: 2111 Url: http://nuiton.org/repositories/revision/nuiton-utils/2111 Log: Remove old nuitonUtil.apt : move docs from apt to javadoc + clean headers Removed: trunk/nuiton-utils/src/site/apt/nuitonUtil.apt Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/BoundedList.java trunk/nuiton-utils/src/main/java/org/nuiton/util/FileUtil.java trunk/nuiton-utils/src/main/java/org/nuiton/util/ObjectUtil.java trunk/nuiton-utils/src/main/java/org/nuiton/util/ReflectUtil.java trunk/nuiton-utils/src/main/java/org/nuiton/util/Resource.java trunk/nuiton-utils/src/main/java/org/nuiton/util/SortedProperties.java trunk/nuiton-utils/src/main/java/org/nuiton/util/StringUtil.java trunk/nuiton-utils/src/main/java/org/nuiton/util/ZipUtil.java trunk/nuiton-utils/src/site/apt/index.apt trunk/nuiton-utils/src/site/site_fr.xml trunk/src/site/apt/index.apt Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/BoundedList.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/BoundedList.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/BoundedList.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -39,7 +39,15 @@ import java.util.ArrayList; import java.util.Collection; -/** ArrayList with minimum and maximum sizes. For each operation, the size is checked and the BoundedList to ensure that it is kept in the range. */ +/** + * ArrayList with minimum and maximum sizes. For each operation, the size is + * checked and the BoundedList to ensure that it is kept in the range. + * <p/> + * Created: 10 juin 2005 + * + * @author athimel <thimel(a)codelutin.com> + * $Id$ + */ public class BoundedList<E> extends ArrayList<E> { /** */ private static final long serialVersionUID = -3211387041114409849L; Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/FileUtil.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/FileUtil.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/FileUtil.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -71,12 +71,26 @@ import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; +/** + * Opérations sur des fichiers. Copie, suppression, renommage, + * recherche, fichiers d'un répertoire, sous-répertoires d'un répertoire, + * récupération du basename ou de l'extension, création d'un fichier + * temporaire, comparaison de dates de création, récupération d'une chaîne, + * d'un Reader ou d'un Writer à partir d'un fichier, récupération du fichier + * saisi dans une boîte de dialogue, conversions en byte[], en Stream... + * <p/> + * Created: 22 novembre 2004 + * + * @author bpoussin <poussin(a)codelutin.com> + * $Id$ + */ public class FileUtil { // FileUtil /** to use log facility, just put in your code: log.info(\"...\"); */ static private Log log = LogFactory.getLog(FileUtil.class); - /** Encoding par defaut utilisé si non spécifié */ + /** Encoding utilisé (peut être redéfini) */ + // TODO fdesbois 2011-04-16 : Perhaps change ISO encoding by UTF-8 static public String ENCODING = "ISO-8859-1"; static protected File currentDirectory = new File("."); Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ObjectUtil.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ObjectUtil.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ObjectUtil.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -59,13 +59,23 @@ import org.apache.commons.beanutils.BeanUtils; import org.apache.commons.beanutils.ConvertUtils; +/** + * Outils pour manipuler des objets. Création d'un objet à partir d'une chaîne + * le décrivant, conversion d'un objet en Object, récupération de méthodes + * à partir de leur nom, de constructeurs à partir de leurs paramètres... + * <p/> + * Created: 4 novembre 2004 + * + * @author bpoussin <poussin(a)codelutin.com> + * $Id$ + */ public class ObjectUtil { // ObjectUtil /** to use log facility, just put in your code: log.info(\"...\"); */ static private Log log = LogFactory.getLog(ObjectUtil.class); - protected static final Integer ZERO = 0; - protected static final Character ZEROC = (char)0; + protected static final Integer ZERO = 0; + protected static final Character ZEROC = (char)0; protected static final Float ZEROF = 0f; protected static final Long ZEROL = 0l; protected static final Double ZEROD = 0.; Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ReflectUtil.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ReflectUtil.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ReflectUtil.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -43,9 +43,14 @@ import static org.nuiton.i18n.I18n._; /** - * Des méthodes utiles d'introspection + * Introspection sur une classe. Détermine si un attribut est constant, + * recherche de constantes d'un type donné, conversion d'une classe en + * Enum... + * <p/> + * Created: 30 décembre 2007 * * @author tchemit <chemit(a)codelutin.com> + * $Id$ */ public class ReflectUtil { Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/Resource.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/Resource.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/Resource.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -66,7 +66,15 @@ * Cette class permet de rechercher un fichier en indiquant son nom avec son * chemin. Cette librairie ira ensuite chercher ce fichier sur le système de * fichier, et s'il n'est pas trouvé dans le classpath. Le fichier peut donc - * être dans un fichier .jar ou .zip. + * être dans un fichier .jar ou .zip. Exemple : + * <pre> + * URL image = Resource.getURL("/images/bidulle.png"); + * </pre> + * <p/> + * Created: 5 août 2003 + * + * @author bpoussin <poussin(a)codelutin.com> + * $Id$ */ public class Resource { // Resource Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/SortedProperties.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/SortedProperties.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/SortedProperties.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -32,9 +32,10 @@ import java.util.Vector; /** - * Permet d'avoir les fichiers de propriétés triés. + * Permet d'avoir les propriétés triées. * - * @author julien + * @author jruchaud <ruchaud(a)codelutin.com> + * $Id$ */ public class SortedProperties extends Properties { Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/StringUtil.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/StringUtil.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/StringUtil.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -54,9 +54,11 @@ * Classe contenant un ensemle de methode static utiles pour la manipulation des * chaine de caractere mais qui ne sont pas defini dans la classe String de * Java. + * <p/> + * Created: 21 octobre 2003 * - * @author poussin - * created 21 octobre 2003 + * @author bpoussin <poussin(a)codelutin.com> + * $Id$ */ public class StringUtil { public static final String[] EMPTY_STRING_ARRAY = new String[0]; // StringUtil Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ZipUtil.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ZipUtil.java 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ZipUtil.java 2011-04-16 10:56:44 UTC (rev 2111) @@ -47,15 +47,14 @@ import java.util.zip.ZipOutputStream; /** - * ZipUtil.java - * + * Opérations sur des fichiers Zip. Compression et décompression avec ou + * sans filtres, scan des fichiers créés ou écrasés lors de la décompression... + * <p/> * Created: 24 août 2006 10:13:35 * - * @author poussin - * @version $Revision$ - * - * Last update: $Date$ - * by : */ + * @author bpoussin <poussin(a)codelutin.com> + * $Id$ + */ public class ZipUtil { /** Class logger. */ Modified: trunk/nuiton-utils/src/site/apt/index.apt =================================================================== (Binary files differ) Deleted: trunk/nuiton-utils/src/site/apt/nuitonUtil.apt =================================================================== --- trunk/nuiton-utils/src/site/apt/nuitonUtil.apt 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/site/apt/nuitonUtil.apt 2011-04-16 10:56:44 UTC (rev 2111) @@ -1,302 +0,0 @@ - ---- - Documentation - ---- - ---- - 2009-08-23 - ---- - -~~~ -~~ #%L -~~ Nuiton Utils -~~ -~~ $Id$ -~~ $HeadURL$ -~~ %% -~~ Copyright (C) 2004 - 2010 CodeLutin -~~ %% -~~ This program is free software: you can redistribute it and/or modify -~~ it under the terms of the GNU Lesser General Public License as -~~ published by the Free Software Foundation, either version 3 of the -~~ License, or (at your option) any later version. -~~ -~~ This program is distributed in the hope that it will be useful, -~~ but WITHOUT ANY WARRANTY; without even the implied warranty of -~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -~~ GNU General Lesser Public License for more details. -~~ -~~ You should have received a copy of the GNU General Lesser Public -~~ License along with this program. If not, see -~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. -~~ #L% -~~~ - -Documentation - - NuitonUtils contient un ensemble de librairies trop petites pour avoir - leur propre projet. Elles sont aussi utile à la plupart des projets de - Code Lutin. - - -Resource - - Cette librairie permet de rechercher une ressource dans le maximum - d'endroit possible et si elle est trouvée l'url de la ressource est - retournée. - ------------------------------------------------------------------------------- - import org.nuiton.util.Resource; - import java.net.URL; - ... - URL image = Resource.getURL("/images/bidulle.png"); - ... ------------------------------------------------------------------------------- - - Dans cet exemple l'image est recherchée sur le système de fichier - local, si elle n'est pas trouvée, elle est recherché dans le - classpath, et si elle n'est toujours pas trouvée une exception est - alors levée. - -Log - - Cette objet permet de suivre ce que fait une application simplement. Le - développeur indique grâce à cette classe l'état dans lequel l'application est. - - Ensuite, il peut mettre des listeners sur cette classe qui afficheront - les messages qui ont été envoyés. Ou afficheront l'état d'une tâche en train - de s'exécuter. - - -Liste des librairies - - Cette liste répertorie l'ensemble des librairies de NuitonUtils. - - -* Configuration - - Gestion de la configuration d'une l'application, de l'internationalisation, - des numéros de versions, des ressources... - -** ApplicationConfig - - Gestion des fichiers de configuration, des variables d'environnement - et des arguments de la ligne de commande. - -** Resource - - Recherche d'un fichier dans le système de fichiers et dans le classpath - (.jar, .zip). - -** ClassLoaderUtil - - Récupération des urls d'un URLClassLoader. - -** LocaleConverter - - Conversion d'une chaîne en Locale. - -** SortedProperties - - Fichier de propriétés trié par ordre alphabétique. - -** RecursiveProperties - - Fichier de propriétés contenant des références à des propriétés de ce - même fichier. - -** Version - - Représentation d'un numéro de version pour une application. - -** VersionConverter - - Conversion d'une chaine en VersionNumber. - -** VersionUtil - - Manipulation de numéros de version sous forme de chaînes - (comparaison, incrémentation...). - - -* Fichiers - - Gestion de fichiers. - -** FileUtil - - Opérations sur des fichiers. Copie, suppression, renommage, - recherche, fichiers d'un répertoire, sous-répertoires d'un répertoire, - récupération du basename ou de l'extension, création d'un fichier - temporaire, comparaison de dates de création, récupération d'une chaîne, - d'un Reader ou d'un Writer à partir d'un fichier, récupération du fichier - saisi dans une boîte de dialogue, conversions en byte[], en Stream... - -** IOUtils - - Copie d'un fichier, chemin temporaire... - -** ZipUtil - - Opérations sur des fichiers Zip. Compression et décompression avec ou - sans filtres, scan des fichiers créés ou écrasés lors de la décompression... - -** ZipStreamEncoder - - Encodage de fichiers Zip dans des threads. - -* Collections - - Gestion de collections et de tableaux. - -** CollectionUtil - - Manipulation des collections. Ajout de plusieurs éléments à une - collection, conversion d'une collection non typée en collection typée. - -** ArrayUtil - - Opérations sur des tableaux. Concaténation, somme, recherche, - conversion d'une liste en tableau, d'un String[] en int[]. - -** BoundedList - - ArrayList avec un nombre d'élément minimum et maximum. - -** HashList - Liste d'objets uniques. - -** TransformedList - Liste d'objets transformables (interface Transformer). - - -* Chaînes de caractères - - Gestion des chaînes de caractères. - -** StringUtil - - Manipulation de chaînes de caractères. Découpage, suppression - d'accents, vérification de parenthésage, conversions vers un nombre, - un tableau, une couleur, une date... - -** URIConverter - - Conversion d'une chaîne en URI. - -** URLConverter - - Conversion d'une chaîne en URL. - -** GZUtil - - Compression et décompression de chaînes de caractères. - - -* Analyse - - Analyse du code et monitoring. - -** CallAnalyse - - Analyse sur des appels de méthodes. Temps d'éxecution, mémoire - utilisée et nombre d'appels. - -* Log - Mise en place de logs dans une application. - -** LoggingPatternFormatter - Formattage des logs. - - -* Énumérations - - Gestion des énumérations et énumérations utiles. - -** EnumConverter - - Conversion d'une chaîne en Enum. - -** EnumEditor - - Editeur d'Enum en Swing. - -** H2TypeEnum - - Énumération pour représenter les différents types d'implantation dans H2. - -** MonthEnum - - Énumération pour représenter les mois d'une année. - -** SimplePaginationEnum - - Énumération pour définir les tailles de liste. - -* Introspection - - Introspection et manipulations sur des objets et des classes. - -** ObjectUtil - - Outils pour manipuler des objets. Création d'un objet à partir d'une chaîne - le décrivant, conversion d'un objet en Object, récupération de méthodes - à partir de leur nom, de constructeurs à partir de leurs paramètres... - -** ReflectUtil - - Introspection sur une classe. Détermine si un attribut est constant, - recherche de constantes d'un type donné, conversion d'une classe en - Enum... - -** FormatConverter - - Conversion d'une représentation d'un objet à une autre représentation. - (Java, SQL, XML...). - - -* Divers - - Autres librairies utiles n'appartenant à aucune des catégories précédentes. - -** CardinalityHelper - - Méthodes pour tester des cardinalités. - -** ListenerSet - - Mise en place de listeners. - -** CategorisedListenerSet - - Gestion des catégories de listeners. - -** ConverterUtil - - Méthodes sur des converters. - -** DigestGenerator - - Fonctionnalités de Digest XML. - -** MD5 - - Implémentation des MD5 hash. - -** MD5InputStream - - MD5 dans un flux. - -** DateUtil //(since 1.1.2)// - - Boîte à outils sur les dates (plus spécialisé que org.apache.commons.lang.DateUils) - -** PeriodDates //(since 1.1.2)// - - Objet correspondant à une période entre deux dates avec contraintes et méthodes utilitaires. - -** FileUtil#grep() //(since 1.1.2)// - - Unix like grep command - -** FileUtil#sed() //(since 1.1.2)// - - Unix like sed command Modified: trunk/nuiton-utils/src/site/site_fr.xml =================================================================== --- trunk/nuiton-utils/src/site/site_fr.xml 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/nuiton-utils/src/site/site_fr.xml 2011-04-16 10:56:44 UTC (rev 2111) @@ -41,8 +41,7 @@ <menu name="Utilisateur"> <item name="Accueil" href="index.html"/> - <item name="Documentation" href="/nuitonUtil.html"/> - <item name="Application config" href="/ApplicationConfig.html"/> + <item name="ApplicationConfig" href="/ApplicationConfig.html"/> </menu> <menu name="Téléchargement"> Modified: trunk/src/site/apt/index.apt =================================================================== --- trunk/src/site/apt/index.apt 2011-04-16 10:33:38 UTC (rev 2110) +++ trunk/src/site/apt/index.apt 2011-04-16 10:56:44 UTC (rev 2111) @@ -40,7 +40,7 @@ les collections, les maps, les chaînes de caractères, ... De plus elle intègre un parser des arguments et des options pour les lignes de commande (ApplicationConfig). - Pour plus d'informations, voir la {{{./nuiton-utils}documentation}} + {{{./nuiton-utils}Plus d'infos}} Librairie Nuiton-profiling @@ -52,11 +52,11 @@ * temps total d'exécution d'une méthode (avec les sous-méthodes) * temps d'appel des sous-méthodes - Pour son utilisation, voir la {{{./nuiton-profiling}documentation}} + {{{./nuiton-profiling}Plus d'infos}} Librairie Nuiton-validator Cette librairie propose une Api de validation plus complète que la JSR-303, permettant nottament de préciser des scopes (info, erreur, warning, ...) - Pour son utilisation, voir la {{{./nuiton-validator}documentation}} + {{{./nuiton-validator}Plus d'infos}}

1 0

r2110 - in trunk: nuiton-utils/src/site/apt src/site/apt
by fdesbois＠users.nuiton.org April 16, 2011

April 16, 2011

Author: fdesbois Date: 2011-04-16 12:33:38 +0200 (Sat, 16 Apr 2011) New Revision: 2110 Url: http://nuiton.org/repositories/revision/nuiton-utils/2110 Log: Improve nuiton-utils documentation Modified: trunk/nuiton-utils/src/site/apt/index.apt trunk/src/site/apt/index.apt Modified: trunk/nuiton-utils/src/site/apt/index.apt =================================================================== (Binary files differ) Modified: trunk/src/site/apt/index.apt =================================================================== --- trunk/src/site/apt/index.apt 2011-04-13 16:24:44 UTC (rev 2109) +++ trunk/src/site/apt/index.apt 2011-04-16 10:33:38 UTC (rev 2110) @@ -38,24 +38,25 @@ Librairie regroupant les utilitaires classiques sur les fichiers, les tableaux, les collections, les maps, les chaînes de caractères, ... De plus elle intègre - un parser des arguments et des options pour les lignes de commande. + un parser des arguments et des options pour les lignes de commande (ApplicationConfig). -Librairie Nuiton-utils-extra + Pour plus d'informations, voir la {{{./nuiton-utils}documentation}} - TODO +Librairie Nuiton-profiling -Librairie Nuiton-validator + Cette librairie a pour but d'instrumenter un projet existant sans modification + des sources. Les fonctionnalités supportés sont : - TODO + * nombre d'appels aux méthodes + * temps min, max, moyen d'exécution d'une méthode (sans les sous-méthodes) + * temps total d'exécution d'une méthode (avec les sous-méthodes) + * temps d'appel des sous-méthodes -Librairie Nuiton-web + Pour son utilisation, voir la {{{./nuiton-profiling}documentation}} - TODO +Librairie Nuiton-validator -Librairie Nuiton-rss + Cette librairie propose une Api de validation plus complète que la JSR-303, + permettant nottament de préciser des scopes (info, erreur, warning, ...) - TODO - - - <Veuillez consulter la documentation de chaque sous projet pour de plus - amples détails sur les différentes librairies.> + Pour son utilisation, voir la {{{./nuiton-validator}documentation}}

1 0

r2109 - trunk/nuiton-utils/src/main/java/org/nuiton/util
by bpoussin＠users.nuiton.org April 13, 2011

April 13, 2011

Author: bpoussin Date: 2011-04-13 18:24:44 +0200 (Wed, 13 Apr 2011) New Revision: 2109 Url: http://nuiton.org/repositories/revision/nuiton-utils/2109 Log: - remise des generics qui servent sur loadDefaultOptions et loadActions (en faite Class<OptionDef> ne permet pas de passer une classe qui herite de OptionDef, on est donc condamn?\195?\169 a utiliser les generics pour ca) Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-13 14:42:23 UTC (rev 2108) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-13 16:24:44 UTC (rev 2109) @@ -430,8 +430,8 @@ * @param configFilename override default config filename, can be null * @param args command line argument can be empty */ - public ApplicationConfig( - Class<OptionDef> optionClass, Class<ActionDef> actionClass, + public <O extends OptionDef, A extends ActionDef> ApplicationConfig( + Class<O> optionClass, Class<A> actionClass, Properties defaults, String configFilename) { this(); if (optionClass != null) { @@ -479,7 +479,7 @@ * @param optionClass to load * @param <O> type of enum extend {@link OptionDef} */ - public void loadDefaultOptions(Class<OptionDef> optionClass) { + public <O extends OptionDef> void loadDefaultOptions(Class<O> optionClass) { // load default option (included configuration file name : important) for (OptionDef o : optionClass.getEnumConstants()) { @@ -495,10 +495,10 @@ * @param actionClass to load * @param <A> type of enum extend {@link ActionDef} */ - public void loadActions(Class<ActionDef> actionClass) { + public <A extends ActionDef> void loadActions(Class<A> actionClass) { // load actions - for (ActionDef a : actionClass.getEnumConstants()) { + for (A a : actionClass.getEnumConstants()) { for (String alias : a.getAliases()) { addActionAlias(alias, a.getAction()); }

1 0

r2108 - trunk/nuiton-utils/src/main/java/org/nuiton/util
by bpoussin＠users.nuiton.org April 13, 2011

April 13, 2011

Author: bpoussin Date: 2011-04-13 16:42:23 +0200 (Wed, 13 Apr 2011) New Revision: 2108 Url: http://nuiton.org/repositories/revision/nuiton-utils/2108 Log: - refactoring du code (deplacement des declarations de classe a la fin, pour tomber des le debut sur ApplicationConfig et pas autre chose) - suppression des generics qui ne servent a rien sur loadDefaultOptions et loadActions - parse retourne this pour permettre ApplicationConfig conf = new ApplicationConfig().parse(args); - quelques methodes protected rendu public (installSaveUserAction, loadDefaultOptions, loadActions, setDefaultOption) - ajout d'un contructeur qui prend tout un tas arguments pour permettre la configuration de la config a la construction Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-11 12:49:16 UTC (rev 2107) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-13 14:42:23 UTC (rev 2108) @@ -384,323 +384,6 @@ protected PropertyChangeSupport pcs = new PropertyChangeSupport(this); /** - * Load default options of enum pass in param (enum must extend {@link OptionDef}) - * - * @param optionClass to load - * @param <O> type of enum extend {@link OptionDef} - */ - protected <O extends OptionDef> void loadDefaultOptions(Class<O> optionClass) { - - // load default option (included configuration file name : important) - for (O o : optionClass.getEnumConstants()) { - if (o.getDefaultValue() != null) { - setDefaultOption(o.getKey(), o.getDefaultValue()); - } - } - } - - /** - * Load actions of enum pass in param (enum must extend {@link ActionDef}) - * - * @param actionClass to load - * @param <A> type of enum extend {@link ActionDef} - */ - protected <A extends ActionDef> void loadActions(Class<A> actionClass) { - - // load actions - for (A a : actionClass.getEnumConstants()) { - for (String alias : a.getAliases()) { - addActionAlias(alias, a.getAction()); - } - } - } - - /** - * Action to save user configuration. - * <p/> - * Add it as a listener of the configuration for a given property. - * - * <b>Note:</b> Will not save if {@link #isAdjusting()} is {@code true}. - * - * @since 1.3 - */ - private final PropertyChangeListener saveUserAction = - new PropertyChangeListener() { - - @Override - public void propertyChange(PropertyChangeEvent evt) { - if (isAdjusting()) { - if (log.isDebugEnabled()) { - log.debug("Skip save while adjusting"); - } - return; - } - if (log.isDebugEnabled()) { - log.debug("Saving configuration fired by property [" + - evt.getPropertyName() + "] at " + - new java.util.Date()); - } - saveForUser(); - } - }; - - /** - * Le contrat de marquage des options, on utilise cette interface pour - * caracteriser une option de configuration. - * - * @since 1.0.0-rc-9 - */ - public interface OptionDef extends Serializable { - - /** - * @return la clef identifiant l'option - */ - String getKey(); - - /** - * @return le type de l'option - */ - Class<?> getType(); - - /** - * @return la clef i18n de description de l'option - */ - String getDescription(); - - /** - * @return la valeur par defaut de l'option sous forme de chaine de - * caracteres - */ - String getDefaultValue(); - - /** - * @return <code>true</code> si l'option ne peut etre sauvegardee sur - * disque (utile par exemple pour les mots de passe, ...) - */ - boolean isTransient(); - - /** - * @return <code>true</code> si l'option n'est pas modifiable (utilise - * par exemple pour la version de l'application, ...) - */ - boolean isFinal(); - - /** - * Changes the default value of the option. - * - * @param defaultValue the new default value of the option - */ - void setDefaultValue(String defaultValue); - - /** - * Changes the transient state of the option. - * - * @param isTransient the new value of the transient state - */ - void setTransient(boolean isTransient); - - /** - * Changes the final state of the option. - * - * @param isFinal the new transient state value - */ - void setFinal(boolean isFinal); - } - - /** - * Le contrat de marquage des action, on utilise cette interface pour - * caracteriser une action. - * - * @author sletellier - * @since 1.5.2 - */ - public interface ActionDef extends Serializable { - - /** - * @return action to run - */ - String getAction(); - - /** - * @return aliases used to execute action - */ - String[] getAliases(); - } - - /** - * Defines a runtime action to be launched via the {@link #doAction()} - * method. - * - * @author poussin - */ - static public class Action { - - @Retention(RetentionPolicy.RUNTIME) - @Target(ElementType.METHOD) - public @interface Step { - - int value() default 0; - } - protected int step; - protected Object o; - protected Method m; - protected String[] params; - - public Action(int step, Object o, Method m, String... params) { - this.step = step; - this.o = o; - this.m = m; - this.params = params; - } - - public void doAction() throws IllegalAccessException, - IllegalArgumentException, - InvocationTargetException, - InstantiationException { - ObjectUtil.call(o, m, params); - } - } - - /** - * Item used for cacheOption - * - * @param <T> - */ - static protected class CacheItem<T> { - - /** typed option value */ - public T item; - /** hash of string representation */ - public int hash; - - public CacheItem(T item, int hash) { - this.item = item; - this.hash = hash; - } - } - - static public class OptionList { - - protected ApplicationConfig config; - protected String key; - protected String value; - - public OptionList(ApplicationConfig config, String key, String value) { - this.config = config; - this.key = key; - this.value = value; - } - - protected <T> List<T> convertListOption(Class<T> type) { - List<T> result= (List<T>) config.convertOption(type, key, value, true); - return result; - } - /** - * Get option value as {@link String}. - * - * @return value as String - */ - public List<String> getOption() { - List<String> result = convertListOption(String.class); - return result; - } - - /** - * Get option value as {@link File}. - * - * @return value as file - */ - public List<File> getOptionAsFile() { - List<File> tmp = convertListOption(File.class); - List<File> result = new ArrayList<File>(tmp.size()); - for (File file : tmp) { - result.add(file.getAbsoluteFile()); - } - return result; - } - - /** - * Get option value as {@link URL}. - * - * @return value as URL - */ - public List<URL> getOptionAsURL() { - List<URL> result = convertListOption(URL.class); - return result; - } - - /** - * Get option value as {@link Class}. - * - * @return value as Class - */ - public List<Class> getOptionAsClass() { - List<Class> result = convertListOption(Class.class); - return result; - } - - /** - * Get option value as {@link Date}. - * - * @return value as Date - */ - public List<Date> getOptionAsDate() { - List<Date> result = convertListOption(Date.class); - return result; - } - - /** - * Get option value as {@link Time}. - * - * @return value as Time - */ - public List<Time> getOptionAsTime() { - List<Time> result = convertListOption(Time.class); - return result; - } - - /** - * Get option value as {@link Timestamp}. - * - * @return value as Timestamp - */ - public List<Timestamp> getOptionAsTimestamp() { - List<Timestamp> result = convertListOption(Timestamp.class); - return result; - } - - /** - * Get option value as {@code int}. - * - * @return value as {@code int} - */ - public List<Integer> getOptionAsInt() { - List<Integer> result = convertListOption(Integer.class); - return result; - } - - /** - * Get option value as {@code double}. - * - * @return value as {@code double} - */ - public List<Double> getOptionAsDouble() { - List<Double> result = convertListOption(Double.class); - return result; - } - - /** - * Get option value as {@code boolean}. - * - * @return value as {@code boolean}. - */ - public List<Boolean> getOptionAsBoolean() { - List<Boolean> result = convertListOption(Boolean.class); - return result; - } - } - - /** * Init ApplicationConfig with current simple class name as config file. * * Also init converters. @@ -717,15 +400,12 @@ } /** - * Create WikittyConfig and load particular configuration filename, parse - * method is automaticaly called + * Create WikittyConfig and load particular configuration filename * - * @param configFilename name of wikitty config file - * @throws ArgumentsParserException + * @param configFilename name of config to use */ public ApplicationConfig(String configFilename) throws ArgumentsParserException { - this(); - parse("--option", CONFIG_FILE_NAME, configFilename); + this(null, null, null, configFilename); } /** @@ -737,12 +417,42 @@ * @see ConverterUtil#initConverters() */ public ApplicationConfig(Properties defaults) { + this(null, null, defaults, null); + } + + /** + * All in one, this constructor allow to pass all necessary argument to + * initialise ApplicationConfig and parse command line + * + * @param optionClass class that describe option, can be null + * @param actionClass class that describe action, can be null + * @param defaults properties that override default value of optionClass, can be null + * @param configFilename override default config filename, can be null + * @param args command line argument can be empty + */ + public ApplicationConfig( + Class<OptionDef> optionClass, Class<ActionDef> actionClass, + Properties defaults, String configFilename) { this(); - // iterate with Properties method and not with Hashtable method to - // prevent missed value with chained Properties object - for (String key : defaults.stringPropertyNames()) { - setDefaultOption(key, defaults.getProperty(key)); + if (optionClass != null) { + loadDefaultOptions(optionClass); } + if (actionClass != null) { + loadActions(actionClass); + } + + if (defaults != null) { + // iterate with Properties method and not with Hashtable method to + // prevent missed value with chained Properties object + for (String key : defaults.stringPropertyNames()) { + setDefaultOption(key, defaults.getProperty(key)); + } + } + + if (configFilename != null) { + setDefaultOption(CONFIG_FILE_NAME, configFilename); + } + } /** @@ -764,13 +474,45 @@ } /** + * Load default options of enum pass in param (enum must extend {@link OptionDef}) + * + * @param optionClass to load + * @param <O> type of enum extend {@link OptionDef} + */ + public void loadDefaultOptions(Class<OptionDef> optionClass) { + + // load default option (included configuration file name : important) + for (OptionDef o : optionClass.getEnumConstants()) { + if (o.getDefaultValue() != null) { + setDefaultOption(o.getKey(), o.getDefaultValue()); + } + } + } + + /** + * Load actions of enum pass in param (enum must extend {@link ActionDef}) + * + * @param actionClass to load + * @param <A> type of enum extend {@link ActionDef} + */ + public void loadActions(Class<ActionDef> actionClass) { + + // load actions + for (ActionDef a : actionClass.getEnumConstants()) { + for (String alias : a.getAliases()) { + addActionAlias(alias, a.getAction()); + } + } + } + + /** * Used to put default configuration option in config option. Those options * are used as fallback value. * * @param key default property key * @param value default property value */ - protected void setDefaultOption(String key, String value) { + public void setDefaultOption(String key, String value) { defaults.setProperty(key, value); } @@ -1754,7 +1496,7 @@ * @param args argument as main(String[] args) * @throws ArgumentsParserException if parsing failed */ - public void parse(String... args) throws ArgumentsParserException { + public ApplicationConfig parse(String... args) throws ArgumentsParserException { if (args == null) { args = ArrayUtil.EMPTY_STRING_ARRAY; } @@ -1941,6 +1683,7 @@ } throw new ArgumentsParserException("Can't parse argument", eee); } + return this; } /** @@ -2053,4 +1796,298 @@ public PropertyChangeListener[] getPropertyChangeListeners() { return pcs.getPropertyChangeListeners(); } + + + /////////////////////////////////////////////////////////////////////////// + // + // C L A S S E S D E C L A R A T I O N + // + /////////////////////////////////////////////////////////////////////////// + + + /** + * Action to save user configuration. + * <p/> + * Add it as a listener of the configuration for a given property. + * + * <b>Note:</b> Will not save if {@link #isAdjusting()} is {@code true}. + * + * @since 1.3 + */ + private final PropertyChangeListener saveUserAction = + new PropertyChangeListener() { + + @Override + public void propertyChange(PropertyChangeEvent evt) { + if (isAdjusting()) { + if (log.isDebugEnabled()) { + log.debug("Skip save while adjusting"); + } + return; + } + if (log.isDebugEnabled()) { + log.debug("Saving configuration fired by property [" + + evt.getPropertyName() + "] at " + + new java.util.Date()); + } + saveForUser(); + } + }; + + /** + * Le contrat de marquage des options, on utilise cette interface pour + * caracteriser une option de configuration. + * + * @since 1.0.0-rc-9 + */ + public interface OptionDef extends Serializable { + + /** + * @return la clef identifiant l'option + */ + String getKey(); + + /** + * @return le type de l'option + */ + Class<?> getType(); + + /** + * @return la clef i18n de description de l'option + */ + String getDescription(); + + /** + * @return la valeur par defaut de l'option sous forme de chaine de + * caracteres + */ + String getDefaultValue(); + + /** + * @return <code>true</code> si l'option ne peut etre sauvegardee sur + * disque (utile par exemple pour les mots de passe, ...) + */ + boolean isTransient(); + + /** + * @return <code>true</code> si l'option n'est pas modifiable (utilise + * par exemple pour la version de l'application, ...) + */ + boolean isFinal(); + + /** + * Changes the default value of the option. + * + * @param defaultValue the new default value of the option + */ + void setDefaultValue(String defaultValue); + + /** + * Changes the transient state of the option. + * + * @param isTransient the new value of the transient state + */ + void setTransient(boolean isTransient); + + /** + * Changes the final state of the option. + * + * @param isFinal the new transient state value + */ + void setFinal(boolean isFinal); + } + + /** + * Le contrat de marquage des action, on utilise cette interface pour + * caracteriser une action. + * + * @author sletellier + * @since 1.5.2 + */ + public interface ActionDef extends Serializable { + + /** + * @return action to run + */ + String getAction(); + + /** + * @return aliases used to execute action + */ + String[] getAliases(); + } + + /** + * Defines a runtime action to be launched via the {@link #doAction()} + * method. + * + * @author poussin + */ + static public class Action { + + @Retention(RetentionPolicy.RUNTIME) + @Target(ElementType.METHOD) + public @interface Step { + + int value() default 0; + } + protected int step; + protected Object o; + protected Method m; + protected String[] params; + + public Action(int step, Object o, Method m, String... params) { + this.step = step; + this.o = o; + this.m = m; + this.params = params; + } + + public void doAction() throws IllegalAccessException, + IllegalArgumentException, + InvocationTargetException, + InstantiationException { + ObjectUtil.call(o, m, params); + } + } + + /** + * Item used for cacheOption + * + * @param <T> + */ + static protected class CacheItem<T> { + + /** typed option value */ + public T item; + /** hash of string representation */ + public int hash; + + public CacheItem(T item, int hash) { + this.item = item; + this.hash = hash; + } + } + + static public class OptionList { + + protected ApplicationConfig config; + protected String key; + protected String value; + + public OptionList(ApplicationConfig config, String key, String value) { + this.config = config; + this.key = key; + this.value = value; + } + + protected <T> List<T> convertListOption(Class<T> type) { + List<T> result= (List<T>) config.convertOption(type, key, value, true); + return result; + } + /** + * Get option value as {@link String}. + * + * @return value as String + */ + public List<String> getOption() { + List<String> result = convertListOption(String.class); + return result; + } + + /** + * Get option value as {@link File}. + * + * @return value as file + */ + public List<File> getOptionAsFile() { + List<File> tmp = convertListOption(File.class); + List<File> result = new ArrayList<File>(tmp.size()); + for (File file : tmp) { + result.add(file.getAbsoluteFile()); + } + return result; + } + + /** + * Get option value as {@link URL}. + * + * @return value as URL + */ + public List<URL> getOptionAsURL() { + List<URL> result = convertListOption(URL.class); + return result; + } + + /** + * Get option value as {@link Class}. + * + * @return value as Class + */ + public List<Class> getOptionAsClass() { + List<Class> result = convertListOption(Class.class); + return result; + } + + /** + * Get option value as {@link Date}. + * + * @return value as Date + */ + public List<Date> getOptionAsDate() { + List<Date> result = convertListOption(Date.class); + return result; + } + + /** + * Get option value as {@link Time}. + * + * @return value as Time + */ + public List<Time> getOptionAsTime() { + List<Time> result = convertListOption(Time.class); + return result; + } + + /** + * Get option value as {@link Timestamp}. + * + * @return value as Timestamp + */ + public List<Timestamp> getOptionAsTimestamp() { + List<Timestamp> result = convertListOption(Timestamp.class); + return result; + } + + /** + * Get option value as {@code int}. + * + * @return value as {@code int} + */ + public List<Integer> getOptionAsInt() { + List<Integer> result = convertListOption(Integer.class); + return result; + } + + /** + * Get option value as {@code double}. + * + * @return value as {@code double} + */ + public List<Double> getOptionAsDouble() { + List<Double> result = convertListOption(Double.class); + return result; + } + + /** + * Get option value as {@code boolean}. + * + * @return value as {@code boolean}. + */ + public List<Boolean> getOptionAsBoolean() { + List<Boolean> result = convertListOption(Boolean.class); + return result; + } + } + }

1 0

r2107 - trunk/nuiton-utils/src/main/java/org/nuiton/util
by bpoussin＠users.nuiton.org April 11, 2011

April 11, 2011

Author: bpoussin Date: 2011-04-11 14:49:16 +0200 (Mon, 11 Apr 2011) New Revision: 2107 Url: http://nuiton.org/repositories/revision/nuiton-utils/2107 Log: modify getOptionAsProperties javadoc Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java Modified: trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java =================================================================== --- trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-11 09:40:42 UTC (rev 2106) +++ trunk/nuiton-utils/src/main/java/org/nuiton/util/ApplicationConfig.java 2011-04-11 12:49:16 UTC (rev 2107) @@ -1368,10 +1368,13 @@ } /** - * Get option value as {@link Properties}. + * Get option value as {@link Properties}, this property must be a filepath + * and file must be a properties. + * + * Returned Properties is {@link RecursiveProperties}. * * @param key the option's key - * @return value as properties + * @return Properties object loaded with value pointed by file * @throws java.io.IOException if exception occured on read file */ public Properties getOptionAsProperties(String key) throws IOException {

1 0

r2106 - in trunk: . nuiton-profiling nuiton-utils nuiton-validator
by hudson＠users.nuiton.org April 11, 2011

April 11, 2011

Author: hudson Date: 2011-04-11 11:40:42 +0200 (Mon, 11 Apr 2011) New Revision: 2106 Url: http://nuiton.org/repositories/revision/nuiton-utils/2106 Log: [maven-release-plugin] prepare for next development iteration Modified: trunk/nuiton-profiling/pom.xml trunk/nuiton-utils/pom.xml trunk/nuiton-validator/pom.xml trunk/pom.xml Modified: trunk/nuiton-profiling/pom.xml =================================================================== --- trunk/nuiton-profiling/pom.xml 2011-04-11 09:40:40 UTC (rev 2105) +++ trunk/nuiton-profiling/pom.xml 2011-04-11 09:40:42 UTC (rev 2106) @@ -33,7 +33,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>nuiton-utils-parent</artifactId> - <version>2.1.1</version> + <version>2.2-SNAPSHOT</version> </parent> <artifactId>nuiton-profiling</artifactId> Modified: trunk/nuiton-utils/pom.xml =================================================================== --- trunk/nuiton-utils/pom.xml 2011-04-11 09:40:40 UTC (rev 2105) +++ trunk/nuiton-utils/pom.xml 2011-04-11 09:40:42 UTC (rev 2106) @@ -33,7 +33,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>nuiton-utils-parent</artifactId> - <version>2.1.1</version> + <version>2.2-SNAPSHOT</version> </parent> <artifactId>nuiton-utils</artifactId> Modified: trunk/nuiton-validator/pom.xml =================================================================== --- trunk/nuiton-validator/pom.xml 2011-04-11 09:40:40 UTC (rev 2105) +++ trunk/nuiton-validator/pom.xml 2011-04-11 09:40:42 UTC (rev 2106) @@ -33,7 +33,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>nuiton-utils-parent</artifactId> - <version>2.1.1</version> + <version>2.2-SNAPSHOT</version> </parent> <artifactId>nuiton-validator</artifactId> Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2011-04-11 09:40:40 UTC (rev 2105) +++ trunk/pom.xml 2011-04-11 09:40:42 UTC (rev 2106) @@ -37,7 +37,7 @@ </parent> <artifactId>nuiton-utils-parent</artifactId> - <version>2.1.1</version> + <version>2.2-SNAPSHOT</version> <modules> <module>nuiton-utils</module> @@ -217,12 +217,12 @@  <scm> <connection> - scm:svn:http://svn.nuiton.org/svn/nuiton-utils/tags/nuiton-utils-2.1.1 + scm:svn:http://svn.nuiton.org/svn/nuiton-utils/trunk </connection> <developerConnection> - scm:svn:http://svn.nuiton.org/svn/nuiton-utils/tags/nuiton-utils-2.1.1 + scm:svn:http://svn.nuiton.org/svn/nuiton-utils/trunk </developerConnection> - <url>http://www.nuiton.org/repositories/browse/nuiton-utils/tags/nuiton-utils-2.…</url> + <url>http://www.nuiton.org/repositories/browse/nuiton-utils/trunk</url> </scm> </project>

1 0