org.owasp.dependencycheck.utils

Class Settings

java.lang.Object

org.owasp.dependencycheck.utils.Settings

public final class Settings
extends Object

A simple settings container that wraps the dependencycheck.properties file.

Version:

$Id: $Id

Author:

Jeremy Long

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Settings.KEYS The collection of keys used within the properties file.

Constructor Summary

Constructors

Constructor and Description
Settings() Initialize the settings object.
Settings(Properties properties) Initialize the settings object using the given properties.
Settings(@NotNull String propertiesFilePath) Initialize the settings object using the given properties file.

Method Summary

Modifier and Type	Method and Description
void	cleanup() Cleans up resources to prevent memory leaks.
void	cleanup(boolean deleteTemporary) Cleans up resources to prevent memory leaks.
String[]	getArray(@NotNull String key) Returns a list with the given key.
boolean	getBoolean(@NotNull String key) Returns a boolean value from the properties file.
boolean	getBoolean(@NotNull String key, boolean defaultValue) Returns a boolean value from the properties file.
String	getConnectionString(String connectionStringKey, String dbFileNameKey) Returns a connection string from the configured properties.
File	getDataDirectory() Retrieves the primary data directory that is used for caching web content.
protected File	getDataFile(@NotNull String key) Returns a value from the properties file as a File object.
@Nullable File	getFile(@NotNull String key) Returns a value from the properties file as a File object.
float	getFloat(@NotNull String key, float defaultValue) Returns a float value from the properties file.
File	getH2DataDirectory() Retrieves the H2 data directory - if the database has been moved to the temp directory this method will return the temp directory.
int	getInt(@NotNull String key) Returns an int value from the properties file.
int	getInt(@NotNull String key, int defaultValue) Returns an int value from the properties file.
long	getLong(@NotNull String key) Returns a long value from the properties file.
protected String	getPrintableValue(@NotNull String key, String value) Obtains the printable/loggable value for a given key/value pair.
String	getString(@NotNull String key) Returns a value from the properties file.
String	getString(@NotNull String key, @Nullable String defaultValue) Returns a value from the properties file.
File	getTempDirectory() Returns the temporary directory.
File	getTempFile(@NotNull String prefix, @NotNull String extension) Generates a new temporary file name that is guaranteed to be unique.
protected void	initMaskedKeys() Initializes the masked keys collection.
void	mergeProperties(@NotNull File filePath) Merges a new properties file into the current properties.
void	mergeProperties(@NotNull InputStream stream) Merges a new properties file into the current properties.
void	mergeProperties(@NotNull String filePath) Merges a new properties file into the current properties.
void	removeProperty(@NotNull String key) Removes a property from the local properties collection.
void	setArrayIfNotEmpty(@NotNull String key, @Nullable List<String> value) Sets a property value only if the array value is not null and not empty.
void	setArrayIfNotEmpty(@NotNull String key, @Nullable String[] value) Sets a property value only if the array value is not null and not empty.
void	setBoolean(@NotNull String key, boolean value) Sets a property value.
void	setBooleanIfNotNull(@NotNull String key, @Nullable Boolean value) Sets a property value only if the value is not null.
void	setFloat(@NotNull String key, float value) Sets a float property value.
void	setInt(@NotNull String key, int value) Sets a property value.
void	setIntIfNotNull(@NotNull String key, @Nullable Integer value) Sets a property value only if the value is not null.
void	setString(@NotNull String key, @NotNull String value) Sets a property value.
void	setStringIfNotEmpty(@NotNull String key, @Nullable String value) Sets a property value only if the value is not null and not empty.
void	setStringIfNotNull(@NotNull String key, @Nullable String value) Sets a property value only if the value is not null.

Methods inherited from class java.lang.Object

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

Constructor Detail

Settings

public Settings()

Initialize the settings object.

Settings

public Settings(Properties properties)

Initialize the settings object using the given properties.

Parameters:

properties - the properties to be used with this Settings instance

Since:

4.0.3

Settings

public Settings(@NotNull
                @NotNull String propertiesFilePath)

Initialize the settings object using the given properties file.

Parameters:

propertiesFilePath - the path to the base properties file to load

Method Detail

cleanup

public void cleanup()

Cleans up resources to prevent memory leaks.

cleanup

public void cleanup(boolean deleteTemporary)

Cleans up resources to prevent memory leaks.

Parameters:

deleteTemporary - flag indicating whether any temporary directories generated should be removed

