org.openjfx.JavaFXBaseMojo Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of javafx-maven-plugin Show documentation
Show all versions of javafx-maven-plugin Show documentation
The JavaFX Plugin is used to run JavaFX 11+ projects
/*
* Copyright 2019, 2020, Gluon
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.openjfx;
import org.apache.commons.exec.CommandLine;
import org.apache.commons.exec.ExecuteException;
import org.apache.commons.exec.ExecuteResultHandler;
import org.apache.commons.exec.Executor;
import org.apache.commons.exec.OS;
import org.apache.commons.exec.ProcessDestroyer;
import org.apache.commons.exec.PumpStreamHandler;
import org.apache.commons.exec.ShutdownHookProcessDestroyer;
import org.apache.maven.artifact.Artifact;
import org.apache.maven.artifact.DependencyResolutionRequiredException;
import org.apache.maven.execution.MavenSession;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.BuildPluginManager;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugins.annotations.Component;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.project.MavenProject;
import org.codehaus.plexus.languages.java.jpms.JavaModuleDescriptor;
import org.codehaus.plexus.languages.java.jpms.LocationManager;
import org.codehaus.plexus.languages.java.jpms.ModuleNameSource;
import org.codehaus.plexus.languages.java.jpms.ResolvePathsRequest;
import org.codehaus.plexus.languages.java.jpms.ResolvePathsResult;
import org.codehaus.plexus.util.StringUtils;
import org.codehaus.plexus.util.cli.CommandLineUtils;
import org.openjfx.model.RuntimePathOption;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLClassLoader;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Properties;
import java.util.stream.Collectors;
import java.util.stream.Stream;
import static org.openjfx.model.RuntimePathOption.CLASSPATH;
import static org.openjfx.model.RuntimePathOption.MODULEPATH;
abstract class JavaFXBaseMojo extends AbstractMojo {
private static final String JAVAFX_APPLICATION_CLASS_NAME = "javafx.application.Application";
static final String JAVAFX_PREFIX = "javafx";
@Parameter(defaultValue = "${project}", readonly = true)
MavenProject project;
@Parameter(defaultValue = "${session}", readonly = true)
private MavenSession session;
@Component
private BuildPluginManager pluginManager;
@Component
private LocationManager locationManager;
@Parameter(property = "javafx.mainClass", required = true)
String mainClass;
/**
* Skip the execution.
*/
@Parameter(property = "javafx.skip", defaultValue = "false")
boolean skip;
@Parameter(readonly = true, required = true, defaultValue = "${basedir}")
File basedir;
@Parameter(readonly = true, required = true, defaultValue = "${project.build.directory}")
File builddir;
/**
* Type of {@link RuntimePathOption} to run the application.
*/
@Parameter(property = "javafx.runtimePathOption")
RuntimePathOption runtimePathOption;
/**
* The current working directory. Optional. If not specified, basedir will be used.
*/
@Parameter(property = "javafx.workingDirectory")
File workingDirectory;
@Parameter(defaultValue = "${project.compileClasspathElements}", readonly = true, required = true)
private List compilePath;
@Parameter(property = "javafx.outputFile")
File outputFile;
/**
* If set to true the child process executes asynchronously and build execution continues in parallel.
*/
@Parameter(property = "javafx.async", defaultValue = "false")
private boolean async;
/**
* If set to true, the asynchronous child process is destroyed upon JVM shutdown. If set to false, asynchronous
* child process continues execution after JVM shutdown. Applies only to asynchronous processes; ignored for
* synchronous processes.
*/
@Parameter(property = "javafx.asyncDestroyOnShutdown", defaultValue = "true")
private boolean asyncDestroyOnShutdown;
/**
*
* A list of vm options passed to the {@code executable}.
*
*
*/
@Parameter
List options;
/**
* Arguments separated by space for the executed program. For example: "-j 20"
*/
@Parameter(property = "javafx.args")
String commandlineArgs;
/**
* The -source argument for the Java compiler.
*/
@Parameter(property = "javafx.source", defaultValue = "11")
private String source;
/**
* The -target argument for the Java compiler.
*/
@Parameter(property = "javafx.target", defaultValue = "11")
private String target;
/**
* The -release argument for the Java compiler
*/
@Parameter(property = "javafx.release", defaultValue = "11")
private String release;
/**
* If set to true, it will include the dependencies that
* generate path exceptions in the classpath. Default is false.
*/
@Parameter(property = "javafx.includePathExceptionsInClasspath", defaultValue = "false")
private boolean includePathExceptionsInClasspath;
List classpathElements;
List modulepathElements;
Map pathElements;
JavaModuleDescriptor moduleDescriptor;
private ProcessDestroyer processDestroyer;
static boolean isMavenUsingJava8() {
return System.getProperty("java.version").startsWith("1.8");
}
static boolean isTargetUsingJava8(CommandLine commandLine) {
final String java = commandLine.getExecutable();
return java != null && Files.exists(Paths.get(java).resolve("../../jre/lib/rt.jar").normalize());
}
void preparePaths(Path jdkHome) throws MojoExecutionException {
if (project == null) {
return;
}
String outputDirectory = project.getBuild().getOutputDirectory();
if (outputDirectory == null || outputDirectory.isEmpty()) {
throw new MojoExecutionException("Error: Output directory doesn't exist");
}
File[] classes = new File(outputDirectory).listFiles();
if (classes == null || classes.length == 0) {
throw new MojoExecutionException("Error: Output directory is empty");
}
File moduleDescriptorPath = Stream
.of(classes)
.filter(file -> "module-info.class".equals(file.getName()))
.findFirst()
.orElse(null);
modulepathElements = new ArrayList<>(compilePath.size());
classpathElements = new ArrayList<>(compilePath.size());
pathElements = new LinkedHashMap<>(compilePath.size());
try {
Collection dependencyArtifacts = getCompileClasspathElements(project);
getLog().debug("Total dependencyArtifacts: " + dependencyArtifacts.size());
ResolvePathsRequest fileResolvePathsRequest = ResolvePathsRequest.ofFiles(dependencyArtifacts);
getLog().debug("module descriptor path: " + moduleDescriptorPath);
if (moduleDescriptorPath != null) {
fileResolvePathsRequest.setMainModuleDescriptor(moduleDescriptorPath);
}
if (jdkHome != null) {
fileResolvePathsRequest.setJdkHome(jdkHome.toFile());
}
ResolvePathsResult resolvePathsResult = locationManager.resolvePaths(fileResolvePathsRequest);
resolvePathsResult.getPathElements().forEach((key, value) -> pathElements.put(key.getPath(), value));
if (runtimePathOption == MODULEPATH && moduleDescriptorPath == null) {
throw new MojoExecutionException("module-info.java file is required for MODULEPATH runtimePathOption");
}
if (moduleDescriptorPath != null) {
if (!resolvePathsResult.getPathExceptions().isEmpty() && !isMavenUsingJava8()) {
// for each path exception, show a warning to plugin user...
for (Map.Entry pathException : resolvePathsResult.getPathExceptions().entrySet()) {
Throwable cause = pathException.getValue();
while (cause.getCause() != null) {
cause = cause.getCause();
}
String fileName = pathException.getKey().getName();
getLog().warn("Can't extract module name from " + fileName + ": " + cause.getMessage());
}
// ...if includePathExceptionsInClasspath is NOT enabled; provide configuration hint to plugin user
if (!includePathExceptionsInClasspath) {
getLog().warn("Some dependencies encountered issues while attempting to be resolved as modules" +
" and will not be included in the classpath; you can change this behavior via the " +
" 'includePathExceptionsInClasspath' configuration parameter.");
}
}
moduleDescriptor = createModuleDescriptor(resolvePathsResult);
for (Map.Entry entry : resolvePathsResult.getModulepathElements().entrySet()) {
if (ModuleNameSource.FILENAME.equals(entry.getValue())) {
final String message = "Required filename-based automodules detected. "
+ "Please don't publish this project to a public artifact repository!";
if (moduleDescriptor != null && moduleDescriptor.exports().isEmpty()) {
// application
getLog().info(message);
} else {
// library
getLog().warn(message);
}
break;
}
}
resolvePathsResult.getClasspathElements().forEach(file -> classpathElements.add(file.getPath()));
resolvePathsResult.getModulepathElements().keySet().forEach(file -> modulepathElements.add(file.getPath()));
if (includePathExceptionsInClasspath) {
resolvePathsResult.getPathExceptions().keySet()
.forEach(file -> classpathElements.add(file.getPath()));
}
} else {
// non-modular projects
pathElements.forEach((k, v) -> {
if (v != null && v.name() != null && v.name().startsWith(JAVAFX_PREFIX)) {
// only JavaFX jars are required in the module-path
modulepathElements.add(k);
} else {
classpathElements.add(k);
}
});
}
} catch (Exception e) {
getLog().warn(e.getMessage());
}
if (runtimePathOption == MODULEPATH) {
getLog().debug(runtimePathOption + " runtimePathOption set by user. Moving all jars to modulepath.");
modulepathElements.addAll(classpathElements);
classpathElements.clear();
} else if (runtimePathOption == CLASSPATH) {
getLog().debug(runtimePathOption + " runtimePathOption set by user. Moving all jars to classpath.");
classpathElements.addAll(modulepathElements);
modulepathElements.clear();
if (mainClass.contains("/")) {
getLog().warn("Module name found in with runtimePathOption set as CLASSPATH. Module name will be ignored.");
}
if (doesExtendFXApplication(createMainClassString(mainClass, moduleDescriptor, runtimePathOption))) {
throw new MojoExecutionException("Launcher class is required. Main-class cannot extend Application when running JavaFX application on CLASSPATH");
}
}
getLog().debug("Classpath:" + classpathElements.size());
classpathElements.forEach(s -> getLog().debug(" " + s));
getLog().debug("Modulepath: " + modulepathElements.size());
modulepathElements.forEach(s -> getLog().debug(" " + s));
getLog().debug("pathElements: " + pathElements.size());
pathElements.forEach((k, v) -> getLog().debug(" " + k + " :: " + (v != null && v.name() != null ? v.name() : v)));
}
private JavaModuleDescriptor createModuleDescriptor(ResolvePathsResult resolvePathsResult) throws MojoExecutionException {
if (runtimePathOption == CLASSPATH) {
getLog().info(CLASSPATH + " runtimePathOption set by user. module-info.java will be ignored.");
return null;
}
return resolvePathsResult.getMainModuleDescriptor();
}
private List getCompileClasspathElements(MavenProject project) {
List list = new ArrayList<>();
list.add(new File(project.getBuild().getOutputDirectory()));
// include systemPath dependencies
list.addAll(project.getDependencies().stream()
.filter(d -> d.getSystemPath() != null && ! d.getSystemPath().isEmpty())
.map(d -> new File(d.getSystemPath()))
.collect(Collectors.toList()));
list.addAll(project.getArtifacts().stream()
.sorted((a1, a2) -> {
int compare = a1.compareTo(a2);
if (compare == 0) {
// give precedence to classifiers
return a1.hasClassifier() ? 1 : (a2.hasClassifier() ? -1 : 0);
}
return compare;
})
.map(Artifact::getFile)
.collect(Collectors.toList()));
return list.stream()
.distinct()
.collect(Collectors.toList());
}
void handleWorkingDirectory() throws MojoExecutionException {
if (workingDirectory == null) {
workingDirectory = basedir;
}
if (!workingDirectory.exists()) {
getLog().debug("Making working directory '" + workingDirectory.getAbsolutePath() + "'.");
if (!workingDirectory.mkdirs()) {
throw new MojoExecutionException("Could not make working directory: '" + workingDirectory.getAbsolutePath() + "'");
}
}
}
Map handleSystemEnvVariables() {
Map enviro = new HashMap<>();
try {
Properties systemEnvVars = CommandLineUtils.getSystemEnvVars();
for (Map.Entry entry : systemEnvVars.entrySet()) {
enviro.put((String) entry.getKey(), (String) entry.getValue());
}
} catch (IOException x) {
getLog().error("Could not assign default system environment variables.", x);
}
return enviro;
}
CommandLine getExecutablePath(String executable, Map enviro, File dir) {
File execFile = new File(executable);
String exec = null;
if (execFile.isFile()) {
getLog().debug("Toolchains are ignored, 'executable' parameter is set to " + executable);
exec = execFile.getAbsolutePath();
}
if (exec == null) {
String javaHomeFromEnv = getJavaHomeEnv(enviro);
if (javaHomeFromEnv != null && ! javaHomeFromEnv.isEmpty()) {
exec = findExecutable(executable, Arrays.asList(javaHomeFromEnv.concat(File.separator).concat("bin")));
}
}
if (exec == null && OS.isFamilyWindows()) {
List paths = this.getExecutablePaths(enviro);
paths.add(0, dir.getAbsolutePath());
exec = findExecutable(executable, paths);
}
if (exec == null) {
exec = executable;
}
CommandLine toRet;
if (OS.isFamilyWindows() && !hasNativeExtension(exec) && hasExecutableExtension(exec) ) {
// run the windows batch script in isolation and exit at the end
final String comSpec = System.getenv( "ComSpec" );
toRet = new CommandLine( comSpec == null ? "cmd" : comSpec );
toRet.addArgument( "/c" );
toRet.addArgument( exec );
} else {
toRet = new CommandLine(exec);
}
getLog().debug("Executable " + toRet.toString());
return toRet;
}
int executeCommandLine(Executor exec, CommandLine commandLine, Map enviro,
OutputStream out, OutputStream err) throws ExecuteException, IOException {
// note: don't use BufferedOutputStream here since it delays the outputs MEXEC-138
PumpStreamHandler psh = new PumpStreamHandler(out, err, System.in);
return executeCommandLine(exec, commandLine, enviro, psh);
}
int executeCommandLine(Executor exec, CommandLine commandLine, Map enviro,
FileOutputStream outputFile) throws ExecuteException, IOException {
BufferedOutputStream bos = new BufferedOutputStream(outputFile);
PumpStreamHandler psh = new PumpStreamHandler(bos);
return executeCommandLine(exec, commandLine, enviro, psh);
}
/**
* Returns the path of the parent directory.
* At the given depth if the path has no parent, the method returns null.
* @param path Path against which the parent needs to be evaluated
* @param depth Depth of the path relative to parent
* @return Path to the parent, if exists. Null, otherwise.
*/
static Path getParent(Path path, int depth) {
if (path == null || !Files.exists(path) || depth > path.getNameCount()) {
return null;
}
return path.getRoot().resolve(path.subpath(0, path.getNameCount() - depth));
}
String createMainClassString(String mainClass, JavaModuleDescriptor moduleDescriptor, RuntimePathOption runtimePathOption) {
Objects.requireNonNull(mainClass, "Main class cannot be null");
if (runtimePathOption == CLASSPATH) {
if (mainClass.contains("/")) {
return mainClass.substring(mainClass.indexOf("/") + 1);
}
return mainClass;
}
if (moduleDescriptor != null && !mainClass.contains("/")) {
getLog().warn("Module name not found in . Module name will be assumed from module-info.java");
return moduleDescriptor.name() + "/" + mainClass;
}
return mainClass;
}
private static String findExecutable(final String executable, final List paths) {
File f = null;
search: for (final String path : paths) {
f = new File(path, executable);
if (!OS.isFamilyWindows() && f.isFile()) {
break;
} else {
for (final String extension : getExecutableExtensions()) {
f = new File(path, executable + extension);
if (f.isFile()) {
break search;
}
}
}
}
if (f == null || !f.exists()) {
return null;
}
return f.getAbsolutePath();
}
private static boolean hasNativeExtension(final String exec) {
final String lowerCase = exec.toLowerCase();
return lowerCase.endsWith(".exe") || lowerCase.endsWith(".com");
}
private static boolean hasExecutableExtension(final String exec) {
final String lowerCase = exec.toLowerCase();
for (final String ext : getExecutableExtensions()) {
if (lowerCase.endsWith(ext)) {
return true;
}
}
return false;
}
private static List getExecutableExtensions() {
final String pathExt = System.getenv("PATHEXT");
return pathExt == null ? Arrays.asList(".bat", ".cmd")
: Arrays.asList(StringUtils.split(pathExt.toLowerCase(), File.pathSeparator));
}
private List getExecutablePaths(Map enviro) {
List paths = new ArrayList<>();
paths.add("");
String path = enviro.get("PATH");
if (path != null) {
paths.addAll(Arrays.asList(StringUtils.split(path, File.pathSeparator)));
}
return paths;
}
private String getJavaHomeEnv(Map enviro) {
String javahome = enviro.get("JAVA_HOME");
if (javahome == null || javahome.isEmpty()) {
return null;
}
int pathStartIndex = javahome.charAt(0) == '"' ? 1 : 0;
int pathEndIndex = javahome.charAt(javahome.length() - 1) == '"' ? javahome.length() - 1 : javahome.length();
return javahome.substring(pathStartIndex, pathEndIndex);
}
private int executeCommandLine(Executor exec, final CommandLine commandLine, Map enviro,
final PumpStreamHandler psh) throws ExecuteException, IOException {
exec.setStreamHandler(psh);
int result;
try {
psh.start();
if (async) {
if (asyncDestroyOnShutdown) {
exec.setProcessDestroyer(getProcessDestroyer());
}
exec.execute(commandLine, enviro, new ExecuteResultHandler() {
public void onProcessFailed(ExecuteException e) {
getLog().error("Async process failed for: " + commandLine, e);
}
public void onProcessComplete(int exitValue) {
getLog().debug("Async process complete, exit value = " + exitValue + " for: " + commandLine);
try {
psh.stop();
} catch (IOException e) {
getLog().error("Error stopping async process stream handler for: " + commandLine, e);
}
}
});
result = 0;
} else {
result = exec.execute(commandLine, enviro);
}
} finally {
if (!async) {
psh.stop();
}
}
return result;
}
private ProcessDestroyer getProcessDestroyer() {
if (processDestroyer == null) {
processDestroyer = new ShutdownHookProcessDestroyer();
}
return processDestroyer;
}
private boolean doesExtendFXApplication(String mainClass) {
boolean fxApplication = false;
try {
List pathUrls = new ArrayList<>();
for (String path : project.getCompileClasspathElements()) {
pathUrls.add(new File(path).toURI().toURL());
}
URL[] urls = pathUrls.toArray(new URL[0]);
URLClassLoader classLoader = new URLClassLoader(urls, JavaFXBaseMojo.class.getClassLoader());
Class clazz = Class.forName(mainClass, false, classLoader);
fxApplication = doesExtendFXApplication(clazz);
getLog().debug("Main Class " + clazz.toString() + " extends Application: " + fxApplication);
} catch (NoClassDefFoundError | ClassNotFoundException | DependencyResolutionRequiredException | MalformedURLException e) {
getLog().debug(e);
}
return fxApplication;
}
private static boolean doesExtendFXApplication(Class mainClass) {
for (Class sc = mainClass.getSuperclass(); sc != null;
sc = sc.getSuperclass()) {
if (sc.getName().equals(JAVAFX_APPLICATION_CLASS_NAME)) {
return true;
}
}
return false;
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy