This is an automated email from the git hooks/post-receive script. New commit to branch develop in repository nuiton-config. See https://gitlab.nuiton.org/nuiton/nuiton-config.git commit 592db202be51ba08bd5e7d42839aa950c29e3377 Author: Tony CHEMIT <chemit@codelutin.com> Date: Fri Oct 7 12:04:28 2016 +0200 Separate io operations from ApplicationConfig --- .../java/org/nuiton/config/ApplicationConfig.java | 108 ++++++++++++--------- .../org/nuiton/config/ApplicationConfigInit.java | 15 +++ .../org/nuiton/config/io/ApplicationConfigIO.java | 21 ++++ .../config/io/ApplicationConfigReadFormat.java | 9 ++ .../ApplicationConfigReadPropertiesException.java | 17 ++++ .../ApplicationConfigWritePropertiesException.java | 17 ++++ .../org/nuiton/config/io/ApplicationIOHelper.java | 49 ++++++++++ 7 files changed, 188 insertions(+), 48 deletions(-) diff --git a/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfig.java b/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfig.java index 0974377..2431f10 100644 --- a/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfig.java +++ b/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfig.java @@ -22,6 +22,7 @@ package org.nuiton.config; * #L% */ +import com.google.common.base.Preconditions; import org.apache.commons.beanutils.ConstructorUtils; import org.apache.commons.collections4.EnumerationUtils; import org.apache.commons.io.FileUtils; @@ -29,6 +30,7 @@ import org.apache.commons.lang3.ArrayUtils; import org.apache.commons.lang3.StringUtils; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; +import org.nuiton.config.io.ApplicationIOHelper; import org.nuiton.converter.ConverterUtil; import org.nuiton.util.ObjectUtil; import org.nuiton.util.RecursiveProperties; @@ -41,11 +43,8 @@ import java.beans.PropertyChangeEvent; import java.beans.PropertyChangeListener; import java.beans.PropertyChangeSupport; import java.io.File; -import java.io.FileOutputStream; import java.io.FileReader; import java.io.IOException; -import java.io.InputStreamReader; -import java.io.OutputStreamWriter; import java.io.PrintStream; import java.io.Reader; import java.io.Writer; @@ -80,15 +79,15 @@ import java.util.Set; * Application configuration. * <h3>A finir...</h3> * <ul> - * <li>Ajout d'annotations sur les methodes + * <li>Ajout d'annotations sur les méthodes * pour preciser plus de chose pour les options (pattern, min/max, alias, * description, ...) * <li>Trouver un moyen de document les options et actions pour automatiquement - * generer l'aide en ligne. Pour eviter de devoir maintenir une methode - * dans lequel est ecrit l'aide en plus des options. + * generer l'aide en ligne. Pour eviter de devoir maintenir une méthode + * dans lequel est écrit l'aide en plus des options. * <li>Prise en compte du flag {@link #useOnlyAliases} - * <li>Vu qu'en java on ne peut pas pointer une methode mais seulement une classe - * il y a un bout des actions qui sont des chaines (nom de la methode). Il faudrait + * <li>Vu qu'en java on ne peut pas pointer une méthode mais seulement une classe + * il y a un bout des actions qui sont des chaînes (nom de la méthode). 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)} @@ -125,24 +124,24 @@ import java.util.Set; * </ul> * <h3>Lecture des fichiers de configuration</h3> * <p> - * La lecture des fichiers de configuration se fait durant l'appel de la methode + * La lecture des fichiers de configuration se fait durant l'appel de la méthode * {@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) * </p> * <h3>La sauvegarde</h3> - * La sauvegarde des options se fait via une des trois methodes disponibles : + * La sauvegarde des options se fait via une des trois méthodes disponibles : * <ul> * <li> {@link #save(File, boolean, String...)} sauve les données dans le fichier demandé - * <li> {@link #saveForSystem(String...)} sauvegarde les donnees dans /etc - * <li> {@link #saveForUser(String...)} sauvegarde les donnees dans $HOME + * <li> {@link #saveForSystem(String...)} sauvegarde les données dans /etc + * <li> {@link #saveForUser(String...)} sauvegarde les données dans $HOME * </ul> * <p> * 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. + * options passees sur la ligne de commande ne seront pas sauvées. * </p> * <h3>Les options de configuration</h3> * <p> @@ -151,7 +150,7 @@ import java.util.Set; * en compte des informations trouvées est le suivant (le premier le plus * important) : * <ul> - * <li>options ajoutees par programmation: {@link #setOption(String, String)}</li> + * <li>options ajoutées par programmation: {@link #setOption(String, String)}</li> * <li>ligne de commande</li> * <li>variable d'environnement de la JVM: java -Dkey=value</li> * <li>variable d'environnement; export key=value</li> @@ -159,7 +158,7 @@ import java.util.Set; * <li>fichier de configuration du repertoire home de l'utilisateur: $user.home/.filename</li> * <li>fichier de configuration du repertoire /etc: /etc/filename</li> * <li>fichier de configuration trouve dans le classpath: $CLASSPATH/filename</li> - * <li>options ajoutees par programmation: {@link #setDefaultOption(String, String)}</li> + * <li>options ajoutées par programmation: {@link #setDefaultOption(String, String)}</li> * </ul> * <p> * Les options sur la ligne de commande sont de la forme: @@ -170,8 +169,8 @@ import java.util.Set; * <ul> * <li>--option key value: est la syntaxe par defaut * <li>--monOption key value1 value2: est la syntaxe si vous avez ajouter une - * methode setMonOption(key, value1, value2) sur votre classe de configuration - * qui herite de {@link ApplicationConfig}. Dans ce cas vous pouvez mettre les + * méthode setMonOption(key, value1, value2) sur votre classe de configuration + * qui hérite de {@link ApplicationConfig}. Dans ce cas vous pouvez mettre les * arguments que vous souhaitez du moment qu'ils soient convertibles de la * representation String vers le type que vous avez mis. * </ul> @@ -183,35 +182,35 @@ import java.util.Set; * --le.package.LaClass#laMethode arg1 arg2 arg3 ... argN * </pre> * <p> - * Une action est donc defini par le chemin complet vers la methode qui traitera - * l'action. Cette methode peut-etre une methode static ou non. Si la methode + * Une action est donc défini par le chemin complet vers la méthode qui traitera + * l'action. Cette méthode peut-être une méthode static ou non. Si la méthode * n'est pas static lors de l'instanciation de l'objet on essaie de passer en - * parametre du constructeur la classe de configuration utilisee pour permettre + * paramètre du constructeur la classe de configuration utilisée pour permettre * a l'action d'avoir a sa disposition les options de configuration. Si aucun - * constructeur avec comme seul parametre une classe heritant de - * {@link ApplicationConfig} n'existe alors le constructeur par defaut est - * utilise (il doit etre accessible). Toutes methodes d'actions faisant + * constructeur avec comme seul paramètre une classe héritant de + * {@link ApplicationConfig} n'existe alors le constructeur par défaut est + * utilise (il doit être accessible). Toutes methodes d'actions faisant * parties d'un meme objet utiliseront la meme instance de cette objet lors * de leur execution. * </p> * <p> - * Si la methode utilise les arguments variants alors tous les arguments + * Si la méthode utilise les arguments variants alors tous les arguments * jusqu'au prochain -- ou la fin de la ligne de commande sont utilises. Sinon - * Le nombre exact d'argument necessaire a la methode sont utilises. + * Le nombre exact d'argument nécessaire a la méthode sont utilises. * </p> * <p> - * Les arguments sont automatiquement converti dans le bon type reclame par la + * Les arguments sont automatiquement converti dans le bon type réclamé par la * methode. * </p> * <p> * Si l'on veut des arguments optionnels le seul moyen actuellement est - * d'utiliser une methode avec des arguments variants + * d'utiliser une méthode avec des arguments variants * </p> * <p> - * Les actions ne sont pas execute mais seulement parsees. Pour les executer - * il faut utiliser la méthode {@link #doAction(int)} qui prend en argument un numero + * Les actions ne sont pas execute mais seulement parsées. Pour les exécuter + * il faut utiliser la méthode {@link #doAction(int)} qui prend en argument un numéro * de 'step' ou {@link #doAllAction()} qui fait les actions dans l'ordre de leur step. - * Par defaut toutes les actions sont de niveau 0 et sont executee + * Par défaut toutes les actions sont de niveau 0 et sont exécutées * dans l'ordre d'apparition sur la ligne de commande. Si l'on souhaite * distinguer les actions il est possible d'utiliser l'annotation * {@link ApplicationConfig.Action.Step} sur la methode qui fera l'action en @@ -227,7 +226,7 @@ import java.util.Set; * </p> * <h3>Les arguments non parsées</h3> * <p> - * Tout ce qui n'est pas option ou action est considere comme non parse et peut + * Tout ce qui n'est pas option ou action est considèré comme non parse et peut * etre recupere par la methode {@link #getUnparsed}. Si l'on souhaite forcer * la fin du parsing de la ligne de commande il est possible de mettre --. * Par exemple: @@ -235,16 +234,16 @@ import java.util.Set; * monProg "mon arg" --option k1 v1 -- --option k2 v2 -- autre * </pre> * <p> - * Dans cet exemple seule la premiere option sera considere comme une option. + * Dans cet exemple seule la premiere option sera considère comme une option. * On retrouvera dans {@code unparsed}: "mon arg", "--option", "k2", "v2", "--", * "autre" * </p> * <h3>Les alias</h3> * <p> * 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 + * méthode doit être utilise. Pour éviter ceci il est possible de définir * des alias ce qui permet de creer des options courtes par exemple. Pour cela, - * on utilise la methode {@link #addAlias(String, String...)}. + * on utilise la méthode {@link #addAlias(String, String...)}. * <pre> * addAlias("-v", "--option", "verbose", "true"); * addAlias("-o", "--option", "outputfile"); @@ -252,16 +251,16 @@ import java.util.Set; * </pre> * En faite avant le parsing de la ligne de commande tous les alias trouves sont * automatiquement remplacer par leur correspondance. Il est donc possible - * d'utiliser ce mecanisme pour autre chose par exemple: + * d'utiliser ce mécanisme pour autre chose par exemple: * <pre> * addAlias("cl", "Code Lutin"); * addAlias("bp", "Benjamin POUSSIN); * </pre> * <p>Dans le premier exemple on simplifie une option de flags l'option -v n'attend * donc plus d'argument. Dans le second exemple on simplifie une option qui - * attend encore un argment de type File. Enfin dans le troisieme exemple + * attend encore un argument de type File. Enfin dans le troisième exemple * on simplifie la syntaxe d'une action et on force le premier argument de - * l'action a etre "import". + * l'action a être "import". * </p> * <h3>Conversion de type</h3> * <p> @@ -279,12 +278,12 @@ import java.util.Set; * etre separe par une virgule. * </ul> * <p> - * Pour suporter d'autre type, il vous suffit d'enregistrer de nouveau + * Pour supporter d'autre type, il vous suffit d'enregistrer de nouveau * converter dans commons-beans. * </p> * <h3>Les substitutions de variable</h3> * <p> - * {@link ApplicationConfig} supporte les substition de variables de la forme + * {@link ApplicationConfig} supporte les substituions de variables de la forme * <tt>${xxx}</tt> où {@code xxx} est une autre variable de la configuration. * </p> * <p> @@ -415,6 +414,12 @@ public class ApplicationConfig { protected Map<String, Object> context = new HashMap<>(); /** + * Pour gérer la lecture/écriture des properties. + * @since 3.1 + */ + protected ApplicationIOHelper applicationIOHelper; + + /** * Init ApplicationConfig with current simple class name as config file. * <p> * Also init converters. @@ -456,9 +461,9 @@ public class ApplicationConfig { * @since 2.4.8 */ public ApplicationConfig(Properties defaults, String configFilename) { - this(ApplicationConfigInit.forAllScopes() - .setConfigFileName(configFilename) - .setDefaults(defaults)); + this(ApplicationConfigInit.defaultInit() + .setConfigFileName(configFilename) + .setDefaults(defaults)); } /** @@ -479,6 +484,10 @@ public class ApplicationConfig { */ protected void init(ApplicationConfigInit init) { + Preconditions.checkNotNull(init,"Can't init ApplicationConfig without an init paramter"); + Preconditions.checkNotNull(init.getReadFormat(), "Can't init Application without an init.readFormat parameter"); + applicationIOHelper = new ApplicationIOHelper(init.getReadFormat()); + Set<ApplicationConfigScope> scopes = init.getScopes(); Properties lastProperties = null; @@ -2297,9 +2306,11 @@ public class ApplicationConfig { * @since 2.3 */ protected void loadResource(URI uri, Properties properties) throws IOException { - try (InputStreamReader reader = new InputStreamReader(uri.toURL().openStream(), getEncoding())) { - properties.load(reader); - } + Properties readProperties = applicationIOHelper.readProperties(uri.toURL(), getEncoding()); + properties.putAll(readProperties); +// try (InputStreamReader reader = new InputStreamReader(uri.toURL().openStream(), getEncoding())) { +// properties.load(reader); +// } } /** @@ -2314,9 +2325,10 @@ public class ApplicationConfig { * @since 2.3 */ protected void saveResource(File file, Properties properties, String comment) throws IOException { - try (Writer reader = new OutputStreamWriter(new FileOutputStream(file), getEncoding())) { - properties.store(reader, comment); - } + applicationIOHelper.writeProperties(properties, file, getEncoding(), comment); +// try (Writer reader = new OutputStreamWriter(new FileOutputStream(file), getEncoding())) { +// properties.store(reader, comment); +// } } /** diff --git a/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfigInit.java b/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfigInit.java index cc99d9a..7a627f2 100644 --- a/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfigInit.java +++ b/nuiton-config/src/main/java/org/nuiton/config/ApplicationConfigInit.java @@ -22,6 +22,8 @@ package org.nuiton.config; * #L% */ +import org.nuiton.config.io.ApplicationConfigReadFormat; + import java.util.Arrays; import java.util.Collections; import java.util.EnumSet; @@ -37,6 +39,10 @@ import java.util.Set; */ public class ApplicationConfigInit { + public static ApplicationConfigInit defaultInit() { + return forAllScopes().setReadFormat(ApplicationConfigReadFormat.properties); + } + public static ApplicationConfigInit forAllScopes() { return new ApplicationConfigInit(ApplicationConfigScope.values()); } @@ -56,6 +62,7 @@ public class ApplicationConfigInit { protected String configFilename; protected Properties defaults; protected final Set<ApplicationConfigScope> scopes ; + protected ApplicationConfigReadFormat readFormat; protected ApplicationConfigInit(ApplicationConfigScope...scopes) { this.scopes = Collections.unmodifiableSet(EnumSet.copyOf(Arrays.asList(scopes))); @@ -83,4 +90,12 @@ public class ApplicationConfigInit { return scopes; } + public ApplicationConfigReadFormat getReadFormat() { + return readFormat; + } + + public ApplicationConfigInit setReadFormat(ApplicationConfigReadFormat readFormat) { + this.readFormat = readFormat; + return this; + } } diff --git a/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigIO.java b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigIO.java new file mode 100644 index 0000000..25e9d24 --- /dev/null +++ b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigIO.java @@ -0,0 +1,21 @@ +package org.nuiton.config.io; + +import java.io.File; +import java.net.URL; +import java.util.Properties; + +/** + * Created on 07/10/16. + * + * @author Tony Chemit - chemit@codelutin.com + * @since 3.1 + */ +public interface ApplicationConfigIO { + + boolean accept(ApplicationConfigReadFormat readFormat); + + Properties readProperties(URL url, String encoding) throws ApplicationConfigReadPropertiesException; + + void writeProperties(Properties properties, File file, String encoding, String comment) throws ApplicationConfigWritePropertiesException; + +} diff --git a/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigReadFormat.java b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigReadFormat.java new file mode 100644 index 0000000..d68d3af --- /dev/null +++ b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigReadFormat.java @@ -0,0 +1,9 @@ +package org.nuiton.config.io; + +/** + * Le format de lecture des ficiers de configuration. + */ +public enum ApplicationConfigReadFormat { + properties, + ini +} diff --git a/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigReadPropertiesException.java b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigReadPropertiesException.java new file mode 100644 index 0000000..113cef8 --- /dev/null +++ b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigReadPropertiesException.java @@ -0,0 +1,17 @@ +package org.nuiton.config.io; + +/** + * Created by tchemit on 07/10/16. + * + * @author Tony Chemit - chemit@codelutin.com + */ +public class ApplicationConfigReadPropertiesException extends RuntimeException { + + public ApplicationConfigReadPropertiesException(String message, Throwable cause) { + super(message, cause); + } + + public ApplicationConfigReadPropertiesException(Throwable cause) { + super(cause); + } +} diff --git a/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigWritePropertiesException.java b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigWritePropertiesException.java new file mode 100644 index 0000000..63d4195 --- /dev/null +++ b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationConfigWritePropertiesException.java @@ -0,0 +1,17 @@ +package org.nuiton.config.io; + +/** + * Created by tchemit on 07/10/16. + * + * @author Tony Chemit - chemit@codelutin.com + */ +public class ApplicationConfigWritePropertiesException extends RuntimeException { + + public ApplicationConfigWritePropertiesException(String message, Throwable cause) { + super(message, cause); + } + + public ApplicationConfigWritePropertiesException(Throwable cause) { + super(cause); + } +} diff --git a/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationIOHelper.java b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationIOHelper.java new file mode 100644 index 0000000..f8a8be0 --- /dev/null +++ b/nuiton-config/src/main/java/org/nuiton/config/io/ApplicationIOHelper.java @@ -0,0 +1,49 @@ +package org.nuiton.config.io; + +import com.google.common.base.Preconditions; + +import java.io.File; +import java.net.URL; +import java.util.Properties; +import java.util.ServiceLoader; + +/** + * Created on 07/10/16. + * + * @author Tony Chemit - chemit@codelutin.com + * @since 3.1 + */ +public class ApplicationIOHelper implements ApplicationConfigIO { + + private final ApplicationConfigIO delegate; + + public ApplicationIOHelper(ApplicationConfigReadFormat readFormat) { + Preconditions.checkNotNull(readFormat, "Can't init with null readFormat"); + ServiceLoader<ApplicationConfigIO> loader = ServiceLoader.load(ApplicationConfigIO.class); + ApplicationConfigIO delegate = null; + for (ApplicationConfigIO applicationConfigIO : loader) { + if (applicationConfigIO.accept(readFormat)) { + delegate = applicationConfigIO; + } + } + Preconditions.checkState(delegate != null, "Could not find ApplicationConfigIO implementation for format: " + readFormat); + this.delegate = delegate; + } + + @Override + public boolean accept(ApplicationConfigReadFormat readFormat) { + // accept all formats + return true; + } + + @Override + public Properties readProperties(URL url, String encoding) throws ApplicationConfigReadPropertiesException { + return delegate.readProperties(url, encoding); + } + + @Override + public void writeProperties(Properties properties, File file, String encoding, String comment) throws ApplicationConfigWritePropertiesException { + delegate.writeProperties(properties, file, encoding, comment); + } + +} -- To stop receiving notification emails like this one, please contact nuiton.org SCM administrator <admin+scm@nuiton.org>.

