1 /*
2 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3 *
4 * This code is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU General Public License version 2 only, as
6 * published by the Free Software Foundation. Oracle designates this
7 * particular file as subject to the "Classpath" exception as provided
8 * by Oracle in the LICENSE file that accompanied this code.
9 *
10 * This code is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
13 * version 2 for more details (a copy is included in the LICENSE file that
14 * accompanied this code).
15 *
16 * You should have received a copy of the GNU General Public License version
17 * 2 along with this work; if not, write to the Free Software Foundation,
18 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19 *
20 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
21 * or visit www.oracle.com if you need additional information or have any
22 * questions.
23 */
24
25 /*
26 * This file is available under and governed by the GNU General Public
27 * License version 2 only, as published by the Free Software Foundation.
28 * However, the following notice accompanied the original version of this
29 * file:
30 *
31 * ASM: a very small and fast Java bytecode manipulation framework
32 * Copyright (c) 2000-2011 INRIA, France Telecom
33 * All rights reserved.
34 *
35 * Redistribution and use in source and binary forms, with or without
36 * modification, are permitted provided that the following conditions
37 * are met:
38 * 1. Redistributions of source code must retain the above copyright
39 * notice, this list of conditions and the following disclaimer.
40 * 2. Redistributions in binary form must reproduce the above copyright
41 * notice, this list of conditions and the following disclaimer in the
42 * documentation and/or other materials provided with the distribution.
43 * 3. Neither the name of the copyright holders nor the names of its
44 * contributors may be used to endorse or promote products derived from
45 * this software without specific prior written permission.
46 *
47 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
48 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
49 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
50 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
51 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
52 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
53 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
54 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
55 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
56 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
57 * THE POSSIBILITY OF SUCH DAMAGE.
58 */
59
60 package jdk.internal.org.objectweb.asm.tree;
61
62 import java.util.ArrayList;
63 import java.util.Arrays;
64 import java.util.List;
65
66 import jdk.internal.org.objectweb.asm.Label;
67 import jdk.internal.org.objectweb.asm.MethodVisitor;
68 import jdk.internal.org.objectweb.asm.Opcodes;
69 import jdk.internal.org.objectweb.asm.TypePath;
70 import jdk.internal.org.objectweb.asm.TypeReference;
71
72 /**
73 * A node that represents a type annotation on a local or resource variable.
74 *
75 * @author Eric Bruneton
76 */
77 public class LocalVariableAnnotationNode extends TypeAnnotationNode {
78
79 /**
80 * The fist instructions corresponding to the continuous ranges that make
81 * the scope of this local variable (inclusive). Must not be <tt>null</tt>.
82 */
83 public List<LabelNode> start;
84
85 /**
86 * The last instructions corresponding to the continuous ranges that make
87 * the scope of this local variable (exclusive). This list must have the
88 * same size as the 'start' list. Must not be <tt>null</tt>.
89 */
90 public List<LabelNode> end;
91
92 /**
93 * The local variable's index in each range. This list must have the same
94 * size as the 'start' list. Must not be <tt>null</tt>.
95 */
96 public List<Integer> index;
97
98 /**
99 * Constructs a new {@link LocalVariableAnnotationNode}. <i>Subclasses must
100 * not use this constructor</i>. Instead, they must use the
101 * {@link #LocalVariableAnnotationNode(int, TypePath, LabelNode[], LabelNode[], int[], String)}
102 * version.
103 *
104 * @param typeRef
105 * a reference to the annotated type. See {@link TypeReference}.
106 * @param typePath
107 * the path to the annotated type argument, wildcard bound, array
108 * element type, or static inner type within 'typeRef'. May be
109 * <tt>null</tt> if the annotation targets 'typeRef' as a whole.
110 * @param start
111 * the fist instructions corresponding to the continuous ranges
112 * that make the scope of this local variable (inclusive).
113 * @param end
114 * the last instructions corresponding to the continuous ranges
115 * that make the scope of this local variable (exclusive). This
116 * array must have the same size as the 'start' array.
117 * @param index
118 * the local variable's index in each range. This array must have
119 * the same size as the 'start' array.
120 * @param desc
121 * the class descriptor of the annotation class.
122 */
123 public LocalVariableAnnotationNode(int typeRef, TypePath typePath,
124 LabelNode[] start, LabelNode[] end, int[] index, String desc) {
125 this(Opcodes.ASM6, typeRef, typePath, start, end, index, desc);
126 }
127
128 /**
129 * Constructs a new {@link LocalVariableAnnotationNode}.
130 *
131 * @param api
132 * the ASM API version implemented by this visitor. Must be one
133 * of {@link Opcodes#ASM4}, {@link Opcodes#ASM5} or {@link Opcodes#ASM6}.
134 * @param typeRef
135 * a reference to the annotated type. See {@link TypeReference}.
136 * @param start
137 * the fist instructions corresponding to the continuous ranges
138 * that make the scope of this local variable (inclusive).
139 * @param end
140 * the last instructions corresponding to the continuous ranges
141 * that make the scope of this local variable (exclusive). This
142 * array must have the same size as the 'start' array.
143 * @param index
144 * the local variable's index in each range. This array must have
145 * the same size as the 'start' array.
146 * @param typePath
147 * the path to the annotated type argument, wildcard bound, array
148 * element type, or static inner type within 'typeRef'. May be
149 * <tt>null</tt> if the annotation targets 'typeRef' as a whole.
150 * @param desc
151 * the class descriptor of the annotation class.
152 */
153 public LocalVariableAnnotationNode(int api, int typeRef, TypePath typePath,
154 LabelNode[] start, LabelNode[] end, int[] index, String desc) {
155 super(api, typeRef, typePath, desc);
156 this.start = new ArrayList<LabelNode>(start.length);
157 this.start.addAll(Arrays.asList(start));
158 this.end = new ArrayList<LabelNode>(end.length);
159 this.end.addAll(Arrays.asList(end));
160 this.index = new ArrayList<Integer>(index.length);
161 for (int i : index) {
162 this.index.add(i);
163 }
164 }
165
166 /**
167 * Makes the given visitor visit this type annotation.
168 *
169 * @param mv
170 * the visitor that must visit this annotation.
171 * @param visible
172 * <tt>true</tt> if the annotation is visible at runtime.
173 */
174 public void accept(final MethodVisitor mv, boolean visible) {
175 Label[] start = new Label[this.start.size()];
176 Label[] end = new Label[this.end.size()];
177 int[] index = new int[this.index.size()];
178 for (int i = 0; i < start.length; ++i) {
179 start[i] = this.start.get(i).getLabel();
180 end[i] = this.end.get(i).getLabel();
181 index[i] = this.index.get(i);
182 }
183 accept(mv.visitLocalVariableAnnotation(typeRef, typePath, start, end,
184 index, desc, visible));
185 }
186 }