1 /* 2 * Copyright (c) 2015, 2018, 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. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package jdk.jfr.api.metadata.annotations; 27 28 import java.lang.annotation.ElementType; 29 import java.lang.annotation.Retention; 30 import java.lang.annotation.RetentionPolicy; 31 import java.lang.annotation.Target; 32 33 import jdk.jfr.AnnotationElement; 34 import jdk.jfr.Description; 35 import jdk.jfr.Event; 36 import jdk.jfr.EventType; 37 import jdk.jfr.MetadataDefinition; 38 import jdk.jfr.SettingDefinition; 39 import jdk.jfr.SettingDescriptor; 40 import jdk.test.lib.Asserts; 41 import jdk.test.lib.jfr.Events; 42 import jdk.test.lib.jfr.SimpleSetting; 43 44 /* 45 * @test 46 * @key jfr 47 * @library /test/lib 48 * @run main/othervm jdk.jfr.api.metadata.annotations.TestDescription 49 */ 50 public class TestDescription { 51 52 @MetadataDefinition 53 @Target({ ElementType.TYPE }) 54 @Retention(RetentionPolicy.RUNTIME) 55 @Description("Meta Annotation") 56 @interface AnnotationWithDescription { 57 } 58 59 @AnnotationWithDescription 60 @Description("Event Annotation") 61 static class DescriptionEvent extends Event { 62 @Description("Field Annotation") 63 String field; 64 65 @SettingDefinition 66 @Description("Setting description") 67 boolean dummy(SimpleSetting ds) { 68 return true; 69 } 70 } 71 72 public static void main(String[] args) throws Exception { 73 74 EventType t = EventType.getEventType(DescriptionEvent.class); 75 76 // field description 77 AnnotationElement aMax = Events.getAnnotation(t.getField("field"), Description.class); 78 String d = (String) aMax.getValue("value"); 79 Asserts.assertEquals("Field Annotation", d, "Incorrect annotation for field, got '" + d + "'"); 80 81 // event description 82 d = t.getAnnotation(Description.class).value(); 83 Asserts.assertEquals("Event Annotation", d, "Incorrect annotation for event, got '" + d + "'"); 84 85 // annotation description 86 AnnotationElement a = Events.getAnnotationByName(t, AnnotationWithDescription.class.getName()); 87 Description de = a.getAnnotation(Description.class); 88 Asserts.assertEquals("Meta Annotation", de.value(), "Incorrect annotation for event, got '" + de.value() + "'"); 89 90 for (SettingDescriptor v: t.getSettingDescriptors()) { 91 if (v.getName().equals("dummy")) { 92 Description settingDescription = v.getAnnotation(Description.class); 93 Asserts.assertEquals(settingDescription.value(), "Setting description", "Incorrect description for setting"); 94 } 95 } 96 } 97 }