Package io.quarkus.test.common

Class LauncherUtil

java.lang.Object

io.quarkus.test.common.LauncherUtil

public final class LauncherUtil
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final int	LOG_CHECK_INTERVAL

Method Summary

Modifier and Type	Method	Description
(package private) static Function<IntegrationTestStartedNotifier.Context,IntegrationTestStartedNotifier.Result>	createStartedFunction()
(package private) static void	destroyProcess(Process quarkusProcess)	Try to destroy the process normally a few times and resort to forceful destruction if necessary
(package private) static void	destroyProcess(ProcessHandle quarkusProcess)
(package private) static void	destroyProcess(Process process, boolean children)
static org.eclipse.microprofile.config.Config	installAndGetSomeConfig()	Deprecated, for removal: This API element is subject to removal in a future version.
(package private) static Process	launchProcess(List<String> args, Map<String,String> env)	Launches a process using the supplied arguments but does drain the IO
(package private) static Process	launchProcessAndDrainIO(List<String> args, Map<String,String> env)	Launches a process using the supplied arguments and makes sure the process's output is drained to standard out
(package private) static void	updateConfigForPort(Integer effectivePort)	Updates the configuration necessary to make all test systems knowledgeable about the port on which the launched process is listening
(package private) static ListeningAddress	waitForCapturedListeningData(Process quarkusProcess, Path logFile, long waitTimeSeconds)	Waits (for a maximum of seconds) until the launched process indicates the address it is listening on.
(package private) static IntegrationTestStartedNotifier.Result	waitForStartedFunction(Function<IntegrationTestStartedNotifier.Context,IntegrationTestStartedNotifier.Result> startedFunction, Process quarkusProcess, long waitTimeSeconds, Path logFile)	Waits for to indicate that the application has started.

Methods inherited from class java.lang.Object

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

Field Details

LOG_CHECK_INTERVAL

public static final int LOG_CHECK_INTERVAL

See Also:

• Constant Field Values

Method Details

installAndGetSomeConfig

@Deprecated(forRemoval=true,
            since="3.17")
public static org.eclipse.microprofile.config.Config installAndGetSomeConfig()

Deprecated, for removal: This API element is subject to removal in a future version.

launchProcessAndDrainIO

static Process launchProcessAndDrainIO(List<String> args,
 Map<String,String> env)
                                throws IOException

Launches a process using the supplied arguments and makes sure the process's output is drained to standard out

Implementation detail: Avoid using ProcessBuilder's redirect here because it causes problems with Maven Failsafe as can be seen in here

Throws:

IOException

launchProcess

static Process launchProcess(List<String> args,
 Map<String,String> env)
                      throws IOException

Launches a process using the supplied arguments but does drain the IO

Throws:

IOException

waitForCapturedListeningData

static ListeningAddress waitForCapturedListeningData(Process quarkusProcess,
 Path logFile,
 long waitTimeSeconds)

Waits (for a maximum of seconds) until the launched process indicates the address it is listening on. If the wait time is exceeded an IllegalStateException is thrown.

destroyProcess

static void destroyProcess(Process quarkusProcess)

Try to destroy the process normally a few times and resort to forceful destruction if necessary

destroyProcess

static void destroyProcess(ProcessHandle quarkusProcess)

destroyProcess

static void destroyProcess(Process process,
 boolean children)

createStartedFunction

static Function<IntegrationTestStartedNotifier.Context,IntegrationTestStartedNotifier.Result> createStartedFunction()

waitForStartedFunction

static IntegrationTestStartedNotifier.Result waitForStartedFunction(Function<IntegrationTestStartedNotifier.Context,IntegrationTestStartedNotifier.Result> startedFunction,
 Process quarkusProcess,
 long waitTimeSeconds,
 Path logFile)

Waits for to indicate that the application has started.

Returns:

the IntegrationTestStartedNotifier.Result indicating a successful start

Throws:

RuntimeException - if no successful start was indicated by

updateConfigForPort

static void updateConfigForPort(Integer effectivePort)

Updates the configuration necessary to make all test systems knowledgeable about the port on which the launched process is listening