/*
* Copyright (c) 2016, 2018, 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.
*
* 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 org.graalvm.compiler.test;
import java.lang.reflect.AccessibleObject;
import java.lang.reflect.Method;
import java.util.Set;
Facade for the java.lang.Module
class introduced in JDK9 that allows tests to be developed against JDK8 but use module logic if deployed on JDK9. /**
* Facade for the {@code java.lang.Module} class introduced in JDK9 that allows tests to be
* developed against JDK8 but use module logic if deployed on JDK9.
*/
public class JLModule {
static {
if (GraalTest.Java8OrEarlier) {
throw new AssertionError("Use of " + JLModule.class + " only allowed if " + GraalTest.class.getName() + ".JDK8OrEarlier is false");
}
}
private final Object realModule;
public JLModule(Object module) {
this.realModule = module;
}
private static final Class<?> moduleClass;
private static final Method getModuleMethod;
private static final Method getUnnamedModuleMethod;
private static final Method getPackagesMethod;
private static final Method isExportedMethod;
private static final Method isExported2Method;
private static final Method addExportsMethod;
jdk.internal.module.Modules.addExports(Module, String, Module)
. /**
* {@code jdk.internal.module.Modules.addExports(Module, String, Module)}.
*/
private static final Method modulesAddExportsMethod;
jdk.internal.module.Modules.addOpens(Module, String, Module)
. /**
* {@code jdk.internal.module.Modules.addOpens(Module, String, Module)}.
*/
private static final Method modulesAddOpensMethod;
static {
try {
moduleClass = Class.forName("java.lang.Module");
Class<?> modulesClass = Class.forName("jdk.internal.module.Modules");
getModuleMethod = Class.class.getMethod("getModule");
getUnnamedModuleMethod = ClassLoader.class.getMethod("getUnnamedModule");
getPackagesMethod = moduleClass.getMethod("getPackages");
isExportedMethod = moduleClass.getMethod("isExported", String.class);
isExported2Method = moduleClass.getMethod("isExported", String.class, moduleClass);
addExportsMethod = moduleClass.getMethod("addExports", String.class, moduleClass);
modulesAddExportsMethod = modulesClass.getDeclaredMethod("addExports", moduleClass, String.class, moduleClass);
modulesAddOpensMethod = modulesClass.getDeclaredMethod("addOpens", moduleClass, String.class, moduleClass);
} catch (Exception e) {
throw new AssertionError(e);
}
}
public static JLModule fromClass(Class<?> cls) {
try {
return new JLModule(getModuleMethod.invoke(cls));
} catch (Exception e) {
throw new AssertionError(e);
}
}
public static JLModule getUnnamedModuleFor(ClassLoader cl) {
try {
return new JLModule(getUnnamedModuleMethod.invoke(cl));
} catch (Exception e) {
throw new AssertionError(e);
}
}
Exports all packages in this module to a given module.
/**
* Exports all packages in this module to a given module.
*/
public void exportAllPackagesTo(JLModule module) {
if (this != module) {
for (String pkg : getPackages()) {
// Export all JVMCI packages dynamically instead
// of requiring a long list of -XaddExports
// options on the JVM command line.
if (!isExported(pkg, module)) {
addExports(pkg, module);
}
}
}
}
@SuppressWarnings("unchecked")
public Set<String> getPackages() {
try {
return (Set<String>) getPackagesMethod.invoke(realModule);
} catch (Exception e) {
throw new AssertionError(e);
}
}
public boolean isExported(String pn) {
try {
return (Boolean) isExportedMethod.invoke(realModule, pn);
} catch (Exception e) {
throw new AssertionError(e);
}
}
public boolean isExported(String pn, JLModule other) {
try {
return (Boolean) isExported2Method.invoke(realModule, pn, other.realModule);
} catch (Exception e) {
throw new AssertionError(e);
}
}
public void addExports(String pn, JLModule other) {
try {
addExportsMethod.invoke(realModule, pn, other.realModule);
} catch (Exception e) {
throw new AssertionError(e);
}
}
private static Object unbox(Object obj) {
if (obj instanceof JLModule) {
return ((JLModule) obj).realModule;
}
return obj;
}
Updates module m1 to export a package to module m2. Same as m1.addExports(pn, m2) but without
a caller check
/**
* Updates module m1 to export a package to module m2. Same as m1.addExports(pn, m2) but without
* a caller check
*/
public static void uncheckedAddExports(Object m1, String pn, Object m2) {
try {
modulesAddExportsMethod.invoke(null, unbox(m1), pn, unbox(m2));
} catch (Exception e) {
throw new AssertionError(e);
}
}
Opens all packages in moduleMember
's module for deep reflection (i.e., allow AccessibleObject.setAccessible(boolean)
to be called for any class/method/field) by requestor
's module. /**
* Opens all packages in {@code moduleMember}'s module for deep reflection (i.e., allow
* {@link AccessibleObject#setAccessible(boolean)} to be called for any class/method/field) by
* {@code requestor}'s module.
*/
public static void openAllPackagesForReflectionTo(Class<?> moduleMember, Class<?> requestor) {
try {
Object moduleToOpen = getModuleMethod.invoke(moduleMember);
Object requestorModule = getModuleMethod.invoke(requestor);
if (moduleToOpen != requestorModule) {
String[] packages = (String[]) getPackagesMethod.invoke(moduleToOpen);
for (String pkg : packages) {
modulesAddOpensMethod.invoke(moduleToOpen, pkg, requestorModule);
}
}
} catch (Exception e) {
throw new AssertionError(e);
}
}
Opens declaringClass
's package to allow a method declared in accessor
to call AccessibleObject.setAccessible(boolean)
on an AccessibleObject
representing a field or method declared by declaringClass
. /**
* Opens {@code declaringClass}'s package to allow a method declared in {@code accessor} to call
* {@link AccessibleObject#setAccessible(boolean)} on an {@link AccessibleObject} representing a
* field or method declared by {@code declaringClass}.
*/
public static void openForReflectionTo(Class<?> declaringClass, Class<?> accessor) {
try {
Object moduleToOpen = getModuleMethod.invoke(declaringClass);
Object accessorModule = getModuleMethod.invoke(accessor);
if (moduleToOpen != accessorModule) {
modulesAddOpensMethod.invoke(null, moduleToOpen, declaringClass.getPackage().getName(), accessorModule);
}
} catch (Exception e) {
throw new AssertionError(e);
}
}
Exports the package named packageName
declared in moduleMember
's module to requestor
's module. /**
* Exports the package named {@code packageName} declared in {@code moduleMember}'s module to
* {@code requestor}'s module.
*/
public static void exportPackageTo(Class<?> moduleMember, String packageName, Class<?> requestor) {
try {
Object moduleToExport = getModuleMethod.invoke(moduleMember);
Object requestorModule = getModuleMethod.invoke(requestor);
if (moduleToExport != requestorModule) {
modulesAddExportsMethod.invoke(null, moduleToExport, packageName, requestorModule);
}
} catch (Exception e) {
throw new AssertionError(e);
}
}
}