ProcessConfigurationBuilder (Sponge

java.lang.Object
- org.openksavi.sponge.util.process.ProcessConfigurationBuilder

public class ProcessConfigurationBuilder
extends Object

A process configuration builder.

Constructor Summary

Constructors
Constructor and Description

ProcessConfigurationBuilder(String executable)
Creates a new process configuration builder.

Constructors
Constructor and Description
`ProcessConfigurationBuilder(String executable)` Creates a new process configuration builder.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ProcessConfigurationBuilder`	`arguments(List<String> arguments)` Adds the process arguments, ignoring `null` elements.
`ProcessConfigurationBuilder`	`arguments(String... arguments)` Adds the process arguments.
`ProcessConfiguration`	`build()` Builds the process configuration.
`ProcessConfigurationBuilder`	`charset(Charset charset)` Sets the charset of the subprocess streams used if the redirect type is STRING.
`ProcessConfigurationBuilder`	`env(Map<String,String> env)` Adds the environment variables.
`ProcessConfigurationBuilder`	`env(String name, String value)` Adds the environment variable.
`ProcessConfigurationBuilder`	`errorAsConsumer()` A convenience method to set the process error redirect type `CONSUMER`.
`ProcessConfigurationBuilder`	`errorAsConsumer(Consumer<String> errorLineConsumer)` A convenience method to set the process error redirect type `CONSUMER`.
`ProcessConfigurationBuilder`	`errorAsException()` A convenience method to set the process error redirect type `EXCEPTION`.
`ProcessConfigurationBuilder`	`errorAsFile(String errorFile)` A convenience method to set the process error redirect type `FILE`.
`ProcessConfigurationBuilder`	`errorAsInherit()` A convenience method to set the process error redirect type `INHERIT`.
`ProcessConfigurationBuilder`	`errorAsString()` A convenience method to set the process error redirect type `STRING`.
`ProcessConfigurationBuilder`	`errorLoggingConsumer(BiConsumer<org.slf4j.Logger,String> errorLoggingConsumer)` The logging consumer for the process error output.
`ProcessConfigurationBuilder`	`errorRedirect(ErrorRedirect errorRedirect)` Sets the error output redirect type.
`ProcessConfigurationBuilder`	`exceptionOnExitCode(boolean exceptionOnExitCode)` If `true`, throws exception if the process exit code is not `0`.
`ProcessConfigurationBuilder`	`inheritIo()` Sets inherit I/O.
`ProcessConfigurationBuilder`	`inputAsBinary(byte[] inputBinary)` A convenience method to set the input redirect type `BINARY`.
`ProcessConfigurationBuilder`	`inputAsFile(String inputFile)` A convenience method to set the input redirect type `FILE`.
`ProcessConfigurationBuilder`	`inputAsInherit()` A convenience method to set the input redirect type `INHERIT`.
`ProcessConfigurationBuilder`	`inputAsStream()` A convenience method to set the input redirect type `STREAM`.
`ProcessConfigurationBuilder`	`inputAsString(String inputString)` A convenience method to set the input redirect type `STRING`.
`ProcessConfigurationBuilder`	`inputRedirect(InputRedirect inputRedirect)` Sets the input redirect type.
`ProcessConfigurationBuilder`	`name(String name)` Sets the process name.
`ProcessConfigurationBuilder`	`outputAsBinary()` A convenience method to set the output redirect type `BINARY`.
`ProcessConfigurationBuilder`	`outputAsConsumer()` A convenience method to set the output redirect type `CONSUMER`.
`ProcessConfigurationBuilder`	`outputAsConsumer(Consumer<String> outputLineConsumer)` A convenience method to set the output redirect type `CONSUMER`.
`ProcessConfigurationBuilder`	`outputAsFile(String outputFile)` A convenience method to set the output redirect type `FILE`.
`ProcessConfigurationBuilder`	`outputAsInherit()` A convenience method to set the output redirect type `INHERIT`.
`ProcessConfigurationBuilder`	`outputAsString()` A convenience method to set the output redirect type `STRING`.
`ProcessConfigurationBuilder`	`outputLoggingConsumer(BiConsumer<org.slf4j.Logger,String> outputLoggingConsumer)` The logging consumer for the process standard output.
`ProcessConfigurationBuilder`	`outputLoggingConsumerNone()` Sets the logging consumer for the process standard output to none.
`ProcessConfigurationBuilder`	`outputRedirect(OutputRedirect outputRedirect)` Sets the standard output redirect type.
`ProcessConfigurationBuilder`	`processBuilderConsumer(Consumer<ProcessBuilder> processBuilderConsumer)` Provides low level access to the Java ProcessBuilder consumer.
`ProcessConfigurationBuilder`	`redirectErrorStream(boolean redirectErrorStream)` Merges the error output with the standard output if `true`.
`ProcessConfigurationBuilder`	`waitForLineTimeout(Long waitForLineTimeout)` Sets the timeout for waiting for a specific line from the process output stream (in seconds).
`ProcessConfigurationBuilder`	`waitForNegativeLineRegexp(String waitForNegativeLineRegexp)` Sets the Java regular expression of a line from the process output stream that signals an error and should cause throwing an exception.
`ProcessConfigurationBuilder`	`waitForPositiveLineRegexp(String waitForPositiveLineRegexp)` Sets the Java regular expression of a line from the process output stream.
`ProcessConfigurationBuilder`	`waitSeconds(Long waitSeconds)` Sets the maximum number of seconds to wait after the start of the process.
`ProcessConfigurationBuilder`	`workingDir(String workingDir)` Sets the process working directory.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ProcessConfigurationBuilder
```
public ProcessConfigurationBuilder(String executable)
```
    Creates a new process configuration builder.
    
    Parameters:
    
    executable - the executable.
- Method Detail
  - build
```
public ProcessConfiguration build()
```
    Builds the process configuration.
    
    Returns:
    
    the process configuration.
  - name
```
public ProcessConfigurationBuilder name(String name)
```
    Sets the process name.
    
    Parameters:
    
    name - the process name.
    
    Returns:
    
    this builder.
  - arguments
```
public ProcessConfigurationBuilder arguments(String... arguments)
```
    Adds the process arguments.
    
    Parameters:
    
    arguments - the process arguments.
    
    Returns:
    
    this builder.
  - arguments
```
public ProcessConfigurationBuilder arguments(List<String> arguments)
```
    Adds the process arguments, ignoring null elements.
    
    Parameters:
    
    arguments - the process arguments.
    
    Returns:
    
    this builder.
  - workingDir
```
public ProcessConfigurationBuilder workingDir(String workingDir)
```
    Sets the process working directory.
    
    Parameters:
    
    workingDir - the process working directory. If null (the default value) then the current directory will be used.
    
    Returns:
    
    this builder.
  - env
```
public ProcessConfigurationBuilder env(String name,
                                       String value)
```
    Adds the environment variable.
    
    Parameters:
    
    name - the environment variable name.
    
    value - the environment variable value.
    
    Returns:
    
    this builder.
  - env
```
public ProcessConfigurationBuilder env(Map<String,String> env)
```
    Adds the environment variables.
    
    Parameters:
    
    env - the environment variables.
    
    Returns:
    
    this builder.
  - waitSeconds
```
public ProcessConfigurationBuilder waitSeconds(Long waitSeconds)
```
    Sets the maximum number of seconds to wait after the start of the process. The thread that started the process will be blocked until the time elapses or the subprocess exits.
    
    Parameters:
    
    waitSeconds - the maximum number of seconds to wait or null (the default value) if the thread shouldn't wait.
    
    Returns:
    
    this builder.
  - inputRedirect
```
public ProcessConfigurationBuilder inputRedirect(InputRedirect inputRedirect)
```
    Sets the input redirect type. The default value is InputRedirect.PIPE.
    
    Parameters:
    
    inputRedirect - the input redirect type.
    
    Returns:
    
    this builder.
  - outputRedirect
```
public ProcessConfigurationBuilder outputRedirect(OutputRedirect outputRedirect)
```
    Sets the standard output redirect type. The default value is OutputRedirect.PIPE.
    
    Parameters:
    
    outputRedirect - the standard output redirect type.
    
    Returns:
    
    this builder.
  - errorRedirect
```
public ProcessConfigurationBuilder errorRedirect(ErrorRedirect errorRedirect)
```
    Sets the error output redirect type. The default value is ErrorRedirect.PIPE.
    
    Parameters:
    
    errorRedirect - the error output redirect type.
    
    Returns:
    
    this builder.
  - charset
```
public ProcessConfigurationBuilder charset(Charset charset)
```
    Sets the charset of the subprocess streams used if the redirect type is STRING.
    
    Parameters:
    
    charset - the charset.
    
    Returns:
    
    this builder.
  - waitForPositiveLineRegexp
```
public ProcessConfigurationBuilder waitForPositiveLineRegexp(String waitForPositiveLineRegexp)
```
    Sets the Java regular expression of a line from the process output stream. The thread that started the process will wait (blocking) for such line (or waitForNegativeLineRegexp if set).
    
    Parameters:
    
    waitForPositiveLineRegexp - the Java regular expression or null if the thread shouldn't wait for a specific line.
    
    Returns:
    
    this builder.
  - waitForNegativeLineRegexp
```
public ProcessConfigurationBuilder waitForNegativeLineRegexp(String waitForNegativeLineRegexp)
```
    Sets the Java regular expression of a line from the process output stream that signals an error and should cause throwing an exception.
    
    Parameters:
    
    waitForNegativeLineRegexp - the Java regular expression or null if the thread shouldn't look for a specific error line.
    
    Returns:
    
    this builder.
  - waitForLineTimeout
```
public ProcessConfigurationBuilder waitForLineTimeout(Long waitForLineTimeout)
```
    Sets the timeout for waiting for a specific line from the process output stream (in seconds). If the timeout is exceeded, the exception will be thrown.
    
    Parameters:
    
    waitForLineTimeout - the timeout for waiting for a specific line or null if the thread could wait indefinitely.
    
    Returns:
    
    this builder.
  - outputLoggingConsumer
```
public ProcessConfigurationBuilder outputLoggingConsumer(BiConsumer<org.slf4j.Logger,String> outputLoggingConsumer)
```
    The logging consumer for the process standard output. Applicable only if the output redirect type is CONSUMER. The default logging level is INFO.
    
    Parameters:
    
    outputLoggingConsumer - the logging consumer.
    
    Returns:
    
    this builder.
  - outputLoggingConsumerNone
```
public ProcessConfigurationBuilder outputLoggingConsumerNone()
```
    Sets the logging consumer for the process standard output to none. Applicable only if the output redirect type is CONSUMER.
    
    Returns:
    
    this builder.
  - errorLoggingConsumer
```
public ProcessConfigurationBuilder errorLoggingConsumer(BiConsumer<org.slf4j.Logger,String> errorLoggingConsumer)
```
    The logging consumer for the process error output. Applicable only if the error redirect type is CONSUMER. The default logging level is WARN.
    
    Parameters:
    
    errorLoggingConsumer - the logging consumer.
    
    Returns:
    
    this builder.
  - inheritIo
```
public ProcessConfigurationBuilder inheritIo()
```
    Sets inherit I/O.
    
    Returns:
    
    this builder.
  - processBuilderConsumer
```
public ProcessConfigurationBuilder processBuilderConsumer(Consumer<ProcessBuilder> processBuilderConsumer)
```
    Provides low level access to the Java ProcessBuilder consumer.
    
    Parameters:
    
    processBuilderConsumer - the Java ProcessBuilder consumer.
    
    Returns:
    
    this builder.
  - redirectErrorStream
```
public ProcessConfigurationBuilder redirectErrorStream(boolean redirectErrorStream)
```
    Merges the error output with the standard output if true. Defaults to false.
    
    Parameters:
    
    redirectErrorStream - redirect error stream flag.
    
    Returns:
    
    this builder.
  - exceptionOnExitCode
```
public ProcessConfigurationBuilder exceptionOnExitCode(boolean exceptionOnExitCode)
```
    If true, throws exception if the process exit code is not 0. Defaults to true.
    
    Parameters:
    
    exceptionOnExitCode - exception on exit code flag.
    
    Returns:
    
    this builder.
  - inputAsInherit
```
public ProcessConfigurationBuilder inputAsInherit()
```
    A convenience method to set the input redirect type INHERIT.
    
    Returns:
    
    this builder.
  - inputAsString
```
public ProcessConfigurationBuilder inputAsString(String inputString)
```
    A convenience method to set the input redirect type STRING.
    
    Parameters:
    
    inputString - the input string.
    
    Returns:
    
    this builder.
  - inputAsBinary
```
public ProcessConfigurationBuilder inputAsBinary(byte[] inputBinary)
```
    A convenience method to set the input redirect type BINARY.
    
    Parameters:
    
    inputBinary - the input binary.
    
    Returns:
    
    this builder.
  - inputAsFile
```
public ProcessConfigurationBuilder inputAsFile(String inputFile)
```
    A convenience method to set the input redirect type FILE.
    
    Parameters:
    
    inputFile - the input filename.
    
    Returns:
    
    this builder.
  - inputAsStream
```
public ProcessConfigurationBuilder inputAsStream()
```
    A convenience method to set the input redirect type STREAM.
    
    Returns:
    
    this builder.
  - outputAsInherit
```
public ProcessConfigurationBuilder outputAsInherit()
```
    A convenience method to set the output redirect type INHERIT.
    
    Returns:
    
    this builder.
  - outputAsString
```
public ProcessConfigurationBuilder outputAsString()
```
    A convenience method to set the output redirect type STRING.
    
    Returns:
    
    this builder.
  - outputAsBinary
```
public ProcessConfigurationBuilder outputAsBinary()
```
    A convenience method to set the output redirect type BINARY.
    
    Returns:
    
    this builder.
  - outputAsFile
```
public ProcessConfigurationBuilder outputAsFile(String outputFile)
```
    A convenience method to set the output redirect type FILE.
    
    Parameters:
    
    outputFile - the output filename.
    
    Returns:
    
    this builder.
  - outputAsConsumer
```
public ProcessConfigurationBuilder outputAsConsumer(Consumer<String> outputLineConsumer)
```
    A convenience method to set the output redirect type CONSUMER.
    
    Parameters:
    
    outputLineConsumer - the line consumer.
    
    Returns:
    
    this builder.
  - outputAsConsumer
```
public ProcessConfigurationBuilder outputAsConsumer()
```
    A convenience method to set the output redirect type CONSUMER.
    
    Returns:
    
    this builder.
  - errorAsInherit
```
public ProcessConfigurationBuilder errorAsInherit()
```
    A convenience method to set the process error redirect type INHERIT.
    
    Returns:
    
    this builder.
  - errorAsString
```
public ProcessConfigurationBuilder errorAsString()
```
    A convenience method to set the process error redirect type STRING.
    
    Returns:
    
    this builder.
  - errorAsFile
```
public ProcessConfigurationBuilder errorAsFile(String errorFile)
```
    A convenience method to set the process error redirect type FILE.
    
    Parameters:
    
    errorFile - the error file.
    
    Returns:
    
    this builder.
  - errorAsException
```
public ProcessConfigurationBuilder errorAsException()
```
    A convenience method to set the process error redirect type EXCEPTION.
    
    Returns:
    
    this builder.
  - errorAsConsumer
```
public ProcessConfigurationBuilder errorAsConsumer()
```
    A convenience method to set the process error redirect type CONSUMER.
    
    Returns:
    
    this builder.
  - errorAsConsumer
```
public ProcessConfigurationBuilder errorAsConsumer(Consumer<String> errorLineConsumer)
```
    A convenience method to set the process error redirect type CONSUMER.
    
    Parameters:
    
    errorLineConsumer - the line consumer.
    
    Returns:
    
    this builder.

Class ProcessConfigurationBuilder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ProcessConfigurationBuilder

Method Detail

build

name

arguments

arguments

workingDir

env

env

waitSeconds

inputRedirect

outputRedirect

errorRedirect

charset

waitForPositiveLineRegexp

waitForNegativeLineRegexp

waitForLineTimeout

outputLoggingConsumer

outputLoggingConsumerNone

errorLoggingConsumer

inheritIo

processBuilderConsumer

redirectErrorStream

exceptionOnExitCode

inputAsInherit

inputAsString

inputAsBinary

inputAsFile

inputAsStream

outputAsInherit

outputAsString

outputAsBinary

outputAsFile

outputAsConsumer

outputAsConsumer

errorAsInherit

errorAsString

errorAsFile

errorAsException

errorAsConsumer

errorAsConsumer