Package tv.hd3g.processlauncher

Class ProcesslauncherBuilder

java.lang.Object

tv.hd3g.processlauncher.ProcesslauncherBuilder

public class ProcesslauncherBuilder
extends Object

Constructor Summary

Constructors

Constructor	Description
ProcesslauncherBuilder(File executable, Collection<String> parameters)
ProcesslauncherBuilder(File executable, Collection<String> parameters, ExecutableFinder execFinder)
ProcesslauncherBuilder(CommandLine commandLine)

Method Summary

Modifier and Type	Method	Description
ProcesslauncherBuilder	addExecutionCallbacker(ExecutionCallbacker executionCallbacker)
void	forEachEnvironmentVar(BiConsumer<String,String> action)
Optional<CaptureStandardOutput>	getCaptureStandardOutput()
String	getEnvironmentVar(String key)
String	getExecutableName()
List<ExecutionCallbacker>	getExecutionCallbackers()
Optional<ExecutionTimeLimiter>	getExecutionTimeLimiter()
Optional<ExternalProcessStartup>	getExternalProcessStartup()
String	getFullCommandLine()
CaptureStandardOutputText	getSetCaptureStandardOutputAsOutputText()	Shortcut for CaptureStandardOutputText.
CaptureStandardOutputText	getSetCaptureStandardOutputAsOutputText(CapturedStreams defaultCaptureOutStreamsBehavior)	Shortcut for CaptureStandardOutputText.
File	getWorkingDirectory()
boolean	isExecCodeMustBeZero()	Default, yes.
ProcessBuilder	makeProcessBuilder()
ProcesslauncherBuilder	removeExecutionCallbacker(ExecutionCallbacker executionCallbacker)
ProcesslauncherBuilder	setCaptureStandardOutput(CaptureStandardOutput captureStandardOutput)
ProcesslauncherBuilder	setEnvironmentVar(String key, String value)
ProcesslauncherBuilder	setEnvironmentVarIfNotFound(String key, String value)
ProcesslauncherBuilder	setExecCodeMustBeZero(boolean execCodeMustBeZero)	Default, yes.
ProcesslauncherBuilder	setExecutionTimeLimiter(long maxExecTime, TimeUnit unit, ScheduledExecutorService maxExecTimeScheduler)	Shortcut for setExecutionTimeLimiter
ProcesslauncherBuilder	setExecutionTimeLimiter(ExecutionTimeLimiter executionTimeLimiter)
ProcesslauncherBuilder	setExternalProcessStartup(ExternalProcessStartup externalProcessStartup)
ProcesslauncherBuilder	setWorkingDirectory(File workingDirectory)
ProcesslauncherLifecycle	start()
Processlauncher	toProcesslauncher()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ProcesslauncherBuilder

public ProcesslauncherBuilder(File executable,
                              Collection<String> parameters,
                              ExecutableFinder execFinder)

ProcesslauncherBuilder

public ProcesslauncherBuilder(File executable,
                              Collection<String> parameters)

ProcesslauncherBuilder

public ProcesslauncherBuilder(CommandLine commandLine)

Method Detail

getEnvironmentVar

public String getEnvironmentVar(String key)

Returns:

null if not found

setEnvironmentVar

public ProcesslauncherBuilder setEnvironmentVar(String key,
                                                String value)

setEnvironmentVarIfNotFound

public ProcesslauncherBuilder setEnvironmentVarIfNotFound(String key,
                                                          String value)

forEachEnvironmentVar

public void forEachEnvironmentVar(BiConsumer<String,String> action)

getWorkingDirectory

public File getWorkingDirectory()

setWorkingDirectory

public ProcesslauncherBuilder setWorkingDirectory(File workingDirectory)
                                           throws IOException

Throws:

IOException

setExecCodeMustBeZero

public ProcesslauncherBuilder setExecCodeMustBeZero(boolean execCodeMustBeZero)

Default, yes.

isExecCodeMustBeZero

public boolean isExecCodeMustBeZero()

Default, yes.

getExecutionCallbackers

public List<ExecutionCallbacker> getExecutionCallbackers()

Returns:

unmodifiableList

addExecutionCallbacker

public ProcesslauncherBuilder addExecutionCallbacker(ExecutionCallbacker executionCallbacker)

removeExecutionCallbacker

public ProcesslauncherBuilder removeExecutionCallbacker(ExecutionCallbacker executionCallbacker)

getExecutionTimeLimiter

public Optional<ExecutionTimeLimiter> getExecutionTimeLimiter()

setExecutionTimeLimiter

public ProcesslauncherBuilder setExecutionTimeLimiter(ExecutionTimeLimiter executionTimeLimiter)

getExternalProcessStartup

public Optional<ExternalProcessStartup> getExternalProcessStartup()

setExternalProcessStartup

public ProcesslauncherBuilder setExternalProcessStartup(ExternalProcessStartup externalProcessStartup)

setCaptureStandardOutput

public ProcesslauncherBuilder setCaptureStandardOutput(CaptureStandardOutput captureStandardOutput)

getCaptureStandardOutput

public Optional<CaptureStandardOutput> getCaptureStandardOutput()

makeProcessBuilder

public ProcessBuilder makeProcessBuilder()

getFullCommandLine

public String getFullCommandLine()

getExecutableName

public String getExecutableName()

toString

public String toString()

Overrides:

toString in class Object

Returns:

getFullCommandLine()

toProcesslauncher

public Processlauncher toProcesslauncher()

Returns:

new Processlauncher(this)

getSetCaptureStandardOutputAsOutputText

public CaptureStandardOutputText getSetCaptureStandardOutputAsOutputText(CapturedStreams defaultCaptureOutStreamsBehavior)

Shortcut for CaptureStandardOutputText. Set if missing or not a CaptureStandardOutputText.

getSetCaptureStandardOutputAsOutputText

public CaptureStandardOutputText getSetCaptureStandardOutputAsOutputText()

Shortcut for CaptureStandardOutputText. Set if missing or not a CaptureStandardOutputText.

start

public ProcesslauncherLifecycle start()
                               throws IOException

Returns:

toProcesslauncher().start()

Throws:

IOException

setExecutionTimeLimiter

public ProcesslauncherBuilder setExecutionTimeLimiter(long maxExecTime,
                                                      TimeUnit unit,
                                                      ScheduledExecutorService maxExecTimeScheduler)

Shortcut for setExecutionTimeLimiter