jodd.props.Props Maven / Gradle / Ivy
// Copyright (c) 2003-2014, Jodd Team (jodd.org). All Rights Reserved.
package jodd.props;
import jodd.io.FastCharArrayWriter;
import jodd.io.FileNameUtil;
import jodd.io.FileUtil;
import jodd.io.StreamUtil;
import jodd.typeconverter.Convert;
import jodd.util.StringPool;
import jodd.util.StringUtil;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.Writer;
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;
}
/**
* Defines if macros should be resolved using active profiles.
*/
public void setUseActiveProfilesWhenResolvingMacros(boolean useActiveProfilesWhenResolvingMacros) {
data.useActiveProfilesWhenResolvingMacros = useActiveProfilesWhenResolvingMacros;
}
// ---------------------------------------------------------------- load
/**
* 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);
}
/**
* 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);
}
// ---------------------------------------------------------------- props
/**
* 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);
}
/**
* 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);
}
// ---------------------------------------------------------------- put
/**
* 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);
}
/**
* Sets default value.
*/
public void setValue(final String key, final String value) {
setValue(key, value, null);
}
// ---------------------------------------------------------------- extract
/**
* 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 base props (no profiles).
*/
public void extractBaseProps(final Map target) {
extractProps(target, null);
}
/**
* Extracts props belonging to active profiles.
*/
public void extractProps(final Map target) {
initialize();
data.extract(target, activeProfiles, null);
}
/**
* Extract props of given profiles.
*/
public void extractProps(final Map target, final String... profiles) {
initialize();
data.extract(target, profiles, null);
}
public void extractBaseSubProps(final Map target, final String... wildcardPatterns) {
initialize();
data.extract(target, null, wildcardPatterns);
}
public void extractSubProps(final Map target, final String... wildcardPatterns) {
initialize();
data.extract(target, activeProfiles, wildcardPatterns);
}
// ---------------------------------------------------------------- initialize
public void extractSubProps(final Map target, final String[] profiles, final String[] wildcardPatterns) {
initialize();
data.extract(target, profiles, wildcardPatterns);
}
/**
* Initializes props by replacing macros in values with the lookup values.
*/
protected void initialize() {
if (initialized == false) {
synchronized (this) {
if (initialized == false) {
resolveActiveProfiles();
data.resolveMacros(activeProfiles);
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 = Convert.toStringArray(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 {@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();
}
}