∟AsmTools/JASM Example - Calculator.jasm

This section provides a tutorial example on how to write a simple calculator in AsmTools/JASM: Calculator.jasm.

Now re-write our Jasmin program, Calculator.j in AsmTools/JASM: Calculator.jasm.

1. AsmTools/JASM version: Calculator.jasm - Write the JASM version by following the Jasmin version:

/* Calculator.jasm for AsmTools
*  Copyright (c) HerongYang.com. All Rights Reserved.
*/
public class Calculator {
  public static Method main:"([Ljava/lang/String;)V"
    stack 4 locals 8 {

    // verify number of arguments
    aload_0;              // load address from variable 0, the first argument: args
    arraylength;          // get args.length
    bipush 3;             // load int 3
    if_icmpeq DO_PARSE;   // skip error messages, if args.length == 3

    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;

    // define a try-catch block
    DO_PARSE: try TRY_PARSE;
      // parse the args[0] as a double value
      aload_0;       // load args address
      iconst_0;      // load index 0
      aaload;        // load args[0]
      invokestatic	Method java/lang/Double.parseDouble:"(Ljava/lang/String;)D";
      dstore_1;      // store it in variable 1 and 2 as x, double requires 2 slots

      aload_0;       // load args address
      iconst_1;      // load index 1
      aaload;        // load args[1]
      iconst_0;      // load index 0
      invokevirtual	Method java/lang/String.charAt:"(I)C";
      istore_3;      // store it in variable 3 as op

      aload_0;       // load args address
      iconst_2;      // load index 2
      aaload;        // load args[2]]
      invokestatic	Method java/lang/Double.parseDouble:"(Ljava/lang/String;)D";
      dstore 4;      // store it in variable 4 and 5 as y, double requires 2 slots

    endtry TRY_PARSE;
    goto DO_SWITCH;
    catch TRY_PARSE java/lang/NumberFormatException;
      // When an exception hits, the exception object reference is pushed onto the stack.
      // We pop it to clear the stack, then print our custom error.
      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;

    DO_SWITCH: iload_3;        // load op from variable 3
    lookupswitch {
      42: DoMul;      // '*' is ASCII 42
      43: DoAdd;      // '+' is ASCII 43
      45: DoSub;      // '-' is ASCII 45
      47: DoDiv;      // '/' is ASCII 47
      default: InvalidOp
    };

    // load x and y, perform addition, store r
    DoAdd: dload_1;
    dload 4;
    dadd;
    dstore 6;
    goto PrintResult;

    // load x and y, perform subtraction, store r
    DoSub: dload_1;
    dload 4;
    dsub;
    dstore 6;
    goto PrintResult;

    // load x and y, perform multiplication, store r
    DoMul: dload_1;
    dload 4;
    dmul;
    dstore 6;
    goto PrintResult;

    // load y, make sure it's not 0.0
    DoDiv:  dload 4;    // load y
    dconst_0;           // load 0.0
    dcmpl;              // compare and generate -1, 0 or 1
    ifeq DivZero;       // go to error handling, if 0

    dload_1;            // load x and y, perform division, store r
    dload 4;
    ddiv;
    dstore 6;
    goto PrintResult;

    PrintResult: getstatic	Field java/lang/System.out:"Ljava/io/PrintStream;";
    dload	6;
    invokevirtual	Method java/io/PrintStream.println:"(D)V";
    return;

    InvalidOp: 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;

    DivZero: 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;
  }
}

2. Compile - Compile it with AsmTools/JASM assembler by invoking the "jasm" sub-command. No errors are reported.

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

3. Run It on JVM

herong> java Calculator 0.9999 + 0.0001
  1.0

herong> java Calculator 0.9999 - 0.0001
  0.9998

herong> java Calculator 0.9999 '*' 0.0001
  9.999000000000001E-5

herong> java Calculator 0.9999 / 2
  0.49995

herong> java Calculator 0.9999  2
  Error: Invalid number of arguments.
  Usage: java Calculator <number> <operator> <number>

herong> java Calculator 0.9999 / two
  Error: Please provide valid numeric values.

herong> java Calculator 0.9999 % 2
  Error: Invalid operator. Use +, -, *, or /.

herong> java Calculator 0.9999 / 0
  Error: Division by zero is not allowed.

Cool! Calculator.jasm seems to be working correctly.

4. Compare Bytecode - Now let's compare the bytecodes generated from Calculator.jasm (AsmTools/JASM version) with Calculator.j (Jasmin version) and Calculator.java (Java version):

herong> ./jasm-0.7.0/bin/jasm Calculator.jasm

herong> ls -l Calculator.class
  -rw-r--r--  1 herong  staff   892 Nov 12 09:39 Calculator.class

herong> java -jar jasmin-2.4/jasmin.jar Calculator.j
  Generated: Calculator.class

herong> ls -l Calculator.class
  -rw-r--r--  1 herong  staff   943 Nov 10 20:54 Calculator.class

herong> javac Calculator.java

herong> ls Calculator.*
  -rw-r--r--  1 herong  staff  1375 Nov 10 21:06 Calculator.class

The bytecode generated from the AsmTools/JASM version has almost the same size as the Jasmin version. They both are about 30% smaller than the Java version.

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