io.openliberty.tools.common.plugins.util

Class DevUtil

java.lang.Object

io.openliberty.tools.common.plugins.util.AbstractContainerSupportUtil

io.openliberty.tools.common.plugins.util.DevUtil

public abstract class DevUtil
extends AbstractContainerSupportUtil

Utility class for dev mode.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	DevUtil.TestJob

Field Summary

Fields

Modifier and Type	Field and Description
protected List<String>	destMount
static String	DEVC_HIDDEN_FOLDER
static String	DEVMODE_PROJECT_ROOT
protected AtomicBoolean	hasFeaturesSh
protected AtomicBoolean	serverFullyStarted
static String	SKIP_BETA_INSTALL_WARNING
protected List<String>	srcMount

Constructor Summary

Constructors

Constructor and Description

DevUtil(File buildDirectory, File serverDirectory, File sourceDirectory, File testSourceDirectory, File configDirectory, File projectDirectory, List<File> resourceDirs, boolean hotTests, boolean skipTests, boolean skipUTs, boolean skipITs, String applicationId, long serverStartTimeout, int appStartupTimeout, int appUpdateTimeout, long compileWaitMillis, boolean libertyDebug, boolean useBuildRecompile, boolean gradle, boolean pollingTest, boolean container, File dockerfile, String dockerRunOpts, int dockerBuildTimeout, boolean skipDefaultPorts, JavaCompilerOptions compilerOptions, boolean keepTempDockerfile, String mavenCacheLocation)

Method Summary

