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
-
-
Field Summary
Fields Modifier and Type Field Description private static java.util.List<ThreadLocalCharsetDecoder>
decoders
private static long
serialVersionUID
-
Constructor Summary
Constructors Constructor Description UTF8Properties()
UTF8Properties(java.util.Properties p)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description private java.lang.String
decode(byte[] buffer)
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
-
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
decoders
private static final java.util.List<ThreadLocalCharsetDecoder> decoders
-
-
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
-
decode
private java.lang.String decode(byte[] buffer) throws java.io.IOException
- 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.
-
-