jodd.props.Props Maven / Gradle / Ivy
Show all versions of jodd-all Show documentation
// Copyright (c) 2003-present, Jodd Team (http://jodd.org)
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// 1. Redistributions of source code must retain the above copyright notice,
// this list of conditions and the following disclaimer.
//
// 2. Redistributions in binary form must reproduce the above copyright
// notice, this list of conditions and the following disclaimer in the
// documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
package jodd.props;
import jodd.io.FastCharArrayWriter;
import jodd.io.FileNameUtil;
import jodd.io.FileUtil;
import jodd.io.StreamUtil;
import jodd.util.StringPool;
import jodd.util.StringUtil;
import jodd.util.Wildcard;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.Writer;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Map;
import java.util.Properties;
/**
* 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.
*
*/
public class Props implements Cloneable {
private static final String DEFAULT_PROFILES_PROP = "@profiles";
protected final PropsParser parser;
protected final PropsData data;
protected String activeProfilesProp = DEFAULT_PROFILES_PROP;
protected String[] activeProfiles;
protected volatile boolean initialized;
/**
* Creates new props.
*/
public Props() {
this(new PropsParser());
}
protected Props(final PropsParser parser) {
this.parser = parser;
this.data = parser.getPropsData();
}
/**
* Clones props by creating new instance and copying current configuration.
*/
@Override
protected Props clone() {
final PropsParser parser = this.parser.clone();
final Props p = new Props(parser);
p.activeProfilesProp = activeProfilesProp;
return p;
}
/**
* Returns active profiles or null if none defined.
*/
public String[] getActiveProfiles() {
initialize();
return activeProfiles;
}
// ---------------------------------------------------------------- configuration
/**
* 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).
*/
public void setActiveProfiles(final String... activeProfiles) {
initialized = false;
this.activeProfiles = activeProfiles;
}
/**
* Specifies the new line string when EOL is escaped.
* Default value is an empty string.
*/
public void setEscapeNewLineValue(final String escapeNewLineValue) {
parser.escapeNewLineValue = escapeNewLineValue;
}
/**
* Specifies should the values be trimmed from the left.
* Default is true.
*/
public void setValueTrimLeft(final boolean valueTrimLeft) {
parser.valueTrimLeft = valueTrimLeft;
}
/**
* Specifies should the values be trimmed from the right.
* Default is true.
*/
public void setValueTrimRight(final boolean valueTrimRight) {
parser.valueTrimRight = valueTrimRight;
}
/**
* Defines if the prefix whitespaces should be ignored when value is split into the lines.
*/
public void setIgnorePrefixWhitespacesOnNewLine(final boolean ignorePrefixWhitespacesOnNewLine) {
parser.ignorePrefixWhitespacesOnNewLine = ignorePrefixWhitespacesOnNewLine;
}
/**
* Skips empty properties as they don't exist.
*/
public void setSkipEmptyProps(final boolean skipEmptyProps) {
parser.skipEmptyProps = skipEmptyProps;
data.skipEmptyProps = skipEmptyProps;
}
/**
* Appends duplicate props.
*/
public void setAppendDuplicateProps(final boolean appendDuplicateProps) {
data.appendDuplicateProps = appendDuplicateProps;
}
/**
* Ignore missing macros by replacing them with an empty string.
*/
public void setIgnoreMissingMacros(boolean ignoreMissingMacros) {
data.ignoreMissingMacros = ignoreMissingMacros;
}
/**
* Enables multiline values.
*/
public void setMultilineValues(final boolean multilineValues) {
parser.multilineValues = multilineValues;
}
/**
* Parses input string and loads provided properties map.
*/
protected synchronized void parse(final String data) {
initialized = false;
parser.parse(data);
}
// ---------------------------------------------------------------- load
/**
* Loads props from the string.
*/
public void load(final String data) {
parse(data);
}
/**
* Loads props from the file. Assumes UTF8 encoding unless
* the file ends with '.properties', than it uses ISO 8859-1.
*/
public void load(final File file) throws IOException {
final String extension = FileNameUtil.getExtension(file.getAbsolutePath());
final String data;
if (extension.equalsIgnoreCase("properties")) {
data = FileUtil.readString(file, StringPool.ISO_8859_1);
} else {
data = FileUtil.readString(file);
}
parse(data);
}
/**
* Loads properties from the file in provided encoding.
*/
public void load(final File file, final String encoding) throws IOException {
parse(FileUtil.readString(file, encoding));
}
/**
* Loads properties from input stream. Stream is not closed at the end.
*/
public void load(final InputStream in) throws IOException {
final Writer out = new FastCharArrayWriter();
StreamUtil.copy(in, out);
parse(out.toString());
}
/**
* Loads properties from input stream and provided encoding.
* Stream is not closed at the end.
*/
public void load(final InputStream in, final String encoding) throws IOException {
final Writer out = new FastCharArrayWriter();
StreamUtil.copy(in, out, encoding);
parse(out.toString());
}
/**
* Loads base properties from the provided java properties.
* Null values are ignored.
*/
public void load(final Map p) {
for (final Map.Entry entry : p.entrySet()) {
final String name = entry.getKey().toString();
final Object value = entry.getValue();
if (value == null) {
continue;
}
data.putBaseProperty(name, value.toString(), false);
}
}
/**
* Loads base properties from java Map using provided prefix.
* Null values are ignored.
*/
@SuppressWarnings("unchecked")
public void load(final Map map, final String prefix) {
String realPrefix = prefix;
realPrefix += '.';
for (final Map.Entry entry : map.entrySet()) {
final String name = entry.getKey().toString();
final Object value = entry.getValue();
if (value == null) {
continue;
}
data.putBaseProperty(realPrefix + name, value.toString(), false);
}
}
/**
* Loads system properties with given prefix.
* If prefix is null it will not be ignored.
*/
public void loadSystemProperties(final String prefix) {
final Properties environmentProperties = System.getProperties();
load(environmentProperties, prefix);
}
/**
* Loads environment properties with given prefix.
* If prefix is null it will not be used.
*/
public void loadEnvironment(final String prefix) {
final Map environmentMap = System.getenv();
load(environmentMap, prefix);
}
// ---------------------------------------------------------------- props
/**
* Counts the total number of properties, including all profiles.
* This operation performs calculation each time and it might be
* more time consuming then expected.
*/
public int countTotalProperties() {
return data.countBaseProperties() + data.countProfileProperties();
}
/**
* Returns string value of base property.
* Returns null if property doesn't exist.
*/
@SuppressWarnings({"NullArgumentToVariableArgMethod"})
public String getBaseValue(final String key) {
return getValue(key, null);
}
/**
* Returns value of property, using active profiles.
*/
public String getValue(final String key) {
initialize();
return data.lookupValue(key, activeProfiles);
}
public Integer getIntegerValue(final String key) {
String value = getValue(key);
if (value == null) {
return null;
}
return Integer.valueOf(value);
}
public Long getLongValue(final String key) {
String value = getValue(key);
if (value == null) {
return null;
}
return Long.valueOf(value);
}
public Double getDoubleValue(final String key) {
String value = getValue(key);
if (value == null) {
return null;
}
return Double.valueOf(value);
}
public Boolean getBooleanValue(final String key) {
String value = getValue(key);
if (value == null) {
return null;
}
return Boolean.valueOf(value);
}
/**
* 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.
*/
public String getValue(final String key, final String... profiles) {
initialize();
return data.lookupValue(key, profiles);
}
public Integer getIntegerValue(final String key, final String... profiles) {
String value = getValue(key, profiles);
if (value == null) {
return null;
}
return Integer.valueOf(value);
}
public Long getLongValue(final String key, final String... profiles) {
String value = getValue(key, profiles);
if (value == null) {
return null;
}
return Long.valueOf(value);
}
public Double getDoubleValue(final String key, final String... profiles) {
String value = getValue(key, profiles);
if (value == null) {
return null;
}
return Double.valueOf(value);
}
public Boolean getBooleanValue(final String key, final String... profiles) {
String value = getValue(key, profiles);
if (value == null) {
return null;
}
return Boolean.valueOf(value);
}
/**
* Sets default value.
*/
public void setValue(final String key, final String value) {
setValue(key, value, null);
}
/**
* Sets value on some profile.
*/
public void setValue(final String key, final String value, final String profile) {
if (profile == null) {
data.putBaseProperty(key, value, false);
} else {
data.putProfileProperty(key, value, profile, false);
}
initialized = false;
}
// ---------------------------------------------------------------- extract
/**
* Extracts props belonging to active profiles.
*/
public void extractProps(final Map target) {
initialize();
data.extract(target, activeProfiles, null, null);
}
/**
* Extract props of given profiles.
*/
public void extractProps(final Map target, final String... profiles) {
initialize();
data.extract(target, profiles, null, null);
}
/**
* Extracts subset of properties that matches given wildcards.
*/
public void extractSubProps(final Map target, final String... wildcardPatterns) {
initialize();
data.extract(target, activeProfiles, wildcardPatterns, null);
}
/**
* Extracts subset of properties that matches given wildcards.
*/
public void extractSubProps(final Map target, final String[] profiles, final String[] wildcardPatterns) {
initialize();
data.extract(target, profiles, wildcardPatterns, null);
}
// ---------------------------------------------------------------- childMap
/**
* Returns inner map from the props with given prefix. Keys in returned map
* will not have the prefix.
*/
@SuppressWarnings("unchecked")
public Map innerMap(String prefix) {
initialize();
return data.extract(null, activeProfiles, null, prefix);
}
/**
* Adds child map to the props on given prefix.
*/
public void addInnerMap(String prefix, Map map) {
addInnerMap(prefix, map, null);
}
/**
* Adds child map to the props on given prefix.
*/
public void addInnerMap(String prefix, Map map, String profile) {
if (!StringUtil.endsWithChar(prefix, '.')) {
prefix += StringPool.DOT;
}
for (Map.Entry entry : map.entrySet()) {
String key = entry.getKey().toString();
key = prefix + key;
setValue(key, entry.getValue().toString(), profile);
}
}
// ---------------------------------------------------------------- initialize
/**
* Initializes props. By default it only resolves active profiles.
*/
protected void initialize() {
if (!initialized) {
synchronized (this) {
if (!initialized) {
resolveActiveProfiles();
initialized = true;
}
}
}
}
/**
* 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.
*/
protected void resolveActiveProfiles() {
if (activeProfilesProp == null) {
activeProfiles = null;
return;
}
final PropsEntry pv = data.getBaseProperty(activeProfilesProp);
if (pv == null) {
// no active profile set as the property, exit
return;
}
final String value = pv.getValue();
if (StringUtil.isBlank(value)) {
activeProfiles = null;
return;
}
activeProfiles = StringUtil.splitc(value, ',');
StringUtil.trimAll(activeProfiles);
}
// ---------------------------------------------------------------- iterator
/**
* Returns all profiles names.
*/
public String[] getAllProfiles() {
String[] profiles = new String[data.profileProperties.size()];
int index = 0;
for (String profileName : data.profileProperties.keySet()) {
profiles[index] = profileName;
index++;
}
return profiles;
}
/**
* Returns all the profiles that define certain prop's key name.
* Key name is given as a wildcard, or it can be matched fully.
*/
public String[] getProfilesFor(String propKeyNameWildcard) {
HashSet profiles = new HashSet<>();
profile:
for (Map.Entry> entries : data.profileProperties.entrySet()) {
String profileName = entries.getKey();
Map value = entries.getValue();
for (String propKeyName : value.keySet()) {
if (Wildcard.equalsOrMatch(propKeyName, propKeyNameWildcard)) {
profiles.add(profileName);
continue profile;
}
}
}
return profiles.toArray(new String[profiles.size()]);
}
/**
* Returns {@link PropsEntries builder} for entries {@link #iterator() itertor}.
*/
public PropsEntries entries() {
initialize();
return new PropsEntries(this);
}
/**
* Returns iterator for active profiles.
*/
public Iterator iterator() {
return entries().activeProfiles().iterator();
}
}