Modifier and Type	Method and Description
void	addShutdownHook(ThreadPoolExecutor executor)
abstract void	checkConfigFile(File configFile, File serverDir) Check the configuration file for new features
protected void	cleanTargetDir(File outputDirectory) Delete all the Java class files within the specified directory.
void	cleanUpServerEnv()
void	cleanUpTempConfig()
void	cleanUpTempDockerfile()
abstract boolean	compile(File dir) Compile the specified directory
void	copyConfigFolder(File fileChanged, File srcDir, String targetFileName) Creates a temporary copy of the configuration file and checks the configFile in the temporary directory to avoid install-feature timing issues
void	copyFile(File fileChanged, File srcDir, File targetDir, String targetFileName) Copies the fileChanged from the srcDir to the targetDir.
int	countApplicationUpdatedMessages() Get the number of times the application updated message has appeared in the application log
abstract void	debug(String msg) Log debug
abstract void	debug(String msg, Throwable e) Log debug
abstract void	debug(Throwable e) Log debug
protected void	deleteFile(File deletedFile, File dir, File targetDir, String targetFileName) Deletes the corresponding file in the targetDir.
protected void	deleteJavaFile(File fileChanged, File classesDir, File compileSourceRoot) Given the fileChanged delete the corresponding Java class or directory
protected void	detectFeaturesSh(List<String> dockerfileLines)
protected void	disableOpenJ9SCC(List<String> dockerfileLines) Disables OpenJ9 SCC to speed up build times by injecting environment variable before "RUN configure.sh" is called.
void	enableServerDebug() Enable server debug variables in server.env, using the user specified debug port if it's available, otherwise uses a random available port.
abstract void	error(String msg) Log error
abstract void	error(String msg, Throwable e) Log error
int	findAvailablePort(int preferredPort, boolean isDebugPort) Finds an available port to use.
abstract List<String>	getArtifacts() Updates artifacts of current project
protected Set<File>	getClassPath(List<String> artifactPaths, List<File> outputDirs) Gets the class path for the specified artifactPaths and outputDirs.
protected static List<String>	getCleanedLines(List<String> dockerfileLines) Trim all lines and get them without comments or empty lines after the first FROM command (so that directives at the beginning of the file are preserved)
protected static List<String>	getCombinedLines(List<String> dockerfileLines, char escape) Combine multi-line commands into single lines.
String	getContainerName()
Map<String,String>	getDebugEnvironmentVariables() Gets a map of the environment variables to set for debug mode.
protected static char	getEscapeCharacter(List<String> dockerfileLines) Get escape character from the escape directive at the top of the Dockerfile.
protected File	getFileFromConfigDirectory(String file) Get the file from the configDirectory if it exists
String	getHostName() Gets the Liberty server's host name.
String	getHttpPort() Gets the Liberty server's http port.
String	getHttpsPort() Gets the Liberty server's https port.
abstract String	getProjectName() Get the name of the current project running dev mode.
abstract String	getServerStartTimeoutExample() Get an example command using the server start timeout parameter.
abstract io.openliberty.tools.ant.ServerTask	getServerTask() Get the ServerTask to start the server, which can be in either "run" or "debug" mode
abstract void	info(String msg) Log info
abstract boolean	isDebugEnabled() Returns whether debug is enabled by the current logger
protected boolean	isGeneratedConfigFile(File fileChanged, File srcDir, File targetDir) Determines if the corresponding target config file was generated by a Liberty plugin
abstract boolean	isLooseApplication() Is the application deployed as a loose application.
abstract void	libertyCreate()
abstract void	libertyDeploy()
abstract void	libertyInstallFeature() Install features in regular dev mode.
protected int	parseHostName(String webAppMessage)
protected void	parseHttpPort(String webAppMessage, int portPrefixIndex)
protected void	parseHttpsPort(List<String> messages)
protected static String[]	parseNetworks(String dockerResult) Parses Docker network names from a "docker inspect" command result on a container.
protected File	prepareTempDockerfile(File dockerfile)
protected void	processCopyLines(List<String> dockerfileLines, String buildContext)
protected List<String>	readDockerfile(File dockerfile)
String	readFile(File file) Reads the file to a String
abstract boolean	recompileBuildFile(File buildFile, List<String> artifactPaths, ThreadPoolExecutor executor) Recompile the build file
protected boolean	recompileJava(Collection<File> javaFilesChanged, List<String> artifactPaths, ThreadPoolExecutor executor, boolean tests, File outputDirectory, File testOutputDirectory) Recompile source files
protected boolean	recompileJavaSource(Collection<File> javaFilesChanged, List<String> artifactPaths, ThreadPoolExecutor executor, File outputDirectory, File testOutputDirectory) Recompile Java source files and run tests after application update
protected boolean	recompileJavaTest(Collection<File> javaFilesChanged, List<String> artifactPaths, ThreadPoolExecutor executor, File outputDirectory, File testOutputDirectory) Recompile test source files and run tests immediately
abstract void	redeployApp() Redeploy the application
protected void	registerAll(Path start, ThreadPoolExecutor executor) Register the parent directory and all sub-directories with the WatchService
protected void	registerAll(Path start, ThreadPoolExecutor executor, boolean removeOnContainerRebuild) Register the parent directory and all sub-directories with the WatchService
protected static String	removeSurroundingQuotes(String str)
protected void	removeWarFileLines(List<String> dockerfileLines)
void	restartServer()
void	restartServer(boolean buildContainer) Stop the server, set up Liberty and restart it.
void	runHotkeyReaderThread(ThreadPoolExecutor executor) Run a hotkey reader thread.
abstract void	runIntegrationTests() Run the integration tests
void	runTests(boolean waitForApplicationUpdate, int messageOccurrences, ThreadPoolExecutor executor, boolean forceSkipUTs) Run unit and/or integration tests
void	runTestThread(boolean waitForApplicationUpdate, ThreadPoolExecutor executor, int messageOccurrences, boolean forceSkipUTs, boolean manualInvocation) Run tests in a new thread.
abstract void	runUnitTests() Run the unit tests
void	setDevStop(boolean devStop) Whether dev mode intentionally caused the server to stop.
void	setLibertyDebugPort(int libertyDebugPort) Sets the preferred debug port.
void	setPropertyFiles(List<File> propertyFiles) This is needed for Gradle only.
void	startServer()
void	startServer(boolean buildContainer, boolean pullParentImage) Start the server and keep it running in a background thread.
abstract void	stopServer() Stop the server
abstract void	warn(String msg) Log warning
void	watchFiles(File buildFile, File outputDirectory, File testOutputDirectory, ThreadPoolExecutor executor, List<String> artifactPaths, File serverXmlFile, File bootstrapPropertiesFile, File jvmOptionsFile)

Methods inherited from class io.openliberty.tools.common.plugins.util.AbstractContainerSupportUtil

execDockerCmd, readStdOut

Methods inherited from class java.lang.Object

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

Field Detail

DEVMODE_PROJECT_ROOT

public static final String DEVMODE_PROJECT_ROOT

See Also:

Constant Field Values

SKIP_BETA_INSTALL_WARNING

public static final String SKIP_BETA_INSTALL_WARNING

See Also:

Constant Field Values

DEVC_HIDDEN_FOLDER

public static final String DEVC_HIDDEN_FOLDER

See Also:

Constant Field Values

srcMount

protected List<String> srcMount

destMount

protected List<String> destMount

