Package aQute.lib.utf8properties
Class UTF8Properties
- java.lang.Object
-
- java.util.Dictionary<K,V>
-
- java.util.Hashtable<java.lang.Object,java.lang.Object>
-
- java.util.Properties
-
- aQute.lib.utf8properties.UTF8Properties
-
- All Implemented Interfaces:
java.io.Serializable
,java.lang.Cloneable
,java.util.Map<java.lang.Object,java.lang.Object>
public class UTF8Properties extends java.util.Properties
Properties were by default read as ISO-8859-1 characters. However, in the last 10 years most builds use UTF-8. Since this is in general a global setting, it is very awkward to use ISO-8859-1. In general, it is not often a problem since most of Java is written with the basic ASCII encoding. However, we want to do this right. So in bnd we generally use this UTF-8 Properties class. This class always writes UTF-8. However, it will try to read UTF-8 first. If this fails, it will try ISO-8859-1, and the last attempt is the platform default.This class can (and probably should) be used anywhere a Properties class is used.
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description UTF8Properties()
UTF8Properties(java.util.Properties p)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
load(java.io.File file, Reporter reporter)
void
load(java.io.InputStream in)
void
load(java.io.InputStream in, java.io.File file, Reporter reporter)
void
load(java.io.Reader r)
void
load(java.lang.String source, java.io.File file, Reporter reporter)
UTF8Properties
replaceAll(java.lang.String pattern, java.lang.String replacement)
Replace a string in all the values.void
store(java.io.OutputStream out)
void
store(java.io.OutputStream out, java.lang.String msg)
void
store(java.io.Writer out, java.lang.String msg)
-
Methods inherited from class java.util.Properties
clear, clone, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, forEach, get, getOrDefault, getProperty, getProperty, hashCode, isEmpty, keys, keySet, list, list, loadFromXML, merge, propertyNames, put, putAll, putIfAbsent, rehash, remove, remove, replace, replace, replaceAll, save, setProperty, size, storeToXML, storeToXML, storeToXML, stringPropertyNames, toString, values
-
-
-
-
Method Detail
-
load
public void load(java.io.InputStream in, java.io.File file, Reporter reporter) throws java.io.IOException
- Throws:
java.io.IOException
-
load
public void load(java.lang.String source, java.io.File file, Reporter reporter) throws java.io.IOException
- Throws:
java.io.IOException
-
load
public void load(java.io.File file, Reporter reporter) throws java.lang.Exception
- Throws:
java.lang.Exception
-
load
public void load(java.io.InputStream in) throws java.io.IOException
- Overrides:
load
in classjava.util.Properties
- Throws:
java.io.IOException
-
load
public void load(java.io.Reader r) throws java.io.IOException
- Overrides:
load
in classjava.util.Properties
- Throws:
java.io.IOException
-
store
public void store(java.io.OutputStream out, java.lang.String msg) throws java.io.IOException
- Overrides:
store
in classjava.util.Properties
- Throws:
java.io.IOException
-
store
public void store(java.io.Writer out, java.lang.String msg) throws java.io.IOException
- Overrides:
store
in classjava.util.Properties
- Throws:
java.io.IOException
-
store
public void store(java.io.OutputStream out) throws java.io.IOException
- Throws:
java.io.IOException
-
replaceAll
public UTF8Properties replaceAll(java.lang.String pattern, java.lang.String replacement)
Replace a string in all the values. This can be used to preassign variables that change. For example, the base directory ${.} for a loaded properties.- Returns:
- A new UTF8Properties with the replacement.
-
-