net.wasdev.wlp.common.plugins.util

Class InstallFeatureUtil

java.lang.Object

net.wasdev.wlp.common.plugins.util.InstallFeatureUtil

public abstract class InstallFeatureUtil
extends Object

Utility class to install features from Maven repositories.

Field Summary

Fields

Modifier and Type	Field and Description
static String	INSTALL_MAP_ARTIFACT_ID
static String	OPEN_LIBERTY_GROUP_ID
static String	REPOSITORY_RESOLVER_ARTIFACT_ID

Constructor Summary

Constructors

Constructor and Description
InstallFeatureUtil(File installDirectory, String from, String to, Set<String> pluginListedEsas) Initialize the utility and check for unsupported scenarios.

Method Summary

Modifier and Type	Method and Description
static Set<String>	combineToSet(Collection<String>... collections) Combine the given String collections into a set
static boolean	containsIgnoreCase(Collection<String> reference, Collection<String> target) Returns whether the reference collection contains all of the strings in the target collection, ignoring case.
abstract void	debug(String msg) Log debug
abstract void	debug(String msg, Throwable e) Log debug
abstract void	debug(Throwable e) Log debug
abstract File	downloadArtifact(String groupId, String artifactId, String type, String version) Download the artifact from the specified Maven coordinates, or retrieve it from the cache if it already exists.
static String	extractSymbolicName(File jar) Extracts the bundle symbolic name from the jar manifest.
static File	getMapBasedInstallKernelJar(File dir) Find latest install map jar from specified directory
static String	getNextProductVersion(String version) Gets the next product version number.
static Set<String>	getOpenLibertyFeatureSet(Set<File> jsons) Gets the set of all Open Liberty features by scanning the product JSONs.
String	getOverrideBundleDescriptor(String groupId, String artifactId) Download the override bundle from the repository with the given groupId and artifactId, corresponding to the latest version in the range between the current Open Liberty version (inclusive) and the next version (exclusive).
Set<String>	getServerFeatures(File serverDirectory) Get the set of features defined in the server.xml
abstract void	info(String msg) Log info
void	installFeatures(boolean isAcceptLicense, List<String> featuresToInstall) Resolve, download, and install features from a Maven repository.
abstract boolean	isDebugEnabled() Returns whether debug is enabled by the current logger
static String	productInfo(File installDirectory, String action) Runs the productInfo command and returns the output
abstract void	warn(String msg) Log warning

Methods inherited from class java.lang.Object

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

Field Detail

OPEN_LIBERTY_GROUP_ID

public static final String OPEN_LIBERTY_GROUP_ID

See Also:

Constant Field Values

REPOSITORY_RESOLVER_ARTIFACT_ID

public static final String REPOSITORY_RESOLVER_ARTIFACT_ID

See Also:

Constant Field Values

INSTALL_MAP_ARTIFACT_ID

public static final String INSTALL_MAP_ARTIFACT_ID

See Also:

Constant Field Values

Constructor Detail

InstallFeatureUtil

public InstallFeatureUtil(File installDirectory,
                          String from,
                          String to,
                          Set<String> pluginListedEsas)
                   throws PluginScenarioException,
                          PluginExecutionException

Initialize the utility and check for unsupported scenarios.

Parameters:

installDirectory - The install directory

from - The "from" parameter specified in the plugin configuration, or null if not specified

to - The "to" parameter specified in the plugin configuration, or null if not specified

pluginListedEsas - The list of ESAs specified in the plugin configuration, or null if not specified

Throws:

PluginScenarioException - If the current scenario is not supported

PluginExecutionException - If properties files cannot be found in the installDirectory/lib/versions

Method Detail

debug

public abstract void debug(String msg)

Log debug

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 -

isDebugEnabled

public abstract boolean isDebugEnabled()

Returns whether debug is enabled by the current logger

Returns:

whether debug is enabled

downloadArtifact

public abstract File downloadArtifact(String groupId,
                                      String artifactId,
                                      String type,
                                      String version)
                               throws PluginExecutionException

Download the artifact from the specified Maven coordinates, or retrieve it from the cache if it already exists.

Parameters:

groupId - The group ID

artifactId - The artifact ID

type - The type e.g. esa

version - The version

Returns:

The file corresponding to the downloaded artifact

Throws:

PluginExecutionException - If the artifact could not be downloaded

combineToSet

@SafeVarargs
public static Set<String> combineToSet(Collection<String>... collections)

Combine the given String collections into a set

Parameters:

collections - a collection of strings

Returns:

the combined set of strings

getServerFeatures

public Set<String> getServerFeatures(File serverDirectory)

Get the set of features defined in the server.xml

Parameters:

serverDirectory - The server directory containing the server.xml

Returns:

the set of features that should be installed from server.xml, or empty set if nothing should be installed

getOpenLibertyFeatureSet

public static Set<String> getOpenLibertyFeatureSet(Set<File> jsons)
                                            throws PluginExecutionException

Gets the set of all Open Liberty features by scanning the product JSONs.

Parameters:

jsons - The set of product JSON files to scan

Returns:

set of all Open Liberty features

Throws:

PluginExecutionException - if any of the JSONs could not be found

containsIgnoreCase

public static boolean containsIgnoreCase(Collection<String> reference,
                                         Collection<String> target)

Returns whether the reference collection contains all of the strings in the target collection, ignoring case.

Parameters:

reference - The reference collection

target - The target collection

Returns:

true if reference contains all Strings from target, ignoring case

installFeatures

public void installFeatures(boolean isAcceptLicense,
                            List<String> featuresToInstall)
                     throws PluginExecutionException

Resolve, download, and install features from a Maven repository. This method calls the resolver with the given JSONs and feature list, downloads the ESAs corresponding to the resolved features, then installs those features.

Parameters:

jsonRepos - JSON files, each containing an array of metadata for all features in a Liberty release.

featuresToInstall - The list of features to install.

Throws:

PluginExecutionException - if any of the features could not be installed

getOverrideBundleDescriptor

public String getOverrideBundleDescriptor(String groupId,
                                          String artifactId)
                                   throws PluginExecutionException

Download the override bundle from the repository with the given groupId and artifactId, corresponding to the latest version in the range between the current Open Liberty version (inclusive) and the next version (exclusive). Returns a string in the format "filepath;BundleName" where BundleName is the bundle symbolic name from its manifest.

Parameters:

groupId - the groupId of the bundle to download

artifactId - the artifactId of the bundle to download

Returns:

a String representing the bundle in filepath;BundleName format

Throws:

PluginExecutionException

getNextProductVersion

public static String getNextProductVersion(String version)
                                    throws PluginExecutionException

Gets the next product version number.

Parameters:

version - the product version

Returns:

the String representation of the next product version

Throws:

PluginExecutionException

extractSymbolicName

public static String extractSymbolicName(File jar)
                                  throws PluginExecutionException

Extracts the bundle symbolic name from the jar manifest.

Parameters:

jar - the jar from which the symbolic name will be extracted

Returns:

the Bundle-SymbolicName

Throws:

PluginExecutionException

getMapBasedInstallKernelJar

public static File getMapBasedInstallKernelJar(File dir)

Find latest install map jar from specified directory

Returns:

the install map jar file

productInfo

public static String productInfo(File installDirectory,
                                 String action)
                          throws PluginExecutionException

Runs the productInfo command and returns the output

Parameters:

installDirectory - The directory of the installed runtime

action - The action to perform for the productInfo command

Returns:

The command output

Throws:

PluginExecutionException - if the exit value of the command was not 0