Class StandardLogger

java.lang.Object
net.sf.saxon.lib.Logger
net.sf.saxon.lib.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 Details

    • 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 Details

    • 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
    • println

      public void println(String message, int severity)
      Output a message with a specified severity.
      Specified by:
      println in class Logger
      Parameters:
      message - The message to be output
      severity - The severity: one of Logger.INFO, Logger.WARNING, Logger.ERROR, Logger.DISASTER
    • close

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