jdk-24/jdk/test/java/lang/ModuleTests/AnnotationsTest.java

/*
 * 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;
    }
}