This is an automated email from the git hooks/post-receive script. New commit to branch develop in repository nuiton-config. See https://gitlab.nuiton.org/nuiton/nuiton-config.git commit 20927f698ae040ea5439c9ae1f087a9b3aee183a Author: Tony CHEMIT <chemit@codelutin.com> Date: Fri Oct 7 12:05:16 2016 +0200 Add ini io implementation --- nuiton-config-io-ini/LICENSE.txt | 165 +++++++++++++++++++++ nuiton-config-io-ini/README.md | 0 nuiton-config-io-ini/pom.xml | 37 +++++ .../config/io/ini/ApplicationConfigIOIni.java | 86 +++++++++++ .../org.nuiton.config.io.ApplicationConfigIO | 1 + pom.xml | 1 + 6 files changed, 290 insertions(+) diff --git a/nuiton-config-io-ini/LICENSE.txt b/nuiton-config-io-ini/LICENSE.txt new file mode 100644 index 0000000..cca7fc2 --- /dev/null +++ b/nuiton-config-io-ini/LICENSE.txt @@ -0,0 +1,165 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + + This version of the GNU Lesser General Public License incorporates +the terms and conditions of version 3 of the GNU General Public +License, supplemented by the additional permissions listed below. + + 0. Additional Definitions. + + As used herein, "this License" refers to version 3 of the GNU Lesser +General Public License, and the "GNU GPL" refers to version 3 of the GNU +General Public License. + + "The Library" refers to a covered work governed by this License, +other than an Application or a Combined Work as defined below. + + An "Application" is any work that makes use of an interface provided +by the Library, but which is not otherwise based on the Library. +Defining a subclass of a class defined by the Library is deemed a mode +of using an interface provided by the Library. + + A "Combined Work" is a work produced by combining or linking an +Application with the Library. The particular version of the Library +with which the Combined Work was made is also called the "Linked +Version". + + The "Minimal Corresponding Source" for a Combined Work means the +Corresponding Source for the Combined Work, excluding any source code +for portions of the Combined Work that, considered in isolation, are +based on the Application, and not on the Linked Version. + + The "Corresponding Application Code" for a Combined Work means the +object code and/or source code for the Application, including any data +and utility programs needed for reproducing the Combined Work from the +Application, but excluding the System Libraries of the Combined Work. + + 1. Exception to Section 3 of the GNU GPL. + + You may convey a covered work under sections 3 and 4 of this License +without being bound by section 3 of the GNU GPL. + + 2. Conveying Modified Versions. + + If you modify a copy of the Library, and, in your modifications, a +facility refers to a function or data to be supplied by an Application +that uses the facility (other than as an argument passed when the +facility is invoked), then you may convey a copy of the modified +version: + + a) under this License, provided that you make a good faith effort to + ensure that, in the event an Application does not supply the + function or data, the facility still operates, and performs + whatever part of its purpose remains meaningful, or + + b) under the GNU GPL, with none of the additional permissions of + this License applicable to that copy. + + 3. Object Code Incorporating Material from Library Header Files. + + The object code form of an Application may incorporate material from +a header file that is part of the Library. You may convey such object +code under terms of your choice, provided that, if the incorporated +material is not limited to numerical parameters, data structure +layouts and accessors, or small macros, inline functions and templates +(ten or fewer lines in length), you do both of the following: + + a) Give prominent notice with each copy of the object code that the + Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the object code with a copy of the GNU GPL and this license + document. + + 4. Combined Works. + + You may convey a Combined Work under terms of your choice that, +taken together, effectively do not restrict modification of the +portions of the Library contained in the Combined Work and reverse +engineering for debugging such modifications, if you also do each of +the following: + + a) Give prominent notice with each copy of the Combined Work that + the Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the Combined Work with a copy of the GNU GPL and this license + document. + + c) For a Combined Work that displays copyright notices during + execution, include the copyright notice for the Library among + these notices, as well as a reference directing the user to the + copies of the GNU GPL and this license document. + + d) Do one of the following: + + 0) Convey the Minimal Corresponding Source under the terms of this + License, and the Corresponding Application Code in a form + suitable for, and under terms that permit, the user to + recombine or relink the Application with a modified version of + the Linked Version to produce a modified Combined Work, in the + manner specified by section 6 of the GNU GPL for conveying + Corresponding Source. + + 1) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (a) uses at run time + a copy of the Library already present on the user's computer + system, and (b) will operate properly with a modified version + of the Library that is interface-compatible with the Linked + Version. + + e) Provide Installation Information, but only if you would otherwise + be required to provide such information under section 6 of the + GNU GPL, and only to the extent that such information is + necessary to install and execute a modified version of the + Combined Work produced by recombining or relinking the + Application with a modified version of the Linked Version. (If + you use option 4d0, the Installation Information must accompany + the Minimal Corresponding Source and Corresponding Application + Code. If you use option 4d1, you must provide the Installation + Information in the manner specified by section 6 of the GNU GPL + for conveying Corresponding Source.) + + 5. Combined Libraries. + + You may place library facilities that are a work based on the +Library side by side in a single library together with other library +facilities that are not Applications and are not covered by this +License, and convey such a combined library under terms of your +choice, if you do both of the following: + + a) Accompany the combined library with a copy of the same work based + on the Library, uncombined with any other library facilities, + conveyed under the terms of this License. + + b) Give prominent notice with the combined library that part of it + is a work based on the Library, and explaining where to find the + accompanying uncombined form of the same work. + + 6. Revised Versions of the GNU Lesser General Public License. + + The Free Software Foundation may publish revised and/or new versions +of the GNU Lesser General Public License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. + + Each version is given a distinguishing version number. If the +Library as you received it specifies that a certain numbered version +of the GNU Lesser General Public License "or any later version" +applies to it, you have the option of following the terms and +conditions either of that published version or of any later version +published by the Free Software Foundation. If the Library as you +received it does not specify a version number of the GNU Lesser +General Public License, you may choose any version of the GNU Lesser +General Public License ever published by the Free Software Foundation. + + If the Library as you received it specifies that a proxy can decide +whether future versions of the GNU Lesser General Public License shall +apply, that proxy's public statement of acceptance of any version is +permanent authorization for you to choose that version for the +Library. diff --git a/nuiton-config-io-ini/README.md b/nuiton-config-io-ini/README.md new file mode 100644 index 0000000..e69de29 diff --git a/nuiton-config-io-ini/pom.xml b/nuiton-config-io-ini/pom.xml new file mode 100644 index 0000000..7a13c3e --- /dev/null +++ b/nuiton-config-io-ini/pom.xml @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding="UTF-8"?> +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> + + <parent> + <groupId>org.nuiton</groupId> + <artifactId>nuiton-config-project</artifactId> + <version>3.1-SNAPSHOT</version> + </parent> + + <artifactId>nuiton-config-io-ini</artifactId> + + <name>Nuiton Config :: IO Ini</name> + <description>Nuiton Config IO Ini</description> + <inceptionYear>2016</inceptionYear> + + <properties> + + </properties> + + <dependencies> + + <dependency> + <groupId>org.nuiton</groupId> + <artifactId>nuiton-config</artifactId> + <version>${project.version}</version> + </dependency> + + <dependency> + <groupId>org.apache.commons</groupId> + <artifactId>commons-configuration2</artifactId> + </dependency> + + </dependencies> + +</project> diff --git a/nuiton-config-io-ini/src/main/java/org/nuiton/config/io/ini/ApplicationConfigIOIni.java b/nuiton-config-io-ini/src/main/java/org/nuiton/config/io/ini/ApplicationConfigIOIni.java new file mode 100644 index 0000000..bfadbc3 --- /dev/null +++ b/nuiton-config-io-ini/src/main/java/org/nuiton/config/io/ini/ApplicationConfigIOIni.java @@ -0,0 +1,86 @@ +package org.nuiton.config.io.ini; + +import com.google.common.io.Files; +import org.apache.commons.configuration2.INIConfiguration; +import org.apache.commons.configuration2.SubnodeConfiguration; +import org.nuiton.config.io.ApplicationConfigIO; +import org.nuiton.config.io.ApplicationConfigReadFormat; +import org.nuiton.config.io.ApplicationConfigReadPropertiesException; +import org.nuiton.config.io.ApplicationConfigWritePropertiesException; + +import java.io.BufferedReader; +import java.io.File; +import java.io.InputStreamReader; +import java.io.Reader; +import java.io.Writer; +import java.net.URL; +import java.nio.charset.Charset; +import java.util.Iterator; +import java.util.Properties; + +/** + * Created on 07/10/16. + * + * @author Tony Chemit - chemit@codelutin.com + * @since 3.1 + */ +public class ApplicationConfigIOIni implements ApplicationConfigIO { + + @Override + public boolean accept(ApplicationConfigReadFormat readFormat) { + return ApplicationConfigReadFormat.ini.equals(readFormat); + } + + @Override + public Properties readProperties(URL url, String encoding) throws ApplicationConfigReadPropertiesException { + Properties properties = new Properties(); + INIConfiguration iniConfiguration = new INIConfiguration(); + try (Reader reader = new BufferedReader(new InputStreamReader(url.openStream(), encoding))) { + iniConfiguration.read(reader); + } catch (Exception e) { + throw new ApplicationConfigReadPropertiesException("Can't read ini file: " + url, e); + } + + Iterator<String> keysIterator = iniConfiguration.getKeys(); + while (keysIterator.hasNext()) { + String key = keysIterator.next(); + properties.put(key, iniConfiguration.getProperty(key)); + } + for (String sectionName : iniConfiguration.getSections()) { + + if (sectionName == null) { + continue; + } + + SubnodeConfiguration section = iniConfiguration.getSection(sectionName); + + Iterator<String> sectionKeysIterator = section.getKeys(); + while (sectionKeysIterator.hasNext()) { + String key = sectionKeysIterator.next(); + properties.put(sectionName + "." + key, section.getProperty(key)); + } + + } + + return properties; + } + + @Override + public void writeProperties(Properties properties, File file, String encoding, String comment) throws ApplicationConfigWritePropertiesException { + + INIConfiguration iniConfiguration = new INIConfiguration(); + + //FIXME See how to manage sections ? guess them from keys ? + for (String key : properties.stringPropertyNames()) { + iniConfiguration.addProperty(key, properties.getProperty(key, null)); + } + + try (Writer writer = Files.newWriter(file, Charset.forName(encoding))) { + iniConfiguration.write(writer); + } catch (Exception e) { + throw new ApplicationConfigWritePropertiesException("Can't write ini file: " + file, e); + } + + } + +} diff --git a/nuiton-config-io-ini/src/main/resources/services/org.nuiton.config.io.ApplicationConfigIO b/nuiton-config-io-ini/src/main/resources/services/org.nuiton.config.io.ApplicationConfigIO new file mode 100644 index 0000000..3ef7454 --- /dev/null +++ b/nuiton-config-io-ini/src/main/resources/services/org.nuiton.config.io.ApplicationConfigIO @@ -0,0 +1 @@ +org.nuiton.config.io.ini.ApplicationConfigIOIni \ No newline at end of file diff --git a/pom.xml b/pom.xml index a8e3e7e..ce56d29 100644 --- a/pom.xml +++ b/pom.xml @@ -47,6 +47,7 @@ <modules> <module>nuiton-config</module> + <module>nuiton-config-io-ini</module> <module>nuiton-config-maven-plugin</module> <module>nuiton-config-example</module> </modules> -- To stop receiving notification emails like this one, please contact nuiton.org SCM administrator <admin+scm@nuiton.org>.

