Module org.github.gestalt.core
Package org.github.gestalt.config.source

Class SystemPropertiesConfigSource

  • All Implemented Interfaces:
    ConfigSource
    public final class SystemPropertiesConfigSource
extends java.lang.Object
implements ConfigSource
    Convert the System properties into a config source.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String SYSTEM_PROPERTIES
      Format for the SystemPropertiesConfigSource.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean equals​(java.lang.Object o)  
      boolean failOnErrors()
      If the source should fail on errors.
      java.lang.String format()
      The format of the config source, for example this can be envVars, the extension of a file (properties, json, ect).
      Tags getTags()
      A source can have a set of tags that apply to all nodes in the source.
      int hashCode()  
      boolean hasList()
      If this config source provides a list of config values.
      boolean hasStream()
      If this config source has a stream to load from.
      java.util.UUID id()
      Id that represents this source as unique.
      java.util.List<Pair<java.lang.String,​java.lang.String>> loadList()
      Convert the System properties into a config list.
      java.io.InputStream loadStream()
      If this config source has a stream, this will return the stream of data.
      java.lang.String name()
      human-readable name for logging.

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • SYSTEM_PROPERTIES

        public static final java.lang.String SYSTEM_PROPERTIES
        Format for the SystemPropertiesConfigSource.
        See Also:
        Constant Field Values

    • Constructor Detail

      • SystemPropertiesConfigSource

        public SystemPropertiesConfigSource()
        Default constructor for SystemPropertiesConfigSource. It will treat Errors while loading as warnings since System Properties are often uncontrolled and may not follow expected conventions of this library.

      • SystemPropertiesConfigSource

        public SystemPropertiesConfigSource​(boolean failOnErrors)
        constructor for SystemPropertiesConfigSource.
        Parameters:
        failOnErrors - treat Errors while loading as warnings since System Properties are often uncontrolled and may not follow expected conventions of this library.

      • SystemPropertiesConfigSource

        public SystemPropertiesConfigSource​(Tags tags)
        constructor for SystemPropertiesConfigSource.
        Parameters:
        tags - tags associated with the source

      • SystemPropertiesConfigSource

        public SystemPropertiesConfigSource​(boolean failOnErrors,
                                    Tags tags)
        constructor for SystemPropertiesConfigSource.
        Parameters:
        failOnErrors - treat Errors while loading as warnings since System Properties are often uncontrolled and may not follow expected conventions of this library.
        tags - tags associated with the source

    • Method Detail

      • failOnErrors

        public boolean failOnErrors()
        Description copied from interface: ConfigSource
        If the source should fail on errors.
        Specified by:
        failOnErrors in interface ConfigSource
        Returns:
        If the source should fail on errors

      • hasStream

        public boolean hasStream()
        Description copied from interface: ConfigSource
        If this config source has a stream to load from.
        Specified by:
        hasStream in interface ConfigSource
        Returns:
        if this config source has a stream to load from

      • loadStream

        public java.io.InputStream loadStream()
                               throws GestaltException
        Description copied from interface: ConfigSource
        If this config source has a stream, this will return the stream of data. Or if not supported it will throw an exception.
        Specified by:
        loadStream in interface ConfigSource
        Returns:
        input stream of data
        Throws:
        GestaltException - if there are any IO or if this is an unsupported operation

      • hasList

        public boolean hasList()
        Description copied from interface: ConfigSource
        If this config source provides a list of config values.
        Specified by:
        hasList in interface ConfigSource
        Returns:
        if this config source provides a list of config values

      • loadList

        public java.util.List<Pair<java.lang.String,​java.lang.String>> loadList()
        Convert the System properties into a config list.
        Specified by:
        loadList in interface ConfigSource
        Returns:
        list of pairs of configs.

      • format

        public java.lang.String format()
        Description copied from interface: ConfigSource
        The format of the config source, for example this can be envVars, the extension of a file (properties, json, ect).
        Specified by:
        format in interface ConfigSource
        Returns:
        The format of the config source

      • name

        public java.lang.String name()
        Description copied from interface: ConfigSource
        human-readable name for logging.
        Specified by:
        name in interface ConfigSource
        Returns:
        human-readable name for logging.

      • id

        public java.util.UUID id()
        Description copied from interface: ConfigSource
        Id that represents this source as unique.
        Specified by:
        id in interface ConfigSource
        Returns:
        id

      • getTags

        public Tags getTags()
        Description copied from interface: ConfigSource
        A source can have a set of tags that apply to all nodes in the source.
        Specified by:
        getTags in interface ConfigSource
        Returns:
        tags assigned to the source

      • equals

        public boolean equals​(java.lang.Object o)
        Overrides:
        equals in class java.lang.Object

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object