getPrintableValue

protected String getPrintableValue(@NotNull
                                   @NotNull String key,
                                   String value)

Obtains the printable/loggable value for a given key/value pair. This will mask some values so as to not leak sensitive information.

Parameters:

key - the property key

value - the property value

Returns:

the printable value

initMaskedKeys

protected void initMaskedKeys()

Initializes the masked keys collection. This is done outside of the initialize(java.lang.String) method because a caller may use the mergeProperties(java.io.File) to add additional properties after the call to initialize.

setString

public void setString(@NotNull
                      @NotNull String key,
                      @NotNull
                      @NotNull String value)

Sets a property value.

Parameters:

key - the key for the property

value - the value for the property

setStringIfNotNull

public void setStringIfNotNull(@NotNull
                               @NotNull String key,
                               @Nullable
                               @Nullable String value)

Sets a property value only if the value is not null.

Parameters:

key - the key for the property

value - the value for the property

setStringIfNotEmpty

public void setStringIfNotEmpty(@NotNull
                                @NotNull String key,
                                @Nullable
                                @Nullable String value)

Sets a property value only if the value is not null and not empty.

Parameters:

key - the key for the property

value - the value for the property

setArrayIfNotEmpty

public void setArrayIfNotEmpty(@NotNull
                               @NotNull String key,
                               @Nullable
                               @Nullable String[] value)

Sets a property value only if the array value is not null and not empty.

Parameters:

key - the key for the property

value - the value for the property

setArrayIfNotEmpty

public void setArrayIfNotEmpty(@NotNull
                               @NotNull String key,
                               @Nullable
                               @Nullable List<String> value)

Sets a property value only if the array value is not null and not empty.

Parameters:

key - the key for the property

value - the value for the property

setBoolean

public void setBoolean(@NotNull
                       @NotNull String key,
                       boolean value)

Sets a property value.

Parameters:

key - the key for the property

value - the value for the property

setBooleanIfNotNull

public void setBooleanIfNotNull(@NotNull
                                @NotNull String key,
                                @Nullable
                                @Nullable Boolean value)

Sets a property value only if the value is not null.

Parameters:

key - the key for the property

value - the value for the property

setFloat

public void setFloat(@NotNull
                     @NotNull String key,
                     float value)

Sets a float property value.

Parameters:

key - the key for the property

value - the value for the property

setInt

public void setInt(@NotNull
                   @NotNull String key,
                   int value)

Sets a property value.

Parameters:

key - the key for the property

value - the value for the property

setIntIfNotNull

public void setIntIfNotNull(@NotNull
                            @NotNull String key,
                            @Nullable
                            @Nullable Integer value)

Sets a property value only if the value is not null.

Parameters:

key - the key for the property

value - the value for the property

mergeProperties

public void mergeProperties(@NotNull
                            @NotNull File filePath)
                     throws FileNotFoundException,
                            IOException

Merges a new properties file into the current properties. This method allows for the loading of a user provided properties file.

Note: even if using this method - system properties will be loaded before properties loaded from files.

Parameters:

filePath - the path to the properties file to merge.

Throws:

FileNotFoundException - is thrown when the filePath points to a non-existent file

IOException - is thrown when there is an exception loading/merging the properties

mergeProperties

public void mergeProperties(@NotNull
                            @NotNull String filePath)
                     throws FileNotFoundException,
                            IOException

Merges a new properties file into the current properties. This method allows for the loading of a user provided properties file.

Note: even if using this method - system properties will be loaded before properties loaded from files.

Parameters:

filePath - the path to the properties file to merge.

Throws:

FileNotFoundException - is thrown when the filePath points to a non-existent file

IOException - is thrown when there is an exception loading/merging the properties

mergeProperties

public void mergeProperties(@NotNull
                            @NotNull InputStream stream)
                     throws IOException

Merges a new properties file into the current properties. This method allows for the loading of a user provided properties file.

Note: even if using this method - system properties will be loaded before properties loaded from files.

Parameters:

stream - an Input Stream pointing at a properties file to merge

Throws:

IOException - is thrown when there is an exception loading/merging the properties

getFile

@Nullable
public @Nullable File getFile(@NotNull
                                        @NotNull String key)

Returns a value from the properties file as a File object. If the value was specified as a system property or passed in via the -Dprop=value argument - this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

Returns:

the property from the properties file converted to a File object

getDataFile

