README.txt 2.31 KB
Newer Older
1 2 3 4 5
Bytecode Outline plugin for Eclipse
-----------------------------------------------------------------

Bytecode Outline plugin shows disassembled bytecode of current java editor or
class file, allows bytecode compare for java/class files and shows ASMifier
andrei's avatar
andrei committed
6 7
code for current bytecode.

8 9 10 11 12 13 14
Have you already asked yourselves what the compiler does with your Java code?
Here is the answer ;)

The main reason for this plugin was my study how Java generates bytecode and my
interest in ASM framework. ASM is a great, fast and small bytecode manipulation
framework, licensed under the BSD License.

andrei's avatar
andrei committed
15 16 17 18 19
Bytecode Outline is free, see copyright. ASM is also free and parts of them are
included to Bytecode Outline plugin distribution. Please visit
http://asm.ow2.org/index.html to obtain latest information about ASM.

Bytecode Outline currently supports only Eclipse default Java editor.
20 21 22 23 24 25


Installation
-----------------------------------------------------------------

All what you need to install Bytecode Outline plugin is to unzip the zip file
andrei's avatar
andrei committed
26 27
into you %Eclipse%/dropins directory and restart Eclipse. You don't need to do
anymore to install Bytecode Outline.
28 29 30 31 32 33 34 35 36 37 38 39


Usage
-----------------------------------------------------------------

Window -> Show View -> Other -> Java -> Bytecode to see bytecode of current
Java editor/ Class file view.

If "Link with editor" is on, then any selection in Java editor will be followed
with selection of appropriated bytecode label, and vice - versa.

Note: this bi-directional selection could only works, if your bytecode contains
andrei's avatar
andrei committed
40
source lines/local variables information. Check your compiler settings, if you
41 42 43
are not sure that your compiler generates debug information.

If "show raw bytecode" is off, than local variable names will be shown instead
andrei's avatar
andrei committed
44
of indexes, full qualified names replaced with simply class names, and
45 46
primitive type abbreviations decoded to readable names.

andrei's avatar
andrei committed
47 48
If "show current element only" is on, then only bytecode of current
field/method node will be shown (if cursor is placed inside field/method name
49 50
or body).

andrei's avatar
andrei committed
51
Select two *.class/*.java files -> right click -> Compare with -> Each Other
52 53 54 55 56
Bytecode

Select one *.class/*.java file -> right click -> Compare with -> Another Class
Bytecode

andrei's avatar
andrei committed
57
to compare bytecode of selected class files. Compare works also for *.class
58
files included in any referenced *.jar library.