jodd.props

Class Props

java.lang.Object

jodd.props.Props

All Implemented Interfaces:

java.lang.Cloneable

public class Props
extends java.lang.Object
implements java.lang.Cloneable

Super properties: fast, configurable, supports (ini) sections, profiles.

Basic parsing rules:

• By default, props files are UTF8 encoded.
• Leading and trailing spaces will be trimmed from section names and property names.
• Leading and/or trailing spaces may be trimmed from property values.
• You can use either equal sign (=) or colon (:) to assign property values
• Comments begin with either a semicolon (;), or a sharp sign (#) and extend to the end of line. It doesn't have to be the first character.
• A backslash (\) escapes the next character (e.g., \# is a literal #, \\ is a literal \).
• If the last character of a line is backslash (\), the value is continued on the next line with new line character included.
• \\uXXXX is encoded as character
• \t, \r and \f are encoded as characters

Sections rules:

• Section names are enclosed between [ and ].
• Properties following a section header belong to that section. Section name is added as a prefix to section properties.
• Section ends with empty section definition [] or with new section start

Profiles rules:

• Profile names are enclosed between < and > in property key.
• Each property key may contain zero, one or more profile definitions.

Macro rules:

• Profile values may contain references to other properties using ${ and }
• Inner references are supported
• References are resolved first in the profile context and then in the base props context.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String[]	activeProfiles
protected java.lang.String	activeProfilesProp
protected PropsData	data
protected boolean	initialized
protected PropsParser	parser

Constructor Summary

Constructors

Modifier	Constructor and Description
	Props() Creates new props.
protected	Props(PropsParser parser)

Method Summary

Methods

Modifier and Type	Method and Description
void	addInnerMap(java.lang.String prefix, java.util.Map<?,?> map) Adds child map to the props on given prefix.
void	addInnerMap(java.lang.String prefix, java.util.Map<?,?> map, java.lang.String profile) Adds child map to the props on given prefix.
protected Props	clone() Clones props by creating new instance and copying current configuration.
int	countTotalProperties() Counts the total number of properties, including all profiles.
PropsEntries	entries() Returns builder for entries itertor.
void	extractProps(java.util.Map target) Extracts props belonging to active profiles.
void	extractProps(java.util.Map target, java.lang.String... profiles) Extract props of given profiles.
void	extractSubProps(java.util.Map target, java.lang.String... wildcardPatterns) Extracts subset of properties that matches given wildcards.
void	extractSubProps(java.util.Map target, java.lang.String[] profiles, java.lang.String[] wildcardPatterns) Extracts subset of properties that matches given wildcards.
java.lang.String[]	getActiveProfiles() Returns active profiles or null if none defined.
java.lang.String[]	getAllProfiles() Returns all profiles names.
java.lang.String	getBaseValue(java.lang.String key) Returns string value of base property.
java.lang.Boolean	getBooleanValue(java.lang.String key)
java.lang.Boolean	getBooleanValue(java.lang.String key, java.lang.String... profiles)
java.lang.Double	getDoubleValue(java.lang.String key)
java.lang.Double	getDoubleValue(java.lang.String key, java.lang.String... profiles)
java.lang.Integer	getIntegerValue(java.lang.String key)
java.lang.Integer	getIntegerValue(java.lang.String key, java.lang.String... profiles)
java.lang.Long	getLongValue(java.lang.String key)
java.lang.Long	getLongValue(java.lang.String key, java.lang.String... profiles)
java.lang.String[]	getProfilesFor(java.lang.String propKeyNameWildcard) Returns all the profiles that define certain prop's key name.
java.lang.String	getValue(java.lang.String key) Returns value of property, using active profiles.
java.lang.String	getValue(java.lang.String key, java.lang.String... profiles) Returns string value of given profiles.
protected void	initialize() Initializes props.
java.util.Map<java.lang.String,java.lang.Object>	innerMap(java.lang.String prefix) Returns inner map from the props with given prefix.
java.util.Iterator<PropsEntry>	iterator() Returns iterator for active profiles.
void	load(java.io.File file) Loads props from the file.
void	load(java.io.File file, java.lang.String encoding) Loads properties from the file in provided encoding.
void	load(java.io.InputStream in) Loads properties from input stream.
void	load(java.io.InputStream in, java.lang.String encoding) Loads properties from input stream and provided encoding.
void	load(java.util.Map<?,?> p) Loads base properties from the provided java properties.
void	load(java.util.Map<?,?> map, java.lang.String prefix) Loads base properties from java Map using provided prefix.
void	load(java.lang.String data) Loads props from the string.
void	loadEnvironment(java.lang.String prefix) Loads environment properties with given prefix.
void	loadSystemProperties(java.lang.String prefix) Loads system properties with given prefix.
protected void	parse(java.lang.String data) Parses input string and loads provided properties map.
protected void	resolveActiveProfiles() Resolves active profiles from special property.
void	setActiveProfiles(java.lang.String... activeProfiles) Sets new active profiles and overrides existing ones.
void	setAppendDuplicateProps(boolean appendDuplicateProps) Appends duplicate props.
void	setEscapeNewLineValue(java.lang.String escapeNewLineValue) Specifies the new line string when EOL is escaped.
void	setIgnoreMissingMacros(boolean ignoreMissingMacros) Ignore missing macros by replacing them with an empty string.
void	setIgnorePrefixWhitespacesOnNewLine(boolean ignorePrefixWhitespacesOnNewLine) Defines if the prefix whitespaces should be ignored when value is split into the lines.
void	setMultilineValues(boolean multilineValues) Enables multiline values.
void	setSkipEmptyProps(boolean skipEmptyProps) Skips empty properties as they don't exist.
void	setValue(java.lang.String key, java.lang.String value) Sets default value.
void	setValue(java.lang.String key, java.lang.String value, java.lang.String profile) Sets value on some profile.
void	setValueTrimLeft(boolean valueTrimLeft) Specifies should the values be trimmed from the left.
void	setValueTrimRight(boolean valueTrimRight) Specifies should the values be trimmed from the right.

Methods inherited from class java.lang.Object

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

Field Detail

parser

protected final PropsParser parser

data

protected final PropsData data

activeProfilesProp

protected java.lang.String activeProfilesProp

activeProfiles

protected java.lang.String[] activeProfiles

initialized

protected volatile boolean initialized

Constructor Detail

Props

public Props()

Creates new props.

Props

protected Props(PropsParser parser)

Method Detail

clone

protected Props clone()

Clones props by creating new instance and copying current configuration.

Overrides:

clone in class java.lang.Object

getActiveProfiles

public java.lang.String[] getActiveProfiles()

Returns active profiles or null if none defined.

setActiveProfiles

public void setActiveProfiles(java.lang.String... activeProfiles)

Sets new active profiles and overrides existing ones. By setting null, no active profile will be set.

Note that if some props are loaded after this method call, they might override active profiles by using special property for active profiles (@profiles).

setEscapeNewLineValue

public void setEscapeNewLineValue(java.lang.String escapeNewLineValue)

Specifies the new line string when EOL is escaped. Default value is an empty string.

setValueTrimLeft

public void setValueTrimLeft(boolean valueTrimLeft)

Specifies should the values be trimmed from the left. Default is true.

setValueTrimRight

public void setValueTrimRight(boolean valueTrimRight)

Specifies should the values be trimmed from the right. Default is true.

setIgnorePrefixWhitespacesOnNewLine

public void setIgnorePrefixWhitespacesOnNewLine(boolean ignorePrefixWhitespacesOnNewLine)

Defines if the prefix whitespaces should be ignored when value is split into the lines.

setSkipEmptyProps

public void setSkipEmptyProps(boolean skipEmptyProps)

Skips empty properties as they don't exist.

setAppendDuplicateProps

public void setAppendDuplicateProps(boolean appendDuplicateProps)

Appends duplicate props.

setIgnoreMissingMacros

public void setIgnoreMissingMacros(boolean ignoreMissingMacros)

Ignore missing macros by replacing them with an empty string.

setMultilineValues

public void setMultilineValues(boolean multilineValues)

Enables multiline values.

parse

protected void parse(java.lang.String data)

Parses input string and loads provided properties map.

load

public void load(java.lang.String data)

Loads props from the string.

load

public void load(java.io.File file)
          throws java.io.IOException

Loads props from the file. Assumes UTF8 encoding unless the file ends with '.properties', than it uses ISO 8859-1.

Throws:

java.io.IOException

load

public void load(java.io.File file,
        java.lang.String encoding)
          throws java.io.IOException

Loads properties from the file in provided encoding.

Throws:

java.io.IOException

load

public void load(java.io.InputStream in)
          throws java.io.IOException

Loads properties from input stream. Stream is not closed at the end.

Throws:

java.io.IOException

load

public void load(java.io.InputStream in,
        java.lang.String encoding)
          throws java.io.IOException

Loads properties from input stream and provided encoding. Stream is not closed at the end.

Throws:

java.io.IOException

load

public void load(java.util.Map<?,?> p)

Loads base properties from the provided java properties. Null values are ignored.

load

public void load(java.util.Map<?,?> map,
        java.lang.String prefix)

Loads base properties from java Map using provided prefix. Null values are ignored.

loadSystemProperties

public void loadSystemProperties(java.lang.String prefix)

Loads system properties with given prefix. If prefix is null it will not be ignored.

loadEnvironment

public void loadEnvironment(java.lang.String prefix)

Loads environment properties with given prefix. If prefix is null it will not be used.

countTotalProperties

public int countTotalProperties()

Counts the total number of properties, including all profiles. This operation performs calculation each time and it might be more time consuming then expected.

getBaseValue

public java.lang.String getBaseValue(java.lang.String key)

Returns string value of base property. Returns null if property doesn't exist.

getValue

public java.lang.String getValue(java.lang.String key)

Returns value of property, using active profiles.

getIntegerValue

public java.lang.Integer getIntegerValue(java.lang.String key)

getLongValue

public java.lang.Long getLongValue(java.lang.String key)

getDoubleValue

public java.lang.Double getDoubleValue(java.lang.String key)

getBooleanValue

public java.lang.Boolean getBooleanValue(java.lang.String key)

getValue

public java.lang.String getValue(java.lang.String key,
                        java.lang.String... profiles)

Returns string value of given profiles. If key is not found under listed profiles, base properties will be searched. Returns null if property doesn't exist.

getIntegerValue

public java.lang.Integer getIntegerValue(java.lang.String key,
                                java.lang.String... profiles)

getLongValue

public java.lang.Long getLongValue(java.lang.String key,
                          java.lang.String... profiles)

getDoubleValue

public java.lang.Double getDoubleValue(java.lang.String key,
                              java.lang.String... profiles)

getBooleanValue

public java.lang.Boolean getBooleanValue(java.lang.String key,
                                java.lang.String... profiles)

setValue

public void setValue(java.lang.String key,
            java.lang.String value)

Sets default value.

setValue

public void setValue(java.lang.String key,
            java.lang.String value,
            java.lang.String profile)

Sets value on some profile.

extractProps

public void extractProps(java.util.Map target)

Extracts props belonging to active profiles.

extractProps

public void extractProps(java.util.Map target,
                java.lang.String... profiles)

Extract props of given profiles.

extractSubProps

public void extractSubProps(java.util.Map target,
                   java.lang.String... wildcardPatterns)

Extracts subset of properties that matches given wildcards.

extractSubProps

public void extractSubProps(java.util.Map target,
                   java.lang.String[] profiles,
                   java.lang.String[] wildcardPatterns)

Extracts subset of properties that matches given wildcards.

innerMap

public java.util.Map<java.lang.String,java.lang.Object> innerMap(java.lang.String prefix)

Returns inner map from the props with given prefix. Keys in returned map will not have the prefix.

addInnerMap

public void addInnerMap(java.lang.String prefix,
               java.util.Map<?,?> map)

Adds child map to the props on given prefix.

addInnerMap

public void addInnerMap(java.lang.String prefix,
               java.util.Map<?,?> map,
               java.lang.String profile)

Adds child map to the props on given prefix.

initialize

protected void initialize()

Initializes props. By default it only resolves active profiles.

resolveActiveProfiles

protected void resolveActiveProfiles()

Resolves active profiles from special property. This property can be only a base property! If default active property is not defined, nothing happens. Otherwise, it will replace currently active profiles.

getAllProfiles

public java.lang.String[] getAllProfiles()

Returns all profiles names.

getProfilesFor

public java.lang.String[] getProfilesFor(java.lang.String propKeyNameWildcard)

Returns all the profiles that define certain prop's key name. Key name is given as a wildcard, or it can be matched fully.

entries

public PropsEntries entries()

Returns builder for entries itertor.

iterator

public java.util.Iterator<PropsEntry> iterator()

Returns iterator for active profiles.