8177530: Module system implementation refresh (4/2017)
Reviewed-by: mchung, alanb
Contributed-by: alan.bateman@oracle.com, mandy.chung@oracle.com
/*
* Copyright (c) 2016, 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.
*/
import java.io.IOException;
import java.io.InputStream;
import java.lang.annotation.Annotation;
import java.lang.module.Configuration;
import java.lang.module.ModuleFinder;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.Set;
import jdk.internal.module.ClassFileAttributes;
import jdk.internal.org.objectweb.asm.AnnotationVisitor;
import jdk.internal.org.objectweb.asm.Attribute;
import jdk.internal.org.objectweb.asm.ClassReader;
import jdk.internal.org.objectweb.asm.ClassVisitor;
import jdk.internal.org.objectweb.asm.ClassWriter;
import jdk.internal.org.objectweb.asm.Opcodes;
import org.testng.annotations.Test;
import static org.testng.Assert.*;
/**
* @test
* @modules java.base/jdk.internal.org.objectweb.asm
* java.base/jdk.internal.module
* java.xml
* @run testng AnnotationsTest
* @summary Basic test of annotations on modules
*/
public class AnnotationsTest {
/**
* Test that there are no annotations on an unnamed module.
*/
@Test
public void testUnnamedModule() {
Module module = this.getClass().getModule();
assertTrue(module.getAnnotations().length == 0);
}
/**
* Test loading a module with a RuntimeVisibleAnnotation attribute.
* The test copies the module-info.class for java.xml, adds the attribute,
* and then loads the updated module.
*/
@Test
public void testNamedModule() throws IOException {
// "deprecate" java.xml
Path dir = Files.createTempDirectory("mods");
deprecateModule("java.xml", true, "9", dir);
// "load" the cloned java.xml
Module module = loadModule(dir, "java.xml");
// check the annotation is present
assertTrue(module.isAnnotationPresent(Deprecated.class));
Deprecated d = module.getAnnotation(Deprecated.class);
assertNotNull(d, "@Deprecated not found");
assertTrue(d.forRemoval());
assertEquals(d.since(), "9");
Annotation[] a = module.getAnnotations();
assertTrue(a.length == 1);
assertTrue(a[0] instanceof Deprecated);
}
/**
* Copy the module-info.class for the given module, add the
* Deprecated annotation, and write the updated module-info.class
* to a directory.
*/
static void deprecateModule(String name,
boolean forRemoval,
String since,
Path output) throws IOException {
Module module = ModuleLayer.boot().findModule(name).orElse(null);
assertNotNull(module, name + " not found");
InputStream in = module.getResourceAsStream("module-info.class");
assertNotNull(in, "No module-info.class for " + name);
try (in) {
ClassWriter cw = new ClassWriter(ClassWriter.COMPUTE_MAXS
+ ClassWriter.COMPUTE_FRAMES);
ClassVisitor cv = new ClassVisitor(Opcodes.ASM5, cw) { };
ClassReader cr = new ClassReader(in);
List<Attribute> attrs = new ArrayList<>();
attrs.add(new ClassFileAttributes.ModuleAttribute());
attrs.add(new ClassFileAttributes.ModulePackagesAttribute());
attrs.add(new ClassFileAttributes.ModuleTargetAttribute());
cr.accept(cv, attrs.toArray(new Attribute[0]), 0);
AnnotationVisitor annotationVisitor
= cv.visitAnnotation("Ljava/lang/Deprecated;", true);
annotationVisitor.visit("forRemoval", forRemoval);
annotationVisitor.visit("since", since);
annotationVisitor.visitEnd();
byte[] bytes = cw.toByteArray();
Path mi = output.resolve("module-info.class");
Files.write(mi, bytes);
}
}
/**
* Load the module of the given name in the given directory into a
* child layer.
*/
static Module loadModule(Path dir, String name) throws IOException {
ModuleFinder finder = ModuleFinder.of(dir);
ModuleLayer bootLayer = ModuleLayer.boot();
Configuration cf = bootLayer.configuration()
.resolve(finder, ModuleFinder.of(), Set.of(name));
ClassLoader scl = ClassLoader.getSystemClassLoader();
ModuleLayer layer = bootLayer.defineModulesWithOneLoader(cf, scl);
Module module = layer.findModule(name).orElse(null);
assertNotNull(module, name + " not loaded");
return module;
}
}