hasFeaturesSh

protected AtomicBoolean hasFeaturesSh

serverFullyStarted

protected AtomicBoolean serverFullyStarted

Constructor Detail

DevUtil

public DevUtil(File buildDirectory,
               File serverDirectory,
               File sourceDirectory,
               File testSourceDirectory,
               File configDirectory,
               File projectDirectory,
               List<File> resourceDirs,
               boolean hotTests,
               boolean skipTests,
               boolean skipUTs,
               boolean skipITs,
               String applicationId,
               long serverStartTimeout,
               int appStartupTimeout,
               int appUpdateTimeout,
               long compileWaitMillis,
               boolean libertyDebug,
               boolean useBuildRecompile,
               boolean gradle,
               boolean pollingTest,
               boolean container,
               File dockerfile,
               String dockerRunOpts,
               int dockerBuildTimeout,
               boolean skipDefaultPorts,
               JavaCompilerOptions compilerOptions,
               boolean keepTempDockerfile,
               String mavenCacheLocation)

Method Detail

debug

public abstract void debug(String msg)

Log debug

Specified by:

debug in class AbstractContainerSupportUtil

Parameters:

msg -

debug

public abstract void debug(String msg,
                           Throwable e)

Log debug

Parameters:

msg -

e -

debug

public abstract void debug(Throwable e)

Log debug

Parameters:

e -

warn

public abstract void warn(String msg)

Log warning

Parameters:

msg -

info

public abstract void info(String msg)

Log info

Parameters:

msg -

error

public abstract void error(String msg)

Log error

Parameters:

msg -

error

public abstract void error(String msg,
                           Throwable e)

Log error

Specified by:

error in class AbstractContainerSupportUtil

Parameters:

msg -

e -

isDebugEnabled

public abstract boolean isDebugEnabled()

Returns whether debug is enabled by the current logger

Returns:

whether debug is enabled

getArtifacts

public abstract List<String> getArtifacts()

Updates artifacts of current project

recompileBuildFile

public abstract boolean recompileBuildFile(File buildFile,
                                           List<String> artifactPaths,
                                           ThreadPoolExecutor executor)
                                    throws PluginExecutionException

Recompile the build file

Parameters:

buildFile -

artifactPaths -

executor - The thread pool executor

Returns:

true if the build file was recompiled with changes

Throws:

PluginExecutionException - if there was an error when restarting the server

runUnitTests

public abstract void runUnitTests()
                           throws PluginScenarioException,
                                  PluginExecutionException

Run the unit tests

Throws:

PluginScenarioException - if unit tests failed

PluginExecutionException - if unit tests could not be run

runIntegrationTests

public abstract void runIntegrationTests()
                                  throws PluginScenarioException,
                                         PluginExecutionException

Run the integration tests

Throws:

PluginScenarioException - if integration tests failed

PluginExecutionException - if integration tests could not be run

checkConfigFile

public abstract void checkConfigFile(File configFile,
                                     File serverDir)

Check the configuration file for new features

Parameters:

configFile -

serverDir -

compile

public abstract boolean compile(File dir)

Compile the specified directory

Parameters:

dir -

Returns:

stopServer

public abstract void stopServer()

Stop the server

getServerTask

public abstract io.openliberty.tools.ant.ServerTask getServerTask()
                                                           throws Exception

Get the ServerTask to start the server, which can be in either "run" or "debug" mode

Returns:

ServerTask the task to start the server

Throws:

Exception - if there was an error copying/creating config files

redeployApp

public abstract void redeployApp()
                          throws PluginExecutionException

Redeploy the application

Throws:

PluginExecutionException

getServerStartTimeoutExample

public abstract String getServerStartTimeoutExample()

Get an example command using the server start timeout parameter. The example command is unique to each plugin.

Returns:

String containing the example command

getProjectName

public abstract String getProjectName()

Get the name of the current project running dev mode.

Returns:

String of the project name

isLooseApplication

public abstract boolean isLooseApplication()

Is the application deployed as a loose application.

runTests

public void runTests(boolean waitForApplicationUpdate,
                     int messageOccurrences,
                     ThreadPoolExecutor executor,
                     boolean forceSkipUTs)

Run unit and/or integration tests

Parameters:

waitForApplicationUpdate - Whether to wait for the application to update before running integration tests

messageOccurrences - The previous number of times the application updated message has appeared.

executor - The thread pool executor

forceSkipUTs - Whether to force skip the unit tests

countApplicationUpdatedMessages