This is an automated email from the git hooks/post-receive script. New commit to branch develop in repository nuiton-config. See https://gitlab.nuiton.org/nuiton/nuiton-config.git commit 471d063dac03fefe3fa64de1a0d03f1a36aeaaf8 Author: Tony CHEMIT <chemit@codelutin.com> Date: Fri Oct 7 14:15:31 2016 +0200 Add ini io implementation --- nuiton-config-io-ini/pom.xml | 5 ++ .../config/io/ini/ApplicationConfigIOIni.java | 37 ++++++++- .../org.nuiton.config.io.ApplicationConfigIO | 0 .../config/io/ini/ApplicationConfigIOIniTest.java | 93 ++++++++++++++++++++++ .../src/test/resources/NuitonConfigExample.ini | 5 ++ 5 files changed, 138 insertions(+), 2 deletions(-) diff --git a/nuiton-config-io-ini/pom.xml b/nuiton-config-io-ini/pom.xml index 7a13c3e..ee920a3 100644 --- a/nuiton-config-io-ini/pom.xml +++ b/nuiton-config-io-ini/pom.xml @@ -32,6 +32,11 @@ <artifactId>commons-configuration2</artifactId> </dependency> + <dependency> + <groupId>junit</groupId> + <artifactId>junit</artifactId> + </dependency> + </dependencies> </project> diff --git a/nuiton-config-io-ini/src/main/java/org/nuiton/config/io/ini/ApplicationConfigIOIni.java b/nuiton-config-io-ini/src/main/java/org/nuiton/config/io/ini/ApplicationConfigIOIni.java index bfadbc3..fd0ed9e 100644 --- a/nuiton-config-io-ini/src/main/java/org/nuiton/config/io/ini/ApplicationConfigIOIni.java +++ b/nuiton-config-io-ini/src/main/java/org/nuiton/config/io/ini/ApplicationConfigIOIni.java @@ -1,5 +1,8 @@ package org.nuiton.config.io.ini; +import com.google.common.base.Joiner; +import com.google.common.collect.ArrayListMultimap; +import com.google.common.collect.Multimap; import com.google.common.io.Files; import org.apache.commons.configuration2.INIConfiguration; import org.apache.commons.configuration2.SubnodeConfiguration; @@ -15,7 +18,11 @@ import java.io.Reader; import java.io.Writer; import java.net.URL; import java.nio.charset.Charset; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collection; import java.util.Iterator; +import java.util.List; import java.util.Properties; /** @@ -70,9 +77,35 @@ public class ApplicationConfigIOIni implements ApplicationConfigIO { INIConfiguration iniConfiguration = new INIConfiguration(); - //FIXME See how to manage sections ? guess them from keys ? + Multimap<String, String> splits = ArrayListMultimap.create(); + for (String key : properties.stringPropertyNames()) { - iniConfiguration.addProperty(key, properties.getProperty(key, null)); + List<String> split = new ArrayList<>(Arrays.asList(key.split("\\."))); + if (split.size() == 1) { + // simple property + iniConfiguration.addProperty(key, properties.getProperty(key)); + } else { + String lastKey = split.remove(split.size() - 1); + splits.put(Joiner.on(".").join(split), lastKey); + } + } + + for (String sectionName : splits.keySet()) { + Collection<String> keyNames = splits.get(sectionName); + if (keyNames.size() > 1) { + + // use section + SubnodeConfiguration section = iniConfiguration.getSection(sectionName); + for (String keyName : keyNames) { + section.addProperty(keyName, properties.getProperty(sectionName + "." + keyName)); + } + + } else { + + // simple property + String keyName = keyNames.iterator().next(); + iniConfiguration.addProperty(sectionName + "." + keyName, properties.getProperty(sectionName + "." + keyName)); + } } try (Writer writer = Files.newWriter(file, Charset.forName(encoding))) { diff --git a/nuiton-config-io-ini/src/main/resources/services/org.nuiton.config.io.ApplicationConfigIO b/nuiton-config-io-ini/src/main/resources/META-INF/services/org.nuiton.config.io.ApplicationConfigIO similarity index 100% rename from nuiton-config-io-ini/src/main/resources/services/org.nuiton.config.io.ApplicationConfigIO rename to nuiton-config-io-ini/src/main/resources/META-INF/services/org.nuiton.config.io.ApplicationConfigIO diff --git a/nuiton-config-io-ini/src/test/java/org/nuiton/config/io/ini/ApplicationConfigIOIniTest.java b/nuiton-config-io-ini/src/test/java/org/nuiton/config/io/ini/ApplicationConfigIOIniTest.java new file mode 100644 index 0000000..024311c --- /dev/null +++ b/nuiton-config-io-ini/src/test/java/org/nuiton/config/io/ini/ApplicationConfigIOIniTest.java @@ -0,0 +1,93 @@ +package org.nuiton.config.io.ini; + +import org.junit.Assert; +import org.junit.Test; +import org.nuiton.config.io.ApplicationConfigIO; +import org.nuiton.config.io.ApplicationConfigIOHelper; +import org.nuiton.config.io.ApplicationConfigReadFormat; + +import java.io.File; +import java.nio.charset.StandardCharsets; +import java.nio.file.Paths; +import java.util.Properties; + +/** + * Created by tchemit on 07/10/16. + * + * @author Tony Chemit - chemit@codelutin.com + */ +public class ApplicationConfigIOIniTest { + + @Test + public void readProperties() throws Exception { + + ApplicationConfigIO io = new ApplicationConfigIOIni(); + + File file = Paths.get(new File("").getAbsolutePath(), "src", "test", "resources", "NuitonConfigExample.ini").toFile(); + + Properties properties = io.readProperties(file.toURI().toURL(), StandardCharsets.UTF_8.name()); + + assertProperties(properties); + + } + + @Test + public void readPropertiesFromHelper() throws Exception { + + File file = Paths.get(new File("").getAbsolutePath(), "src", "test", "resources", "NuitonConfigExample.ini").toFile(); + + Properties properties = new ApplicationConfigIOHelper(ApplicationConfigReadFormat.ini).readProperties(file.toURI().toURL(), StandardCharsets.UTF_8.name()); + + assertProperties(properties); + + } + + @Test + public void writeProperties() throws Exception { + + ApplicationConfigIO io = new ApplicationConfigIOIni(); + + Properties properties = new Properties(); + properties.put("identity.firstName", "Joshua"); + properties.put("identity.lastName", "Bloch"); + properties.put("identity.age", "56"); + properties.put("identity.twitter", "jbloch"); + + File file = Paths.get(new File("").getAbsolutePath(), "target", "surefire-workdir", "NuitonConfigExample" + System.currentTimeMillis() + ".ini").toFile(); + + io.writeProperties(properties, file, StandardCharsets.UTF_8.name(), null); + + Properties properties2 = io.readProperties(file.toURI().toURL(), StandardCharsets.UTF_8.name()); + + assertProperties(properties2); + + } + + @Test + public void writePropertiesFromHelper() throws Exception { + + Properties properties = new Properties(); + properties.put("identity.firstName", "Joshua"); + properties.put("identity.lastName", "Bloch"); + properties.put("identity.age", "56"); + properties.put("identity.twitter", "jbloch"); + + File file = Paths.get(new File("").getAbsolutePath(), "target", "surefire-workdir", "NuitonConfigExample" + System.currentTimeMillis() + ".ini").toFile(); + new ApplicationConfigIOHelper(ApplicationConfigReadFormat.ini).writeProperties(properties, file, StandardCharsets.UTF_8.name(), null); + + Properties properties2 = new ApplicationConfigIOHelper(ApplicationConfigReadFormat.ini).readProperties(file.toURI().toURL(), StandardCharsets.UTF_8.name()); + + assertProperties(properties2); + + } + + private void assertProperties(Properties properties) { + Assert.assertNotNull(properties); + Assert.assertNotNull(properties.getProperty("identity.firstName")); + Assert.assertEquals("Joshua", properties.getProperty("identity.firstName")); + Assert.assertEquals("Bloch", properties.getProperty("identity.lastName")); + Assert.assertEquals("56", properties.getProperty("identity.age")); + Assert.assertEquals("jbloch", properties.getProperty("identity.twitter")); + } + +} \ No newline at end of file diff --git a/nuiton-config-io-ini/src/test/resources/NuitonConfigExample.ini b/nuiton-config-io-ini/src/test/resources/NuitonConfigExample.ini new file mode 100644 index 0000000..cee47b5 --- /dev/null +++ b/nuiton-config-io-ini/src/test/resources/NuitonConfigExample.ini @@ -0,0 +1,5 @@ +[identity] +firstName = Joshua +lastName = Bloch +age = 56 +twitter = jbloch -- To stop receiving notification emails like this one, please contact nuiton.org SCM administrator <admin+scm@nuiton.org>.

