org.testcontainers.utility

Class LogUtils

java.lang.Object

org.testcontainers.utility.LogUtils

public final class LogUtils
extends java.lang.Object

Provides utility methods for logging.

Method Summary

Modifier and Type	Method and Description
static void	followOutput(com.github.dockerjava.api.DockerClient dockerClient, java.lang.String containerId, java.util.function.Consumer<OutputFrame> consumer) Attach a log consumer to a container's log outputs in follow mode.
static void	followOutput(com.github.dockerjava.api.DockerClient dockerClient, java.lang.String containerId, java.util.function.Consumer<OutputFrame> consumer, OutputFrame.OutputType... types) Attach a log consumer to a container's log outputs in follow mode.
static java.lang.String	getOutput(com.github.dockerjava.api.DockerClient dockerClient, java.lang.String containerId, OutputFrame.OutputType... types) Retrieve all previous log outputs for a container of the specified type(s).

Methods inherited from class java.lang.Object

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

Method Detail

followOutput

public static void followOutput(com.github.dockerjava.api.DockerClient dockerClient,
                                java.lang.String containerId,
                                java.util.function.Consumer<OutputFrame> consumer,
                                OutputFrame.OutputType... types)

Attach a log consumer to a container's log outputs in follow mode. The consumer will receive all previous and all future log frames of the specified type(s).

Parameters:

dockerClient - a Docker client

containerId - container ID to attach to

consumer - a consumer of OutputFrames

types - types of OutputFrame to receive

followOutput

public static void followOutput(com.github.dockerjava.api.DockerClient dockerClient,
                                java.lang.String containerId,
                                java.util.function.Consumer<OutputFrame> consumer)

Attach a log consumer to a container's log outputs in follow mode. The consumer will receive all previous and all future log frames (both stdout and stderr).

Parameters:

dockerClient - a Docker client

containerId - container ID to attach to

consumer - a consumer of OutputFrames

getOutput

public static java.lang.String getOutput(com.github.dockerjava.api.DockerClient dockerClient,
                                         java.lang.String containerId,
                                         OutputFrame.OutputType... types)

Retrieve all previous log outputs for a container of the specified type(s).

Parameters:

dockerClient - a Docker client

containerId - container ID to attach to

types - types of OutputFrame to receive

Returns:

all previous output frames (stdout/stderr being separated by newline characters)