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 package jdk.internal.org.objectweb.asm.tree;
60
61 import java.util.List;
62
63 import jdk.internal.org.objectweb.asm.MethodVisitor;
64
65 /**
66 * A node that represents a try catch block.
67 *
68 * @author Eric Bruneton
69 */
70 public class TryCatchBlockNode {
71
72 /**
73 * Beginning of the exception handler's scope (inclusive).
74 */
75 public LabelNode start;
76
77 /**
78 * End of the exception handler's scope (exclusive).
79 */
80 public LabelNode end;
81
82 /**
83 * Beginning of the exception handler's code.
84 */
85 public LabelNode handler;
86
87 /**
88 * Internal name of the type of exceptions handled by the handler. May be
89 * <tt>null</tt> to catch any exceptions (for "finally" blocks).
90 */
91 public String type;
92
93 /**
94 * The runtime visible type annotations on the exception handler type. This
95 * list is a list of {@link TypeAnnotationNode} objects. May be
96 * <tt>null</tt>.
97 *
98 * @associates jdk.internal.org.objectweb.asm.tree.TypeAnnotationNode
99 * @label visible
100 */
101 public List<TypeAnnotationNode> visibleTypeAnnotations;
102
103 /**
104 * The runtime invisible type annotations on the exception handler type.
105 * This list is a list of {@link TypeAnnotationNode} objects. May be
106 * <tt>null</tt>.
107 *
108 * @associates jdk.internal.org.objectweb.asm.tree.TypeAnnotationNode
109 * @label invisible
110 */
111 public List<TypeAnnotationNode> invisibleTypeAnnotations;
112
113 /**
114 * Constructs a new {@link TryCatchBlockNode}.
115 *
116 * @param start
117 * beginning of the exception handler's scope (inclusive).
118 * @param end
119 * end of the exception handler's scope (exclusive).
120 * @param handler
121 * beginning of the exception handler's code.
122 * @param type
123 * internal name of the type of exceptions handled by the
124 * handler, or <tt>null</tt> to catch any exceptions (for
125 * "finally" blocks).
126 */
127 public TryCatchBlockNode(final LabelNode start, final LabelNode end,
128 final LabelNode handler, final String type) {
129 this.start = start;
130 this.end = end;
131 this.handler = handler;
132 this.type = type;
133 }
134
135 /**
136 * Updates the index of this try catch block in the method's list of try
137 * catch block nodes. This index maybe stored in the 'target' field of the
138 * type annotations of this block.
139 *
140 * @param index
141 * the new index of this try catch block in the method's list of
142 * try catch block nodes.
143 */
144 public void updateIndex(final int index) {
145 int newTypeRef = 0x42000000 | (index << 8);
146 if (visibleTypeAnnotations != null) {
147 for (TypeAnnotationNode tan : visibleTypeAnnotations) {
148 tan.typeRef = newTypeRef;
149 }
150 }
151 if (invisibleTypeAnnotations != null) {
152 for (TypeAnnotationNode tan : invisibleTypeAnnotations) {
153 tan.typeRef = newTypeRef;
154 }
155 }
156 }
157
158 /**
159 * Makes the given visitor visit this try catch block.
160 *
161 * @param mv
162 * a method visitor.
163 */
164 public void accept(final MethodVisitor mv) {
165 mv.visitTryCatchBlock(start.getLabel(), end.getLabel(),
166 handler == null ? null : handler.getLabel(), type);
167 int n = visibleTypeAnnotations == null ? 0 : visibleTypeAnnotations
168 .size();
169 for (int i = 0; i < n; ++i) {
170 TypeAnnotationNode an = visibleTypeAnnotations.get(i);
171 an.accept(mv.visitTryCatchAnnotation(an.typeRef, an.typePath,
172 an.desc, true));
173 }
174 n = invisibleTypeAnnotations == null ? 0 : invisibleTypeAnnotations
175 .size();
176 for (int i = 0; i < n; ++i) {
177 TypeAnnotationNode an = invisibleTypeAnnotations.get(i);
178 an.accept(mv.visitTryCatchAnnotation(an.typeRef, an.typePath,
179 an.desc, false));
180 }
181 }
182 }