xyz.maow.jproperties

Class JProperties

java.lang.Object

xyz.maow.jproperties.JProperties

public final class JProperties
extends java.lang.Object

The JProperties class provides an up-to-date way to parse Java properties files.

Java's standard library includes the Properties by default, and it is used by most applications that require working with properties files, but this class is outdated for a large number of reasons.

• Usage of the pre-JCF Hashtable class, of which has been superseded by ConcurrentHashMap, the latter is a much more efficient, up-to-date class.
• Lack of concurrency control, there is no way to access a Properties in a non-concurrent way, which may be useful for efficiency if the properties are only accessed by one thread.
• Limited input options, one can only create a Properties from a InputStream or Reader, which makes code more verbose.
• Insistence on XML, the only alternative readers/writers supported by Properties are Properties.loadFromXML(InputStream) and Properties.storeToXML(java.io.OutputStream, java.lang.String), while JProperties offers a way to declare converters to and from other formats, such as XML.
• As Properties extends Hashtable and was never retrofitted for generics, it technically extends Hashtable<Object, Object>, which means that the designers of the class had to make type-safety work using the Properties.setProperty(java.lang.String, java.lang.String) and Properties.getProperty(java.lang.String) methods, making the get and set overridden from Hashtable redundant.

A major solution for all of these problems is just to use Map as opposed to a custom Hashtable implementation, and so this class provides utility methods for converting Maps with standard Converter implementations.

Since:

1.0.0

See Also:

Converters

Method Summary

Modifier and Type	Method and Description
static java.util.Map<java.lang.String,java.lang.String>	from(byte[] bytes)
static java.util.Map<java.lang.String,java.lang.String>	from(java.io.File file)
static java.util.Map<java.lang.String,java.lang.String>	from(java.io.InputStream stream)
static java.util.Map<java.lang.String,java.lang.String>	from(java.nio.file.Path path)
static java.util.Map<java.lang.String,java.lang.String>	from(java.util.Properties props)
static java.util.Map<java.lang.String,java.lang.String>	from(java.lang.String s)
static java.util.Map<java.lang.String,java.lang.String>	fromConcurrent(byte[] bytes)
static java.util.Map<java.lang.String,java.lang.String>	fromConcurrent(java.io.File file)
static java.util.Map<java.lang.String,java.lang.String>	fromConcurrent(java.io.InputStream stream)
static java.util.Map<java.lang.String,java.lang.String>	fromConcurrent(java.nio.file.Path path)
static java.util.Map<java.lang.String,java.lang.String>	fromConcurrent(java.util.Properties props)
static java.util.Map<java.lang.String,java.lang.String>	fromConcurrent(java.lang.String s)
static java.util.Map<java.lang.String,java.lang.String>	fromResource(java.lang.String name)
static java.util.Map<java.lang.String,java.lang.String>	fromResourceConcurrent(java.lang.String name)

Methods inherited from class java.lang.Object

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

Method Detail

from

public static java.util.Map<java.lang.String,java.lang.String> from(java.io.InputStream stream)

from

public static java.util.Map<java.lang.String,java.lang.String> from(java.io.File file)

from

public static java.util.Map<java.lang.String,java.lang.String> from(java.nio.file.Path path)

from

public static java.util.Map<java.lang.String,java.lang.String> from(byte[] bytes)

from

public static java.util.Map<java.lang.String,java.lang.String> from(java.lang.String s)

from

public static java.util.Map<java.lang.String,java.lang.String> from(java.util.Properties props)

fromConcurrent

public static java.util.Map<java.lang.String,java.lang.String> fromConcurrent(java.io.InputStream stream)

fromConcurrent

public static java.util.Map<java.lang.String,java.lang.String> fromConcurrent(java.io.File file)

fromConcurrent

public static java.util.Map<java.lang.String,java.lang.String> fromConcurrent(java.nio.file.Path path)

fromConcurrent

public static java.util.Map<java.lang.String,java.lang.String> fromConcurrent(byte[] bytes)

fromConcurrent

public static java.util.Map<java.lang.String,java.lang.String> fromConcurrent(java.lang.String s)

fromConcurrent

public static java.util.Map<java.lang.String,java.lang.String> fromConcurrent(java.util.Properties props)

fromResource

public static java.util.Map<java.lang.String,java.lang.String> fromResource(java.lang.String name)

fromResourceConcurrent

public static java.util.Map<java.lang.String,java.lang.String> fromResourceConcurrent(java.lang.String name)