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 import java.lang.module.ModuleDescriptor.Exports;
  25 import java.lang.module.ResolvedModule;
  26 import java.lang.reflect.Layer;
  27 import java.lang.reflect.Module;
  28 import java.util.function.Predicate;
  29 import java.util.stream.Stream;
  30 
  31 import org.testng.annotations.Test;
  32 import static org.testng.Assert.*;
  33 
  34 /*
  35  * @test
  36  * @summary Basic test of java.lang.reflect.Module
  37  * @modules java.desktop java.xml
  38  * @run testng BasicModuleTest
  39  */
  40 
  41 public class BasicModuleTest {
  42 
  43     /**
  44      * Tests that the given module reads all modules in the boot Layer.
  45      */
  46     private void testReadsAllBootModules(Module m) {
  47         Layer bootLayer = Layer.boot();
  48         bootLayer.configuration()
  49             .modules()
  50             .stream()
  51             .map(ResolvedModule::name)
  52             .map(bootLayer::findModule)
  53             .forEach(target -> assertTrue(m.canRead(target.get())));
  54     }
  55 
  56     /**
  57      * Returns {@code true} if the array contains the given object.
  58      */
  59     private <T> boolean contains(T[] array, T obj) {
  60         return Stream.of(array).anyMatch(obj::equals);
  61     }
  62 
  63     /**
  64      * Returns a {@code Predicate} to test if a package is exported.
  65      */
  66     private Predicate<Exports> doesExport(String pn) {
  67         return e -> (e.source().equals(pn) && !e.isQualified());
  68     }
  69 
  70 
  71 
  72     @Test
  73     public void testThisModule() {
  74         Module thisModule = BasicModuleTest.class.getModule();
  75         Module baseModule = Object.class.getModule();
  76 
  77         assertFalse(thisModule.isNamed());
  78         assertTrue(thisModule.getName() == null);
  79         assertTrue(thisModule.getDescriptor() == null);
  80         assertTrue(thisModule.getLayer() == null);
  81         assertTrue(thisModule.toString().startsWith("unnamed module "));
  82 
  83         ClassLoader thisLoader = BasicModuleTest.class.getClassLoader();
  84         assertTrue(thisLoader == thisModule.getClassLoader());
  85         assertTrue(thisLoader.getUnnamedModule() == thisModule);
  86 
  87         // unnamed modules read all other modules
  88         ClassLoader cl;
  89         cl = ClassLoader.getPlatformClassLoader();
  90         assertTrue(thisModule.canRead(cl.getUnnamedModule()));
  91         cl = ClassLoader.getSystemClassLoader();
  92         assertTrue(thisModule.canRead(cl.getUnnamedModule()));
  93         testReadsAllBootModules(thisModule);
  94 
  95         // unnamed modules export all packages
  96         assertTrue(thisModule.isExported(""));
  97         assertTrue(thisModule.isExported("", thisModule));
  98         assertTrue(thisModule.isExported("", baseModule));
  99         assertTrue(thisModule.isExported("p"));
 100         assertTrue(thisModule.isExported("p", thisModule));
 101         assertTrue(thisModule.isExported("p", baseModule));
 102 
 103         // this test is in the unnamed package
 104         assertTrue(contains(thisModule.getPackages(), ""));
 105     }
 106 
 107 
 108     @Test
 109     public void testUnnamedModules() {
 110         Module thisModule = BasicModuleTest.class.getModule();
 111         Module baseModule = Object.class.getModule();
 112 
 113         ClassLoader loader1 = ClassLoader.getSystemClassLoader();
 114         ClassLoader loader2 = loader1.getParent();
 115 
 116         Module m1 = loader1.getUnnamedModule();
 117         Module m2 = loader2.getUnnamedModule();
 118 
 119         assertTrue(m1 != m2);
 120 
 121         assertFalse(m1.isNamed());
 122         assertFalse(m2.isNamed());
 123 
 124         assertTrue(m1.getLayer() == null);
 125         assertTrue(m2.getLayer() == null);
 126 
 127         assertTrue(m1.toString().startsWith("unnamed module "));
 128         assertTrue(m2.toString().startsWith("unnamed module "));
 129 
 130         // unnamed module reads all modules
 131         assertTrue(m1.canRead(m2));
 132         assertTrue(m2.canRead(m1));
 133 
 134         testReadsAllBootModules(m1);
 135         testReadsAllBootModules(m2);
 136 
 137         assertTrue(m1.isExported(""));
 138         assertTrue(m1.isExported("", thisModule));
 139         assertTrue(m1.isExported("", baseModule));
 140         assertTrue(m1.isExported("p"));
 141         assertTrue(m1.isExported("p", thisModule));
 142         assertTrue(m1.isExported("p", baseModule));
 143     }
 144 
 145 
 146 
 147     @Test
 148     public void testBaseModule() {
 149         Module base = Object.class.getModule();
 150         Module thisModule = BasicModuleTest.class.getModule();
 151 
 152         // getName
 153         assertTrue(base.getName().equals("java.base"));
 154 
 155         // getDescriptor
 156         assertTrue(base.getDescriptor().exports().stream()
 157                 .anyMatch(doesExport("java.lang")));
 158 
 159         // getClassLoader
 160         assertTrue(base.getClassLoader() == null);
 161 
 162         // getLayer
 163         assertTrue(base.getLayer() == Layer.boot());
 164 
 165         // toString
 166         assertEquals(base.toString(), "module java.base");
 167 
 168         // getPackages
 169         assertTrue(contains(base.getPackages(), "java.lang"));
 170 
 171         // canRead
 172         assertTrue(base.canRead(base));
 173 
 174         // isExported
 175         assertTrue(base.isExported("java.lang"));
 176         assertTrue(base.isExported("java.lang", thisModule));
 177         assertTrue(base.isExported("java.lang", base));
 178         assertFalse(base.isExported("jdk.internal.misc"));
 179         assertFalse(base.isExported("jdk.internal.misc", thisModule));
 180         assertTrue(base.isExported("jdk.internal.misc", base));
 181         assertFalse(base.isExported("java.wombat"));
 182         assertFalse(base.isExported("java.wombat", thisModule));
 183         assertFalse(base.isExported("java.wombat", base));
 184 
 185         // isOpen
 186         assertFalse(base.isOpen("java.lang"));
 187         assertFalse(base.isOpen("java.lang", thisModule));
 188         assertTrue(base.isOpen("java.lang", base));
 189         assertFalse(base.isOpen("jdk.internal.misc"));
 190         assertFalse(base.isOpen("jdk.internal.misc", thisModule));
 191         assertTrue(base.isOpen("jdk.internal.misc", base));
 192         assertFalse(base.isOpen("java.wombat"));
 193         assertFalse(base.isOpen("java.wombat", thisModule));
 194         assertFalse(base.isOpen("java.wombat", base));
 195     }
 196 
 197 
 198     @Test
 199     public void testDesktopModule() {
 200         Module desktop = java.awt.Component.class.getModule();
 201         Module base = Object.class.getModule();
 202         Module xml = javax.xml.XMLConstants.class.getModule();
 203         Module thisModule = BasicModuleTest.class.getModule();
 204 
 205         // name
 206         assertTrue(desktop.getName().equals("java.desktop"));
 207 
 208         // descriptor
 209         assertTrue(desktop.getDescriptor().exports().stream()
 210                    .anyMatch(doesExport("java.awt")));
 211 
 212         // getClassLoader
 213         assertTrue(desktop.getClassLoader() == null);
 214 
 215         // getLayer
 216         assertTrue(desktop.getLayer() == Layer.boot());
 217 
 218         // toString
 219         assertEquals(desktop.toString(), "module java.desktop");
 220 
 221         // getPackages
 222         assertTrue(contains(desktop.getPackages(), "java.awt"));
 223         assertTrue(contains(desktop.getPackages(), "sun.awt"));
 224 
 225         // canRead
 226         assertTrue(desktop.canRead(base));
 227         assertTrue(desktop.canRead(xml));
 228 
 229         // isExported
 230         assertTrue(desktop.isExported("java.awt"));
 231         assertTrue(desktop.isExported("java.awt", thisModule));
 232         assertFalse(desktop.isExported("java.wombat"));
 233         assertFalse(desktop.isExported("java.wombat", thisModule));
 234     }
 235 
 236 
 237     @Test(expectedExceptions = { NullPointerException.class })
 238     public void testIsExportedNull() {
 239         Module thisModule = this.getClass().getModule();
 240         thisModule.isExported(null, thisModule);
 241     }
 242 
 243 
 244     @Test(expectedExceptions = { NullPointerException.class })
 245     public void testIsExportedToNull() {
 246         Module thisModule = this.getClass().getModule();
 247         thisModule.isExported("", null);
 248     }
 249 
 250 
 251 }