net.openhft.chronicle.testframework.process

Interface JavaProcessBuilder

public interface JavaProcessBuilder

Method Summary

Modifier and Type	Method and Description
static JavaProcessBuilder	create(@NotNull Class<?> mainClass) Creates and returns a new JavaProcessBuilder.
static String	getProcessStdErr(Process process) Get process stderr
static String	getProcessStdOut(Process process) Get process stdout
JavaProcessBuilder	inheritingIO() Make the spawned process inherit the IO streams of the spawning process
static void	printProcessOutput(String processName, Process process) Log stdout and stderr for a process
Process	start() Start a process defined by the current state of the builder
JavaProcessBuilder	withClasspathEntries(String... classpathEntries) Provide classpath entries to run with, by default uses classpath of spawning process
JavaProcessBuilder	withJvmArguments(String... jvmArguments) Provide JVM arguments to execute with
JavaProcessBuilder	withProgramArguments(String... programArguments) Provide program arguments to execute with

Method Detail

withProgramArguments

JavaProcessBuilder withProgramArguments(@NotNull
                                        String... programArguments)

Provide program arguments to execute with

Parameters:

programArguments - The list of program arguments

Returns:

this builder

withJvmArguments

JavaProcessBuilder withJvmArguments(@NotNull
                                    String... jvmArguments)

Provide JVM arguments to execute with

Parameters:

jvmArguments - The list of JVM arguments

Returns:

this builder

withClasspathEntries

JavaProcessBuilder withClasspathEntries(@NotNull
                                        String... classpathEntries)

Provide classpath entries to run with, by default uses classpath of spawning process

Parameters:

classpathEntries - The classpath entries to run with

Returns:

this builder

inheritingIO

JavaProcessBuilder inheritingIO()

Make the spawned process inherit the IO streams of the spawning process

Note: good for testing locally, shouldn't be done in CI because it breaks Maven Surefire

Returns:

this builder

start

Process start()

Start a process defined by the current state of the builder

Returns:

the started Process

create

static JavaProcessBuilder create(@NotNull
                                 @NotNull Class<?> mainClass)

Creates and returns a new JavaProcessBuilder.

Parameters:

mainClass - to call when starting the process

Returns:

a new JavaProcessBuilder

printProcessOutput

static void printProcessOutput(String processName,
                               Process process)

Log stdout and stderr for a process

ProcessBuilder.inheritIO() didn't play nicely with Maven failsafe plugin

https://maven.apache.org/surefire/maven-failsafe-plugin/faq.html#corruptedstream

getProcessStdErr

static String getProcessStdErr(Process process)

Get process stderr

Parameters:

process - The process

getProcessStdOut

static String getProcessStdOut(Process process)

Get process stdout

Parameters:

process - The process