public int countApplicationUpdatedMessages()

Get the number of times the application updated message has appeared in the application log

Returns:

the number of times the application has updated

startServer

public void startServer()
                 throws PluginExecutionException

Throws:

PluginExecutionException

startServer

public void startServer(boolean buildContainer,
                        boolean pullParentImage)
                 throws PluginExecutionException

Start the server and keep it running in a background thread.

Parameters:

buildContainer - Force a Docker build when in container mode. Ignored otherwise.

pullParentImage - If buildContainer is true, this determines whether the Docker build should also pull the latest parent image. Ignored otherwise.

Throws:

PluginExecutionException - If the server startup could not be verified within the timeout, or server startup failed.

readDockerfile

protected List<String> readDockerfile(File dockerfile)
                               throws PluginExecutionException

Throws:

PluginExecutionException

getEscapeCharacter

protected static char getEscapeCharacter(List<String> dockerfileLines)
                                  throws PluginExecutionException

Get escape character from the escape directive at the top of the Dockerfile. Docker documents a couple of directives, but it seems escape must always be the first line to work.

Throws:

PluginExecutionException

getCleanedLines

protected static List<String> getCleanedLines(List<String> dockerfileLines)
                                       throws PluginExecutionException

Trim all lines and get them without comments or empty lines after the first FROM command (so that directives at the beginning of the file are preserved)

Throws:

PluginExecutionException

getCombinedLines

protected static List<String> getCombinedLines(List<String> dockerfileLines,
                                               char escape)
                                        throws PluginExecutionException

Combine multi-line commands into single lines. Requires that getCleanedLines() be called first.

Throws:

PluginExecutionException

removeWarFileLines

protected void removeWarFileLines(List<String> dockerfileLines)
                           throws PluginExecutionException

Throws:

PluginExecutionException

disableOpenJ9SCC

protected void disableOpenJ9SCC(List<String> dockerfileLines)

Disables OpenJ9 SCC to speed up build times by injecting environment variable before "RUN configure.sh" is called. Reference: https://github.com/OpenLiberty/ci.docker#openj9-shared-class-cache-scc
Note: lines must have been trimmed and cleaned of comments using getCleanedLines() before calling this.

detectFeaturesSh

protected void detectFeaturesSh(List<String> dockerfileLines)

processCopyLines

protected void processCopyLines(List<String> dockerfileLines,
                                String buildContext)
                         throws PluginExecutionException

Throws:

PluginExecutionException

prepareTempDockerfile

protected File prepareTempDockerfile(File dockerfile)
                              throws PluginExecutionException

Throws:

PluginExecutionException

parseNetworks

protected static String[] parseNetworks(String dockerResult)

Parses Docker network names from a "docker inspect" command result on a container.

Parameters:

dockerResult - the result from the command "docker inspect -f '{{.NetworkSettings.Networks}}' containerName" -> dockerResult must not contain surrounding quotes or leading/trailing whitespace

Returns:

a String array containing the names of the networks contained in the dockerResult parameter

removeSurroundingQuotes

protected static String removeSurroundingQuotes(String str)

libertyCreate

public abstract void libertyCreate()
                            throws PluginExecutionException

Throws:

PluginExecutionException

libertyDeploy

public abstract void libertyDeploy()
                            throws PluginExecutionException

Throws:

PluginExecutionException

libertyInstallFeature

public abstract void libertyInstallFeature()
                                    throws PluginExecutionException

Install features in regular dev mode. This method should not be used in container mode.

Throws:

PluginExecutionException

restartServer

public void restartServer()
                   throws PluginExecutionException

Throws:

PluginExecutionException

restartServer

public void restartServer(boolean buildContainer)
                   throws PluginExecutionException

Stop the server, set up Liberty and restart it.

Parameters:

buildContainer - Force a Docker build when in container mode. Ignored otherwise.

Throws:

PluginExecutionException

parseHostName

protected int parseHostName(String webAppMessage)
                     throws PluginExecutionException

Throws:

PluginExecutionException

parseHttpPort

protected void parseHttpPort(String webAppMessage,
                             int portPrefixIndex)

parseHttpsPort

protected void parseHttpsPort(List<String> messages)
                       throws PluginExecutionException

Throws:

PluginExecutionException

cleanUpServerEnv

public void cleanUpServerEnv()

cleanUpTempConfig

public void cleanUpTempConfig()

cleanUpTempDockerfile

public void cleanUpTempDockerfile()

setDevStop

public void setDevStop(boolean devStop)

