Class StatusConfiguration


  • public class StatusConfiguration
    extends java.lang.Object
    Configuration for setting up StatusConsoleListener instances.
    • Field Detail

      • DEFAULT_STREAM

        private static final java.io.PrintStream DEFAULT_STREAM
      • DEFAULT_STATUS

        private static final Level DEFAULT_STATUS
      • errorMessages

        private final java.util.Collection<java.lang.String> errorMessages
      • initialized

        private volatile boolean initialized
      • destination

        private java.io.PrintStream destination
      • status

        private Level status
      • verboseClasses

        private java.lang.String[] verboseClasses
    • Constructor Detail

      • StatusConfiguration

        public StatusConfiguration()
    • Method Detail

      • error

        public void error​(java.lang.String message)
        Logs an error message to the StatusLogger. If the StatusLogger hasn't been set up yet, queues the message to be logged after initialization.
        Parameters:
        message - error message to log.
      • withDestination

        public StatusConfiguration withDestination​(java.lang.String destination)
        Specifies the destination for StatusLogger events. This can be out (default) for using standard out, err for using standard error, or a file URI to which log events will be written. If the provided URI is invalid, then the default destination of standard out will be used.
        Parameters:
        destination - where status log messages should be output.
        Returns:
        this
      • parseStreamName

        private java.io.PrintStream parseStreamName​(java.lang.String name)
                                             throws java.net.URISyntaxException,
                                                    java.io.FileNotFoundException
        Throws:
        java.net.URISyntaxException
        java.io.FileNotFoundException
      • withStatus

        public StatusConfiguration withStatus​(java.lang.String status)
        Specifies the logging level by name to use for filtering StatusLogger messages.
        Parameters:
        status - name of logger level to filter below.
        Returns:
        this
        See Also:
        Level
      • withStatus

        public StatusConfiguration withStatus​(Level status)
        Specifies the logging level to use for filtering StatusLogger messages.
        Parameters:
        status - logger level to filter below.
        Returns:
        this
      • withVerbosity

        public StatusConfiguration withVerbosity​(java.lang.String verbosity)
        Specifies the verbosity level to log at. This only applies to classes configured by verboseClasses.
        Parameters:
        verbosity - basic filter for status logger messages.
        Returns:
        this
      • withVerboseClasses

        public StatusConfiguration withVerboseClasses​(java.lang.String... verboseClasses)
        Specifies which class names to filter if the configured verbosity level is QUIET.
        Parameters:
        verboseClasses - names of classes to filter if not using VERBOSE.
        Returns:
        this
      • initialize

        public void initialize()
        Configures and initializes the StatusLogger using the configured options in this instance.
      • configureExistingStatusConsoleListener

        private boolean configureExistingStatusConsoleListener()
      • registerNewStatusConsoleListener

        private void registerNewStatusConsoleListener()
      • migrateSavedLogMessages

        private void migrateSavedLogMessages()