com.jcabi.log

Class VerboseProcess

java.lang.Object

com.jcabi.log.VerboseProcess

public final class VerboseProcess
extends Object

Utility class for getting stdout from a running process and logging it through SLF4J.

For example:

 String name = new VerboseProcess(
   new ProcessBuilder("who", "am", "i")
 ).stdout();

The class throws an exception if the process returns a non-zero exit code.

The class is thread-safe.

Since:

0.5

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
VerboseProcess(Process prc) Public ctor.
VerboseProcess(ProcessBuilder builder) Public ctor (builder will be configured to redirect error input to the stdout and will receive an empty stdin).
VerboseProcess(ProcessBuilder bdr, Level stdout, Level stderr) Public ctor, with a given process and logging levels for stdout and stderr.
VerboseProcess(Process prc, Level stdout, Level stderr) Public ctor, with a given process and logging levels for stdout and stderr.

Method Summary

Methods

Modifier and Type	Method and Description
String	stdout() Get stdout from the process, after its finish (the method will wait for the process and log its output).
String	stdoutQuietly() Get stdout from the process, after its finish (the method will wait for the process and log its output).

Methods inherited from class java.lang.Object

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

Constructor Detail

VerboseProcess

public VerboseProcess(Process prc)

Public ctor.

Parameters:

prc - The process to work with

VerboseProcess

public VerboseProcess(@NotNull(message="process builder can\'t be NULL")
              ProcessBuilder builder)

Public ctor (builder will be configured to redirect error input to the stdout and will receive an empty stdin).

Parameters:

builder - Process builder to work with

VerboseProcess

public VerboseProcess(@NotNull(message="process can\'t be NULL")
              Process prc,
              @NotNull(message="stdout level can\'t be NULL")
              Level stdout,
              @NotNull(message="stderr level can\'t be NULL")
              Level stderr)

Public ctor, with a given process and logging levels for stdout and stderr.

Parameters:

prc - Process to execute and monitor

stdout - Log level for stdout

stderr - Log level for stderr

Since:

0.11

VerboseProcess

public VerboseProcess(@NotNull(message="process can\'t be NULL")
              ProcessBuilder bdr,
              @NotNull(message="stdout level can\'t be NULL")
              Level stdout,
              @NotNull(message="stderr level can\'t be NULL")
              Level stderr)

Public ctor, with a given process and logging levels for stdout and stderr.

Parameters:

bdr - Process builder to execute and monitor

stdout - Log level for stdout

stderr - Log level for stderr

Since:

0.12

Method Detail

stdout

public String stdout()

Get stdout from the process, after its finish (the method will wait for the process and log its output).

The method will check process exit code, and if it won't be equal to zero a runtime exception will be thrown. A non-zero exit code usually is an indicator of problem. If you want to ignore this code, use stdoutQuietly() instead.

Returns:

Full stdout of the process

stdoutQuietly

public String stdoutQuietly()

Get stdout from the process, after its finish (the method will wait for the process and log its output).

This method ignores exit code of the process. Even if it is not equal to zero (which usually is an indicator of an error), the method will quietly return its output. The method is useful when you're running a background process. You will kill it with Process.destroy(), which usually will lead to a non-zero exit code, which you want to ignore.

Returns:

Full stdout of the process

Since:

0.10