Package org.refcodes.configuration
Interface ResourceProperties.MutableResoureProperties
-
- All Superinterfaces:
org.refcodes.structure.CanonicalMap
,org.refcodes.structure.CanonicalMap.MutableCanonicalMap
,org.refcodes.structure.Clearable
,org.refcodes.structure.Containable
,org.refcodes.mixin.DelimiterAccessor
,org.refcodes.structure.Dictionary<java.lang.String,T>
,org.refcodes.structure.Dictionary.MutableDictionary<java.lang.String,T>
,org.refcodes.mixin.Dumpable
,java.io.Flushable
,org.refcodes.component.Flushable
,org.refcodes.structure.Keys<java.lang.String,T>
,org.refcodes.structure.Keys.MutableKeys<java.lang.String,T>
,org.refcodes.structure.Keys.MutableValues<java.lang.String,T>
,java.util.Map<java.lang.String,T>
,org.refcodes.structure.PathMap<java.lang.String>
,org.refcodes.structure.PathMap.MutablePathMap<java.lang.String>
,Properties
,Properties.MutableProperties
,org.refcodes.structure.PropertiesAccessorMixin
,org.refcodes.structure.PropertiesAccessorMixin.PropertiesMutatorMixin
,ResourceProperties
,org.refcodes.mixin.TypeAccessor<java.lang.String>
- All Known Subinterfaces:
ResourceProperties.ResourcePropertiesBuilder
,ScheduledResourceProperties.ScheduledMuableResourceProperties
,ScheduledResourceProperties.ScheduledResourcePropertiesBuilder
- All Known Implementing Classes:
AbstractResourcePropertiesBuilder
,AbstractResourcePropertiesBuilderDecorator
,JavaPropertiesBuilder
,JsonPropertiesBuilder
,PolyglotPropertiesBuilder
,ScheduledResourcePropertiesBuilderDecorator
,TomlPropertiesBuilder
,XmlPropertiesBuilder
,YamlPropertiesBuilder
- Enclosing interface:
- ResourceProperties
public static interface ResourceProperties.MutableResoureProperties extends ResourceProperties, Properties.MutableProperties, org.refcodes.component.Flushable
The interfaceResourceProperties.MutableResoureProperties
defines "dirty" methods allowing to modify ("mutate") theResourceProperties
.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.refcodes.structure.CanonicalMap
org.refcodes.structure.CanonicalMap.CanonicalMapBuilder, org.refcodes.structure.CanonicalMap.MutableCanonicalMap
-
Nested classes/interfaces inherited from interface org.refcodes.mixin.DelimiterAccessor
org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B extends org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B>>, org.refcodes.mixin.DelimiterAccessor.DelimiterMutator, org.refcodes.mixin.DelimiterAccessor.DelimiterProperty
-
Nested classes/interfaces inherited from interface org.refcodes.structure.Dictionary
org.refcodes.structure.Dictionary.MutableDictionary<K extends java.lang.Object,V extends java.lang.Object>
-
Nested classes/interfaces inherited from interface org.refcodes.structure.Dictionary.MutableDictionary
org.refcodes.structure.Dictionary.MutableDictionary.DictionaryBuilder<K extends java.lang.Object,V extends java.lang.Object,B extends org.refcodes.structure.Dictionary.MutableDictionary.DictionaryBuilder<K,V,B>>
-
Nested classes/interfaces inherited from interface org.refcodes.component.Flushable
org.refcodes.component.Flushable.FlushBuilder<B extends org.refcodes.component.Flushable.FlushBuilder<B>>
-
Nested classes/interfaces inherited from interface org.refcodes.structure.Keys
org.refcodes.structure.Keys.MutableKeys<K extends java.lang.Object,V extends java.lang.Object>, org.refcodes.structure.Keys.MutableValues<K extends java.lang.Object,V extends java.lang.Object>
-
Nested classes/interfaces inherited from interface java.util.Map
java.util.Map.Entry<K extends java.lang.Object,V extends java.lang.Object>
-
Nested classes/interfaces inherited from interface org.refcodes.structure.PathMap
org.refcodes.structure.PathMap.MutablePathMap<T extends java.lang.Object>, org.refcodes.structure.PathMap.PathMapBuilder<T extends java.lang.Object>
-
Nested classes/interfaces inherited from interface org.refcodes.configuration.Properties
Properties.MutableProperties, Properties.PropertiesBuilder
-
Nested classes/interfaces inherited from interface org.refcodes.structure.PropertiesAccessorMixin
org.refcodes.structure.PropertiesAccessorMixin.PropertiesBuilderMixin<T extends java.lang.Object>, org.refcodes.structure.PropertiesAccessorMixin.PropertiesMixin, org.refcodes.structure.PropertiesAccessorMixin.PropertiesMutatorMixin
-
Nested classes/interfaces inherited from interface org.refcodes.configuration.ResourceProperties
ResourceProperties.MutableResoureProperties, ResourceProperties.ResourcePropertiesBuilder
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
DEFAULT_COMMENT
-
Fields inherited from interface org.refcodes.configuration.ResourceProperties
VALUE_ATTRIBUTES
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default java.io.File
fileTo(java.io.File aFile)
Files (writes) the properties to the givenFile
.default java.io.File
fileTo(java.io.File aFile, char aDelimiter)
Files (writes) the properties to the givenFile
using the provided delimiter as the destination's path delimiter.default java.io.File
fileTo(java.io.File aFile, java.lang.String aComment)
Files (writes) the properties to the givenFile
.default java.io.File
fileTo(java.io.File aFile, java.lang.String aComment, char aDelimiter)
Files (writes) the properties to the givenFile
using the provided delimiter as the destination's path delimiter.default java.io.File
fileTo(java.lang.String aFilePath)
Files (writes) the properties to the givenFile
.default java.io.File
fileTo(java.lang.String aFilePath, char aDelimiter)
Files (writes) the properties to the givenFile
using the provided delimiter as the destination's path delimiter.default java.io.File
fileTo(java.lang.String aFilePath, java.lang.String aComment)
Files (writes) the properties to theFile
represented by the given file path.default java.io.File
fileTo(java.lang.String aFilePath, java.lang.String aComment, char aDelimiter)
Files (writes) the properties to theFile
represented by the given file path using the provided delimiter as the destination's path delimiter.void
flush()
FlushesResourceProperties.MutableResoureProperties
to the resource to which theResourceProperties
are attached to (such as aFile
as ofloadFrom(File)
orsaveTo(File)
).default Properties
loadFrom(java.io.File aFile)
Loads the properties from the givenFile
.Properties
loadFrom(java.io.File aFile, char... aDelimiters)
Loads the properties from the givenFile
.default Properties
loadFrom(java.io.InputStream aInputStream)
Loads the properties from the givenInputStream
.Properties
loadFrom(java.io.InputStream aInputStream, char... aDelimiters)
Loads the properties from the givenInputStream
.default Properties
loadFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath)
Loads the properties from the given class resource (from inside a JAR).default Properties
loadFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, char... aDelimiters)
Loads the properties from the given class resource (from inside a JAR).default Properties
loadFrom(java.lang.String aFilePath)
Loads the properties from the given file path'sFile
.default Properties
loadFrom(java.lang.String aFilePath, char... aDelimiters)
Loads the properties from the given file path'sFile
.default Properties
loadFrom(java.net.URL aUrl)
Loads the properties from the givenURL
.default Properties
loadFrom(java.net.URL aUrl, char... aDelimiters)
Loads the properties from the givenURL
.default void
parseFrom(java.lang.String aSerialized)
Inspects the given serialized representation and adds all declared elements found.default void
parseFrom(java.lang.String aSerialized, char... aDelimiters)
Inspects the given serialized representation and adds all declared elements found.default java.io.File
saveTo(java.io.File aFile)
Saves the properties to the givenFile
.default java.io.File
saveTo(java.io.File aFile, char aDelimiter)
Saves the properties to the givenFile
using the provided delimiter as the destination's path delimiter.default java.io.File
saveTo(java.io.File aFile, java.lang.String aComment)
Saves the properties to the givenFile
.java.io.File
saveTo(java.io.File aFile, java.lang.String aComment, char aDelimiter)
Saves the properties to the givenFile
using the provided delimiter as the destination's path delimiter.default void
saveTo(java.io.OutputStream aOutputStream)
Saves the properties to the givenOutputStream
.default void
saveTo(java.io.OutputStream aOutputStream, char aDelimiter)
Saves the properties to the givenOutputStream
.default void
saveTo(java.io.OutputStream aOutputStream, java.lang.String aComment)
Saves the properties to the givenOutputStream
.void
saveTo(java.io.OutputStream aOutputStream, java.lang.String aComment, char aDelimiter)
Saves the properties to the givenOutputStream
using the provided delimiter as the destination's path delimiter.default java.io.File
saveTo(java.lang.String aFilePath)
Saves the properties to the givenFile
.default java.io.File
saveTo(java.lang.String aFilePath, char aDelimiter)
Saves the properties to the givenFile
using the provided delimiter as the destination's path delimiter.default java.io.File
saveTo(java.lang.String aFilePath, java.lang.String aComment)
Saves the properties to theFile
represented by the given file path.default java.io.File
saveTo(java.lang.String aFilePath, java.lang.String aComment, char aDelimiter)
Saves the properties to theFile
represented by the given file path using the provided delimiter as the destination's path delimiter.default Properties
seekFrom(java.io.File aFile)
Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed).default Properties
seekFrom(java.io.File aFile, char... aDelimiters)
Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed).default Properties
seekFrom(java.io.File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters)
Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed).default Properties
seekFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath)
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed).default Properties
seekFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, char... aDelimiters)
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of theConfigLocator.ALL
configuration.Properties
seekFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters)
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of theConfigLocator
configuration passed.default Properties
seekFrom(java.lang.String aFilePath)
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed).default Properties
seekFrom(java.lang.String aFilePath, char... aDelimiters)
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed).default Properties
seekFrom(java.lang.String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters)
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed).default java.lang.String
toSerialized(char aDelimiter)
Produces the external representation of the properties as of the serialized format supported by the implementing class.-
Methods inherited from interface org.refcodes.structure.CanonicalMap
getBoolean, getBoolean, getBooleanOr, getBooleanOr, getByte, getByte, getByteOr, getByteOr, getCharacter, getCharacter, getCharacterOr, getCharacterOr, getDouble, getDouble, getDoubleOr, getDoubleOr, getFloat, getFloat, getFloatOr, getFloatOr, getInteger, getInteger, getIntegerOr, getIntegerOr, getLong, getLong, getLongOr, getLongOr, getShort, getShort, getShortOr, getShortOr, toInstance, toInstance, toMap, toProperties, toType, toType
-
Methods inherited from interface org.refcodes.structure.CanonicalMap.MutableCanonicalMap
insert, insertBetween, insertFrom, insertTo, put, put, putAll, putBoolean, putBoolean, putByte, putByte, putDouble, putDouble, putFloat, putFloat, putInteger, putInteger, putLong, putLong, putShort, putShort, removeFrom, toDump, toSourceCode, toSourceCode
-
Methods inherited from interface org.refcodes.structure.Keys
containsKey, get, getOr, keySet, use, values
-
Methods inherited from interface java.util.Map
clear, compute, computeIfAbsent, computeIfPresent, containsKey, entry, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, of, of, of, of, of, of, of, of, of, of, of, ofEntries, put, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
-
Methods inherited from interface org.refcodes.structure.PathMap
children, children, children, children, children, children, containsKey, containsKey, containsKey, dirs, dirs, dirs, dirs, dirs, dirs, findPaths, fromExternalPath, get, get, get, getArray, getArray, getArray, getArray, getArray, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayIndexes, getDirAt, getDirAt, getDirAt, getDirAt, getDirIndexes, getDirIndexes, getDirIndexes, getDirIndexes, getDirIndexes, getRootPath, getValueAt, getValueAt, getValueAt, getValueAt, getValueAt, getValueAt, hasChildren, hasChildren, hasChildren, hasChildren, hasChildren, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasParentPath, hasPath, hasPath, hasPath, hasPath, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, isArray, isArray, isArray, isArray, isArray, isArray, isArrayIndex, isArrayIndex, isArrayIndex, isArrayIndex, isArrayIndex, isArrayIndex, isChild, isChild, isChild, isChild, isDir, isDir, isDir, isDir, isDir, isDirIndex, isDirIndex, isDirIndex, isDirIndex, isDirIndex, isLeaf, isLeaf, isLeaf, isLeaf, isLeaf, isRootPath, keySet, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, leaves, leaves, leaves, leaves, leaves, leaves, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, paths, paths, paths, paths, paths, paths, queryPaths, queryPaths, queryPaths, queryPaths, queryPaths, sortedKeys, toDataStructure, toDataStructure, toExternalPath, toLeaf, toMap, toNormalizedPath, toParentPath, toPath, toPath, toPath, toPathElements, toPathList, toPathStack, toPropertyPath
-
Methods inherited from interface org.refcodes.structure.PathMap.MutablePathMap
appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, delete, delete, delete, delete, insert, insert, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertBetween, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertFrom, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, insertTo, merge, merge, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeBetween, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, mergeTo, put, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putArray, putValueAt, putValueAt, putValueAt, putValueAt, putValueAt, remove, remove, removeValueAt, removeValueAt, removeValueAt, removeValueAt, removeValueAt
-
Methods inherited from interface org.refcodes.configuration.Properties
getDelimiter, getType, query, query, query, query, queryBetween, queryBetween, queryBetween, queryBetween, queryBetween, queryFrom, queryFrom, queryFrom, queryFrom, queryFrom, queryTo, queryTo, queryTo, queryTo, queryTo, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveFrom, retrieveFrom, retrieveFrom, retrieveFrom, retrieveFrom, retrieveTo, retrieveTo, retrieveTo, retrieveTo, retrieveTo
-
Methods inherited from interface org.refcodes.configuration.Properties.MutableProperties
containsValue, delete, delete, getDirAt, getDirAt, insert, insertBetween, insertFrom, insertTo, put, putAll, putAll, putAll, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, putDirAt, removeAll, removeAll, removeAll, removeAll, removeAll, removeDirAt, removeDirAt, removeDirAt, removeDirAt, removeDirAt, removeFrom, removeFrom, removeFrom, removeFrom, removePaths, removePaths
-
Methods inherited from interface org.refcodes.structure.PropertiesAccessorMixin
asArray, asArray, asArray, asArray, asBooleanArray, asBooleanArray, asBooleanArray, asBooleanArray, asByteArray, asByteArray, asByteArray, asByteArray, asCharacterArray, asCharacterArray, asCharacterArray, asCharacterArray, asDoubleArray, asDoubleArray, asDoubleArray, asDoubleArray, asFloatArray, asFloatArray, asFloatArray, asFloatArray, asIntegerArray, asIntegerArray, asIntegerArray, asIntegerArray, asLongArray, asLongArray, asLongArray, asLongArray, asShortArray, asShortArray, asShortArray, asShortArray, getBoolean, getBoolean, getBooleanOr, getBooleanOr, getByte, getByte, getByteOr, getByteOr, getCharacter, getCharacter, getCharacterOr, getCharacterOr, getDouble, getDouble, getDoubleOr, getDoubleOr, getFloat, getFloat, getFloatOr, getFloatOr, getInteger, getInteger, getIntegerOr, getIntegerOr, getLong, getLong, getLongOr, getLongOr, getShort, getShort, getShortOr, getShortOr
-
Methods inherited from interface org.refcodes.structure.PropertiesAccessorMixin.PropertiesMutatorMixin
put, put, putBoolean, putBoolean, putByte, putByte, putDouble, putDouble, putFloat, putFloat, putInteger, putInteger, putLong, putLong, putShort, putShort
-
Methods inherited from interface org.refcodes.configuration.ResourceProperties
reload, reload, toSerialized
-
-
-
-
Method Detail
-
fileTo
default java.io.File fileTo(java.io.File aFile) throws java.io.IOException
Files (writes) the properties to the givenFile
. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(File)
. The default implementation uses the hook methodfileTo(File, String, char)
to finally format and write the properties.- Parameters:
aFile
- TheFile
from which to load the properties.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
fileTo
default java.io.File fileTo(java.io.File aFile, char aDelimiter) throws java.io.IOException
Files (writes) the properties to the givenFile
using the provided delimiter as the destination's path delimiter. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(File, char...)
. The default implementation uses the hook methodfileTo(File, String, char)
to finally format and write the properties.- Parameters:
aFile
- TheFile
from which to load the properties.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).- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
fileTo
default java.io.File fileTo(java.io.File aFile, java.lang.String aComment) throws java.io.IOException
Files (writes) the properties to the givenFile
. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(File)
. The default implementation uses the hook methodfileTo(File, String, char)
to finally format and write the properties.- Parameters:
aFile
- TheFile
from which to load the properties.aComment
- The description for the properties file.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
fileTo
default java.io.File fileTo(java.io.File aFile, java.lang.String aComment, char aDelimiter) throws java.io.IOException
Files (writes) the properties to the givenFile
using the provided delimiter as the destination's path delimiter. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(File, char...)
.- Parameters:
aFile
- TheFile
to which to file 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).- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
fileTo
default java.io.File fileTo(java.lang.String aFilePath) throws java.io.IOException
Files (writes) the properties to the givenFile
. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(File)
The default implementation uses the hook methodfileTo(String, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
fileTo
default java.io.File fileTo(java.lang.String aFilePath, char aDelimiter) throws java.io.IOException
Files (writes) the properties to the givenFile
using the provided delimiter as the destination's path delimiter. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(String, char...)
The default implementation uses the hook methodfileTo(File, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.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).- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
fileTo
default java.io.File fileTo(java.lang.String aFilePath, java.lang.String aComment) throws java.io.IOException
Files (writes) the properties to theFile
represented by the given file path. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(String)
. The default implementation uses the hook methodfileTo(File, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.aComment
- The description for the properties file.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
fileTo
default java.io.File fileTo(java.lang.String aFilePath, java.lang.String aComment, char aDelimiter) throws java.io.IOException
Files (writes) the properties to theFile
represented by the given file path using the provided delimiter as the destination's path delimiter. The properties are filed to the first folder detected by the methodConfigLocator.getFolders(File...)
. Load them viaseekFrom(File, char...)
. The default implementation uses the hook methodfileTo(File, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.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).aComment
- The description for the properties file.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
flush
void flush() throws org.refcodes.component.OpenException
FlushesResourceProperties.MutableResoureProperties
to the resource to which theResourceProperties
are attached to (such as aFile
as ofloadFrom(File)
orsaveTo(File)
).- Specified by:
flush
in interfacejava.io.Flushable
- Specified by:
flush
in interfaceorg.refcodes.component.Flushable
- Throws:
org.refcodes.component.OpenException
-
loadFrom
default Properties loadFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath) throws java.io.IOException, java.text.ParseException
Loads the properties from the given class resource (from inside a JAR). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
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.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
default Properties loadFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads the properties from the given class resource (from inside a JAR). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
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 (in case the the serialized format supports / requires the such).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
default Properties loadFrom(java.io.File aFile) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenFile
. Save them using the methodsaveTo(File)
. The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFile
- TheFile
from which to load the properties.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
Properties loadFrom(java.io.File aFile, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenFile
. Save them using the methodsaveTo(File)
. The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFile
- TheFile
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).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
default Properties loadFrom(java.io.InputStream aInputStream) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenInputStream
. Save them using the methodsaveTo(OutputStream)
. The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aInputStream
- TheInputStream
from which to load the properties.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
Properties loadFrom(java.io.InputStream aInputStream, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenInputStream
. Save them using the methodsaveTo(OutputStream)
. This is the hook-method of the default implementation for loading the properties. In case you want to implementResourceProperties
which support other notations than the properties notation (path=value
), then you overwrite this method in your implementation accordingly.- Parameters:
aInputStream
- TheInputStream
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).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
default Properties loadFrom(java.lang.String aFilePath) throws java.io.IOException, java.text.ParseException
Loads the properties from the given file path'sFile
. Save them using the methodsaveTo(String)
. The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFilePath
- The file path from which to load the properties.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded..
-
loadFrom
default Properties loadFrom(java.lang.String aFilePath, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads the properties from the given file path'sFile
. Save them using the methodsaveTo(String, char)
. The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFilePath
- The file path 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).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
default Properties loadFrom(java.net.URL aUrl) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenURL
. The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aUrl
- TheURL
from which to load the properties.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
loadFrom
default Properties loadFrom(java.net.URL aUrl, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenURL
. The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aUrl
- TheURL
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).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case loading the properties failedjava.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
parseFrom
default void parseFrom(java.lang.String aSerialized) throws java.text.ParseException
Inspects the given serialized representation and adds all declared elements found. Unmarshaled elements of typeMap
,Collection
and arrays are identified and handled as of their type: The path for each value in aMap
is appended with its according key. The path for each value in aCollection
or array is appended with its according index of occurrence (in case of aList
or an array, its actual index). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aSerialized
- The serialized representation which is to be parsed for the therein declared elements being added with their according determined paths.- Throws:
java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
parseFrom
default void parseFrom(java.lang.String aSerialized, char... aDelimiters) throws java.text.ParseException
Inspects the given serialized representation and adds all declared elements found. Unmarshaled elements of typeMap
,Collection
and arrays are identified and handled as of their type: The path for each value in aMap
is appended with its according key. The path for each value in aCollection
or array is appended with its according index of occurrence (in case of aList
or an array, its actual index). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aSerialized
- The serialized representation which is to be parsed for the therein declared elements being added with their according determined paths.aDelimiters
- The path delimiters to be used when parsing the source's properties (in case the the serialized format supports / requires the such).- Throws:
java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
saveTo
default java.io.File saveTo(java.io.File aFile) throws java.io.IOException
Saves the properties to the givenFile
. Load them vialoadFrom(File)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFile
- TheFile
from which to load the properties.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default java.io.File saveTo(java.io.File aFile, char aDelimiter) throws java.io.IOException
Saves the properties to the givenFile
using the provided delimiter as the destination's path delimiter. Load them vialoadFrom(File, char...)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFile
- TheFile
from which to load the properties.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).- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default java.io.File saveTo(java.io.File aFile, java.lang.String aComment) throws java.io.IOException
Saves the properties to the givenFile
. Load them vialoadFrom(File)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFile
- TheFile
from which to load the properties.aComment
- The description for the properties file.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
java.io.File saveTo(java.io.File aFile, java.lang.String aComment, char aDelimiter) throws java.io.IOException
Saves the properties to the givenFile
using the provided delimiter as the destination's path delimiter. Load them vialoadFrom(File, char...)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFile
- TheFile
from which to load the properties.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).- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default void saveTo(java.io.OutputStream aOutputStream) throws java.io.IOException
Saves the properties to the givenOutputStream
. Load them vialoadFrom(InputStream)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aOutputStream
- the output stream- Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default void saveTo(java.io.OutputStream aOutputStream, char aDelimiter) throws java.io.IOException
Saves the properties to the givenOutputStream
. Load them vialoadFrom(InputStream, char...)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aOutputStream
- theOutputStream
where to write the properties to.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).- Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default void saveTo(java.io.OutputStream aOutputStream, java.lang.String aComment) throws java.io.IOException
Saves the properties to the givenOutputStream
. Load them vialoadFrom(InputStream)
The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aOutputStream
- TheOutputStream
to which to save the properties to.aComment
- The description for the properties file.- Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
void saveTo(java.io.OutputStream aOutputStream, java.lang.String aComment, char aDelimiter) throws java.io.IOException
Saves the properties to the givenOutputStream
using the provided delimiter as the destination's path delimiter. Load them vialoadFrom(InputStream, char...)
This is the hook-method of the default implementation for writing (saving) the properties. In case you want to implementResourceProperties
which support other notations than the properties notation (path=value
), then you overwrite this method in your implementation accordingly.- Parameters:
aOutputStream
- TheOutputStream
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).- Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default java.io.File saveTo(java.lang.String aFilePath) throws java.io.IOException
Saves the properties to the givenFile
. Load them vialoadFrom(File)
The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default java.io.File saveTo(java.lang.String aFilePath, char aDelimiter) throws java.io.IOException
Saves the properties to the givenFile
using the provided delimiter as the destination's path delimiter. Load them vialoadFrom(String, char...)
The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.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).- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default java.io.File saveTo(java.lang.String aFilePath, java.lang.String aComment) throws java.io.IOException
Saves the properties to theFile
represented by the given file path. Load them vialoadFrom(String)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.aComment
- The description for the properties file.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
saveTo
default java.io.File saveTo(java.lang.String aFilePath, java.lang.String aComment, char aDelimiter) throws java.io.IOException
Saves the properties to theFile
represented by the given file path using the provided delimiter as the destination's path delimiter. Load them vialoadFrom(File, char...)
. The default implementation uses the hook methodsaveTo(OutputStream, String, char)
to finally format and write the properties.- Parameters:
aFilePath
- The file path from which to load the properties.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).aComment
- The description for the properties file.- Returns:
- The
File
representing the actual location where the properties have been saved to. - Throws:
java.io.IOException
- thrown in case saving the properties failed
-
seekFrom
default Properties seekFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed). 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). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aResourceClass
- The class which's class loader is to take care of loading the properties (from inside a JAR).aFilePath
- The file path from which to load the properties.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
default Properties seekFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of theConfigLocator.ALL
configuration. 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). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aResourceClass
- The class which's class loader is to take care of loading the properties (from inside a JAR).aFilePath
- The file path 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).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
Properties seekFrom(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of theConfigLocator
configuration passed. 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). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aResourceClass
- The class which's class loader is to take care of loading the properties (from inside a JAR).aFilePath
- The file path from which to load the properties.aConfigLocator
- TheConfigLocator
describes the locations to additional crawl for the desired file.aDelimiters
- The path delimiters to be used when parsing the source's properties (in case the the serialized format supports / requires the such).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
default Properties seekFrom(java.io.File aFile) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFile
- The file of the properties file to load.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
default Properties seekFrom(java.io.File aFile, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFile
- The file of the properties file to load.aDelimiters
- The path delimiters to be used when parsing the source's properties (in case the the serialized format supports / requires the such).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
default Properties seekFrom(java.io.File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFile
- The file of the properties file to load.aConfigLocator
- TheConfigLocator
describes the locations to additional crawl for the desired file.aDelimiters
- The path delimiters to be used when parsing the source's properties (in case the the serialized format supports / requires the such).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
default Properties seekFrom(java.lang.String aFilePath) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFilePath
- The file path from which to load the properties.- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
default Properties seekFrom(java.lang.String aFilePath, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFilePath
- The file path 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).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
seekFrom
default Properties seekFrom(java.lang.String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads a properties file from the file path directly or (if not found) from the first folder containing such a file as of the specification for theConfigLocator
(if not provided, thenConfigLocator.ALL
is assumed). The default implementation uses the hook methodloadFrom(InputStream, char...)
to finally load and parse the properties.- Parameters:
aFilePath
- The file path from which to load the properties.aConfigLocator
- TheConfigLocator
describes the locations to additional crawl for the desired file.aDelimiters
- The path delimiters to be used when parsing the source's properties (in case the the serialized format supports / requires the such).- Returns:
- The
Properties
as loaded from the resource and applied to this instance. - Throws:
java.io.IOException
- thrown in case accessing or processing the properties file failed.java.text.ParseException
- Signals that an error has been reached unexpectedly while parsing the data to be loaded.
-
toSerialized
default java.lang.String toSerialized(char aDelimiter)
Produces the external representation of the properties as of the serialized format supported by the implementing class.- Specified by:
toSerialized
in interfaceResourceProperties
- Parameters:
aDelimiter
- The path delimiter to be used when serializing the properties (in case the the serialized format supports / requires the such).- Returns:
- The external (serialized) representation of the properties.
-
-