net.thevpc.nuts.runtime.standalone.util.jclass

Class NJavaSdkUtils

java.lang.Object

net.thevpc.nuts.runtime.standalone.util.jclass.NJavaSdkUtils

public class NJavaSdkUtils
extends Object

Method Summary

Modifier and Type	Method and Description
protected NLog	_LOG()
NId	createJdkId(String version)
NVersionFilter	createVersionFilter(String requestedJavaVersion)
NVersionFilter	createVersionFilterExact(String requestedJavaVersion)
Predicate<String>	createVersionFilterPredicate(NVersionFilter versionFilter)
Predicate<String>	createVersionFilterPredicate(String requestedJavaVersion)
static NPath	currentJavaHome() Effective java home of the currently running JVM.
static Integer	defaultJavaMajorVersion()
String	detectJdkProvider(String name)
NOptional<NRuntimeDistribution>	findJavaDistributionByName(String name) Finds a registered java installation by its name.
NRuntimeDistribution	getHostJvm()
static boolean	isCurrentJavaSpec(String javaVersion) Checks whether the given java version spec denotes the currently running JVM.
static boolean	isJava(NId id)
static boolean	isJavaVersionSpec(String javaVersion) Checks whether the given java version spec is a plain version (such as 11, 1.8.0_452 or 21+35) rather than an alias such as current or a registered java installation name.
List<JavaProvider>	javaProviders()
static List<NClassLoaderNodeExt>	loadNutsClassLoaderNodeExts(NClasspathEntry[] n, boolean java9)
static int	normalizeJavaVersionAsInt(NVersion version)
static NJavaSdkUtils	of()
NOptional<NRuntimeDistribution>	resolveAndInstall(String product, NVersion version, NOsFamily os, NArchFamily arch, String vendor)
String	resolveJavaCommandByHome(String javaHome)
NOptional<String>	resolveJavaCommandByVersion(NRuntimeDistribution nutsPlatformLocation, boolean javaw)
NOptional<String>	resolveJavaCommandByVersion(String requestedJavaVersion, boolean javaw, boolean jdk, boolean ifNotFoundSearchLocally, boolean ifNotFoundSearchRemotely, String removeVendor)
NOptional<NRuntimeDistribution>	resolveJavaDistribution(String javaVersion) Resolves a java version spec that is not a plain version.
NRuntimeDistribution	resolveJdkLocation(NPath path, String preferredName)
NOptional<NRuntimeDistribution>	resolveJdkLocation(String javaVersion, boolean jdk, boolean ifNotFoundSearchLocally, boolean ifNotFoundSearchRemotely, String remoteVendor)
NRuntimeDistribution[]	searchJdkLocations()
NRuntimeDistribution[]	searchJdkLocations(NPath loc)
Future<NRuntimeDistribution[]>	searchJdkLocationsFuture()
Future<NRuntimeDistribution[]>	searchJdkLocationsFuture(NPath s)
NRuntimeDistribution[]	searchRemoteLocationsAndInstall(String product, NVersion version, String vendor)
static NOptional<Integer>	validateJavaMajorVersion(NVersion version)
static NOptional<Integer>	validateJavaMajorVersion(String version)
static Integer	validateJavaMajorVersionOrDefault(NVersion version)
static Integer	validateJavaMajorVersionOrDefault(String version)
static NOptional<String>	validateJavaProduct(String product)
Predicate<NVersion>	validateJavaVersion(NVersionFilter versionFilter)

Methods inherited from class java.lang.Object

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

Method Detail

javaProviders

public List<JavaProvider> javaProviders()

of

public static NJavaSdkUtils of()

defaultJavaMajorVersion

public static Integer defaultJavaMajorVersion()

validateJavaMajorVersionOrDefault

public static Integer validateJavaMajorVersionOrDefault(String version)

validateJavaMajorVersion

public static NOptional<Integer> validateJavaMajorVersion(String version)

validateJavaMajorVersionOrDefault

public static Integer validateJavaMajorVersionOrDefault(NVersion version)

resolveAndInstall

public NOptional<NRuntimeDistribution> resolveAndInstall(String product,
                                                         NVersion version,
                                                         NOsFamily os,
                                                         NArchFamily arch,
                                                         String vendor)

validateJavaMajorVersion

public static NOptional<Integer> validateJavaMajorVersion(NVersion version)

validateJavaProduct

public static NOptional<String> validateJavaProduct(String product)

