1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
/* NSC -- new Scala compiler
* Copyright 2005-2014 LAMP/EPFL
* @author Martin Odersky
*/
package scala.tools.nsc
package backend.jvm
package opt
import scala.tools.asm.{Opcodes, MethodWriter, ClassWriter}
import scala.tools.asm.tree.analysis.{Analyzer, BasicValue, BasicInterpreter}
import scala.tools.asm.tree._
import scala.collection.convert.decorateAsScala._
import scala.collection.{ mutable => m }
/**
* Intra-Method optimizations.
*/
object LocalOpt {
/**
* Remove unreachable instructions from all (non-abstract) methods.
*
* @param clazz The class whose methods are optimized
* @return `true` if unreachable code was elminated in some method, `false` otherwise.
*/
def removeUnreachableCode(clazz: ClassNode): Boolean = {
clazz.methods.asScala.foldLeft(false) {
case (changed, method) => removeUnreachableCode(method, clazz.name) || changed
}
}
/**
* Remove unreachable code from a method.
* We rely on dead code elimination provided by the ASM framework, as described in the ASM User
* Guide (http://asm.ow2.org/index.html), Section 8.2.1. It runs a data flow analysis, which only
* computes Frame information for reachable instructions. Instructions for which no Frame data is
* available after the analyis are unreachable.
*
* TODO doc: it also removes empty handlers, unused local vars
*
* Returns `true` if dead code in `method` has been eliminated.
*/
private def removeUnreachableCode(method: MethodNode, ownerClassName: String): Boolean = {
if (method.instructions.size == 0) return false // fast path for abstract methods
val codeRemoved = removeUnreachableCodeImpl(method, ownerClassName)
// unreachable-code also removes unused local variable nodes and empty exception handlers.
// This is required for correctness: such nodes are not allowed to refer to instruction offsets
// that don't exist (because they have been eliminated).
val localsRemoved = removeUnusedLocalVariableNodes(method)
val handlersRemoved = removeEmptyExceptionHandlers(method)
// When eliminating a handler, the catch block becomes unreachable. The recursive invocation
// removes these blocks.
// Note that invoking removeUnreachableCode*Impl* a second time is not enough: removing the dead
// catch block can render other handlers empty, which also have to be removed in turn.
if (handlersRemoved) removeUnreachableCode(method, ownerClassName)
// assert that we can leave local variable annotations as-is
def nullOrEmpty[T](l: java.util.List[T]) = l == null || l.isEmpty
assert(nullOrEmpty(method.visibleLocalVariableAnnotations), method.visibleLocalVariableAnnotations)
assert(nullOrEmpty(method.invisibleLocalVariableAnnotations), method.invisibleLocalVariableAnnotations)
codeRemoved || localsRemoved || handlersRemoved
}
private def removeUnreachableCodeImpl(method: MethodNode, ownerClassName: String): Boolean = {
val initialSize = method.instructions.size
if (initialSize == 0) return false
// The data flow analysis requires the maxLocals / maxStack fields of the method to be computed.
computeMaxLocalsMaxStack(method)
val a = new Analyzer[BasicValue](new BasicInterpreter)
a.analyze(ownerClassName, method)
val frames = a.getFrames
var i = 0
val itr = method.instructions.iterator()
while (itr.hasNext) {
val ins = itr.next()
// Don't remove label nodes: they might be referenced for example in a LocalVariableNode
if (frames(i) == null && !ins.isInstanceOf[LabelNode]) {
// Instruction iterators allow removing during iteration.
// Removing is O(1): instructions are doubly linked list elements.
itr.remove()
}
i += 1
}
method.instructions.size != initialSize
}
/**
* Remove exception handlers that cover empty code blocks from all methods of `clazz`.
* Returns `true` if any exception handler was eliminated.
*/
def removeEmptyExceptionHandlers(clazz: ClassNode): Boolean = {
clazz.methods.asScala.foldLeft(false) {
case (changed, method) => removeEmptyExceptionHandlers(method) || changed
}
}
/**
* Remove exception handlers that cover empty code blocks. A block is considered empty if it
* consist only of labels, frames, line numbers, nops and gotos.
*
* Note that no instructions are eliminated.
*
* @return `true` if some exception handler was eliminated.
*/
def removeEmptyExceptionHandlers(method: MethodNode): Boolean = {
/** True if there exists code between start and end. */
def containsExecutableCode(start: AbstractInsnNode, end: LabelNode): Boolean = {
start != end && (start.getOpcode match {
// FrameNode, LabelNode and LineNumberNode have opcode == -1.
case -1 | Opcodes.NOP | Opcodes.GOTO => containsExecutableCode(start.getNext, end)
case _ => true
})
}
val initialNumberHandlers = method.tryCatchBlocks.size
val handlersIter = method.tryCatchBlocks.iterator()
while(handlersIter.hasNext) {
val handler = handlersIter.next()
if (!containsExecutableCode(handler.start, handler.end)) handlersIter.remove()
}
method.tryCatchBlocks.size != initialNumberHandlers
}
/**
* Remove all non-parameter entries from the local variable table which denote variables that are
* not actually read or written.
*
* Note that each entry in the local variable table has a start, end and index. Two entries with
* the same index, but distinct start / end ranges are different variables, they may have not the
* same type or name.
*
* TODO: also re-allocate locals to occupy fewer slots after eliminating unused ones
*/
def removeUnusedLocalVariableNodes(method: MethodNode): Boolean = {
def variableIsUsed(start: AbstractInsnNode, end: LabelNode, varIndex: Int): Boolean = {
start != end && (start match {
case v: VarInsnNode => v.`var` == varIndex
case _ => variableIsUsed(start.getNext, end, varIndex)
})
}
val initialNumVars = method.localVariables.size
val localsIter = method.localVariables.iterator()
// The parameters and `this` (for instance methods) have the lowest indices in the local variables
// table. Note that double / long fields occupy two slots, so we sum up the sizes. Since getSize
// returns 0 for void, we have to add `max 1`.
val paramsSize = scala.tools.asm.Type.getArgumentTypes(method.desc).map(_.getSize max 1).sum
val thisSize = if ((method.access & Opcodes.ACC_STATIC) == 0) 1 else 0
val endParamIndex = paramsSize + thisSize
while (localsIter.hasNext) {
val local = localsIter.next()
// parameters and `this` have the lowest indices, starting at 0
val used = local.index < endParamIndex || variableIsUsed(local.start, local.end, local.index)
if (!used)
localsIter.remove()
}
method.localVariables.size == initialNumVars
}
/**
* In order to run an Analyzer, the maxLocals / maxStack fields need to be available. The ASM
* framework only computes these values during bytecode generation.
*
* Sicne there's currently no better way, we run a bytecode generator on the method and extract
* the computed values. This required changes to the ASM codebase:
* - the [[MethodWriter]] class was made public
* - accessors for maxLocals / maxStack were added to the MethodWriter class
*
* We could probably make this faster (and allocate less memory) by hacking the ASM framework
* more: create a subclass of MethodWriter with a /dev/null byteVector. Another option would be
* to create a separate visitor for computing those values, duplicating the functionality from the
* MethodWriter.
*/
private def computeMaxLocalsMaxStack(method: MethodNode) {
val cw = new ClassWriter(ClassWriter.COMPUTE_MAXS)
val excs = method.exceptions.asScala.toArray
val mw = cw.visitMethod(method.access, method.name, method.desc, method.signature, excs).asInstanceOf[MethodWriter]
method.accept(mw)
method.maxLocals = mw.getMaxLocals
method.maxStack = mw.getMaxStack
}
}
|