This is an automated email from the git hooks/post-receive script. New commit to branch develop in repository nuiton-config. See https://gitlab.nuiton.org/nuiton/nuiton-config.git commit c9d94d72c329bca0980b70138b6125feabf33c3a Author: Tony CHEMIT <chemit@codelutin.com> Date: Fri Oct 7 16:47:39 2016 +0200 Add doc for ini format usage --- nuiton-config/src/site/apt/index.apt | 56 +++++++++++++++++++++--------------- src/site/apt/usage.apt.vm | 10 +++++++ 2 files changed, 43 insertions(+), 23 deletions(-) diff --git a/nuiton-config/src/site/apt/index.apt b/nuiton-config/src/site/apt/index.apt index 7f808e6..60e9f65 100644 --- a/nuiton-config/src/site/apt/index.apt +++ b/nuiton-config/src/site/apt/index.apt @@ -33,7 +33,7 @@ Présentation * la lecture de fichier de configuration ; - * le parsage de la ligne de commande ; + * le parsing de la ligne de commande ; * l'execution des actions ; @@ -44,31 +44,31 @@ Lecture/écriture * Lecture des fichiers de configuration La lecture des fichiers de configuration est effectuée lors de l'appel - à la methode <<<parse(String...)>>> en utilisant la valeur de + à la méthode <<<parse(String...)>>> en utilisant la valeur de <<<getConfigFileName()>>> pour trouver les fichiers à lire. * La sauvegarde - La sauvegarde des options se fait via une des trois methodes disponibles : + La sauvegarde des options se fait via une des trois méthodes disponibles : - * <<<save>>> : sauvegarde dans un fichier specifique ; + * <<<save>>> : sauvegarde dans un fichier spécifique ; - * <<<saveForSystem>>> : sauvegarde les donnees dans /etc ; + * <<<saveForSystem>>> : sauvegarde les données dans /etc ; - * <<<saveForUser>>> : sauvegarde les donnees dans $HOME. + * <<<saveForUser>>> : sauvegarde les données dans $HOME. [] - Seules les options qui ont été modifiées par l'application (par la methode + Seules les options qui ont été modifiées par l'application (par la méthode <<<setOption()>>>) seront sauvegardées. Les variables d'environnement, les arguments de la ligne de commandes(etc...) ne seront pas sauvegardés. * Configuration multi instance Il est possible d'associer un nom de contexte à une configuration via la - methode <<<setAppName("azerty")>>>. Ainsi, les fichiers seront cherchés + méthode <<<setAppName("azerty")>>>. Ainsi, les fichiers seront cherchés dans le dossier défini par l'option <<<azerty.config.path>>> si elle existe - (sinon, dans le dossier par défaut) et le nom du fichier cherché defini + (sinon, dans le dossier par défaut) et le nom du fichier cherché défini par l'option <<<azerty.config.file>>>. Cette option est utilisée par exemple pour installer plusieurs instances @@ -111,8 +111,8 @@ Fonctionnalités --org.nuiton.test.Test#doLogin user password true +------------------------------------------------ - Une action est donc définie par le chemin complet de la methode qui traitera - l'action. Si la methode est statique, elle sera appelée directement. Dans le + Une action est donc définie par le chemin complet de la méthode qui traitera + l'action. Si la méthode est statique, elle sera appelée directement. Dans le cas contraire, la classe contenant la méthode sera instanciée à partir d'un constructeur prenant en paramètre seulement la configuration, ou, s'il n'est pas disponible, le constructeur par défaut. La méthode sera ensuite @@ -127,7 +127,7 @@ Fonctionnalités Si vous avez des paramètres optionnels, le seul moyen est d'utiliser des arguments variants. - Par exemple, la ligne de commande précédente appelera la methode : + Par exemple, la ligne de commande précédente appellera la méthode : +------------------------------------------- public class Test { @@ -137,10 +137,10 @@ public class Test { } +------------------------------------------- - Les actions ne sont pas executées, mais seulement parsées. Cela signifie - qu'elles seront executées seulement lorsque l'application appelera la méthode + Les actions ne sont pas exécutées, mais seulement parsées. Cela signifie + qu'elles seront exécutées seulement lorsque l'application appellera la méthode <<<doAction(int)>>>. - Par défaut, toutes les actions sont de niveau 0 et sont executées dans leur + Par défaut, toutes les actions sont de niveau 0 et sont exécutées dans leur ordre d'apparition sur la ligne de commande. Il est possible de différencier les différentes actions en utilisant l'annotation <<<@Step>>> @@ -152,13 +152,13 @@ doAction(1); +------------------------------------------- Dans cet exemple, les actions 0 et 1 ne sont pas effectuées au même moment. - C'est très utile par exemple pour éxecuter certaines actions avant le démarrage + C'est très utile par exemple pour exécuter certaines actions avant le démarrage de l'UI par exemple, et d'autres après... * Les arguments non parsés La configuration 'consomme' les arguments de la ligne de commande qu'elle a - réussie à traiter. Pour recupérer les autres arguments propres à l'application + réussie à traiter. Pour récupérer les autres arguments propres à l'application il est possible de les obtenir grace à la méthode <<<getUnparsed()>>>. Si l'on souhaite forcer la fin du parsing de la ligne de commande il est possible de mettre <<<-->>>. @@ -177,8 +177,8 @@ monApplication "mon arg" --option k1 v1 -- --option k2 v2 -- autre * Les alias - Il est possible d'utiliser des alias pour definir les options et les actions. - Ces alias doivent être renseignés par la methode <<<addAlias(String, String>>>: + Il est possible d'utiliser des alias pour définir les options et les actions. + Ces alias doivent être renseignés par la méthode <<<addAlias(String, String>>>: +------------------------------------------- addAlias("-v", "--option", "verbose", "true"); @@ -188,12 +188,12 @@ addAlias("-i", "--mon.package.MaClass#MaMethode", "import"); Dans le premier exemple on simplifie une option de flags l'option -v n'attend donc plus d'argument. Dans le second exemple on simplifie une option qui - attend encore un argment de type File. Enfin dans le troisieme exemple + attend encore un argument de type File. Enfin dans le troisième exemple on simplifie la syntaxe d'une action et on force le premier argument de l'action à être "import". Lors du parsing de la ligne de commande, tous les alias sont remplacés par - leur correspondance. Il est donc possible d'utiliser ce mecanisme pour + leur correspondance. Il est donc possible d'utiliser ce mécanisme pour autre chose : +------------------------------------------- @@ -244,7 +244,7 @@ application.version = 1.2.3 application.info = ${application.name} ${application.version} (${java.version}) +------------------------------------------- - L'appel de l'option <<<application.info>>> via la methode <<<getOption()>>> + L'appel de l'option <<<application.info>>> via la méthode <<<getOption()>>> retournera une chaîne de la forme : +------------------------------------------- @@ -309,7 +309,7 @@ public class MyConfig extends ApplicationConfig { * Usage - La configuration doit principalement être initilalisée grâce à la méthode + La configuration doit principalement être initialisée grâce à la méthode <<<parse(String[])>>> avant d'être utilisée. +------------------------------------------- @@ -369,3 +369,13 @@ org.chorem.pollen.PollenApplicationConfigProvider Cela permet ensuite, par exemple, de générer un rapport contenant toutes les options disponibles dans l'application. + +* Lire/Écrire des fichiers au format ini + + Depuis la version <<3.1>>, il est possible de lire/écrire les configuration au format <ini>. + + Pour ce faire, il faut indiquer à ApplicationConfig via son objet d'initialisation qu'on veut utiliser ce format : + ++------------------------------------------------ +ApplicationConfig applicationConfig = new ApplicationConfig(ApplicationConfigInit.forAllScopes().useIniFormat()); ++------------------------------------------------ diff --git a/src/site/apt/usage.apt.vm b/src/site/apt/usage.apt.vm index baeae89..fca9018 100644 --- a/src/site/apt/usage.apt.vm +++ b/src/site/apt/usage.apt.vm @@ -363,3 +363,13 @@ src +------------------------------------------------ Vous pouvez aussi choisir le format <toml> ou <yaml> en passant l'option <<-Dconfig.format=ini|toml|yaml>>. + +Lire et enregistrer ApplicationConfig au format ini + + Depuis la version <<3.1>>, il est possible de lire et d'enregistrer sa configuration au format <ini>. + + Pour ce faire, il faut indiquer à ApplicationConfig via son objet d'initialisation qu'on veut utiliser ce format : + ++------------------------------------------------ +ApplicationConfig applicationConfig = new ApplicationConfig(ApplicationConfigInit.forAllScopes().useIniFormat()); ++------------------------------------------------ -- To stop receiving notification emails like this one, please contact nuiton.org SCM administrator <admin+scm@nuiton.org>.