loadNutsClassLoaderNodeExts

public static List<NClassLoaderNodeExt> loadNutsClassLoaderNodeExts(NClasspathEntry[] n,
                                                                    boolean java9)

isJava

public static boolean isJava(NId id)

_LOG

protected NLog _LOG()

createVersionFilterPredicate

public Predicate<String> createVersionFilterPredicate(String requestedJavaVersion)

createVersionFilterPredicate

public Predicate<String> createVersionFilterPredicate(NVersionFilter versionFilter)

createVersionFilterExact

public NVersionFilter createVersionFilterExact(String requestedJavaVersion)

createVersionFilter

public NVersionFilter createVersionFilter(String requestedJavaVersion)

getHostJvm

public NRuntimeDistribution getHostJvm()

currentJavaHome

public static NPath currentJavaHome()

Effective java home of the currently running JVM. On legacy layouts (java 8 and below) the java.home system property points to the nested jre folder, so the enclosing folder is used whenever the executable is not found in the direct child.

Returns:

java home of the currently running JVM

Since:

1.0.0

isJavaVersionSpec

public static boolean isJavaVersionSpec(String javaVersion)

Checks whether the given java version spec is a plain version (such as 11, 1.8.0_452 or 21+35) rather than an alias such as current or a registered java installation name.

Parameters:

javaVersion - java version spec

Returns:

true if the spec starts with a number and hence can be resolved as a version

Since:

1.0.0

isCurrentJavaSpec

public static boolean isCurrentJavaSpec(String javaVersion)

Checks whether the given java version spec denotes the currently running JVM.

Parameters:

javaVersion - java version spec

Returns:

true if the spec is current

Since:

1.0.0

findJavaDistributionByName

public NOptional<NRuntimeDistribution> findJavaDistributionByName(String name)

Finds a registered java installation by its name.

Parameters:

name - java installation name

Returns:

the matching java installation or an empty optional if no java is registered with that name

Since:

1.0.0

resolveJavaDistribution

public NOptional<NRuntimeDistribution> resolveJavaDistribution(String javaVersion)

Resolves a java version spec that is not a plain version. Two aliases are supported :

• current : the java home of the currently running JVM
• the name of a registered java installation (see NRuntimeDistribution of family java)

Such a spec is honored as is : no other java version is searched for and no new jdk is ever provisioned.

Parameters:

javaVersion - java version spec

Returns:

the resolved java installation, an empty optional if the spec is a plain version (and hence should be resolved the standard way), or an error optional if the spec is neither a version nor a valid alias

Since:

1.0.0

resolveJdkLocation

public NOptional<NRuntimeDistribution> resolveJdkLocation(String javaVersion,
                                                          boolean jdk,
                                                          boolean ifNotFoundSearchLocally,
                                                          boolean ifNotFoundSearchRemotely,
                                                          String remoteVendor)

validateJavaVersion

public Predicate<NVersion> validateJavaVersion(NVersionFilter versionFilter)

searchRemoteLocationsAndInstall

public NRuntimeDistribution[] searchRemoteLocationsAndInstall(String product,
                                                              NVersion version,
                                                              String vendor)

searchJdkLocations

public NRuntimeDistribution[] searchJdkLocations()

searchJdkLocationsFuture

public Future<NRuntimeDistribution[]> searchJdkLocationsFuture()

searchJdkLocations

public NRuntimeDistribution[] searchJdkLocations(NPath loc)

searchJdkLocationsFuture

public Future<NRuntimeDistribution[]> searchJdkLocationsFuture(NPath s)

detectJdkProvider

public String detectJdkProvider(String name)

resolveJdkLocation

public NRuntimeDistribution resolveJdkLocation(NPath path,
                                               String preferredName)

createJdkId

public NId createJdkId(String version)

resolveJavaCommandByVersion

public NOptional<String> resolveJavaCommandByVersion(String requestedJavaVersion,
                                                     boolean javaw,
                                                     boolean jdk,
                                                     boolean ifNotFoundSearchLocally,
                                                     boolean ifNotFoundSearchRemotely,
                                                     String removeVendor)

resolveJavaCommandByVersion

public NOptional<String> resolveJavaCommandByVersion(NRuntimeDistribution nutsPlatformLocation,
                                                     boolean javaw)

normalizeJavaVersionAsInt

public static int normalizeJavaVersionAsInt(NVersion version)

resolveJavaCommandByHome

public String resolveJavaCommandByHome(String javaHome)