com.spotify.docker.client

Class LogStream

java.lang.Object

com.google.common.collect.UnmodifiableIterator<T>

com.google.common.collect.AbstractIterator<LogMessage>

com.spotify.docker.client.LogStream

All Implemented Interfaces:

Closeable, AutoCloseable, Iterator<LogMessage>

public class LogStream
extends com.google.common.collect.AbstractIterator<LogMessage>
implements Closeable

Method Summary

Modifier and Type	Method and Description
void	attach(OutputStream stdout, OutputStream stderr) Attaches two OutputStreams to the LogStream.
void	attach(OutputStream stdout, OutputStream stderr, boolean closeAtEOF) Attaches two OutputStreams to the LogStream.
void	close()
protected LogMessage	computeNext()
protected void	finalize()
String	readFully()

Methods inherited from class com.google.common.collect.AbstractIterator

endOfData, hasNext, next, peek

Methods inherited from class com.google.common.collect.UnmodifiableIterator

remove

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Method Detail

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

computeNext

protected LogMessage computeNext()

Specified by:

computeNext in class com.google.common.collect.AbstractIterator<LogMessage>

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

readFully

public String readFully()

attach

public void attach(OutputStream stdout,
                   OutputStream stderr)
            throws IOException

Attaches two OutputStreams to the LogStream. Closes the streams after use.

Parameters:

stdout - OutputStream for the standard out

stderr - OutputStream for the standard err

Throws:

IOException - if an I/O error occurs

See Also:

for control over stream lifecycles

attach

public void attach(OutputStream stdout,
                   OutputStream stderr,
                   boolean closeAtEOF)
            throws IOException

Attaches two OutputStreams to the LogStream.

Example usage:

 
 dockerClient
     .attachContainer(containerId,
         AttachParameter.LOGS, AttachParameter.STDOUT,
         AttachParameter.STDERR, AttachParameter.STREAM)
     .attach(System.out, System.err);
 
 

Typically you use PipedOutputStream connected to a PipedInputStream which are read by - for example - an InputStreamReader or a Scanner. For small inputs, the PipedOutputStream just writes to the buffer of the PipedInputStream, but you actually want to read and write from separate threads, as it may deadlock the thread.

 
   final PipedInputStream stdout = new PipedInputStream();
   final PipedInputStream stderr = new PipedInputStream();
   final PipedOutputStream stdout_pipe = new PipedOutputStream(stdout);
   final PipedOutputStream stderr_pipe = new PipedOutputStream(stderr);

   executor.submit(new Callable<Void>() {
     @Override
     public Void call() throws Exception {
       dockerClient.attachContainer(containerId,
           AttachParameter.LOGS, AttachParameter.STDOUT,
           AttachParameter.STDERR, AttachParameter.STREAM
         .attach(stdout_pipe, stderr_pipe);
       return null;
     }
   });

   try (Scanner sc_stdout = new Scanner(stdout); Scanner sc_stderr = new Scanner(stderr)) {
     // ... read here
   }
 
 

Parameters:

stdout - OutputStream for the standard out

stderr - OutputStream for the standard err

closeAtEOF - whether to close the streams when this log stream ends

Throws:

IOException - if an I/O error occurs

See Also:

PipedInputStream, PipedOutputStream