Class StandardLogger


  • public class StandardLogger
    extends Logger
    The default Logger used by Saxon on the Java platform. All messages are written by default to System.err. The logger can be configured by setting a different output destination, and by setting a minimum threshold for the severity of messages to be output.
    • Constructor Detail

      • StandardLogger

        public StandardLogger()
        Create a Logger that wraps the System.err output stream
      • StandardLogger

        public StandardLogger​(PrintStream stream)
        Create a Logger that wraps the specified stream. Closing the Logger will not close the underlying stream; this remains the caller's responsibility
        Parameters:
        stream - the stream to which the Logger's output should be written
      • StandardLogger

        public StandardLogger​(Writer writer)
        Create a Logger that wraps the specified writer. Closing the Logger will not close the underlying stream; this remains the caller's responsibility
        Parameters:
        writer - the writer to which the Logger's output should be written
      • StandardLogger

        public StandardLogger​(File fileName)
                       throws FileNotFoundException
        Create a Logger that writes to a specified file
        Parameters:
        fileName - the file to which output should be written. When the logger is closed, output will be flushed to the file.
        Throws:
        FileNotFoundException - if the file is not accessible
    • Method Detail

      • setPrintStream

        public void setPrintStream​(PrintStream stream)
        Set the output destination for messages
        Parameters:
        stream - the stream to which messages will be written. Defaults to System.err. The caller is responsible for closing the stream after use (it will not be closed by the close() method on the Logger)
      • setPrintWriter

        public void setPrintWriter​(PrintWriter writer)
        Set the output destination for messages
        Parameters:
        writer - the stream to which messages will be written. Defaults to System.err. The caller is responsible for closing the stream after use (it will not be closed by the close() method on the Logger)
      • getPrintWriter

        public PrintWriter getPrintWriter()
        Get the output destination used for messages
        Returns:
        the stream to which messages are written
      • setThreshold

        public void setThreshold​(int threshold)
        Set the minimum threshold for the severity of messages to be output. Defaults to Logger.INFO. Messages whose severity is below this threshold will be ignored
        Parameters:
        threshold - the minimum severity of messages to be output.
      • getThreshold

        public int getThreshold()
        Get the minimum threshold for the severity of messages to be output. Defaults to Logger.INFO. Messages whose severity is below this threshold will be ignored
        Returns:
        the minimum severity of messages to be output.
      • asStreamResult

        public StreamResult asStreamResult()
        Get a JAXP Result object allowing serialized XML to be written to the output destination of this Logger
        Overrides:
        asStreamResult in class Logger
        Returns:
        a Result that serializes XML to this Logger
      • close

        public void close()
        Close the logger, indicating that no further messages will be written
        Overrides:
        close in class Logger