Whether dev mode intentionally caused the server to stop.

Parameters:

devStop - If true, stopping the server will not cause dev mode to print an error message.

addShutdownHook

public void addShutdownHook(ThreadPoolExecutor executor)

getDebugEnvironmentVariables

public Map<String,String> getDebugEnvironmentVariables()
                                                throws IOException

Gets a map of the environment variables to set for debug mode.

Parameters:

libertyDebugPort - the debug port to use

Throws:

IOException

enableServerDebug

public void enableServerDebug()
                       throws IOException

Enable server debug variables in server.env, using the user specified debug port if it's available, otherwise uses a random available port.

Throws:

IOException - if there was an IO exception when reading or writing the server.env

findAvailablePort

public int findAvailablePort(int preferredPort,
                             boolean isDebugPort)
                      throws IOException

Finds an available port to use. There are two semantics. If looking for a port for the server debug connection and the port is in use then return an ephemeral port. If looking for a port for the server http connection then try sequential port numbers. In the case of the server debug connection, if the preferred port is not available, return a random available port and cache the result which will override the preferredPort if this method is called again.

Parameters:

The - number of the port to start the search for an available port.

Whether - to choose an ephemeral port. True to choose an ephemeral port, false to search sequentially.

Returns:

An available port.

Throws:

IOException - if it could not find any available port, or there was an error when opening a server socket regardless of port.

runHotkeyReaderThread

public void runHotkeyReaderThread(ThreadPoolExecutor executor)

Run a hotkey reader thread. If the thread is already running, re-prints the message about pressing enter to run tests.

Parameters:

executor - the test thread executor

watchFiles

public void watchFiles(File buildFile,
                       File outputDirectory,
                       File testOutputDirectory,
                       ThreadPoolExecutor executor,
                       List<String> artifactPaths,
                       File serverXmlFile,
                       File bootstrapPropertiesFile,
                       File jvmOptionsFile)
                throws Exception

Throws:

Exception

isGeneratedConfigFile

protected boolean isGeneratedConfigFile(File fileChanged,
                                        File srcDir,
                                        File targetDir)
                                 throws IOException

Determines if the corresponding target config file was generated by a Liberty plugin

Parameters:

fileChanged - the file that was changed

srcDir - the directory of the file changed

targetDir - the target directory

Throws:

IOException - unable to resolve canonical path

readFile

public String readFile(File file)
                throws IOException

Reads the file to a String

Parameters:

file -

Returns:

String representation of the file

Throws:

IOException - unable to read file to string

copyConfigFolder

public void copyConfigFolder(File fileChanged,
                             File srcDir,
                             String targetFileName)
                      throws IOException

Creates a temporary copy of the configuration file and checks the configFile in the temporary directory to avoid install-feature timing issues

Parameters:

fileChanged - the file that was changed

srcDir - the directory of the file changed

targetFileName - if not null renames the fileChanged to targetFileName in the targetDir

Throws:

IOException - creating and copying to tempConfig directory

copyFile

public void copyFile(File fileChanged,
                     File srcDir,
                     File targetDir,
                     String targetFileName)
              throws IOException

Copies the fileChanged from the srcDir to the targetDir.

Parameters:

fileChanged - the file that was changed

srcDir - the directory of the file changed

targetDir - the target directory

targetFileName - if not null renames the fileChanged to targetFileName in the targetDir

Throws:

IOException - unable to resolve canonical path

deleteFile

protected void deleteFile(File deletedFile,
                          File dir,
                          File targetDir,
                          String targetFileName)
                   throws IOException

Deletes the corresponding file in the targetDir.

Parameters:

deletedFile - the file that was deleted

dir - the directory of the deletedFile

targetDir - the corresponding targetDir of the deletedFile

targetFileName - if not null deletes the targetFile with this name

Throws:

IOException - unable to resolve canonical path

cleanTargetDir

protected void cleanTargetDir(File outputDirectory)

Delete all the Java class files within the specified directory. If the directory is empty, deletes the directory as well.

Parameters:

outputDirectory - the directory for compiled classes

registerAll

protected void registerAll(Path start,
                           ThreadPoolExecutor executor)
                    throws IOException

Register the parent directory and all sub-directories with the WatchService

Parameters:

start - parent directory

executor - the test thread executor

Throws:

IOException - unable to walk through file tree

registerAll

protected void registerAll(Path start,
                           ThreadPoolExecutor executor,
                           boolean removeOnContainerRebuild)
                    throws IOException

