1 // ASM: a very small and fast Java bytecode manipulation framework 2 // Copyright (c) 2000-2011 INRIA, France Telecom 3 // All rights reserved. 4 // 5 // Redistribution and use in source and binary forms, with or without 6 // modification, are permitted provided that the following conditions 7 // are met: 8 // 1. Redistributions of source code must retain the above copyright 9 // notice, this list of conditions and the following disclaimer. 10 // 2. Redistributions in binary form must reproduce the above copyright 11 // notice, this list of conditions and the following disclaimer in the 12 // documentation and/or other materials provided with the distribution. 13 // 3. Neither the name of the copyright holders nor the names of its 14 // contributors may be used to endorse or promote products derived from 15 // this software without specific prior written permission. 16 // 17 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 18 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20 // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 21 // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22 // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23 // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24 // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25 // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26 // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 27 // THE POSSIBILITY OF SUCH DAMAGE. 28 package org.objectweb.asm.tree; 29 30 import org.objectweb.asm.Opcodes; 31 import org.objectweb.asm.TypePath; 32 33 /** 34 * A node that represents a type annotation. 35 * 36 * @author Eric Bruneton 37 */ 38 public class TypeAnnotationNode extends AnnotationNode { 39 40 /** A reference to the annotated type. See {@link org.objectweb.asm.TypeReference}. */ 41 public int typeRef; 42 43 /** 44 * The path to the annotated type argument, wildcard bound, array element type, or static outer 45 * type within the referenced type. May be {@literal null} if the annotation targets 'typeRef' as 46 * a whole. 47 */ 48 public TypePath typePath; 49 50 /** 51 * Constructs a new {@link AnnotationNode}. <i>Subclasses must not use this constructor</i>. 52 * Instead, they must use the {@link #TypeAnnotationNode(int, int, TypePath, String)} version. 53 * 54 * @param typeRef a reference to the annotated type. See {@link org.objectweb.asm.TypeReference}. 55 * @param typePath the path to the annotated type argument, wildcard bound, array element type, or 56 * static inner type within 'typeRef'. May be {@literal null} if the annotation targets 57 * 'typeRef' as a whole. 58 * @param descriptor the class descriptor of the annotation class. 59 * @throws IllegalStateException If a subclass calls this constructor. 60 */ TypeAnnotationNode(final int typeRef, final TypePath typePath, final String descriptor)61 public TypeAnnotationNode(final int typeRef, final TypePath typePath, final String descriptor) { 62 this(/* latest api = */ Opcodes.ASM9, typeRef, typePath, descriptor); 63 if (getClass() != TypeAnnotationNode.class) { 64 throw new IllegalStateException(); 65 } 66 } 67 68 /** 69 * Constructs a new {@link AnnotationNode}. 70 * 71 * @param api the ASM API version implemented by this visitor. Must be one of the {@code 72 * ASM}<i>x</i> values in {@link Opcodes}. 73 * @param typeRef a reference to the annotated type. See {@link org.objectweb.asm.TypeReference}. 74 * @param typePath the path to the annotated type argument, wildcard bound, array element type, or 75 * static inner type within 'typeRef'. May be {@literal null} if the annotation targets 76 * 'typeRef' as a whole. 77 * @param descriptor the class descriptor of the annotation class. 78 */ TypeAnnotationNode( final int api, final int typeRef, final TypePath typePath, final String descriptor)79 public TypeAnnotationNode( 80 final int api, final int typeRef, final TypePath typePath, final String descriptor) { 81 super(api, descriptor); 82 this.typeRef = typeRef; 83 this.typePath = typePath; 84 } 85 } 86