protected File getDataFile(@NotNull
                           @NotNull String key)

Returns a value from the properties file as a File object. If the value was specified as a system property or passed in via the -Dprop=value argument - this method will return the value from the system properties before the values in the contained configuration file.

This method will check the configured base directory and will use this as the base of the file path. Additionally, if the base directory begins with a leading "[JAR]\" sequence with the path to the folder containing the JAR file containing this class.

Parameters:

key - the key to lookup within the properties file

Returns:

the property from the properties file converted to a File object

getString

public String getString(@NotNull
                        @NotNull String key,
                        @Nullable
                        @Nullable String defaultValue)

Returns a value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument - this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

defaultValue - the default value for the requested property

Returns:

the property from the properties file

getTempDirectory

public File getTempDirectory()
                      throws IOException

Returns the temporary directory.

Returns:

the temporary directory

Throws:

IOException - if any.

getString

public String getString(@NotNull
                        @NotNull String key)

Returns a value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument - this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

Returns:

the property from the properties file

getArray

public String[] getArray(@NotNull
                         @NotNull String key)

Returns a list with the given key.

If the property is not set then null will be returned.

Parameters:

key - the key to get from this Settings.

Returns:

the list or null if the key wasn't present.

removeProperty

public void removeProperty(@NotNull
                           @NotNull String key)

Removes a property from the local properties collection. This is mainly used in test cases.

Parameters:

key - the property key to remove

getInt

public int getInt(@NotNull
                  @NotNull String key)
           throws InvalidSettingException

Returns an int value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument - this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

Returns:

the property from the properties file

Throws:

InvalidSettingException - is thrown if there is an error retrieving the setting

getInt

public int getInt(@NotNull
                  @NotNull String key,
                  int defaultValue)

Returns an int value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument - this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

defaultValue - the default value to return

Returns:

the property from the properties file or the defaultValue if the property does not exist or cannot be converted to an integer

getLong

public long getLong(@NotNull
                    @NotNull String key)
             throws InvalidSettingException

Returns a long value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument - this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

Returns:

the property from the properties file

Throws:

InvalidSettingException - is thrown if there is an error retrieving the setting

getBoolean

public boolean getBoolean(@NotNull
                          @NotNull String key)
                   throws InvalidSettingException

Returns a boolean value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

Returns:

the property from the properties file

Throws:

InvalidSettingException - is thrown if there is an error retrieving the setting

getBoolean

public boolean getBoolean(@NotNull
                          @NotNull String key,
                          boolean defaultValue)

Returns a boolean value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

defaultValue - the default value to return if the setting does not exist

Returns:

the property from the properties file

getFloat

public float getFloat(@NotNull
                      @NotNull String key,
                      float defaultValue)

Returns a float value from the properties file. If the value was specified as a system property or passed in via the -Dprop=value argument this method will return the value from the system properties before the values in the contained configuration file.

Parameters:

key - the key to lookup within the properties file

defaultValue - the default value to return if the setting does not exist

Returns:

the property from the properties file

getConnectionString

public String getConnectionString(String connectionStringKey,
                                  String dbFileNameKey)
                           throws IOException,
                                  InvalidSettingException

Returns a connection string from the configured properties. If the connection string contains a %s, this method will determine the 'data' directory and replace the %s with the path to the data directory. If the data directory does not exist it will be created.

Parameters:

connectionStringKey - the property file key for the connection string

dbFileNameKey - the settings key for the db filename

Returns:

the connection string

Throws:

IOException - thrown the data directory cannot be created

InvalidSettingException - thrown if there is an invalid setting

getDataDirectory

public File getDataDirectory()
                      throws IOException

Retrieves the primary data directory that is used for caching web content.

Returns:

the data directory to store data files

Throws:

IOException - is thrown if an java.io.IOException occurs of course...

getH2DataDirectory

public File getH2DataDirectory()
                        throws IOException

Retrieves the H2 data directory - if the database has been moved to the temp directory this method will return the temp directory.

Returns:

the data directory to store data files

Throws:

IOException - is thrown if an java.io.IOException occurs of course...

getTempFile

public File getTempFile(@NotNull
                        @NotNull String prefix,
                        @NotNull
                        @NotNull String extension)
                 throws IOException

Generates a new temporary file name that is guaranteed to be unique.

Parameters:

prefix - the prefix for the file name to generate

extension - the extension of the generated file name

Returns:

a temporary File

Throws:

IOException - if any.