Register the parent directory and all sub-directories with the WatchService

Parameters:

start - parent directory

executor - the test thread executor

removeOnContainerRebuild - whether the files should be unwatched if the container is rebuilt

Throws:

IOException - unable to walk through file tree

getFileFromConfigDirectory

protected File getFileFromConfigDirectory(String file)

Get the file from the configDirectory if it exists

Parameters:

file -

Returns:

file or null if it does not exist

deleteJavaFile

protected void deleteJavaFile(File fileChanged,
                              File classesDir,
                              File compileSourceRoot)
                       throws IOException

Given the fileChanged delete the corresponding Java class or directory

Parameters:

fileChanged - Java file changed

classesDir - the directory for compiled classes

compileSourceRoot - the source directory for the Java classes

Throws:

IOException - unable to resolve canonical path

recompileJavaSource

protected boolean recompileJavaSource(Collection<File> javaFilesChanged,
                                      List<String> artifactPaths,
                                      ThreadPoolExecutor executor,
                                      File outputDirectory,
                                      File testOutputDirectory)
                               throws PluginExecutionException

Recompile Java source files and run tests after application update

Parameters:

javaFilesChanged - collection of Java files changed

artifactPaths - list of project artifact paths for building the classpath

executor - the test thread executor

outputDirectory - the directory for compiled classes

testOutputDirectory - the directory for compiled test classes

Throws:

PluginExecutionException - if the classes output directory doesn't exist and can't be created

recompileJavaTest

protected boolean recompileJavaTest(Collection<File> javaFilesChanged,
                                    List<String> artifactPaths,
                                    ThreadPoolExecutor executor,
                                    File outputDirectory,
                                    File testOutputDirectory)
                             throws PluginExecutionException

Recompile test source files and run tests immediately

Parameters:

javaFilesChanged - collection of Java files changed

artifactPaths - list of project artifact paths for building the classpath

executor - the test thread executor

outputDirectory - the directory for compiled classes

testOutputDirectory - the directory for compiled test classes

Throws:

PluginExecutionException - if the classes output directory doesn't exist and can't be created

recompileJava

protected boolean recompileJava(Collection<File> javaFilesChanged,
                                List<String> artifactPaths,
                                ThreadPoolExecutor executor,
                                boolean tests,
                                File outputDirectory,
                                File testOutputDirectory)
                         throws PluginExecutionException

Recompile source files

Parameters:

javaFilesChanged - collection of Java files changed

artifactPaths - list of project artifact paths for building the classpath

executor - the test thread executor

tests - indicates whether the files changed were test files

outputDirectory - the directory for compiled classes

testOutputDirectory - the directory for compiled test classes

Throws:

PluginExecutionException - if the classes output directory doesn't exist and can't be created

getClassPath

protected Set<File> getClassPath(List<String> artifactPaths,
                                 List<File> outputDirs)
                          throws IOException

Gets the class path for the specified artifactPaths and outputDirs.

Parameters:

artifactPaths - list of artifacts for the current project

outputDirs - list of output directories for the current project

Returns:

set of classpath files

Throws:

IOException - unable to resolve canonical path

runTestThread

public void runTestThread(boolean waitForApplicationUpdate,
                          ThreadPoolExecutor executor,
                          int messageOccurrences,
                          boolean forceSkipUTs,
                          boolean manualInvocation)

Run tests in a new thread.

Parameters:

waitForApplicationUpdate - whether it should wait for the application to update before running integration tests

executor - the thread pool executor

messageOccurrences - how many times the application updated message has occurred in the log

forceSkipUTs - whether to force skip the unit tests

manualInvocation - whether the tests were manually invoked

getHostName

public String getHostName()

Gets the Liberty server's host name.

Returns:

hostName the host name, or null if the server is not started

getHttpPort

public String getHttpPort()

Gets the Liberty server's http port.

Returns:

httpPort the http port, or null if the server is not started or there is no http port bound

getHttpsPort

public String getHttpsPort()

Gets the Liberty server's https port.

Returns:

httpsPort the https port, or null if the server is not started or there is no https port bound

setLibertyDebugPort

public void setLibertyDebugPort(int libertyDebugPort)

Sets the preferred debug port.

Parameters:

libertyDebugPort - the preferred debug port

setPropertyFiles

public void setPropertyFiles(List<File> propertyFiles)

This is needed for Gradle only. Sets additional property files that may be used by the build. Loads the properties for later comparison of changes.

Parameters:

propertyFiles - list of property files

getContainerName

public String getContainerName()