Package org.apache.commons.exec

Class LogOutputStream

  • All Implemented Interfaces:
    java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable
    public abstract class LogOutputStream
extends java.io.OutputStream
    Base class to connect a logging system to the output and/or error stream of then external process. The implementation parses the incoming data to construct a line and passes the complete line to an user-defined implementation.
    Version:
    $Id: LogOutputStream.java 1636056 2014-11-01 21:12:52Z ggregory $

    • Constructor Summary

      Constructors 
      Constructor Description
      LogOutputStream()
      Creates a new instance of this class.
      LogOutputStream​(int level)
      Creates a new instance of this class.

    • Method Summary

      All Methods Instance Methods Abstract Methods Concrete Methods 
      Modifier and Type Method Description
      void close()
      Writes all remaining data from the buffer.
      void flush()
      Flush this log stream.
      int getMessageLevel()  
      protected void processBuffer()
      Converts the buffer to a string and sends it to processLine.
      protected void processLine​(java.lang.String line)
      Logs a line to the log system of the user.
      protected abstract void processLine​(java.lang.String line, int logLevel)
      Logs a line to the log system of the user.
      void write​(byte[] b, int off, int len)
      Write a block of characters to the output stream
      void write​(int cc)
      Write the data to the buffer and flush the buffer, if a line separator is detected.

      • Methods inherited from class java.io.OutputStream

        nullOutputStream, write

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • LogOutputStream

        public LogOutputStream()
        Creates a new instance of this class. Uses the default level of 999.

      • LogOutputStream

        public LogOutputStream​(int level)
        Creates a new instance of this class.
        Parameters:
        level - loglevel used to log data written to this stream.

    • Method Detail

      • write

        public void write​(int cc)
           throws java.io.IOException
        Write the data to the buffer and flush the buffer, if a line separator is detected.
        Specified by:
        write in class java.io.OutputStream
        Parameters:
        cc - data to log (byte).
        Throws:
        java.io.IOException
        See Also:
        OutputStream.write(int)

      • flush

        public void flush()
        Flush this log stream.
        Specified by:
        flush in interface java.io.Flushable
        Overrides:
        flush in class java.io.OutputStream
        See Also:
        OutputStream.flush()

      • close

        public void close()
           throws java.io.IOException
        Writes all remaining data from the buffer.
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Overrides:
        close in class java.io.OutputStream
        Throws:
        java.io.IOException
        See Also:
        OutputStream.close()

      • getMessageLevel

        public int getMessageLevel()
        Returns:
        the trace level of the log system

      • write

        public void write​(byte[] b,
                  int off,
                  int len)
           throws java.io.IOException
        Write a block of characters to the output stream
        Overrides:
        write in class java.io.OutputStream
        Parameters:
        b - the array containing the data
        off - the offset into the array where data starts
        len - the length of block
        Throws:
        java.io.IOException - if the data cannot be written into the stream.
        See Also:
        OutputStream.write(byte[], int, int)

      • processBuffer

        protected void processBuffer()
        Converts the buffer to a string and sends it to processLine.

      • processLine

        protected void processLine​(java.lang.String line)
        Logs a line to the log system of the user.
        Parameters:
        line - the line to log.

      • processLine

        protected abstract void processLine​(java.lang.String line,
                                    int logLevel)
        Logs a line to the log system of the user.
        Parameters:
        line - the line to log.
        logLevel - the log level to use