1 /*
   2  * Copyright (c) 2014, 2016, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20  * or visit www.oracle.com if you need additional information or have any
  21  * questions.
  22  */
  23 
  24 /**
  25  * @test
  26  * @library /lib/testlibrary
  27  * @modules jdk.compiler
  28  *          jdk.jartool
  29  *          jdk.jlink
  30  * @build BasicTest CompilerUtils jdk.testlibrary.*
  31  * @run testng BasicTest
  32  * @summary Basic test of starting an application as a module
  33  */
  34 
  35 import java.io.File;
  36 import java.nio.file.Files;
  37 import java.nio.file.Path;
  38 import java.nio.file.Paths;
  39 import java.util.spi.ToolProvider;
  40 
  41 import jdk.testlibrary.ProcessTools;
  42 
  43 import org.testng.annotations.BeforeTest;
  44 import org.testng.annotations.Test;
  45 import static org.testng.Assert.*;
  46 
  47 
  48 @Test
  49 public class BasicTest {
  50     private static final ToolProvider JAR_TOOL = ToolProvider.findFirst("jar")
  51         .orElseThrow(() ->
  52             new RuntimeException("jar tool not found")
  53         );
  54     private static final ToolProvider JMOD_TOOL = ToolProvider.findFirst("jmod")
  55         .orElseThrow(() ->
  56             new RuntimeException("jmod tool not found")
  57         );
  58 
  59     private static final Path USER_DIR = Paths.get(System.getProperty("user.dir"));
  60 
  61     private static final String TEST_SRC = System.getProperty("test.src");
  62 
  63     private static final Path SRC_DIR = Paths.get(TEST_SRC, "src");
  64     private static final Path MODS_DIR = Paths.get("mods");
  65 
  66     // the module name of the test module
  67     private static final String TEST_MODULE = "test";
  68 
  69     // the module main class
  70     private static final String MAIN_CLASS = "jdk.test.Main";
  71 
  72 
  73     @BeforeTest
  74     public void compileTestModule() throws Exception {
  75 
  76         // javac -d mods/$TESTMODULE src/$TESTMODULE/**
  77         boolean compiled
  78             = CompilerUtils.compile(SRC_DIR.resolve(TEST_MODULE),
  79                                     MODS_DIR.resolve(TEST_MODULE));
  80 
  81         assertTrue(compiled, "test module did not compile");
  82     }
  83 
  84     /**
  85      * Execute "java" with the given arguments, returning the exit code.
  86      */
  87     private int exec(String... args) throws Exception {
  88        return ProcessTools.executeTestJava(args)
  89                 .outputTo(System.out)
  90                 .errorTo(System.out)
  91                 .getExitValue();
  92     }
  93 
  94 
  95     /**
  96      * The initial module is loaded from an exploded module
  97      */
  98     public void testRunWithExplodedModule() throws Exception {
  99         String dir = MODS_DIR.toString();
 100         String subdir = MODS_DIR.resolve(TEST_MODULE).toString();
 101         String mid = TEST_MODULE + "/" + MAIN_CLASS;
 102 
 103         // java --module-path mods -module $TESTMODULE/$MAINCLASS
 104         int exitValue = exec("--module-path", dir, "--module", mid);
 105         assertTrue(exitValue == 0);
 106 
 107         // java --module-path mods/$TESTMODULE --module $TESTMODULE/$MAINCLASS
 108         exitValue = exec("--module-path", subdir, "--module", mid);
 109         assertTrue(exitValue == 0);
 110 
 111         // java --module-path=mods --module=$TESTMODULE/$MAINCLASS
 112         exitValue = exec("--module-path=" + dir, "--module=" + mid);
 113         assertTrue(exitValue == 0);
 114 
 115         // java --module-path=mods/$TESTMODULE --module=$TESTMODULE/$MAINCLASS
 116         exitValue = exec("--module-path=" + subdir, "--module=" + mid);
 117         assertTrue(exitValue == 0);
 118 
 119         // java -p mods -m $TESTMODULE/$MAINCLASS
 120         exitValue = exec("-p", dir, "-m", mid);
 121         assertTrue(exitValue == 0);
 122 
 123         // java -p mods/$TESTMODULE -m $TESTMODULE/$MAINCLASS
 124         exitValue = exec("-p", subdir, "-m", mid);
 125         assertTrue(exitValue == 0);
 126     }
 127 
 128 
 129     /**
 130      * The initial module is loaded from a modular JAR file
 131      */
 132     public void testRunWithModularJar() throws Exception {
 133         Path dir = Files.createTempDirectory(USER_DIR, "mlib");
 134         Path jar = dir.resolve("m.jar");
 135 
 136         // jar --create ...
 137         String classes = MODS_DIR.resolve(TEST_MODULE).toString();
 138         String[] args = {
 139             "--create",
 140             "--file=" + jar,
 141             "--main-class=" + MAIN_CLASS,
 142             "-C", classes, "."
 143         };
 144         int rc = JAR_TOOL.run(System.out, System.out, args);
 145         assertTrue(rc == 0);
 146 
 147         // java --module-path mlib -module $TESTMODULE
 148         int exitValue = exec("--module-path", dir.toString(),
 149                              "--module", TEST_MODULE);
 150         assertTrue(exitValue == 0);
 151 
 152         // java --module-path mlib/m.jar -module $TESTMODULE
 153         exitValue = exec("--module-path", jar.toString(),
 154                          "--module", TEST_MODULE);
 155         assertTrue(exitValue == 0);
 156     }
 157 
 158 
 159     /**
 160      * Attempt to run with the initial module packaged as a JMOD file.
 161      */
 162     public void testTryRunWithJMod() throws Exception {
 163         Path dir = Files.createTempDirectory(USER_DIR, "mlib");
 164 
 165         // jmod create ...
 166         String cp = MODS_DIR.resolve(TEST_MODULE).toString();
 167         String jmod = dir.resolve("m.jmod").toString();
 168         String[] args = {
 169             "create",
 170             "--class-path", cp,
 171             "--main-class", MAIN_CLASS,
 172             jmod
 173         };
 174 
 175         assertEquals(JMOD_TOOL.run(System.out, System.out, args), 0);
 176 
 177         // java --module-path mods --module $TESTMODULE
 178         int exitValue = exec("--module-path", dir.toString(),
 179                              "--module", TEST_MODULE);
 180         assertTrue(exitValue != 0);
 181     }
 182 
 183 
 184     /**
 185      * Run the test with a non-existent file on the application module path.
 186      * It should be silently ignored.
 187      */
 188     public void testRunWithNonExistentEntry() throws Exception {
 189         String mp = "DoesNotExist" + File.pathSeparator + MODS_DIR.toString();
 190         String mid = TEST_MODULE + "/" + MAIN_CLASS;
 191 
 192         // java --module-path mods --module $TESTMODULE/$MAINCLASS
 193         int exitValue = exec("--module-path", mp, "--module", mid);
 194         assertTrue(exitValue == 0);
 195     }
 196 
 197 
 198     /**
 199      * Attempt to run an unknown initial module
 200      */
 201     public void testTryRunWithBadModule() throws Exception {
 202         String modulepath = MODS_DIR.toString();
 203 
 204         // java --module-path mods -m $TESTMODULE
 205         int exitValue = exec("--module-path", modulepath, "-m", "rhubarb");
 206         assertTrue(exitValue != 0);
 207     }
 208 
 209 
 210     /**
 211      * Attempt to run with -m specifying a main class that does not
 212      * exist.
 213      */
 214     public void testTryRunWithBadMainClass() throws Exception {
 215         String modulepath = MODS_DIR.toString();
 216         String mid = TEST_MODULE + "/p.rhubarb";
 217 
 218         // java --module-path mods -m $TESTMODULE/$MAINCLASS
 219         int exitValue = exec("--module-path", modulepath, "-m", mid);
 220         assertTrue(exitValue != 0);
 221     }
 222 
 223 
 224     /**
 225      * Attempt to run with -m specifying a modular JAR that does not have
 226      * a MainClass attribute
 227      */
 228     public void testTryRunWithMissingMainClass() throws Exception {
 229         Path dir = Files.createTempDirectory(USER_DIR, "mlib");
 230 
 231         // jar --create ...
 232         String classes = MODS_DIR.resolve(TEST_MODULE).toString();
 233         String jar = dir.resolve("m.jar").toString();
 234         String[] args = {
 235             "--create",
 236             "--file=" + jar,
 237             "-C", classes, "."
 238         };
 239         int rc = JAR_TOOL.run(System.out, System.out, args);
 240         assertTrue(rc == 0);
 241 
 242         // java --module-path mods -m $TESTMODULE
 243         int exitValue = exec("--module-path", dir.toString(), "-m", TEST_MODULE);
 244         assertTrue(exitValue != 0);
 245     }
 246 
 247 
 248     /**
 249      * Attempt to run with -m specifying a main class that is a different
 250      * module to that specified to -m
 251      */
 252     public void testTryRunWithMainClassInWrongModule() throws Exception {
 253         String modulepath = MODS_DIR.toString();
 254         String mid = "java.base/" + MAIN_CLASS;
 255 
 256         // java --module-path mods --module $TESTMODULE/$MAINCLASS
 257         int exitValue = exec("--module-path", modulepath, "--module", mid);
 258         assertTrue(exitValue != 0);
 259     }
 260 
 261 }