javatools.administrative

Class Parameters

java.lang.Object

javatools.administrative.Parameters

public class Parameters
extends Object

Copyright 2016 Fabian M. Suchanek Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Provides an interface for an ini-File to load parameter settings. Note that this is a static version, i.e. all components share the same parameters. There is also an instantiable NonsharedParameters version. That version can deal with different parameter settings used in parallel. If your work will be shared with others, please consider using the NonsharedParameters, as they allow an easier integration of your component with other components that may want to work on a separate set of parameters (e.g. there might be different database settings etc.). The ini-File loaded may contain parameters of the form

 parameterName = value
 ...
 

It may also contain comments or section headers (i.e. anything that does not match the above pattern). Parameter names are not case sensitive. Initial and terminal spaces are trimmed for both parameter names and values. Boolean parameters accept multiple ways of expressing "true" (namely "on", "true", "yes" and "active").

To avoid passing around object handles, this class does not function as an object! There is only one "static object". Example:

 // Read data from my.ini
 Parameters.init("my.ini");
 // Abort with error message if the following parameters are not specified
 Parameters.ensureParameters(
                "firstPar - some help text for the first parameter",
                "secondPar - some help text for the secondparameter");
 // Retrieve the value of a parameter
 String p = Parameters.get("firstPar");
 

You can load parameters from multiple files. These will overlay.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Parameters.UndefinedParameterException Thrown for an undefined Parameter

Field Summary

Fields

Modifier and Type	Field and Description
static File	iniFile Holds the filename of the ini-file
static Pattern	INIPATTERN Holds the pattern used for ini-file-entries
static FinalSet<String>	no Holds words that count as "no" for boolean parameters
static Map<String,String>	values Contains the values for the parameters

Constructor Summary

Constructors

Constructor and Description
Parameters()

Method Summary

Modifier and Type	Method and Description
static void	add(String key, String value) Adds a value to the map and to the ini file, if not yet there
static void	ensureParameters(String... p) Reports an error message and aborts if the parameters are undefined.
static String	get(String s) Returns a value for a parameter
static String	get(String s, String defaultValue) Returns a value for a parameter, returning a default value by default
static boolean	getBoolean(String s) Returns a value for a boolean parameter
static boolean	getBoolean(String s, boolean defaultValue) Returns a value for a boolean parameter, returning a default value by default
static boolean	getBooleanArgument(String[] args, String... argnames) Parses the arguments of the main method and tells whether a parameter is on or off
static Database	getDatabase() Returns the database defined in this ini-file
static double	getDouble(String s) Returns a value for an integer parameter
static double	getDouble(String s, double defaultValue) Returns a value for an integer parameter returning the default value if undefined
static File	getFile(String s) Returns a value for a file or folder parameter
static File	getFile(String s, File defaultValue) Returns a value for a file or folder parameter, returning the default value if undefined
static int	getInt(String s) Returns a value for an integer parameter
static int	getInt(String s, int defaultValue) Returns a value for an integer parameter returning the default value if undefined
static List<String>	getList(String s) Returns a value for a list parameter
static String	getOrRequest(String s, String description) Returns a value for a parameter.
static String	getOrRequestAndAdd(String s, String description) Returns a value for a parameter.
static boolean	getOrRequestAndAddBoolean(String s, String description) Returns a value for a parameter.
static File	getOrRequestAndAddFile(String s, String description) Returns a value for a parameter.
static int	getOrRequestAndAddInt(String s, String description) Returns a value for a parameter.
static boolean	getOrRequestBoolean(String s, String description) Returns a value for a parameter.
static File	getOrRequestFileParameter(String s, String description) Returns a value for a parameter.
static int	getOrRequestInteger(String s, String description) Returns a value for a parameter.
static void	init(File f) Initializes the parameters from a file
static void	init(String file) Initializes the parameters from a file
static void	init(String filename, File... folders) Seeks the file in all given folders
static boolean	isDefined(String s) Tells whether a parameter is defined
static void	main(String[] args) Test routine
static Set<String>	parameters() Returns all defined parameters
static String	remove(String parameter) Removes a value from the mapping (NOT: from the file)
static void	reset() Deletes all current values

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

iniFile

public static File iniFile

Holds the filename of the ini-file

values

public static Map<String,String> values

Contains the values for the parameters

INIPATTERN

public static Pattern INIPATTERN

Holds the pattern used for ini-file-entries

no

public static FinalSet<String> no

Holds words that count as "no" for boolean parameters

Constructor Detail

Parameters

public Parameters()

Method Detail

getFile

public static File getFile(String s)
                    throws Parameters.UndefinedParameterException

Returns a value for a file or folder parameter

Throws:

Parameters.UndefinedParameterException

getFile

public static File getFile(String s,
                           File defaultValue)
                    throws Parameters.UndefinedParameterException

Returns a value for a file or folder parameter, returning the default value if undefined

Throws:

Parameters.UndefinedParameterException

getInt

public static int getInt(String s)
                  throws Parameters.UndefinedParameterException

Returns a value for an integer parameter

Throws:

Parameters.UndefinedParameterException

getInt

public static int getInt(String s,
                         int defaultValue)
                  throws Parameters.UndefinedParameterException

Returns a value for an integer parameter returning the default value if undefined

Throws:

Parameters.UndefinedParameterException

getDouble

public static double getDouble(String s)
                        throws Parameters.UndefinedParameterException

Returns a value for an integer parameter

Throws:

Parameters.UndefinedParameterException

getDouble

public static double getDouble(String s,
                               double defaultValue)
                        throws Parameters.UndefinedParameterException

Returns a value for an integer parameter returning the default value if undefined

Throws:

Parameters.UndefinedParameterException

getBoolean

public static boolean getBoolean(String s)
                          throws Parameters.UndefinedParameterException

Returns a value for a boolean parameter

Throws:

Parameters.UndefinedParameterException

getBoolean

public static boolean getBoolean(String s,
                                 boolean defaultValue)

Returns a value for a boolean parameter, returning a default value by default

getList

public static List<String> getList(String s)
                            throws Parameters.UndefinedParameterException

Returns a value for a list parameter

Throws:

Parameters.UndefinedParameterException

get

public static String get(String s)
                  throws Parameters.UndefinedParameterException

Returns a value for a parameter

Throws:

Parameters.UndefinedParameterException

get

public static String get(String s,
                         String defaultValue)

Returns a value for a parameter, returning a default value by default

getOrRequest

public static String getOrRequest(String s,
                                  String description)

Returns a value for a parameter. If not present, asks the user for it

getOrRequestAndAdd

public static String getOrRequestAndAdd(String s,
                                        String description)
                                 throws IOException

Returns a value for a parameter. If not present, asks the user for it and adds it

Throws:

IOException

getOrRequestAndAddInt

public static int getOrRequestAndAddInt(String s,
                                        String description)
                                 throws IOException

Returns a value for a parameter. If not present, asks the user for it and adds it

Throws:

IOException

getOrRequestAndAddFile

public static File getOrRequestAndAddFile(String s,
                                          String description)
                                   throws IOException

Returns a value for a parameter. If not present, asks the user for it and adds it

Throws:

IOException

getOrRequestAndAddBoolean

public static boolean getOrRequestAndAddBoolean(String s,
                                                String description)
                                         throws IOException

Returns a value for a parameter. If not present, asks the user for it and adds it

Throws:

IOException

getOrRequestFileParameter

public static File getOrRequestFileParameter(String s,
                                             String description)

Returns a value for a parameter. If not present, asks the user for it

remove

public static String remove(String parameter)

Removes a value from the mapping (NOT: from the file)

getOrRequestBoolean

public static boolean getOrRequestBoolean(String s,
                                          String description)

Returns a value for a parameter. If not present, asks the user for it

getOrRequestInteger

public static int getOrRequestInteger(String s,
                                      String description)

Returns a value for a parameter. If not present, asks the user for it

add

public static void add(String key,
                       String value)
                throws IOException

Adds a value to the map and to the ini file, if not yet there

Throws:

IOException

init

public static void init(File f)
                 throws IOException

Initializes the parameters from a file

Throws:

IOException

init

public static void init(String filename,
                        File... folders)
                 throws IOException

Seeks the file in all given folders

Throws:

IOException

isDefined

public static boolean isDefined(String s)

Tells whether a parameter is defined

init

public static void init(String file)
                 throws IOException

Initializes the parameters from a file

Throws:

IOException

ensureParameters

public static void ensureParameters(String... p)

Reports an error message and aborts if the parameters are undefined. p may contain strings of the form "parametername explanation"

getBooleanArgument

public static boolean getBooleanArgument(String[] args,
                                         String... argnames)

Parses the arguments of the main method and tells whether a parameter is on or off

reset

public static void reset()

Deletes all current values

getDatabase

public static Database getDatabase()
                            throws Exception

Returns the database defined in this ini-file

Throws:

Exception

parameters

public static Set<String> parameters()

Returns all defined parameters

main

public static void main(String[] args)
                 throws Exception

Test routine

Throws:

Exception