public class JsonPropertiesBuilder extends AbstractResourcePropertiesBuilder implements ResourceProperties.ResourcePropertiesBuilder
ResourceProperties.ResourcePropertiesBuilder interface with
support of so called "JSON properties" (or just "properties").
For JSON, see "https://en.wikipedia.org/wiki/JSON".AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>ResourceProperties.MutableResoureProperties, ResourceProperties.ResourcePropertiesBuilderProperties.MutableProperties, Properties.PropertiesBuilderorg.refcodes.structure.CanonicalMap.CanonicalMapBuilder, org.refcodes.structure.CanonicalMap.MutableCanonicalMaporg.refcodes.structure.PropertiesAccessorMixin.PropertiesBuilderMixin<T>, org.refcodes.structure.PropertiesAccessorMixin.PropertiesMixin, org.refcodes.structure.PropertiesAccessorMixin.PropertiesMutatorMixinorg.refcodes.structure.PathMap.MutablePathMap<T>, org.refcodes.structure.PathMap.PathMapBuilder<T>org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B extends org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B>>, org.refcodes.mixin.DelimiterAccessor.DelimiterMutator, org.refcodes.mixin.DelimiterAccessor.DelimiterPropertyorg.refcodes.mixin.TypeAccessor.TypeMutator<T>, org.refcodes.mixin.TypeAccessor.TypeProperty<T>org.refcodes.structure.Dictionary.MutableDictionary.DictionaryBuilder<K,V,B extends org.refcodes.structure.Dictionary.MutableDictionary.DictionaryBuilder<K,V,B>>_propertiesFileDEFAULT_COMMENT| Constructor and Description |
|---|
JsonPropertiesBuilder()
Create an empty
JsonPropertiesBuilder instance using the
default path delimiter "/" (Delimiter.PATH) for the path
declarations. |
JsonPropertiesBuilder(Class<?> aResourceClass,
String aFilePath)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(Class<?> aResourceClass,
String aFilePath,
boolean isSeekFile)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(Class<?> aResourceClass,
String aFilePath,
boolean isSeekFile,
char... aDelimiters)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(Class<?> aResourceClass,
String aFilePath,
char... aDelimiters)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(File aFile)
Loads the JSON properties from the given
File. |
JsonPropertiesBuilder(File aFile,
boolean isSeekFile)
Loads or seeks the JSON properties from the given
File. |
JsonPropertiesBuilder(File aFile,
boolean isSeekFile,
char... aDelimiters)
Loads or seeks the JSON properties from the given
File. |
JsonPropertiesBuilder(File aFile,
char... aDelimiters)
Loads the JSON properties from the given
File. |
JsonPropertiesBuilder(InputStream aInputStream)
Reads the JSON properties from the given
InputStream. |
JsonPropertiesBuilder(InputStream aInputStream,
char... aDelimiters)
Reads the JSON properties from the given
InputStream. |
JsonPropertiesBuilder(Map<?,?> aProperties)
Create a
JsonPropertiesBuilder instance containing the
elements of the provided Map instance using the default path
delimiter "/" (Delimiter.PATH) for the path declarations |
JsonPropertiesBuilder(Object aObj)
Create a
JsonPropertiesBuilder instance containing the
elements as of MutablePathMap#insert(Object) using the default
path delimiter "/" (Delimiter.PATH) for the path declarations:
"Inspects the given object and adds all elements found in the given
object. |
JsonPropertiesBuilder(Properties.PropertiesBuilder aProperties)
Create a
JsonPropertiesBuilder instance containing the
elements of the provided PropertiesBuilder instance using the
default path delimiter "/" (Delimiter.PATH) for the path
declarations |
JsonPropertiesBuilder(Properties aProperties)
Create a
JsonPropertiesBuilder instance containing the
elements of the provided Properties instance using the default
path delimiter "/" (Delimiter.PATH) for the path declarations |
JsonPropertiesBuilder(String aFilePath)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(String aFilePath,
boolean isSeekFile)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(String aFilePath,
boolean isSeekFile,
char... aDelimiters)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(String aFilePath,
char... aDelimiters)
Loads the JSON properties from the given file's path.
|
JsonPropertiesBuilder(URL aUrl)
Loads the JSON properties from the given
URL. |
JsonPropertiesBuilder(URL aUrl,
char... aDelimiters)
Loads the JSON properties from the given
URL. |
| Modifier and Type | Method and Description |
|---|---|
Properties |
loadFrom(InputStream aInputStream,
char... aDelimiters)
Loads the properties from the given
InputStream. |
void |
saveTo(OutputStream aOutputStream,
String aComment,
char aDelimiter)
The comment is ignored for the JSON format as JSON does not(!)
|
flush, isFlushable, loadFrom, reload, reload, saveTo, seekFromchildrenOf, retrieveFrom, retrieveTocompute, computeIfAbsent, computeIfPresent, containsKey, get, getDelimiter, getOrDefault, getType, merge, put, putIfAbsent, remove, remove, replace, replace, toDataStructureclear, clone, containsValue, entrySet, forEach, isEmpty, keySet, putAll, replaceAll, size, valuesequals, hashCode, toStringfinalize, getClass, notify, notifyAll, wait, wait, waitwithInsert, withInsert, withInsertFrom, withInsertTo, withLoadFrom, withLoadFrom, withLoadFrom, withLoadFrom, withLoadFrom, withLoadFrom, withLoadFrom, withLoadFrom, withLoadFrom, withLoadFrom, withPut, withPut, withPutBoolean, withPutByte, withPutDouble, withPutFloat, withPutInteger, withPutLong, withPutShort, withRemoveFrom, withSeekFrom, withSeekFrom, withSeekFrom, withSeekFrom, withSeekFrom, withSeekFromwithInsert, withInsert, withInsertFrom, withInsertTowithInsert, withInsert, withInsertFrom, withInsertTowithInsert, withInsert, withInsertFrom, withInsertTowithPutput, put, putBoolean, putBoolean, putByte, putByte, putDouble, putDouble, putFloat, putFloat, putInteger, putInteger, putLong, putLong, putShort, putShortflush, loadFrom, loadFrom, loadFrom, loadFrom, loadFrom, loadFrom, loadFrom, loadFrom, loadFrom, parseFrom, parseFrom, seekFrom, seekFrom, seekFrom, seekFrom, seekFrom, seekFromfileTo, fileTo, fileTo, fileTo, fileTo, fileTo, fileTo, fileTo, reload, reload, saveTo, saveTo, saveTo, saveTo, saveTo, saveTo, saveTo, saveTo, saveTo, saveTo, saveTo, toSerialized, toSerializedcontainsValue, delete, delete, insert, insert, insertFrom, insertTo, put, putAll, putAll, putAllchildrenOf, getType, retrieve, retrieveFrom, retrieveTo, toMap, toProperties, toPropertyPathinsert, insert, insertFrom, insertTo, putAll, toDump, toSourceCode, toSourceCodetoInstance, toInstance, toType, toTypecontainsKey, get, getBoolean, getBoolean, getByte, getByte, getCharacter, getCharacter, getDouble, getDouble, getFloat, getFloat, getInteger, getInteger, getLong, getLong, getShort, getShort, use, useBoolean, useBoolean, useByte, useByte, useDouble, useDouble, useFloat, useFloat, useInteger, useInteger, useLong, useLong, useShort, useShortinsert, insert, insert, insert, insertFrom, insertFrom, insertTo, insertTo, put, putArray, putArray, removeAlldirectories, directories, entries, entries, fromExternalKey, getArray, getArray, hasParentPath, isArray, isArray, isDirectory, isEntry, isRecord, isRootPath, keySet, paths, paths, records, records, toDataStructure, toDataStructure, toExternalKey, toMap, toNormalizedPath, toNormalizedPath, toParentPath, toPath, toRootPathpublic JsonPropertiesBuilder()
JsonPropertiesBuilder instance using the
default path delimiter "/" (Delimiter.PATH) for the path
declarations.public JsonPropertiesBuilder(Object aObj)
JsonPropertiesBuilder instance containing the
elements as of MutablePathMap#insert(Object) using the default
path delimiter "/" (Delimiter.PATH) for the path declarations:
"Inspects the given object and adds all elements found in the given
object. Elements of type Map, Collection and arrays are
identified and handled as of their type: The path for each value in a
Map is appended with its according key. The path for each value
in a Collection or array is appended with its according index of
occurrence (in case of a List or an array, its actual index). In
case of reflection, the path for each member is appended with its
according mamber's name. All elements (e.g. the members and values) are
inspected recursively which results in the according paths of the
terminating values."aObj - The object from which the elements are to be added.public JsonPropertiesBuilder(Properties aProperties)
JsonPropertiesBuilder instance containing the
elements of the provided Properties instance using the default
path delimiter "/" (Delimiter.PATH) for the path declarationsaProperties - the properties to be added.public JsonPropertiesBuilder(Properties.PropertiesBuilder aProperties)
JsonPropertiesBuilder instance containing the
elements of the provided PropertiesBuilder instance using the
default path delimiter "/" (Delimiter.PATH) for the path
declarationsaProperties - the properties to be added.public JsonPropertiesBuilder(Map<?,?> aProperties)
JsonPropertiesBuilder instance containing the
elements of the provided Map instance using the default path
delimiter "/" (Delimiter.PATH) for the path declarationsaProperties - the properties to be added.public JsonPropertiesBuilder(File aFile) throws IOException, ParseException
File.aFile - The File from which to load the properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(File aFile, char... aDelimiters) throws IOException, ParseException
File.aFile - The File from which to load the properties.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(File aFile, boolean isSeekFile) throws IOException, ParseException
File.
In case you enable the "seek" argument and directly loading from the
File does not succeed, then loads from the first folder
containing such a file as of the specification for the method
RuntimeUtility.toConfigDirs().aFile - The File from which to load the properties.isSeekFile - When true, then the properties are loaded as of the
"seek" functionality described above.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(File aFile, boolean isSeekFile, char... aDelimiters) throws IOException, ParseException
File.
In case you enable the "seek" argument and directly loading from the
File does not succeed, then loads from the first folder
containing such a file as of the specification for the method
RuntimeUtility.toConfigDirs().aFile - The File from which to load the properties.isSeekFile - When true, then the properties are loaded as of the
"seek" functionality described above.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(String aFilePath) throws IOException, ParseException
aFilePath - The path to the file from which to load the properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(String aFilePath, char... aDelimiters) throws IOException, ParseException
aFilePath - The path to the file from which to load the properties.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(Class<?> aResourceClass, String aFilePath) throws IOException, ParseException
aResourceClass - The class which's class loader is to take care of
loading the properties (from inside a JAR).aFilePath - The file path of the class's resources from which to
load the properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(Class<?> aResourceClass, String aFilePath, char... aDelimiters) throws IOException, ParseException
aResourceClass - The class which's class loader is to take care of
loading the properties (from inside a JAR).aFilePath - The file path of the class's resources from which to
load the properties.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(String aFilePath, boolean isSeekFile) throws IOException, ParseException
File does not succeed, then loads from the first folder
containing such a file as of the specification for the method
RuntimeUtility.toConfigDirs().aFilePath - The path to the file from which to load the properties.isSeekFile - When true, then the properties are loaded as of the
"seek" functionality described above.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(String aFilePath, boolean isSeekFile, char... aDelimiters) throws IOException, ParseException
File does not succeed, then loads from the first folder
containing such a file as of the specification for the method
RuntimeUtility.toConfigDirs().aFilePath - The path to the file from which to load the properties.isSeekFile - When true, then the properties are loaded as of the
"seek" functionality described above.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(Class<?> aResourceClass, String aFilePath, boolean isSeekFile) throws IOException, ParseException
File does not succeed, then loads from the first folder
containing such a file as of the specification for the method
RuntimeUtility.toConfigDirs().
Finally (if nothing else succeeds) the properties are loaded by the
provided class's class loader which takes care of loading the properties
(in case the file path is a relative path, also the absolute path with a
prefixed path delimiter "/" is probed).aResourceClass - The class which's class loader is to take care of
loading the properties (from inside a JAR).aFilePath - The file path of the class's resources from which to
load the properties.isSeekFile - When true, then the properties are loaded as of the
"seek" functionality described above.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(Class<?> aResourceClass, String aFilePath, boolean isSeekFile, char... aDelimiters) throws IOException, ParseException
File does not succeed, then loads from the first folder
containing such a file as of the specification for the method
RuntimeUtility.toConfigDirs().
Finally (if nothing else succeeds) the properties are loaded by the
provided class's class loader which takes care of loading the properties
(in case the file path is a relative path, also the absolute path with a
prefixed path delimiter "/" is probed). *aResourceClass - The class which's class loader is to take care of
loading the properties (from inside a JAR).aFilePath - The file path of the class's resources from which to
load the properties.isSeekFile - When true, then the properties are loaded as of the
"seek" functionality described above.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(URL aUrl) throws IOException, ParseException
URL.aUrl - The URL from which to read the properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(URL aUrl, char... aDelimiters) throws IOException, ParseException
URL.aUrl - The URL from which to read the properties.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(InputStream aInputStream) throws IOException, ParseException
InputStream.aInputStream - The InputStream from which to read the
properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public JsonPropertiesBuilder(InputStream aInputStream, char... aDelimiters) throws IOException, ParseException
InputStream.aInputStream - The InputStream from which to read the
properties.aDelimiters - The path delimiters to be used when parsing the
source's properties.IOException - thrown in case accessing or processing the properties
file failed.ParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public Properties loadFrom(InputStream aInputStream, char... aDelimiters) throws IOException, ParseException
InputStream. Save them
using the method ResourceProperties.saveTo(OutputStream).
This is the hook-method of the default implementation for loading the
properties. In case you want to implement ResourceProperties
which support other notations than the properties notation
(path=value), then you overwrite this method in your
implementation accordingly.loadFrom in interface ResourceProperties.MutableResourePropertiesaInputStream - The InputStream from which to load the
properties.aDelimiters - The path delimiters to be used when parsing the
source's properties (in case the the serialized format
supports / requires the such).Properties as loaded from the resource and
applied to this instance.IOException - thrown in case loading the properties failedParseException - Signals that an error has been reached
unexpectedly while parsing the data to be loaded.public void saveTo(OutputStream aOutputStream, String aComment, char aDelimiter) throws IOException
OutputStream using the provided
delimiter as the destination's path delimiter. Load them via
ResourceProperties.MutableResoureProperties.loadFrom(InputStream, char...)
This is the hook-method of the default implementation for writing
(saving) the properties. In case you want to implement
ResourceProperties which support other notations than the
properties notation (path=value), then you overwrite this
method in your implementation accordingly.saveTo in interface ResourcePropertiesaOutputStream - The OutputStream to which to save the
properties to.aComment - The description for the properties file.aDelimiter - The path delimiter to be used when writing out the
properties to the destination (in case the the serialized format
supports / requires the such).IOException - thrown in case saving the properties failedCopyright © 2018. All rights reserved.