Class RuntimePropertiesImpl

java.lang.Object
org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
org.refcodes.properties.ext.runtime.RuntimePropertiesImpl
All Implemented Interfaces:
org.refcodes.cli.ArgsParser, org.refcodes.cli.ArgsParserMixin<org.refcodes.cli.ArgsParser>, org.refcodes.cli.ArgsSyntaxAccessor, org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxBuilder<RuntimeProperties>, org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxMutator, org.refcodes.cli.ArgumentEscapeCodeAccessor, org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeMutator, org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeProperty, org.refcodes.cli.CliMetrics, org.refcodes.cli.LongOptionPrefixAccessor, org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixMutator, org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixProperty, org.refcodes.cli.Optionable, org.refcodes.cli.OptionEscapeCodeAccessor, org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeMutator, org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeProperty, org.refcodes.cli.ShortOptionPrefixAccessor, org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixMutator, org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixProperty, org.refcodes.cli.SyntaxMetricsAccessor, org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsMutator, org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsProperty, org.refcodes.mixin.AnnotatorAccessor, org.refcodes.mixin.DelimiterAccessor, org.refcodes.mixin.DescriptionAccessor, org.refcodes.mixin.DescriptionAccessor.DescriptionBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.mixin.DescriptionAccessor.DescriptionMutator, org.refcodes.mixin.DescriptionAccessor.DescriptionProperty, org.refcodes.mixin.Dumpable, org.refcodes.mixin.EmptyAccessor, org.refcodes.mixin.EscapeCodesStatusAccessor, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusMutator, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusProperty, org.refcodes.mixin.NameAccessor, org.refcodes.mixin.NameAccessor.NameBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.mixin.NameAccessor.NameMutator, org.refcodes.mixin.NameAccessor.NameProperty, org.refcodes.mixin.Resetable, org.refcodes.mixin.ResetEscapeCodeAccessor, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeMutator, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeProperty, org.refcodes.mixin.SecretAccessor.SecretBuilder<RuntimeProperties>, org.refcodes.mixin.SecretAccessor.SecretMutator, org.refcodes.mixin.TitleAccessor, org.refcodes.mixin.TitleAccessor.TitleBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.mixin.TitleAccessor.TitleMutator, org.refcodes.mixin.TitleAccessor.TitleProperty, org.refcodes.mixin.TypeAccessor<String>, ArgsParserProperties, ArgsParserPropertiesAccessor, RuntimeProperties, org.refcodes.properties.ProfileProperties, org.refcodes.properties.Properties, org.refcodes.properties.ResourceLoaderMixin<RuntimeProperties>, org.refcodes.properties.ResourceProperties, org.refcodes.struct.CanonicalMap, org.refcodes.struct.Containable, org.refcodes.struct.Dictionary<String,String>, org.refcodes.struct.InterOperableMap<String>, org.refcodes.struct.Keys<String,String>, org.refcodes.struct.PathMap<String>, org.refcodes.textual.TextBoxGridAccessor, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<org.refcodes.cli.ArgsParser>, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridMutator, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridProperty

public class RuntimePropertiesImpl extends org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties> implements RuntimeProperties
The RuntimePropertiesImpl composite represent command line properties, system properties as well as environment variables (in that order) and resource properties. The RuntimePropertiesImpl are actually constructed from ArgsParserProperties, SystemProperties, EnvironmentProperties and ResourceProperties instances (in that precedence). Add the ResourceProperties via the following methods RuntimeProperties.withFile(File), RuntimeProperties.withFilePath(String), RuntimeProperties.withUrl(URL) or RuntimeProperties.withInputStream(InputStream). Obfuscation may be applied to the properties as of the ObfuscationProperties and ObfuscationProperties.ObfuscationPropertiesBuilder types.
  • 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.cli.ArgsSyntaxAccessor

    org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxBuilder<B extends org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxBuilder<B>>, org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxMutator, org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxProperty

    Nested classes/interfaces inherited from interface org.refcodes.cli.ArgumentEscapeCodeAccessor

    org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<B extends org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<B>>, org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeMutator, org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeProperty

    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.mixin.DescriptionAccessor

    org.refcodes.mixin.DescriptionAccessor.DescriptionBuilder<B extends org.refcodes.mixin.DescriptionAccessor.DescriptionBuilder<B>>, org.refcodes.mixin.DescriptionAccessor.DescriptionMutator, org.refcodes.mixin.DescriptionAccessor.DescriptionProperty

    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.mixin.EmptyAccessor

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

    Nested classes/interfaces inherited from interface org.refcodes.mixin.EscapeCodesStatusAccessor

    org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusBuilder<B extends org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusBuilder<B>>, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusMutator, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusProperty

    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.cli.LongOptionPrefixAccessor

    org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixBuilder<B extends org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixBuilder<B>>, org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixMutator, org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixProperty

    Nested classes/interfaces inherited from interface org.refcodes.mixin.NameAccessor

    org.refcodes.mixin.NameAccessor.NameBuilder<B extends org.refcodes.mixin.NameAccessor.NameBuilder<B>>, org.refcodes.mixin.NameAccessor.NameMutator, org.refcodes.mixin.NameAccessor.NameProperty

    Nested classes/interfaces inherited from interface org.refcodes.cli.OptionEscapeCodeAccessor

    org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeBuilder<B extends org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeBuilder<B>>, org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeMutator, org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeProperty

    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.properties.ProfileProperties

    org.refcodes.properties.ProfileProperties.MutableProfileProperties, org.refcodes.properties.ProfileProperties.ProfilePropertiesBuilder

    Nested classes/interfaces inherited from interface org.refcodes.properties.Properties

    org.refcodes.properties.Properties.MutableProperties, org.refcodes.properties.Properties.PropertiesBuilder

    Nested classes/interfaces inherited from interface org.refcodes.mixin.ResetEscapeCodeAccessor

    org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeBuilder<B extends org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeBuilder<B>>, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeMutator, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeProperty

    Nested classes/interfaces inherited from interface org.refcodes.properties.ResourceProperties

    org.refcodes.properties.ResourceProperties.MutableResoureProperties, org.refcodes.properties.ResourceProperties.ResourcePropertiesBuilder

    Nested classes/interfaces inherited from interface org.refcodes.cli.ShortOptionPrefixAccessor

    org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<B extends org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<B>>, org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixMutator, org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixProperty

    Nested classes/interfaces inherited from interface org.refcodes.cli.SyntaxMetricsAccessor

    org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsBuilder<B extends org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsBuilder<B>>, org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsMutator, org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsProperty

    Nested classes/interfaces inherited from interface org.refcodes.textual.TextBoxGridAccessor

    org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<B extends org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<?>>, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridMutator, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridProperty

    Nested classes/interfaces inherited from interface org.refcodes.mixin.TitleAccessor

    org.refcodes.mixin.TitleAccessor.TitleBuilder<B extends org.refcodes.mixin.TitleAccessor.TitleBuilder<B>>, org.refcodes.mixin.TitleAccessor.TitleMutator, org.refcodes.mixin.TitleAccessor.TitleProperty

    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 inherited from interface org.refcodes.struct.PathMap

    ANNOTATOR, DELIMITER

    Fields inherited from interface org.refcodes.properties.Properties

    DEFAULT_COMMENT

    Fields inherited from interface org.refcodes.properties.ext.runtime.RuntimeProperties

    DELIMITERS
  • Constructor Summary

    Constructors
    Constructor
    Description
    Constructs a RuntimeProperties instance with no Condition for parsing command line arguments.
    Constructs a RuntimeProperties instance with a custom secret for obfuscation.
    Constructs a RuntimeProperties instance with no Condition for parsing command line arguments: As no syntax notation is required by the constructor (no root Condition), no syntax validation is done.
    RuntimePropertiesImpl(String[] aArgs, String aSecret)
    Constructs a RuntimeProperties instance with no Condition for parsing command line arguments: As no syntax notation is required by the constructor (no root Condition), no syntax validation is done.
    RuntimePropertiesImpl(String[] aArgs, org.refcodes.runtime.SystemContext aObfuscationMode)
    Constructs a RuntimeProperties instance with no Condition for parsing command line arguments: As no syntax notation is required by the constructor (no root Condition), no syntax validation is done.
    RuntimePropertiesImpl(org.refcodes.cli.Constituent aArgsSyntax)
    Constructs a RuntimeProperties instance with the given Condition used to parse command line arguments.
    RuntimePropertiesImpl(org.refcodes.cli.Constituent aArgsSyntax, String aSecret)
    Constructs a RuntimeProperties instance with the given Condition used to parse command line arguments.
    RuntimePropertiesImpl(org.refcodes.cli.Constituent aArgsSyntax, org.refcodes.runtime.SystemContext aObfuscationMode)
    Constructs a RuntimeProperties instance with the given Condition used to parse command line arguments.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory)
    Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String aSecret)
    Constructs a RuntimeProperties instance with a custom secret for obfuscation.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String[] aArgs)
    Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments: As no syntax notation is required by the constructor (no root args syntax Constituent node), no syntax validation is done.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String[] aArgs, String aSecret)
    Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments: As no syntax notation is required by the constructor (no root args syntax Constituent node), no syntax validation is done.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String[] aArgs, org.refcodes.runtime.SystemContext aObfuscationMode)
    Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments: As no syntax notation is required by the constructor (no args syntax Constituent node), no syntax validation is done.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.cli.Constituent aArgsSyntax)
    Constructs a RuntimeProperties instance with the given args syntax Constituent node used to parse command line arguments.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.cli.Constituent aArgsSyntax, String aSecret)
    Constructs a RuntimeProperties instance with the given args syntax Constituent node used to parse command line arguments.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.cli.Constituent aArgsSyntax, org.refcodes.runtime.SystemContext aObfuscationMode)
    Constructs a RuntimeProperties instance with the given args syntax Constituent node used to parse command line arguments.
    RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.runtime.SystemContext aObfuscationMode)
    Constructs the RuntimeProperties with the given obfuscation mode.
    RuntimePropertiesImpl(org.refcodes.runtime.SystemContext aObfuscationMode)
    Constructs the RuntimeProperties with the given obfuscation mode.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addExample(org.refcodes.cli.Example aExampleUsage)
    protected void
    addProperties(File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters)
    Reads the ResourceProperties.ResourcePropertiesBuilder from the given data sink.
    protected void
    addProperties(InputStream aInputStream, char[] aDelimiters)
    Reads the ResourceProperties from the given data sink.
    protected void
    addProperties(Class<?> aResourceClass, String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters)
    Reads the ResourceProperties.ResourcePropertiesBuilder from the given data sink.
    protected void
    addProperties(URL aUrl, char... aDelimiters)
    Reads the ResourceProperties from the given data sink.
    protected void
    addProperties(org.refcodes.properties.Properties aProperties)
    Adds the properties.
    boolean
    void
    errorLn(String aLine)
    List<? extends org.refcodes.cli.Operand<?>>
    evalArgs(String[] aArgs)
    List<? extends org.refcodes.cli.Operand<?>>
    evalArgs(String aToPath, String[] aArgs)
    List<? extends org.refcodes.cli.Operand<?>>
    evalArgs(String aToPath, List<String> aArgs)
    List<? extends org.refcodes.cli.Operand<?>>
    get(Object aKey)
    The ArgsParserProperties are those properties derived from the command line arguments (as of the getArgsSyntax()).
    org.refcodes.cli.Constituent
    char
    List<org.refcodes.cli.Example>
    protected org.refcodes.properties.Properties
    char
    org.refcodes.cli.SyntaxMetrics
    org.refcodes.textual.TextBoxGrid
    boolean
    boolean
    void
    void
    void
    void
    void
    void
    void
    void
    void
    printLn(String aLine)
    void
    void
    void
    org.refcodes.properties.Properties
    org.refcodes.properties.Properties
    reload(org.refcodes.properties.ReloadMode aReloadMode)
    void
    org.refcodes.properties.Properties
    retrieveFrom(String aFromPath)
    org.refcodes.properties.Properties
    retrieveTo(String aToPath)
    void
    setArgsSyntax(org.refcodes.cli.Constituent aArgsSyntax)
    void
    void
    setBannerBorderEscapeCode(String aBannerBorderEscCode)
    void
    setBannerEscapeCode(String aBannerEscCode)
    void
    setBannerFont(org.refcodes.textual.Font aBannerFont)
    void
    setBannerFontPalette(char[] aColorPalette)
    void
    setCommandEscapeCode(String aCommandEscCode)
    void
    setConsoleWidth(int aConsoleWidth)
    void
    setCopyrightNote(String aCopyrightNote)
    void
    setDescription(String aDescription)
    void
    setDescriptionEscapeCode(String aParamDescriptionEscCode)
    void
    void
    setEscapeCodesEnabled(boolean isEscCodeEnabled)
    void
    setLicenseNote(String aLicenseNote)
    void
    setLineBreak(String aLineBreak)
    void
    setLineSeparatorEscapeCode(String aLineSeparatorEscCode)
    void
    setLongOptionPrefix(String aLongOptionPrefix)
    void
    setMaxConsoleWidth(int aMaxConsoleWidth)
    void
    setName(String aName)
    void
    setObfuscationMode(org.refcodes.runtime.SystemContext aObfuscationMode)
    Specifies the obfuscation mode to be used.
    void
    void
    setResetEscapeCode(String aResetEscCode)
    void
    setSecret(String aSecret)
    void
    setSeparatorLnChar(char aSeparatorChar)
    void
    setShortOptionPrefix(Character aShortOptionPrefix)
    void
    void
    setSyntaxMetrics(org.refcodes.cli.SyntaxMetrics aSyntaxMetrics)
    void
    setTextBoxGrid(org.refcodes.textual.TextBoxGrid aTextBoxGrid)
    void
    setTitle(String aTitle)
    int
    org.refcodes.properties.Properties
    toRuntimeProfile(String... aProfiles)
    Returns the serialized format as of the ResourceProperties.ResourcePropertiesBuilder instance being produced upon invocation of the PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory.toProperties(Properties) method.
    toSerialized(char aDelimiter)
    Returns the serialized format as of the ResourceProperties.ResourcePropertiesBuilder instance being produced upon invocation of the PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory.toProperties(Properties) method.
    toSerialized(String aComment, char aDelimiter)
    Returns the serialized format as of the ResourceProperties.ResourcePropertiesBuilder instance being produced upon invocation of the PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory.toProperties(Properties) method.
    withFile(File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters)
    withFilePath(Class<?> aResourceClass, String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters)
    withInputStream(InputStream aInputStream, char... aDelimiters)
    withProperties(org.refcodes.properties.Properties aProperties)
    A hook for you to provide Properties programmatically.
    withUrl(URL aUrl, char... aDelimiters)

    Methods inherited from class org.refcodes.properties.AbstractPropertiesDecorator

    getAnnotator, setProperties, toDump, toDump, toPrintable

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface org.refcodes.cli.ArgsParser

    addExample, evalArgs, evalArgs, evalArgs, evalArgs, printBody, toOptions

    Methods inherited from interface org.refcodes.cli.ArgsParserMixin

    withEvalArgs, withEvalArgs, withEvalArgs, withEvalArgs

    Methods inherited from interface org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeProperty

    letArgumentEscapeCode

    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.mixin.DescriptionAccessor.DescriptionProperty

    letDescription

    Methods inherited from interface org.refcodes.mixin.Dumpable

    toDump, toDump

    Methods inherited from interface org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusProperty

    letEscapeCodesEnabled

    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.Keys

    getOr, use

    Methods inherited from interface org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixProperty

    letLongOptionPrefix

    Methods inherited from interface org.refcodes.mixin.NameAccessor.NameProperty

    letName

    Methods inherited from interface org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeProperty

    letOptionEscapeCode

    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, toExternalPath, toInstance, toInstance, toLeaf, toMap, toNormalizedPath, toParentPath, toPath, toPath, toPath, toPath, toPathElements, toPathList, toPathStack, toPrintable, toPropertyPath, toType, toType, toType, toType, toType, toType, toType, toType

    Methods inherited from interface org.refcodes.properties.ProfileProperties

    getRuntimeProfiles, getRuntimeProfilesPath, toRuntimeProfile

    Methods inherited from interface org.refcodes.properties.Properties

    containsValue, getAnnotator, getDir, getDir, getDir, getDir, getDir, getDirAt, getDirAt, getDirAt, getDirAt, getDirAt, getDirAt, getDirs, getDirs, getDirs, getDirs, getDirs, getType, query, query, query, query, query, queryBetween, queryBetween, queryBetween, queryBetween, queryBetween, queryFrom, queryFrom, queryFrom, queryFrom, queryFrom, queryFrom, queryTo, queryTo, queryTo, queryTo, queryTo, queryTo, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveFrom, retrieveFrom, retrieveFrom, retrieveFrom, retrieveTo, retrieveTo, retrieveTo, retrieveTo

    Methods inherited from interface org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeProperty

    letResetEscapeCode

    Methods inherited from interface org.refcodes.properties.ResourceLoaderMixin

    withFile, withFilePath, withFilePath, withFilePath

    Methods inherited from interface org.refcodes.properties.ResourceProperties

    toSerialized

    Methods inherited from interface org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixProperty

    letShortOptionPrefix

    Methods inherited from interface org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsProperty

    letSyntaxMetrics

    Methods inherited from interface org.refcodes.textual.TextBoxGridAccessor.TextBoxGridProperty

    letTextBoxGrid

    Methods inherited from interface org.refcodes.mixin.TitleAccessor.TitleProperty

    letTitle
  • Constructor Details

    • RuntimePropertiesImpl

      public RuntimePropertiesImpl()
      Constructs a RuntimeProperties instance with no Condition for parsing command line arguments. As no syntax notation is required by the constructor (no root Condition), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments when invoking withEvalArgs(String[]).
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.cli.Constituent aArgsSyntax)
      Constructs a RuntimeProperties instance with the given Condition used to parse command line arguments.
      Parameters:
      aArgsSyntax - The root condition being the node from which parsing the command line arguments starts. Parse the command line arguments via evalArgs(String[]).
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.cli.Constituent aArgsSyntax, String aSecret)
      Constructs a RuntimeProperties instance with the given Condition used to parse command line arguments. Also constructs a RuntimeProperties instance with a custom secret for obfuscation.
      Parameters:
      aArgsSyntax - The root condition being the node from which parsing the command line arguments starts. Parse the command line arguments via evalArgs(String[]).
      aSecret - The secret to be used when encountering upon obfuscated properties.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.cli.Constituent aArgsSyntax, org.refcodes.runtime.SystemContext aObfuscationMode)
      Constructs a RuntimeProperties instance with the given Condition used to parse command line arguments. Also constructs the RuntimeProperties with the given obfuscation mode.
      Parameters:
      aArgsSyntax - The root condition being the node from which parsing the command line arguments starts. Parse the command line arguments via evalArgs(String[]).
      aObfuscationMode - The SystemContext specifies which level of obfuscation is to be used when encountering upon obfuscated properties: E.g. obfuscation may be bound to the host, the "secret" used for obfuscation being the same for all applications on the same host or obfuscation may be bound to the application, being different for different applications on the same host.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory)
      Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments. As no syntax notation is required by the constructor (no root args syntax Constituent node), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments when invoking withEvalArgs(String[]).
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.cli.Constituent aArgsSyntax)
      Constructs a RuntimeProperties instance with the given args syntax Constituent node used to parse command line arguments.
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aArgsSyntax - The root condition being the node from which parsing the command line arguments starts. Parse the command line arguments via evalArgs(String[]).
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.cli.Constituent aArgsSyntax, String aSecret)
      Constructs a RuntimeProperties instance with the given args syntax Constituent node used to parse command line arguments. Also constructs a RuntimeProperties instance with a custom secret for obfuscation.
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aArgsSyntax - The root condition being the node from which parsing the command line arguments starts. Parse the command line arguments via evalArgs(String[]).
      aSecret - The secret to be used when encountering upon obfuscated properties.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.cli.Constituent aArgsSyntax, org.refcodes.runtime.SystemContext aObfuscationMode)
      Constructs a RuntimeProperties instance with the given args syntax Constituent node used to parse command line arguments. Also constructs the RuntimeProperties with the given obfuscation mode.
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aArgsSyntax - The root condition being the node from which parsing the command line arguments starts. Parse the command line arguments via evalArgs(String[]).
      aObfuscationMode - The SystemContext specifies which level of obfuscation is to be used when encountering upon obfuscated properties: E.g. obfuscation may be bound to the host, the "secret" used for obfuscation being the same for all applications on the same host or obfuscation may be bound to the application, being different for different applications on the same host.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String aSecret)
      Constructs a RuntimeProperties instance with a custom secret for obfuscation.
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aSecret - The secret to be used when encountering upon obfuscated properties.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String[] aArgs)
      Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments: As no syntax notation is required by the constructor (no root args syntax Constituent node), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments.
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aArgs - The command line arguments to be evaluated.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String[] aArgs, String aSecret)
      Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments: As no syntax notation is required by the constructor (no root args syntax Constituent node), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments. Also constructs a RuntimeProperties instance with a custom secret for obfuscation.
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aArgs - The command line arguments to be evaluated.
      aSecret - The secret to be used when encountering upon obfuscated properties.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, String[] aArgs, org.refcodes.runtime.SystemContext aObfuscationMode)
      Constructs a RuntimeProperties instance with no args syntax Constituent node for parsing command line arguments: As no syntax notation is required by the constructor (no args syntax Constituent node), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments. Also constructs the RuntimeProperties with the given obfuscation mode
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aArgs - The command line arguments to be evaluated.
      aObfuscationMode - The SystemContext specifies which level of obfuscation is to be used when encountering upon obfuscated properties: E.g. obfuscation may be bound to the host, the "secret" used for obfuscation being the same for all applications on the same host or obfuscation may be bound to the application, being different for different applications on the same host.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.properties.PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory aPropertiesBuilderFactory, org.refcodes.runtime.SystemContext aObfuscationMode)
      Constructs the RuntimeProperties with the given obfuscation mode.
      Parameters:
      aPropertiesBuilderFactory - The factory to use when constructing ResourceProperties instances.
      aObfuscationMode - The SystemContext specifies which level of obfuscation is to be used when encountering upon obfuscated properties: E.g. obfuscation may be bound to the host, the "secret" used for obfuscation being the same for all applications on the same host or obfuscation may be bound to the application, being different for different applications on the same host.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(String aSecret)
      Constructs a RuntimeProperties instance with a custom secret for obfuscation.
      Parameters:
      aSecret - The secret to be used when encountering upon obfuscated properties.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(String[] aArgs)
      Constructs a RuntimeProperties instance with no Condition for parsing command line arguments: As no syntax notation is required by the constructor (no root Condition), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments.
      Parameters:
      aArgs - The command line arguments to be evaluated.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(String[] aArgs, String aSecret)
      Constructs a RuntimeProperties instance with no Condition for parsing command line arguments: As no syntax notation is required by the constructor (no root Condition), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments. Also constructs a RuntimeProperties instance with a custom secret for obfuscation.
      Parameters:
      aArgs - The command line arguments to be evaluated.
      aSecret - The secret to be used when encountering upon obfuscated properties.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(String[] aArgs, org.refcodes.runtime.SystemContext aObfuscationMode)
      Constructs a RuntimeProperties instance with no Condition for parsing command line arguments: As no syntax notation is required by the constructor (no root Condition), no syntax validation is done. Therefore the properties are heuristically determined from the provided command line arguments. Also constructs the RuntimeProperties with the given obfuscation mode
      Parameters:
      aArgs - The command line arguments to be evaluated.
      aObfuscationMode - The SystemContext specifies which level of obfuscation is to be used when encountering upon obfuscated properties: E.g. obfuscation may be bound to the host, the "secret" used for obfuscation being the same for all applications on the same host or obfuscation may be bound to the application, being different for different applications on the same host.
    • RuntimePropertiesImpl

      public RuntimePropertiesImpl(org.refcodes.runtime.SystemContext aObfuscationMode)
      Constructs the RuntimeProperties with the given obfuscation mode.
      Parameters:
      aObfuscationMode - The SystemContext specifies which level of obfuscation is to be used when encountering upon obfuscated properties: E.g. obfuscation may be bound to the host, the "secret" used for obfuscation being the same for all applications on the same host or obfuscation may be bound to the application, being different for different applications on the same host.
  • Method Details

    • addExample

      public void addExample(org.refcodes.cli.Example aExampleUsage)
      Specified by:
      addExample in interface org.refcodes.cli.ArgsParser
    • containsKey

      public boolean containsKey(Object aKey)
      Specified by:
      containsKey in interface org.refcodes.struct.Keys<String,String>
      Overrides:
      containsKey in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • errorLn

      public void errorLn(String aLine)
      Specified by:
      errorLn in interface org.refcodes.cli.ArgsParser
    • evalArgs

      public List<? extends org.refcodes.cli.Operand<?>> evalArgs(List<String> aArgs) throws org.refcodes.cli.ArgsSyntaxException
      Specified by:
      evalArgs in interface org.refcodes.cli.ArgsParser
      Specified by:
      evalArgs in interface ArgsParserProperties
      Throws:
      org.refcodes.cli.ArgsSyntaxException
    • evalArgs

      public List<? extends org.refcodes.cli.Operand<?>> evalArgs(String aToPath, List<String> aArgs) throws org.refcodes.cli.ArgsSyntaxException
      Specified by:
      evalArgs in interface ArgsParserProperties
      Throws:
      org.refcodes.cli.ArgsSyntaxException
    • evalArgs

      public List<? extends org.refcodes.cli.Operand<?>> evalArgs(String aToPath, String[] aArgs) throws org.refcodes.cli.ArgsSyntaxException
      Specified by:
      evalArgs in interface ArgsParserProperties
      Throws:
      org.refcodes.cli.ArgsSyntaxException
    • evalArgs

      public List<? extends org.refcodes.cli.Operand<?>> evalArgs(String[] aArgs) throws org.refcodes.cli.ArgsSyntaxException
      Specified by:
      evalArgs in interface org.refcodes.cli.ArgsParser
      Specified by:
      evalArgs in interface ArgsParserProperties
      Throws:
      org.refcodes.cli.ArgsSyntaxException
    • get

      public String get(Object aKey)
      Specified by:
      get in interface org.refcodes.struct.Keys<String,String>
      Overrides:
      get in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • getArgsParserProperties

      public ArgsParserProperties getArgsParserProperties()
      The ArgsParserProperties are those properties derived from the command line arguments (as of the getArgsSyntax()).
      Specified by:
      getArgsParserProperties in interface ArgsParserPropertiesAccessor
    • getArgsSyntax

      public org.refcodes.cli.Constituent getArgsSyntax()
      Specified by:
      getArgsSyntax in interface org.refcodes.cli.ArgsParser
      Specified by:
      getArgsSyntax in interface org.refcodes.cli.ArgsSyntaxAccessor
    • getBannerBorderEscapeCode

      public String getBannerBorderEscapeCode()
      Specified by:
      getBannerBorderEscapeCode in interface org.refcodes.cli.ArgsParser
    • getBannerEscapeCode

      public String getBannerEscapeCode()
      Specified by:
      getBannerEscapeCode in interface org.refcodes.cli.ArgsParser
    • getCommandEscapeCode

      public String getCommandEscapeCode()
      Specified by:
      getCommandEscapeCode in interface org.refcodes.cli.ArgsParser
    • getCopyrightNote

      public String getCopyrightNote()
      Specified by:
      getCopyrightNote in interface org.refcodes.cli.ArgsParser
    • getDelimiter

      public char getDelimiter()
      Specified by:
      getDelimiter in interface org.refcodes.mixin.DelimiterAccessor
      Specified by:
      getDelimiter in interface org.refcodes.properties.Properties
      Overrides:
      getDelimiter in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • getDescription

      public String getDescription()
      Specified by:
      getDescription in interface org.refcodes.cli.ArgsParser
      Specified by:
      getDescription in interface org.refcodes.mixin.DescriptionAccessor
    • getDescriptionEscapeCode

      public String getDescriptionEscapeCode()
      Specified by:
      getDescriptionEscapeCode in interface org.refcodes.cli.ArgsParser
    • getExamples

      public List<org.refcodes.cli.Example> getExamples()
      Specified by:
      getExamples in interface org.refcodes.cli.ArgsParser
    • getLicenseNote

      public String getLicenseNote()
      Specified by:
      getLicenseNote in interface org.refcodes.cli.ArgsParser
    • getLineSeparatorEscapeCode

      public String getLineSeparatorEscapeCode()
      Specified by:
      getLineSeparatorEscapeCode in interface org.refcodes.cli.ArgsParser
    • getLongOptionPrefix

      public String getLongOptionPrefix()
      Specified by:
      getLongOptionPrefix in interface org.refcodes.cli.LongOptionPrefixAccessor
    • getName

      public String getName()
      Specified by:
      getName in interface org.refcodes.mixin.NameAccessor
    • getOptionEscapeCode

      public String getOptionEscapeCode()
      Specified by:
      getOptionEscapeCode in interface org.refcodes.cli.ArgsParser
      Specified by:
      getOptionEscapeCode in interface org.refcodes.cli.OptionEscapeCodeAccessor
    • getArgumentEscapeCode

      public String getArgumentEscapeCode()
      Specified by:
      getArgumentEscapeCode in interface org.refcodes.cli.ArgsParser
      Specified by:
      getArgumentEscapeCode in interface org.refcodes.cli.ArgumentEscapeCodeAccessor
    • getResetEscapeCode

      public String getResetEscapeCode()
      Specified by:
      getResetEscapeCode in interface org.refcodes.mixin.ResetEscapeCodeAccessor
    • getSeparatorLnChar

      public char getSeparatorLnChar()
      Specified by:
      getSeparatorLnChar in interface org.refcodes.cli.ArgsParser
    • getShortOptionPrefix

      public Character getShortOptionPrefix()
      Specified by:
      getShortOptionPrefix in interface org.refcodes.cli.ShortOptionPrefixAccessor
    • getSyntaxMetrics

      public org.refcodes.cli.SyntaxMetrics getSyntaxMetrics()
      Specified by:
      getSyntaxMetrics in interface org.refcodes.cli.SyntaxMetricsAccessor
    • getTextBoxGrid

      public org.refcodes.textual.TextBoxGrid getTextBoxGrid()
      Specified by:
      getTextBoxGrid in interface org.refcodes.textual.TextBoxGridAccessor
    • getTitle

      public String getTitle()
      Specified by:
      getTitle in interface org.refcodes.mixin.TitleAccessor
    • isEmpty

      public boolean isEmpty()
      Specified by:
      isEmpty in interface org.refcodes.mixin.EmptyAccessor
      Overrides:
      isEmpty in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • isEscapeCodesEnabled

      public boolean isEscapeCodesEnabled()
      Specified by:
      isEscapeCodesEnabled in interface org.refcodes.mixin.EscapeCodesStatusAccessor
    • keySet

      public Set<String> keySet()
      Specified by:
      keySet in interface org.refcodes.struct.Keys<String,String>
      Overrides:
      keySet in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • printBanner

      public void printBanner()
      Specified by:
      printBanner in interface org.refcodes.cli.ArgsParser
    • printCopyrightNote

      public void printCopyrightNote()
      Specified by:
      printCopyrightNote in interface org.refcodes.cli.ArgsParser
    • printDescription

      public void printDescription()
      Specified by:
      printDescription in interface org.refcodes.cli.ArgsParser
    • printExamples

      public void printExamples()
      Specified by:
      printExamples in interface org.refcodes.cli.ArgsParser
    • printHeader

      public void printHeader()
      Specified by:
      printHeader in interface org.refcodes.cli.ArgsParser
    • printHelp

      public void printHelp()
      Specified by:
      printHelp in interface org.refcodes.cli.ArgsParser
    • printLicenseNote

      public void printLicenseNote()
      Specified by:
      printLicenseNote in interface org.refcodes.cli.ArgsParser
    • printLn

      public void printLn()
      Specified by:
      printLn in interface org.refcodes.cli.ArgsParser
    • printLn

      public void printLn(String aLine)
      Specified by:
      printLn in interface org.refcodes.cli.ArgsParser
    • printOptions

      public void printOptions()
      Specified by:
      printOptions in interface org.refcodes.cli.ArgsParser
    • printSeparatorLn

      public void printSeparatorLn()
      Specified by:
      printSeparatorLn in interface org.refcodes.cli.ArgsParser
    • printSynopsis

      public void printSynopsis()
      Specified by:
      printSynopsis in interface org.refcodes.cli.ArgsParser
    • reload

      public org.refcodes.properties.Properties reload() throws IOException, IllegalStateException, ParseException
      Specified by:
      reload in interface org.refcodes.properties.ResourceProperties
      Throws:
      IOException
      IllegalStateException
      ParseException
    • reload

      public org.refcodes.properties.Properties reload(org.refcodes.properties.ReloadMode aReloadMode) throws IOException, IllegalStateException, ParseException
      Specified by:
      reload in interface org.refcodes.properties.ResourceProperties
      Throws:
      IOException
      IllegalStateException
      ParseException
    • reset

      public void reset()
      Specified by:
      reset in interface org.refcodes.mixin.Resetable
    • retrieveFrom

      public org.refcodes.properties.Properties retrieveFrom(String aFromPath)
      Specified by:
      retrieveFrom in interface org.refcodes.struct.CanonicalMap
      Specified by:
      retrieveFrom in interface org.refcodes.struct.PathMap<String>
      Specified by:
      retrieveFrom in interface org.refcodes.properties.Properties
      Overrides:
      retrieveFrom in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • retrieveTo

      public org.refcodes.properties.Properties retrieveTo(String aToPath)
      Specified by:
      retrieveTo in interface org.refcodes.struct.CanonicalMap
      Specified by:
      retrieveTo in interface org.refcodes.struct.PathMap<String>
      Specified by:
      retrieveTo in interface org.refcodes.properties.Properties
      Overrides:
      retrieveTo in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • setArgsSyntax

      public void setArgsSyntax(org.refcodes.cli.Constituent aArgsSyntax)
      Specified by:
      setArgsSyntax in interface org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxMutator
    • setBannerBorderEscapeCode

      public void setBannerBorderEscapeCode(String aBannerBorderEscCode)
      Specified by:
      setBannerBorderEscapeCode in interface org.refcodes.cli.ArgsParser
    • setBannerEscapeCode

      public void setBannerEscapeCode(String aBannerEscCode)
      Specified by:
      setBannerEscapeCode in interface org.refcodes.cli.ArgsParser
    • setBannerFont

      public void setBannerFont(org.refcodes.textual.Font aBannerFont)
      Specified by:
      setBannerFont in interface org.refcodes.cli.ArgsParser
    • setBannerFontPalette

      public void setBannerFontPalette(char[] aColorPalette)
      Specified by:
      setBannerFontPalette in interface org.refcodes.cli.ArgsParser
    • setCommandEscapeCode

      public void setCommandEscapeCode(String aCommandEscCode)
      Specified by:
      setCommandEscapeCode in interface org.refcodes.cli.ArgsParser
    • setConsoleWidth

      public void setConsoleWidth(int aConsoleWidth)
      Specified by:
      setConsoleWidth in interface org.refcodes.cli.ArgsParser
    • setCopyrightNote

      public void setCopyrightNote(String aCopyrightNote)
      Specified by:
      setCopyrightNote in interface org.refcodes.cli.ArgsParser
    • setDescription

      public void setDescription(String aDescription)
      Specified by:
      setDescription in interface org.refcodes.mixin.DescriptionAccessor.DescriptionMutator
    • setDescriptionEscapeCode

      public void setDescriptionEscapeCode(String aParamDescriptionEscCode)
      Specified by:
      setDescriptionEscapeCode in interface org.refcodes.cli.ArgsParser
    • setErrorOut

      public void setErrorOut(PrintStream aErrorOut)
      Specified by:
      setErrorOut in interface org.refcodes.cli.ArgsParser
    • setEscapeCodesEnabled

      public void setEscapeCodesEnabled(boolean isEscCodeEnabled)
      Specified by:
      setEscapeCodesEnabled in interface org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusMutator
    • setLicenseNote

      public void setLicenseNote(String aLicenseNote)
      Specified by:
      setLicenseNote in interface org.refcodes.cli.ArgsParser
    • setLineBreak

      public void setLineBreak(String aLineBreak)
      Specified by:
      setLineBreak in interface org.refcodes.cli.ArgsParser
    • setLineSeparatorEscapeCode

      public void setLineSeparatorEscapeCode(String aLineSeparatorEscCode)
      Specified by:
      setLineSeparatorEscapeCode in interface org.refcodes.cli.ArgsParser
    • setLongOptionPrefix

      public void setLongOptionPrefix(String aLongOptionPrefix)
      Specified by:
      setLongOptionPrefix in interface org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixMutator
    • setMaxConsoleWidth

      public void setMaxConsoleWidth(int aMaxConsoleWidth)
      Specified by:
      setMaxConsoleWidth in interface org.refcodes.cli.ArgsParser
    • setName

      public void setName(String aName)
      Specified by:
      setName in interface org.refcodes.mixin.NameAccessor.NameMutator
    • setObfuscationMode

      public void setObfuscationMode(org.refcodes.runtime.SystemContext aObfuscationMode)
      Specifies the obfuscation mode to be used.
      Specified by:
      setObfuscationMode in interface RuntimeProperties
      Parameters:
      aObfuscationMode - The SystemContext specifies which level of obfuscation is to be used when encountering upon obfuscated properties: E.g. obfuscation may be bound to the host, the "secret" used for obfuscation being the same for all applications on the same host or obfuscation may be bound to the application, being different for different applications on the same host.
    • setOptionEscapeCode

      public void setOptionEscapeCode(String aOptEscCode)
      Specified by:
      setOptionEscapeCode in interface org.refcodes.cli.ArgsParser
      Specified by:
      setOptionEscapeCode in interface org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeMutator
    • setArgumentEscapeCode

      public void setArgumentEscapeCode(String aParamEscCode)
      Specified by:
      setArgumentEscapeCode in interface org.refcodes.cli.ArgsParser
      Specified by:
      setArgumentEscapeCode in interface org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeMutator
    • setResetEscapeCode

      public void setResetEscapeCode(String aResetEscCode)
      Specified by:
      setResetEscapeCode in interface org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeMutator
    • setSecret

      public void setSecret(String aSecret)
      Specified by:
      setSecret in interface org.refcodes.mixin.SecretAccessor.SecretMutator
    • setSeparatorLnChar

      public void setSeparatorLnChar(char aSeparatorChar)
      Specified by:
      setSeparatorLnChar in interface org.refcodes.cli.ArgsParser
    • setShortOptionPrefix

      public void setShortOptionPrefix(Character aShortOptionPrefix)
      Specified by:
      setShortOptionPrefix in interface org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixMutator
    • setStandardOut

      public void setStandardOut(PrintStream aStandardOut)
      Specified by:
      setStandardOut in interface org.refcodes.cli.ArgsParser
    • setSyntaxMetrics

      public void setSyntaxMetrics(org.refcodes.cli.SyntaxMetrics aSyntaxMetrics)
      Specified by:
      setSyntaxMetrics in interface org.refcodes.cli.ArgsParser
      Specified by:
      setSyntaxMetrics in interface org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsMutator
    • setTextBoxGrid

      public void setTextBoxGrid(org.refcodes.textual.TextBoxGrid aTextBoxGrid)
      Specified by:
      setTextBoxGrid in interface org.refcodes.textual.TextBoxGridAccessor.TextBoxGridMutator
    • setTitle

      public void setTitle(String aTitle)
      Specified by:
      setTitle in interface org.refcodes.mixin.TitleAccessor.TitleMutator
    • size

      public int size()
      Specified by:
      size in interface org.refcodes.struct.Containable
      Overrides:
      size in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • toDataStructure

      public Object toDataStructure(String aFromPath)
      Specified by:
      toDataStructure in interface org.refcodes.struct.PathMap<String>
      Overrides:
      toDataStructure in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • toRuntimeProfile

      public org.refcodes.properties.Properties toRuntimeProfile(String... aProfiles)
      Specified by:
      toRuntimeProfile in interface org.refcodes.properties.ProfileProperties
    • toSerialized

      public String toSerialized()
      Returns the serialized format as of the ResourceProperties.ResourcePropertiesBuilder instance being produced upon invocation of the PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory.toProperties(Properties) method. The behavior of this method is implementation specific. See the javadoc of the implementation in question (such as toSerialized()) for implementation details.
      Specified by:
      toSerialized in interface org.refcodes.properties.ResourceProperties
      Specified by:
      toSerialized in interface RuntimeProperties
    • toSerialized

      public String toSerialized(char aDelimiter)
      Returns the serialized format as of the ResourceProperties.ResourcePropertiesBuilder instance being produced upon invocation of the PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory.toProperties(Properties) method. The behavior of this method is implementation specific. See the javadoc of the implementation in question (such as toSerialized()) for implementation details.
      Specified by:
      toSerialized in interface org.refcodes.properties.ResourceProperties
      Specified by:
      toSerialized in interface RuntimeProperties
    • toSerialized

      public String toSerialized(String aComment, char aDelimiter)
      Returns the serialized format as of the ResourceProperties.ResourcePropertiesBuilder instance being produced upon invocation of the PolyglotPropertiesBuilder.PolyglotPropertiesBuilderFactory.toProperties(Properties) method.
      Specified by:
      toSerialized in interface org.refcodes.properties.ResourceProperties
    • values

      public Collection<String> values()
      Specified by:
      values in interface org.refcodes.struct.Keys<String,String>
      Overrides:
      values in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>
    • withEvalArgs

      public RuntimeProperties withEvalArgs(String[] aArgs) throws org.refcodes.cli.ArgsSyntaxException
      Specified by:
      withEvalArgs in interface org.refcodes.cli.ArgsParser
      Specified by:
      withEvalArgs in interface org.refcodes.cli.ArgsParserMixin<org.refcodes.cli.ArgsParser>
      Specified by:
      withEvalArgs in interface ArgsParserProperties
      Specified by:
      withEvalArgs in interface RuntimeProperties
      Throws:
      org.refcodes.cli.ArgsSyntaxException
    • withFile

      public RuntimeProperties withFile(File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters) throws IOException, ParseException
      Specified by:
      withFile in interface org.refcodes.properties.ResourceLoaderMixin<RuntimeProperties>
      Throws:
      IOException
      ParseException
    • withFilePath

      public RuntimeProperties withFilePath(Class<?> aResourceClass, String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters) throws IOException, ParseException
      Specified by:
      withFilePath in interface org.refcodes.properties.ResourceLoaderMixin<RuntimeProperties>
      Throws:
      IOException
      ParseException
    • withInputStream

      public RuntimeProperties withInputStream(InputStream aInputStream, char... aDelimiters) throws IOException, ParseException
      Specified by:
      withInputStream in interface org.refcodes.properties.ResourceLoaderMixin<RuntimeProperties>
      Throws:
      IOException
      ParseException
    • withProperties

      public RuntimeProperties withProperties(org.refcodes.properties.Properties aProperties)
      A hook for you to provide Properties programmatically. The later you add Properties, the lower their precedence.
      Specified by:
      withProperties in interface RuntimeProperties
      Parameters:
      aProperties - The Properties to be added.
      Returns:
      This instance as of the builder pattern to apply method chaining.
    • withUrl

      public RuntimeProperties withUrl(URL aUrl, char... aDelimiters) throws IOException, ParseException
      Specified by:
      withUrl in interface org.refcodes.properties.ResourceLoaderMixin<RuntimeProperties>
      Throws:
      IOException
      ParseException
    • addProperties

      protected void addProperties(Class<?> aResourceClass, String aFilePath, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters) throws IOException, ParseException
      Reads the ResourceProperties.ResourcePropertiesBuilder from the given data sink.
      Parameters:
      aResourceClass - The class which's class loader is to take care of loading the properties (from inside a JAR).
      aFilePath - The data sink from which to read the ResourceProperties.ResourcePropertiesBuilder.
      aConfigLocator - The ConfigLocator specifying where to seek for properties.
      aDelimiters - The delimiters in the properties file to identity a path delimiter.
      Throws:
      IOException - Thrown in case there were problems reading the data sink.
      ParseException - Thrown in case there were problems parsing the data from the data sink.
    • addProperties

      protected void addProperties(File aFile, org.refcodes.runtime.ConfigLocator aConfigLocator, char... aDelimiters) throws IOException, ParseException
      Reads the ResourceProperties.ResourcePropertiesBuilder from the given data sink.
      Parameters:
      aFile - The data sink from which to read the ResourceProperties.ResourcePropertiesBuilder.
      aConfigLocator - The ConfigLocator specifying where to seek for properties.
      aDelimiters - The delimiters in the properties file to identity a path delimiter.
      Throws:
      IOException - Thrown in case there were problems reading the data sink.
      ParseException - Thrown in case there were problems parsing the data from the data sink.
    • addProperties

      protected void addProperties(InputStream aInputStream, char[] aDelimiters) throws IOException, ParseException
      Reads the ResourceProperties from the given data sink.
      Parameters:
      aInputStream - The data sink from which to read the ResourceProperties.
      aDelimiters - The delimiters in the properties file to identity a path delimiter.
      Throws:
      IOException - Thrown in case there were problems reading the data sink.
      ParseException - Thrown in case there were problems parsing the data from the data sink.
    • addProperties

      protected void addProperties(org.refcodes.properties.Properties aProperties)
      Adds the properties.
      Parameters:
      aProperties - the properties
    • addProperties

      protected void addProperties(URL aUrl, char... aDelimiters) throws IOException, ParseException
      Reads the ResourceProperties from the given data sink.
      Parameters:
      aUrl - The data sink from which to read the ResourceProperties.
      aDelimiters - The delimiters in the properties file to identity a path delimiter.
      Throws:
      IOException - Thrown in case there were problems reading the data sink.
      ParseException - Thrown in case there were problems parsing the data from the data sink.
    • getProperties

      protected org.refcodes.properties.Properties getProperties()
      Overrides:
      getProperties in class org.refcodes.properties.AbstractPropertiesDecorator<org.refcodes.properties.Properties>