Module org.refcodes.properties
Package org.refcodes.properties

Interface ResourceProperties.MutableResoureProperties

    • Nested Class Summary

      • Nested classes/interfaces inherited from interface org.refcodes.mixin.AnnotatorAccessor

        org.refcodes.mixin.AnnotatorAccessor.AnnotatorBuilder<B extends org.refcodes.mixin.AnnotatorAccessor.AnnotatorBuilder<B>>, org.refcodes.mixin.AnnotatorAccessor.AnnotatorMutator, org.refcodes.mixin.AnnotatorAccessor.AnnotatorProperty

      • Nested classes/interfaces inherited from interface org.refcodes.struct.CanonicalMap

        org.refcodes.struct.CanonicalMap.CanonicalMapBuilder, org.refcodes.struct.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.struct.Dictionary

        org.refcodes.struct.Dictionary.MutableDictionary<K extends Object,​V extends Object>

      • Nested classes/interfaces inherited from interface org.refcodes.struct.Dictionary.MutableDictionary

        org.refcodes.struct.Dictionary.MutableDictionary.DictionaryBuilder<K extends Object,​V extends Object,​B extends org.refcodes.struct.Dictionary.MutableDictionary.DictionaryBuilder<K,​V,​B>>

      • Nested classes/interfaces inherited from interface org.refcodes.mixin.EmptyAccessor

        org.refcodes.mixin.EmptyAccessor.EmptyMutator, org.refcodes.mixin.EmptyAccessor.EmptyProperty

      • 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.struct.InterOperableMap

        org.refcodes.struct.InterOperableMap.InterOperableMapBuilder<T extends Object>, org.refcodes.struct.InterOperableMap.MutableInterOperableMap<T extends Object>

      • Nested classes/interfaces inherited from interface org.refcodes.struct.Keys

        org.refcodes.struct.Keys.MutableKeys<K extends Object,​V extends Object>, org.refcodes.struct.Keys.MutableValues<K extends Object,​V extends Object>

      • Nested classes/interfaces inherited from interface org.refcodes.struct.PathMap

        org.refcodes.struct.PathMap.MutablePathMap<T extends Object>, org.refcodes.struct.PathMap.PathMapBuilder<T extends Object>

      • Nested classes/interfaces inherited from interface org.refcodes.mixin.TypeAccessor

        org.refcodes.mixin.TypeAccessor.TypeBuilder<T extends Object,​B extends org.refcodes.mixin.TypeAccessor.TypeBuilder<T,​B>>, org.refcodes.mixin.TypeAccessor.TypeMutator<T extends Object>, org.refcodes.mixin.TypeAccessor.TypeProperty<T extends Object>

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static String DEFAULT_COMMENT  

      • Fields inherited from interface org.refcodes.struct.PathMap

        ANNOTATOR, DELIMITER

    • Method Summary

      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and Type Method Description
      default File fileTo​(File aFile)
      Files (writes) the properties to the given File.
      default File fileTo​(File aFile, char aDelimiter)
      Files (writes) the properties to the given File using the provided delimiter as the destination's path delimiter.
      default File fileTo​(File aFile, String aComment)
      Files (writes) the properties to the given File.
      default File fileTo​(File aFile, String aComment, char aDelimiter)
      Files (writes) the properties to the given File using the provided delimiter as the destination's path delimiter.
      default File fileTo​(String aFilePath)
      Files (writes) the properties to the given File.
      default File fileTo​(String aFilePath, char aDelimiter)
      Files (writes) the properties to the given File using the provided delimiter as the destination's path delimiter.
      default File fileTo​(String aFilePath, String aComment)
      Files (writes) the properties to the File represented by the given file path.
      default File fileTo​(String aFilePath, String aComment, char aDelimiter)
      Files (writes) the properties to the File represented by the given file path using the provided delimiter as the destination's path delimiter.
      void flush()
      Flushes ResourceProperties.MutableResoureProperties to the resource to which the ResourceProperties are attached to (such as a File as of loadFrom(File) or saveTo(File)).
      default Properties loadFrom​(File aFile)
      Loads the properties from the given File.
      Properties loadFrom​(File aFile, char... aDelimiters)
      Loads the properties from the given File.
      default Properties loadFrom​(InputStream aInputStream)
      Loads the properties from the given InputStream.
      Properties loadFrom​(InputStream aInputStream, char... aDelimiters)
      Loads the properties from the given InputStream.
      default Properties loadFrom​(Class<?> aResourceClass, String aFilePath)
      Loads the properties from the given class resource (from inside a JAR).
      default Properties loadFrom​(Class<?> aResourceClass, String aFilePath, char... aDelimiters)
      Loads the properties from the given class resource (from inside a JAR).
      default Properties loadFrom​(String aFilePath)
      Loads the properties from the given file path's File.
      default Properties loadFrom​(String aFilePath, char... aDelimiters)
      Loads the properties from the given file path's File.
      default Properties loadFrom​(URL aUrl)
      Loads the properties from the given URL.
      default Properties loadFrom​(URL aUrl, char... aDelimiters)
      Loads the properties from the given URL.
      default void parseFrom​(String aSerialized)
      Inspects the given serialized representation and adds all declared elements found.
      default void parseFrom​(String aSerialized, char... aDelimiters)
      Inspects the given serialized representation and adds all declared elements found.
      default File saveTo​(File aFile)
      Saves the properties to the given File.
      default File saveTo​(File aFile, char aDelimiter)
      Saves the properties to the given File using the provided delimiter as the destination's path delimiter.
      default File saveTo​(File aFile, String aComment)
      Saves the properties to the given File.
      File saveTo​(File aFile, String aComment, char aDelimiter)
      Saves the properties to the given File using the provided delimiter as the destination's path delimiter.
      default void saveTo​(OutputStream aOutputStream)
      Saves the properties to the given OutputStream.
      default void saveTo​(OutputStream aOutputStream, char aDelimiter)
      Saves the properties to the given OutputStream.
      default void saveTo​(OutputStream aOutputStream, String aComment)
      Saves the properties to the given OutputStream.
      void saveTo​(OutputStream aOutputStream, String aComment, char aDelimiter)
      Saves the properties to the given OutputStream using the provided delimiter as the destination's path delimiter.
      default File saveTo​(String aFilePath)
      Saves the properties to the given File.
      default File saveTo​(String aFilePath, char aDelimiter)
      Saves the properties to the given File using the provided delimiter as the destination's path delimiter.
      default File saveTo​(String aFilePath, String aComment)
      Saves the properties to the File represented by the given file path.
      default File saveTo​(String aFilePath, String aComment, char aDelimiter)
      Saves the properties to the File represented by the given file path using the provided delimiter as the destination's path delimiter.
      default Properties seekFrom​(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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed).
      default Properties seekFrom​(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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed).
      default Properties seekFrom​(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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed).
      default Properties seekFrom​(Class<?> aResourceClass, 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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed).
      default Properties seekFrom​(Class<?> aResourceClass, 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 ConfigLocator.ALL configuration.
      Properties seekFrom​(Class<?> aResourceClass, 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 ConfigLocator configuration passed.
      default Properties seekFrom​(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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed).
      default Properties seekFrom​(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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed).
      default Properties seekFrom​(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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed).
      default String toSerialized​(String aComment, 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.struct.CanonicalMap

        asArray, asArray, asArray, asArray, asBooleanArray, asBooleanArray, asBooleanArray, asBooleanArray, asByteArray, asByteArray, asByteArray, asByteArray, asCharArray, asCharArray, asCharArray, asCharArray, asDoubleArray, asDoubleArray, asDoubleArray, asDoubleArray, asFloatArray, asFloatArray, asFloatArray, asFloatArray, asIntArray, asIntArray, asIntArray, asIntArray, asLongArray, asLongArray, asLongArray, asLongArray, asShortArray, asShortArray, asShortArray, asShortArray, queryBetween, toMap, toProperties

      • Methods inherited from interface org.refcodes.struct.CanonicalMap.MutableCanonicalMap

        insert, insertBetween, insertFrom, insertTo, put, put, put, put, putAll, removeFrom, toDump

      • Methods inherited from interface org.refcodes.mixin.Clearable

        clear

      • Methods inherited from interface org.refcodes.struct.Containable

        size

      • Methods inherited from interface org.refcodes.mixin.Dumpable

        toDump, toPrintable

      • Methods inherited from interface org.refcodes.mixin.EmptyAccessor

        isEmpty

      • Methods inherited from interface org.refcodes.component.Flushable

        flushUnchecked, isFlushable

      • Methods inherited from interface org.refcodes.struct.InterOperableMap

        getBoolean, getBoolean, getBoolean, getBoolean, getBoolean, getBooleanOr, getBooleanOr, getBooleanOr, getBooleanOr, getBooleanOr, getByte, getByte, getByte, getByte, getByte, getByteOr, getByteOr, getByteOr, getByteOr, getByteOr, getChar, getChar, getChar, getChar, getChar, getCharOr, getCharOr, getCharOr, getCharOr, getCharOr, getClass, getClass, getClass, getClass, getClass, getClassOr, getClassOr, getClassOr, getClassOr, getClassOr, getDouble, getDouble, getDouble, getDouble, getDouble, getDoubleOr, getDoubleOr, getDoubleOr, getDoubleOr, getDoubleOr, getEnum, getEnum, getEnum, getEnum, getEnum, getEnumOr, getEnumOr, getEnumOr, getEnumOr, getEnumOr, getEnumOr, getEnumOr, getEnumOr, getEnumOr, getEnumOr, getFloat, getFloat, getFloat, getFloat, getFloat, getFloatOr, getFloatOr, getFloatOr, getFloatOr, getFloatOr, getInt, getInt, getInt, getInt, getInt, getIntOr, getIntOr, getIntOr, getIntOr, getIntOr, getLong, getLong, getLong, getLong, getLong, getLongOr, getLongOr, getLongOr, getLongOr, getLongOr, getShort, getShort, getShort, getShort, getShort, getShortOr, getShortOr, getShortOr, getShortOr, getShortOr, getString, getString, getString, getString, getString, getStringOr, getStringOr, getStringOr, getStringOr, getStringOr

      • Methods inherited from interface org.refcodes.struct.InterOperableMap.MutableInterOperableMap

        insert, insertBetween, insertFrom, insertTo, putBoolean, putBoolean, putBoolean, putBoolean, putBoolean, putByte, putByte, putByte, putByte, putByte, putChar, putChar, putChar, putChar, putChar, putClass, putClass, putClass, putClass, putClass, putDouble, putDouble, putDouble, putDouble, putDouble, putEnum, putEnum, putEnum, putEnum, putEnum, putFloat, putFloat, putFloat, putFloat, putFloat, putInt, putInt, putInt, putInt, putInt, putLong, putLong, putLong, putLong, putLong, putShort, putShort, putShort, putShort, putShort, putString, putString, putString, putString, putString

      • Methods inherited from interface org.refcodes.struct.Keys

        containsKey, get, getOr, keySet, use, values

      • Methods inherited from interface org.refcodes.struct.Keys.MutableValues

        put

      • Methods inherited from interface org.refcodes.struct.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, getArrayOr, getArrayOr, getArrayOr, getArrayOr, getArrayOr, 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, hasSubDirs, hasSubDirs, hasSubDirs, hasSubDirs, hasValue, hasValue, hasValue, hasValue, hasValue, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, isArray, isArray, isArray, isArray, isArray, isArray, isChild, isChild, isChild, isChild, isDir, isDir, isDir, isDir, isDir, isEqualTo, isIndexDir, isIndexDir, isIndexDir, isIndexDir, isIndexDir, isLeaf, isLeaf, isLeaf, isLeaf, isLeaf, isRootPath, keySet, keySet, keySet, keySet, 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, queryPaths, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, toDataStructure, toDataStructure, toExternalPath, toInstance, toInstance, toLeaf, toMap, toNormalizedPath, toParentPath, toPath, toPath, toPath, toPath, toPathElements, toPathList, toPathStack, toPropertyPath, toType, toType, toType, toType, toType, toType, toType, toType

      • Methods inherited from interface org.refcodes.struct.PathMap.MutablePathMap

        add, add, add, add, add, add, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendDirTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, appendValueTo, delete, 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, putValueAt, remove, remove, remove, removeValueAt, removeValueAt, removeValueAt, removeValueAt, removeValueAt, toSourceCode, toSourceCode

    • Field Detail

      • DEFAULT_COMMENT

        static final String DEFAULT_COMMENT

    • Method Detail

      • fileTo

        default File fileTo​(File aFile)
             throws IOException
        Files (writes) the properties to the given File. The properties are filed to the first folder detected by the method ConfigLocator.getFolders(File...). Load them via seekFrom(File). The default implementation uses the hook method fileTo(File, String, char) to finally format and write the properties.
        Parameters:
        aFile - The File from which to load the properties.
        Returns:
        The File representing the actual location where the properties have been saved to.
        Throws:
        IOException - thrown in case saving the properties failed

      • fileTo

        default File fileTo​(File aFile,
                    char aDelimiter)
             throws IOException
        Files (writes) the properties to the given File using the provided delimiter as the destination's path delimiter. The properties are filed to the first folder detected by the method ConfigLocator.getFolders(File...). Load them via seekFrom(File, char...). The default implementation uses the hook method fileTo(File, String, char) to finally format and write the properties.
        Parameters:
        aFile - The File 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:
        IOException - thrown in case saving the properties failed

      • fileTo

        default File fileTo​(File aFile,
                    String aComment)
             throws IOException
        Files (writes) the properties to the given File. The properties are filed to the first folder detected by the method ConfigLocator.getFolders(File...). Load them via seekFrom(File). The default implementation uses the hook method fileTo(File, String, char) to finally format and write the properties.
        Parameters:
        aFile - The File 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:
        IOException - thrown in case saving the properties failed

      • fileTo

        default File fileTo​(File aFile,
                    String aComment,
                    char aDelimiter)
             throws IOException
        Files (writes) the properties to the given File using the provided delimiter as the destination's path delimiter. The properties are filed to the first folder detected by the method ConfigLocator.getFolders(File...). Load them via seekFrom(File, char...).
        Parameters:
        aFile - The File 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:
        IOException - thrown in case saving the properties failed

      • fileTo

        default File fileTo​(String aFilePath)
             throws IOException
        Files (writes) the properties to the given File. The properties are filed to the first folder detected by the method ConfigLocator.getFolders(File...). Load them via seekFrom(File) The default implementation uses the hook method fileTo(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:
        IOException - thrown in case saving the properties failed

      • fileTo

        default File fileTo​(String aFilePath,
                    char aDelimiter)
             throws IOException
        Files (writes) the properties to the given File using the provided delimiter as the destination's path delimiter. The properties are filed to the first folder detected by the method ConfigLocator.getFolders(File...). Load them via seekFrom(String, char...) The default implementation uses the hook method fileTo(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:
        IOException - thrown in case saving the properties failed

      • fileTo

        default File fileTo​(String aFilePath,
                    String aComment)
             throws IOException
        Files (writes) the properties to the File represented by the given file path. The properties are filed to the first folder detected by the method ConfigLocator.getFolders(File...). Load them via seekFrom(String). The default implementation uses the hook method fileTo(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:
        IOException - thrown in case saving the properties failed

      • fileTo

        default File fileTo​(String aFilePath,
                    String aComment,
                    char aDelimiter)
             throws IOException
        Files (writes) the properties to the File 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 method ConfigLocator.getFolders(File...). Load them via seekFrom(File, char...). The default implementation uses the hook method fileTo(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:
        IOException - thrown in case saving the properties failed

      • loadFrom

        default Properties loadFrom​(Class<?> aResourceClass,
                            String aFilePath)
                     throws IOException,
                            ParseException
        Loads the properties from the given class resource (from inside a JAR). The default implementation uses the hook method loadFrom(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:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • loadFrom

        default Properties loadFrom​(Class<?> aResourceClass,
                            String aFilePath,
                            char... aDelimiters)
                     throws IOException,
                            ParseException
        Loads the properties from the given class resource (from inside a JAR). The default implementation uses the hook method loadFrom(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:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • loadFrom

        Properties loadFrom​(File aFile,
                    char... aDelimiters)
             throws IOException,
                    ParseException
        Loads the properties from the given File. Save them using the method saveTo(File). The default implementation uses the hook method loadFrom(InputStream, char...) to finally load and parse the properties.
        Parameters:
        aFile - The File 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:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • loadFrom

        Properties loadFrom​(InputStream aInputStream,
                    char... aDelimiters)
             throws IOException,
                    ParseException
        Loads the properties from the given InputStream. Save them using the method 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.
        Parameters:
        aInputStream - 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).
        Returns:
        The Properties as loaded from the resource and applied to this instance.
        Throws:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • loadFrom

        default Properties loadFrom​(String aFilePath)
                     throws IOException,
                            ParseException
        Loads the properties from the given file path's File. Save them using the method saveTo(String). The default implementation uses the hook method loadFrom(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:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded..

      • loadFrom

        default Properties loadFrom​(String aFilePath,
                            char... aDelimiters)
                     throws IOException,
                            ParseException
        Loads the properties from the given file path's File. Save them using the method saveTo(String, char). The default implementation uses the hook method loadFrom(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:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • loadFrom

        default Properties loadFrom​(URL aUrl)
                     throws IOException,
                            ParseException
        Loads the properties from the given URL. The default implementation uses the hook method loadFrom(InputStream, char...) to finally load and parse the properties.
        Parameters:
        aUrl - The URL from which to load the properties.
        Returns:
        The Properties as loaded from the resource and applied to this instance.
        Throws:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • loadFrom

        default Properties loadFrom​(URL aUrl,
                            char... aDelimiters)
                     throws IOException,
                            ParseException
        Loads the properties from the given URL. The default implementation uses the hook method loadFrom(InputStream, char...) to finally load and parse the properties.
        Parameters:
        aUrl - The URL 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:
        IOException - thrown in case loading the properties failed
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • parseFrom

        default void parseFrom​(String aSerialized)
                throws ParseException
        Inspects the given serialized representation and adds all declared elements found. Unmarshaled 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). The default implementation uses the hook method loadFrom(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:
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • parseFrom

        default void parseFrom​(String aSerialized,
                       char... aDelimiters)
                throws ParseException
        Inspects the given serialized representation and adds all declared elements found. Unmarshaled 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). The default implementation uses the hook method loadFrom(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:
        ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

      • saveTo

        default File saveTo​(File aFile)
             throws IOException
        Saves the properties to the given File. Load them via loadFrom(File). The default implementation uses the hook method saveTo(OutputStream, String, char) to finally format and write the properties.
        Parameters:
        aFile - The File from which to load the properties.
        Returns:
        The File representing the actual location where the properties have been saved to.
        Throws:
        IOException - thrown in case saving the properties failed

      • saveTo

        default File saveTo​(File aFile,
                    char aDelimiter)
             throws IOException
        Saves the properties to the given File using the provided delimiter as the destination's path delimiter. Load them via loadFrom(File, char...). The default implementation uses the hook method saveTo(OutputStream, String, char) to finally format and write the properties.
        Parameters:
        aFile - The File 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:
        IOException - thrown in case saving the properties failed

      • saveTo

        default File saveTo​(File aFile,
                    String aComment)
             throws IOException
        Saves the properties to the given File. Load them via loadFrom(File). The default implementation uses the hook method saveTo(OutputStream, String, char) to finally format and write the properties.
        Parameters:
        aFile - The File 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:
        IOException - thrown in case saving the properties failed

      • saveTo

        File saveTo​(File aFile,
            String aComment,
            char aDelimiter)
     throws IOException
        Saves the properties to the given File using the provided delimiter as the destination's path delimiter. Load them via loadFrom(File, char...). The default implementation uses the hook method saveTo(OutputStream, String, char) to finally format and write the properties.
        Parameters:
        aFile - The File 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:
        IOException - thrown in case saving the properties failed

      • saveTo

        default void saveTo​(OutputStream aOutputStream,
                    char aDelimiter)
             throws IOException
        Saves the properties to the given OutputStream. Load them via loadFrom(InputStream, char...). The default implementation uses the hook method saveTo(OutputStream, String, char) to finally format and write the properties.
        Parameters:
        aOutputStream - the OutputStream 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:
        IOException - thrown in case saving the properties failed

      • saveTo

        void saveTo​(OutputStream aOutputStream,
            String aComment,
            char aDelimiter)
     throws IOException
        Saves the properties to the given OutputStream using the provided delimiter as the destination's path delimiter. Load them via 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.
        Parameters:
        aOutputStream - 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).
        Throws:
        IOException - thrown in case saving the properties failed

      • saveTo

        default File saveTo​(String aFilePath)
             throws IOException
        Saves the properties to the given File. Load them via loadFrom(File) The default implementation uses the hook method saveTo(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:
        IOException - thrown in case saving the properties failed

      • saveTo

        default File saveTo​(String aFilePath,
                    char aDelimiter)
             throws IOException
        Saves the properties to the given File using the provided delimiter as the destination's path delimiter. Load them via loadFrom(String, char...) The default implementation uses the hook method saveTo(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:
        IOException - thrown in case saving the properties failed

      • saveTo

        default File saveTo​(String aFilePath,
                    String aComment)
             throws IOException
        Saves the properties to the File represented by the given file path. Load them via loadFrom(String). The default implementation uses the hook method saveTo(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:
        IOException - thrown in case saving the properties failed

      • saveTo

        default File saveTo​(String aFilePath,
                    String aComment,
                    char aDelimiter)
             throws IOException
        Saves the properties to the File represented by the given file path using the provided delimiter as the destination's path delimiter. Load them via loadFrom(File, char...). The default implementation uses the hook method saveTo(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:
        IOException - thrown in case saving the properties failed

      • seekFrom

        default Properties seekFrom​(Class<?> aResourceClass,
                            String aFilePath)
                     throws IOException,
                            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 the ConfigLocator (if not provided, then ConfigLocator.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 method loadFrom(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:
        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.

      • seekFrom

        default Properties seekFrom​(Class<?> aResourceClass,
                            String aFilePath,
                            char... aDelimiters)
                     throws IOException,
                            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 ConfigLocator.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 method loadFrom(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:
        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.

      • seekFrom

        Properties seekFrom​(Class<?> aResourceClass,
                    String aFilePath,
                    org.refcodes.runtime.ConfigLocator aConfigLocator,
                    char... aDelimiters)
             throws IOException,
                    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 ConfigLocator 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 method loadFrom(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 - The ConfigLocator 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:
        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.

      • seekFrom

        default Properties seekFrom​(File aFile)
                     throws IOException,
                            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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed). The default implementation uses the hook method loadFrom(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:
        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.

      • seekFrom

        default Properties seekFrom​(File aFile,
                            char... aDelimiters)
                     throws IOException,
                            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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed). The default implementation uses the hook method loadFrom(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:
        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.

      • seekFrom

        default Properties seekFrom​(File aFile,
                            org.refcodes.runtime.ConfigLocator aConfigLocator,
                            char... aDelimiters)
                     throws IOException,
                            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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed). The default implementation uses the hook method loadFrom(InputStream, char...) to finally load and parse the properties.
        Parameters:
        aFile - The file of the properties file to load.
        aConfigLocator - The ConfigLocator 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:
        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.

      • seekFrom

        default Properties seekFrom​(String aFilePath)
                     throws IOException,
                            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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed). The default implementation uses the hook method loadFrom(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:
        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.

      • seekFrom

        default Properties seekFrom​(String aFilePath,
                            char... aDelimiters)
                     throws IOException,
                            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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed). The default implementation uses the hook method loadFrom(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:
        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.

      • seekFrom

        default Properties seekFrom​(String aFilePath,
                            org.refcodes.runtime.ConfigLocator aConfigLocator,
                            char... aDelimiters)
                     throws IOException,
                            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 the ConfigLocator (if not provided, then ConfigLocator.ALL is assumed). The default implementation uses the hook method loadFrom(InputStream, char...) to finally load and parse the properties.
        Parameters:
        aFilePath - The file path from which to load the properties.
        aConfigLocator - The ConfigLocator 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:
        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.

      • toSerialized

        default String toSerialized​(String aComment,
                            char aDelimiter)
        Produces the external representation of the properties as of the serialized format supported by the implementing class.
        Specified by:
        toSerialized in interface ResourceProperties
        Parameters:
        aComment - The comment to be used.
        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.