/*
 * Copyright (c) 2014, 2020, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package jdk.jpackage.internal;

import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.text.MessageFormat;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.Date;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.function.BiFunction;
import java.util.function.Function;
import java.util.stream.Collectors;
import java.util.stream.Stream;

StandardBundlerParam A parameter to a bundler. Also contains static definitions of all of the common bundler parameters. (additional platform specific and mode specific bundler parameters are defined in each of the specific bundlers) Also contains static methods that operate on maps of parameters.
/** * StandardBundlerParam * * A parameter to a bundler. * * Also contains static definitions of all of the common bundler parameters. * (additional platform specific and mode specific bundler parameters * are defined in each of the specific bundlers) * * Also contains static methods that operate on maps of parameters. */
class StandardBundlerParam<T> extends BundlerParamInfo<T> { private static final String JAVABASEJMOD = "java.base.jmod"; private final static String DEFAULT_VERSION = "1.0"; private final static String DEFAULT_RELEASE = "1"; private final static String[] DEFAULT_JLINK_OPTIONS = { "--strip-native-commands", "--strip-debug", "--no-man-pages", "--no-header-files"}; StandardBundlerParam(String id, Class<T> valueType, Function<Map<String, ? super Object>, T> defaultValueFunction, BiFunction<String, Map<String, ? super Object>, T> stringConverter) { this.id = id; this.valueType = valueType; this.defaultValueFunction = defaultValueFunction; this.stringConverter = stringConverter; } static final StandardBundlerParam<LauncherData> LAUNCHER_DATA = new StandardBundlerParam<>( "launcherData", LauncherData.class, params -> { try { return LauncherData.create(params); } catch (ConfigException | IOException ex) { throw new RuntimeException(ex); } }, null ); static final StandardBundlerParam<Path> SOURCE_DIR = new StandardBundlerParam<>( Arguments.CLIOptions.INPUT.getId(), Path.class, p -> null, (s, p) -> Path.of(s) ); // note that each bundler is likely to replace this one with // their own converter static final StandardBundlerParam<Path> MAIN_JAR = new StandardBundlerParam<>( Arguments.CLIOptions.MAIN_JAR.getId(), Path.class, params -> LAUNCHER_DATA.fetchFrom(params).mainJarName(), null ); static final StandardBundlerParam<String> MAIN_CLASS = new StandardBundlerParam<>( Arguments.CLIOptions.APPCLASS.getId(), String.class, params -> { if (isRuntimeInstaller(params)) { return null; } return LAUNCHER_DATA.fetchFrom(params).qualifiedClassName(); }, (s, p) -> s ); static final StandardBundlerParam<Path> PREDEFINED_RUNTIME_IMAGE = new StandardBundlerParam<>( Arguments.CLIOptions.PREDEFINED_RUNTIME_IMAGE.getId(), Path.class, params -> null, (s, p) -> Path.of(s) ); static final StandardBundlerParam<Path> PREDEFINED_APP_IMAGE = new StandardBundlerParam<>( Arguments.CLIOptions.PREDEFINED_APP_IMAGE.getId(), Path.class, params -> null, (s, p) -> Path.of(s)); // this is the raw --app-name arg - used in APP_NAME and INSTALLER_NAME static final StandardBundlerParam<String> NAME = new StandardBundlerParam<>( Arguments.CLIOptions.NAME.getId(), String.class, params -> null, (s, p) -> s ); // this is the application name, either from the app-image (if given), // the name (if given) derived from the main-class, or the runtime image static final StandardBundlerParam<String> APP_NAME = new StandardBundlerParam<>( "application-name", String.class, params -> { Path appImage = PREDEFINED_APP_IMAGE.fetchFrom(params); String appName = NAME.fetchFrom(params); if (appImage != null) { String name = AppImageFile.extractAppName(appImage); appName = (name != null) ? name : appName; } else if (appName == null) { String s = MAIN_CLASS.fetchFrom(params); if (s != null) { int idx = s.lastIndexOf("."); appName = (idx < 0) ? s : s.substring(idx+1); } else if (isRuntimeInstaller(params)) { Path f = PREDEFINED_RUNTIME_IMAGE.fetchFrom(params); if (f != null) { appName = f.getFileName().toString(); } } } return appName; }, (s, p) -> s ); static final StandardBundlerParam<String> INSTALLER_NAME = new StandardBundlerParam<>( "installer-name", String.class, params -> { String installerName = NAME.fetchFrom(params); return (installerName != null) ? installerName : APP_NAME.fetchFrom(params); }, (s, p) -> s ); static final StandardBundlerParam<Path> ICON = new StandardBundlerParam<>( Arguments.CLIOptions.ICON.getId(), Path.class, params -> null, (s, p) -> Path.of(s) ); static final StandardBundlerParam<String> VENDOR = new StandardBundlerParam<>( Arguments.CLIOptions.VENDOR.getId(), String.class, params -> I18N.getString("param.vendor.default"), (s, p) -> s ); static final StandardBundlerParam<String> DESCRIPTION = new StandardBundlerParam<>( Arguments.CLIOptions.DESCRIPTION.getId(), String.class, params -> params.containsKey(APP_NAME.getID()) ? APP_NAME.fetchFrom(params) : I18N.getString("param.description.default"), (s, p) -> s ); static final StandardBundlerParam<String> COPYRIGHT = new StandardBundlerParam<>( Arguments.CLIOptions.COPYRIGHT.getId(), String.class, params -> MessageFormat.format(I18N.getString( "param.copyright.default"), new Date()), (s, p) -> s ); @SuppressWarnings("unchecked") static final StandardBundlerParam<List<String>> ARGUMENTS = new StandardBundlerParam<>( Arguments.CLIOptions.ARGUMENTS.getId(), (Class<List<String>>) (Object) List.class, params -> Collections.emptyList(), (s, p) -> null ); @SuppressWarnings("unchecked") static final StandardBundlerParam<List<String>> JAVA_OPTIONS = new StandardBundlerParam<>( Arguments.CLIOptions.JAVA_OPTIONS.getId(), (Class<List<String>>) (Object) List.class, params -> Collections.emptyList(), (s, p) -> Arrays.asList(s.split("\n\n")) ); static final StandardBundlerParam<String> VERSION = new StandardBundlerParam<>( Arguments.CLIOptions.VERSION.getId(), String.class, StandardBundlerParam::getDefaultAppVersion, (s, p) -> s ); static final StandardBundlerParam<String> RELEASE = new StandardBundlerParam<>( Arguments.CLIOptions.RELEASE.getId(), String.class, params -> DEFAULT_RELEASE, (s, p) -> s ); @SuppressWarnings("unchecked") public static final StandardBundlerParam<String> LICENSE_FILE = new StandardBundlerParam<>( Arguments.CLIOptions.LICENSE_FILE.getId(), String.class, params -> null, (s, p) -> s ); static final StandardBundlerParam<Path> TEMP_ROOT = new StandardBundlerParam<>( Arguments.CLIOptions.TEMP_ROOT.getId(), Path.class, params -> { try { return Files.createTempDirectory("jdk.jpackage"); } catch (IOException ioe) { return null; } }, (s, p) -> Path.of(s) ); public static final StandardBundlerParam<Path> CONFIG_ROOT = new StandardBundlerParam<>( "configRoot", Path.class, params -> { Path root = TEMP_ROOT.fetchFrom(params).resolve("config"); try { Files.createDirectories(root); } catch (IOException ioe) { return null; } return root; }, (s, p) -> null ); static final StandardBundlerParam<Boolean> VERBOSE = new StandardBundlerParam<>( Arguments.CLIOptions.VERBOSE.getId(), Boolean.class, params -> false, // valueOf(null) is false, and we actually do want null (s, p) -> (s == null || "null".equalsIgnoreCase(s)) ? true : Boolean.valueOf(s) ); static final StandardBundlerParam<Path> RESOURCE_DIR = new StandardBundlerParam<>( Arguments.CLIOptions.RESOURCE_DIR.getId(), Path.class, params -> null, (s, p) -> Path.of(s) ); static final BundlerParamInfo<String> INSTALL_DIR = new StandardBundlerParam<>( Arguments.CLIOptions.INSTALL_DIR.getId(), String.class, params -> null, (s, p) -> s ); @SuppressWarnings("unchecked") static final StandardBundlerParam<List<Map<String, ? super Object>>> ADD_LAUNCHERS = new StandardBundlerParam<>( Arguments.CLIOptions.ADD_LAUNCHER.getId(), (Class<List<Map<String, ? super Object>>>) (Object) List.class, params -> new ArrayList<>(1), // valueOf(null) is false, and we actually do want null (s, p) -> null ); @SuppressWarnings("unchecked") static final StandardBundlerParam <List<Map<String, ? super Object>>> FILE_ASSOCIATIONS = new StandardBundlerParam<>( Arguments.CLIOptions.FILE_ASSOCIATIONS.getId(), (Class<List<Map<String, ? super Object>>>) (Object) List.class, params -> new ArrayList<>(1), // valueOf(null) is false, and we actually do want null (s, p) -> null ); @SuppressWarnings("unchecked") static final StandardBundlerParam<List<String>> FA_EXTENSIONS = new StandardBundlerParam<>( "fileAssociation.extension", (Class<List<String>>) (Object) List.class, params -> null, // null means not matched to an extension (s, p) -> Arrays.asList(s.split("(,|\\s)+")) ); @SuppressWarnings("unchecked") static final StandardBundlerParam<List<String>> FA_CONTENT_TYPE = new StandardBundlerParam<>( "fileAssociation.contentType", (Class<List<String>>) (Object) List.class, params -> null, // null means not matched to a content/mime type (s, p) -> Arrays.asList(s.split("(,|\\s)+")) ); static final StandardBundlerParam<String> FA_DESCRIPTION = new StandardBundlerParam<>( "fileAssociation.description", String.class, p -> null, (s, p) -> s ); static final StandardBundlerParam<Path> FA_ICON = new StandardBundlerParam<>( "fileAssociation.icon", Path.class, ICON::fetchFrom, (s, p) -> Path.of(s) ); @SuppressWarnings("unchecked") static final BundlerParamInfo<List<Path>> MODULE_PATH = new StandardBundlerParam<>( Arguments.CLIOptions.MODULE_PATH.getId(), (Class<List<Path>>) (Object)List.class, p -> getDefaultModulePath(), (s, p) -> { List<Path> modulePath = Stream.of(s.split(File.pathSeparator)) .map(Path::of) .collect(Collectors.toList()); Path javaBasePath = findPathOfModule(modulePath, JAVABASEJMOD); // Add the default JDK module path to the module path. if (javaBasePath == null) { List<Path> jdkModulePath = getDefaultModulePath(); if (jdkModulePath != null) { modulePath.addAll(jdkModulePath); javaBasePath = findPathOfModule(modulePath, JAVABASEJMOD); } } if (javaBasePath == null || !Files.exists(javaBasePath)) { Log.error(String.format(I18N.getString( "warning.no.jdk.modules.found"))); } return modulePath; }); // Returns the path to the JDK modules in the user defined module path. private static Path findPathOfModule( List<Path> modulePath, String moduleName) { for (Path path : modulePath) { Path moduleNamePath = path.resolve(moduleName); if (Files.exists(moduleNamePath)) { return path; } } return null; } static final BundlerParamInfo<String> MODULE = new StandardBundlerParam<>( Arguments.CLIOptions.MODULE.getId(), String.class, p -> null, (s, p) -> { return String.valueOf(s); }); @SuppressWarnings("unchecked") static final BundlerParamInfo<Set<String>> ADD_MODULES = new StandardBundlerParam<>( Arguments.CLIOptions.ADD_MODULES.getId(), (Class<Set<String>>) (Object) Set.class, p -> new LinkedHashSet<String>(), (s, p) -> new LinkedHashSet<>(Arrays.asList(s.split(","))) ); @SuppressWarnings("unchecked") static final StandardBundlerParam<List<String>> JLINK_OPTIONS = new StandardBundlerParam<>( Arguments.CLIOptions.JLINK_OPTIONS.getId(), (Class<List<String>>) (Object) List.class, p -> Arrays.asList(DEFAULT_JLINK_OPTIONS), (s, p) -> null); @SuppressWarnings("unchecked") static final BundlerParamInfo<Set<String>> LIMIT_MODULES = new StandardBundlerParam<>( "limit-modules", (Class<Set<String>>) (Object) Set.class, p -> new LinkedHashSet<String>(), (s, p) -> new LinkedHashSet<>(Arrays.asList(s.split(","))) ); static boolean isRuntimeInstaller(Map<String, ? super Object> params) { if (params.containsKey(MODULE.getID()) || params.containsKey(MAIN_JAR.getID()) || params.containsKey(PREDEFINED_APP_IMAGE.getID())) { return false; // we are building or are given an application } // runtime installer requires --runtime-image, if this is false // here then we should have thrown error validating args. return params.containsKey(PREDEFINED_RUNTIME_IMAGE.getID()); } static Path getPredefinedAppImage(Map<String, ? super Object> params) { Path applicationImage = PREDEFINED_APP_IMAGE.fetchFrom(params); if (applicationImage != null && !IOUtils.exists(applicationImage)) { throw new RuntimeException( MessageFormat.format(I18N.getString( "message.app-image-dir-does-not-exist"), PREDEFINED_APP_IMAGE.getID(), applicationImage.toString())); } return applicationImage; } static void copyPredefinedRuntimeImage(Map<String, ? super Object> params, ApplicationLayout appLayout) throws IOException, ConfigException { Path topImage = PREDEFINED_RUNTIME_IMAGE.fetchFrom(params); if (!IOUtils.exists(topImage)) { throw new ConfigException( MessageFormat.format(I18N.getString( "message.runtime-image-dir-does-not-exist"), PREDEFINED_RUNTIME_IMAGE.getID(), topImage.toString()), MessageFormat.format(I18N.getString( "message.runtime-image-dir-does-not-exist.advice"), PREDEFINED_RUNTIME_IMAGE.getID())); } if (Platform.isMac()) { // On Mac topImage can be runtime root or runtime home. Path runtimeHome = topImage.resolve("Contents/Home"); if (Files.isDirectory(runtimeHome)) { // topImage references runtime root, adjust it to pick data from // runtime home topImage = runtimeHome; } } // copy whole runtime, need to skip jmods and src.zip final List<String> excludes = Arrays.asList("jmods", "src.zip"); IOUtils.copyRecursive(topImage, appLayout.runtimeHomeDirectory(), excludes); // if module-path given - copy modules to appDir/mods List<Path> modulePath = MODULE_PATH.fetchFrom(params); List<Path> defaultModulePath = getDefaultModulePath(); Path dest = appLayout.appModsDirectory(); if (dest != null) { for (Path mp : modulePath) { if (!defaultModulePath.contains(mp)) { Files.createDirectories(dest); IOUtils.copyRecursive(mp, dest); } } } } private static List<Path> getDefaultModulePath() { return List.of( Path.of(System.getProperty("java.home"), "jmods").toAbsolutePath()); } private static String getDefaultAppVersion(Map<String, ? super Object> params) { String appVersion = DEFAULT_VERSION; if (isRuntimeInstaller(params)) { return appVersion; } LauncherData launcherData = null; try { launcherData = LAUNCHER_DATA.fetchFrom(params); } catch (RuntimeException ex) { if (ex.getCause() instanceof ConfigException) { return appVersion; } throw ex; } if (launcherData.isModular()) { String moduleVersion = launcherData.getAppVersion(); if (moduleVersion != null) { Log.verbose(MessageFormat.format(I18N.getString( "message.module-version"), moduleVersion, launcherData.moduleName())); appVersion = moduleVersion; } } return appVersion; } }