Package org.refcodes.configuration
Interface ResourcePropertiesMixin<B extends ResourcePropertiesMixin<B>>
-
public interface ResourcePropertiesMixin<B extends ResourcePropertiesMixin<B>>
This mixin provides builder additions (as of the builder pattern for chained configuring method calls) for "dynamic"ResourceProperties
: AsResourceProperties
are immutable from an interface's point of view, there are no mutating methods provided. Sub-types of theResourceProperties
might need to load the properties after instantiation. Such types might implement this interface, providing means to load from resources after instantiation.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default B
withFile(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 methodConfigLocator.getFolders()
.default B
withFile(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 methodConfigLocator.getFolders()
.default B
withFile(java.io.File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator)
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 methodConfigLocator.getFolders()
.B
withFile(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 methodConfigLocator.getFolders()
.default B
withFilePath(java.lang.Class<?> aResourceClass, java.lang.String aFilePath)
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 methodConfigLocator.getFolders()
.default B
withFilePath(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, 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 methodConfigLocator.getFolders()
.B
withFilePath(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, 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 methodConfigLocator.getFolders()
.default B
withFilePath(java.lang.String aFilePath)
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 methodConfigLocator.getFolders()
.default B
withFilePath(java.lang.String aFilePath, 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 methodConfigLocator.getFolders()
.default B
withFilePath(java.lang.String aFilePath, 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 methodConfigLocator.getFolders()
.default B
withInputStream(java.io.InputStream aInputStream)
Reads the properties from the givenInputStream
.B
withInputStream(java.io.InputStream aInputStream, char... aDelimiters)
Reads the properties from the givenInputStream
.default B
withUrl(java.net.URL aUrl)
Loads the properties from the givenURL
.B
withUrl(java.net.URL aUrl, char... aDelimiters)
Loads the properties from the givenURL
.
-
-
-
Method Detail
-
withFile
default B withFile(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 methodConfigLocator.getFolders()
.- Parameters:
aFile
- The file of the properties to load.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFile
default B withFile(java.io.File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator) 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 methodConfigLocator.getFolders()
.- Parameters:
aFile
- The file of the properties to load.aConfigLocator
- TheConfigLocator
specifying where to seek for properties.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFile
default B withFile(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 methodConfigLocator.getFolders()
.- Parameters:
aFile
- The file of the properties to load.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFile
B withFile(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 methodConfigLocator.getFolders()
.- Parameters:
aFile
- The file of the properties to load.aConfigLocator
- TheConfigLocator
specifying where to seek for properties.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withInputStream
default B withInputStream(java.io.InputStream aInputStream) throws java.io.IOException, java.text.ParseException
Reads the properties from the givenInputStream
.- Parameters:
aInputStream
- TheInputStream
from which to read the properties.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withInputStream
B withInputStream(java.io.InputStream aInputStream, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Reads the properties from the givenInputStream
.- Parameters:
aInputStream
- TheInputStream
from which to read the properties.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFilePath
default B withFilePath(java.lang.String aFilePath) 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 methodConfigLocator.getFolders()
.- Parameters:
aFilePath
- The file of the properties file to load.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFilePath
default B withFilePath(java.lang.String aFilePath, 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 methodConfigLocator.getFolders()
.- Parameters:
aFilePath
- The file of the properties file to load.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFilePath
default B withFilePath(java.lang.Class<?> aResourceClass, java.lang.String aFilePath) 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 methodConfigLocator.getFolders()
.- Parameters:
aResourceClass
- The class which's class loader is to take care of loading the properties (from inside a JAR).aFilePath
- The file of the properties file to load.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFilePath
default B withFilePath(java.lang.Class<?> aResourceClass, java.lang.String aFilePath, 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 methodConfigLocator.getFolders()
.- Parameters:
aResourceClass
- The class which's class loader is to take care of loading the properties (from inside a JAR).aFilePath
- The file of the properties file to load.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFilePath
default B withFilePath(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 directly or (if not found) from first folder containing such a file as of the specification for the methodConfigLocator.getFolders()
.- Parameters:
aFilePath
- The file of the properties file to load.aConfigLocator
- TheConfigLocator
specifying where to seek for properties.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withFilePath
B withFilePath(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 directly or (if not found) from first folder containing such a file as of the specification for the methodConfigLocator.getFolders()
.- Parameters:
aResourceClass
- The class which's class loader is to take care of loading the properties (from inside a JAR).aFilePath
- The file of the properties file to load.aConfigLocator
- TheConfigLocator
specifying where to seek for properties.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withUrl
default B withUrl(java.net.URL aUrl) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenURL
.- Parameters:
aUrl
- TheURL
from which to read the properties.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
withUrl
B withUrl(java.net.URL aUrl, char... aDelimiters) throws java.io.IOException, java.text.ParseException
Loads the properties from the givenURL
.- Parameters:
aUrl
- TheURL
from which to read the properties.aDelimiters
- The delimiters in the properties file to identity a path delimiter.- Returns:
- This instance as of the builder pattern for chained method calls.
- 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.
-
-