∟AsmTools/JASM Disassembler: "jdis"

This section provides a tutorial example on how to disassemble a JVM bytecode using the AsmTools/JASM disassembler.

What Is AsmTools/JASM Disassembler? AsmTools/JASM disassembler is a tool provided in the AsmTools/JASM package that allows you to disassemble JVM bytecode back into AsmTools/JASM assembly code. JASM disassembler can be invoked by the "jdis" sub-command.

Let's try it with Calculator.class generated in the last tutorial.

1. Disassemble Calculator.class.

# list original AsmTools/JASM source and bytecode files
herong> ls -l Calculator.*
  -rw-r--r--  1 herong  staff   892 Nov 12 09:39 Calculator.class
  -rw-r--r--@ 1 herong  staff  3960 Nov 12 09:39 Calculator.jasm

# run JASM disassembler and store output in "out" sub-directory
herong> mkdir out
herong> java -jar asmtools-core-7.0.b10-ea.jar jdis Calculator.class \
  > out/Calculator.jasm

# list the disassembled output
herong> ls -l out
  -rw-r--r--  1 herong  staff  2228 Nov 12 09:48 Calculator.jasm

2. Review the disassembled AsmTools/JASM code.

herong> more out/Calculator.jasm

public class Calculator
  version 45:3
{
  public static Method main:"([Ljava/lang/String;)V"
  stack 4 locals 8
  {
    aload_0;
    arraylength;
    bipush	3;
    if_icmpeq	L24;
    getstatic	Field java/lang/System.out:"Ljava/io/PrintStream;";
    ldc	String "Error: Invalid number of arguments.";
    invokevirtual	Method java/io/PrintStream.println:"(Ljava/lang/String;)V";
    getstatic	Field java/lang/System.out:"Ljava/io/PrintStream;";
    ldc	String "Usage: java Calculator <number> <operator> <number>";
    invokevirtual	Method java/io/PrintStream.println:"(Ljava/lang/String;)V";
    return;
    try t0;
  L24:	aload_0;
    iconst_0;
    aaload;
    invokestatic	Method java/lang/Double.parseDouble:"(Ljava/lang/String;)D";
    dstore_1;
    aload_0;
    iconst_1;
    aaload;
    iconst_0;
    invokevirtual	Method java/lang/String.charAt:"(I)C";
    istore_3;
    aload_0;
    iconst_2;
    aaload;
    invokestatic	Method java/lang/Double.parseDouble:"(Ljava/lang/String;)D";
    dstore	4;
    endtry t0;
    goto	L60;
    catch t0 java/lang/NumberFormatException;
    pop;
    getstatic	Field java/lang/System.out:"Ljava/io/PrintStream;";
    ldc	String "Error: Please provide valid numeric values.";
    invokevirtual	Method java/io/PrintStream.println:"(Ljava/lang/String;)V";
    return;
  L60:	iload_3;
    lookupswitch{ //4
    42: L122;
    43: L104;
    45: L113;
    47: L131;
    default: L156 };
  L104:	dload_1;
    dload	4;
    dadd;
    dstore	6;
    goto	L147;
  L113:	dload_1;
    dload	4;
    dsub;
    dstore	6;
    goto	L147;
  L122:	dload_1;
    dload	4;
    dmul;
    dstore	6;
    goto	L147;
  L131:	dload	4;
    dconst_0;
    dcmpl;
    ifeq	L165;
    dload_1;
    dload	4;
    ddiv;
    dstore	6;
    goto	L147;
  L147:	getstatic	Field java/lang/System.out:"Ljava/io/PrintStream;";
    dload	6;
    invokevirtual	Method java/io/PrintStream.println:"(D)V";
    return;
  L156:	getstatic	Field java/lang/System.out:"Ljava/io/PrintStream;";
    ldc	String "Error: Invalid operator. Use +, -, *, or /.";
    invokevirtual	Method java/io/PrintStream.println:"(Ljava/lang/String;)V";
    return;
  L165:	getstatic	Field java/lang/System.out:"Ljava/io/PrintStream;";
    ldc	String "Error: Division by zero is not allowed.";
    invokevirtual	Method java/io/PrintStream.println:"(Ljava/lang/String;)V";
    return;
  }

} // end Class Calculator

3. Re-compile the disassembled AsmTools/JASM code.

herong> cd out

herong> java -jar ../asmtools-core-7.0.b10-ea.jar jasm Calculator.jasm

herong> ls -l
  -rw-r--r--  1 herong  staff   892 Nov 12 09:55 Calculator.class
  -rw-r--r--  1 herong  staff  2228 Nov 12 09:48 Calculator.jasm

3. Test the re-compiled bytecode.

herong> java Calculator 0.9999 + 0.0001
  1.0

herong> java Calculator 0.9999 - 0.0001
  0.9998

herong> java out Calculator 0.9999 = 0.0001
  Error: Invalid operator. Use +, -, *, or /.

Okay. The re-compiled bytecode of the disassembled version works correctly.

Table of Contents

 About This Book

 JVM (Java Virtual Machine) Specification

 Java HotSpot VM - JVM by Oracle/Sun

 java.lang.Runtime Class - The JVM Instance

 java.lang.System Class - The Operating System

 ClassLoader Class - Class Loaders

 Class Class - Class Reflections

 JVM Runtime Data Areas

 JVM Stack, Frame and Stack Overflow

 Thread Testing Program and Result

 CPU Impact of Multi-Thread Applications

 I/O Impact of Multi-Thread Applications

 CDS (Class Data Sharing)

 Micro Benchmark Runner and JVM Options

 Micro Benchmark Tests on "int" Operations

 Micro Benchmark Tests on "long" Operations

 Micro Benchmark Tests in JIT Compilation Mode

 Micro Benchmark Tests on "float" and "double" Operations

 OpenJ9 by Eclipse Foundation

 JRockit JVM 28.2.7 by Oracle Corporation

 JVM Bytecode and Instruction Set

►JVM Assembler/Disassembler Tools

 What Is JVM Assembler

 What Is Jasmin

 Compare HelloWorld.j with "javap" Output

 Jasmin Assembly Statements

 Jasmin Example - Empty.j

 Jasmin Example - Calculator.j

 What Is JASM

 JASM Assembly Statements

 JASM Example - Calculator.jasm

 JASM Disassembler: "jasm -d"

 What Is AsmTools

 AsmTools/JASM Assembly Statements

 AsmTools/JASM Example - Calculator.jasm

►AsmTools/JASM Disassembler: "jdis"

 AsmTools/JCOD Assembly File Format

 AsmTools/JCOD Example - HelloWorld.jcod

 AsmTools/JCOD Disassembler: "jdec"

 What Is Lilac

 Lilac Assembly Statements

 Lilac Macro Example - HelloWorldMacro.jasm

 Lilac Disassembler: "jdasm"

 Archived Tutorials

 References

 Index

 Full Version in PDF/EPUB