01: /* Soot - a J*va Optimization Framework
02: * Copyright (C) 2003 John Jorgensen
03: *
04: * This library is free software; you can redistribute it and/or
05: * modify it under the terms of the GNU Library General Public
06: * License as published by the Free Software Foundation; either
07: * version 2 of the License, or (at your option) any later version.
08: *
09: * This library is distributed in the hope that it will be useful,
10: * but WITHOUT ANY WARRANTY; without even the implied warranty of
11: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12: * Library General Public License for more details.
13: *
14: * You should have received a copy of the GNU Library General Public
15: * License along with this library; if not, write to the
16: * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17: * Boston, MA 02111-1307, USA.
18: */
19:
20: package soot.toolkits.exceptions;
21:
22: import soot.Unit;
23: import soot.Singletons;
24: import soot.G;
25: import soot.baf.ThrowInst;
26: import soot.jimple.ThrowStmt;
27:
28: /**
29: * A {@link ThrowAnalysis} that says that every unit can throw every
30: * possible exception type. Strictly speaking, this is correct, since
31: * the deprecated {@link java.lang.Thread#stop(Throwable)} method
32: * allows one thread to cause any {@link Throwable} it wants to be
33: * thrown in another thread, meaning that all {@link Throwable}s may
34: * arrive asynchronously from the perspective of the victim thread.
35: */
36: public class PedanticThrowAnalysis extends AbstractThrowAnalysis {
37:
38: /**
39: * Constructs a <code>PedanticThrowAnalysis</code> for inclusion in
40: * Soot's global variable manager, {@link G}.
41: *
42: * @param g guarantees that the constructor may only be called
43: * from {@link Singletons}.
44: */
45: public PedanticThrowAnalysis(Singletons.Global g) {
46: }
47:
48: /**
49: * Returns the single instance of <code>PedanticThrowAnalysis</code>.
50: *
51: * @return Soot's <code>PedanticThrowAnalysis</code>.
52: */
53: public static PedanticThrowAnalysis v() {
54: return G.v().soot_toolkits_exceptions_PedanticThrowAnalysis();
55: }
56:
57: /**
58: * Returns the set of all <code>Throwable</code>s as the set
59: * of types that the specified unit might throw, regardless of the
60: * unit's identity.
61: *
62: * @param u {@link Unit} whose exceptions are to be returned.
63: *
64: * @return the set of all <code>Throwable</code>s.
65: */
66: public ThrowableSet mightThrow(Unit u) {
67: return ThrowableSet.Manager.v().ALL_THROWABLES;
68: }
69:
70: /**
71: * Returns the set of all <code>Throwable</code>s as the set
72: * of types that a <code>throw</code> instruction may throw implicitly,
73: * that is, the possible types of errors which might arise in
74: * the course of executing the <code>throw</code> instruction, rather
75: * than the type of the <code>throw</code>'s operand.
76: *
77: * @param t the {@link ThrowInst} whose exceptions are to be returned.
78: *
79: * @return the set of all <code>Throwable</code>s.
80: */
81: public ThrowableSet mightThrowImplicitly(ThrowInst t) {
82: return ThrowableSet.Manager.v().ALL_THROWABLES;
83: }
84:
85: /**
86: * Returns the set of all <code>Throwable</code>s as the set
87: * of types that a <code>throw</code> statement may throw implicitly,
88: * that is, the possible types of errors which might arise in
89: * the course of executing the <code>throw</code> statement, rather
90: * than the type of the <code>throw</code>'s operand.
91: *
92: * @param t the {@link ThrowStmt} whose exceptions are to be returned.
93: *
94: * @return the set of all <code>Throwable</code>s.
95: */
96: public ThrowableSet mightThrowImplicitly(ThrowStmt t) {
97: return ThrowableSet.Manager.v().ALL_THROWABLES;
98: }
99: }
|