JASM : Java Glossary

by Roedy Green ©1996-2008 Canadian Mind Products
Go to : punctuation 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z (all)

JASM

Java Assembler. Pronounced "jazz-em", a generic term for assemblers for the JVM bytecodes. It also includes postfix assemblers. There are four ways to create class files of JVM byte codes:

Write a Java program and compile it.
Write a program in some other language such as NetRexx or JPython that support the JVM and compile it.
Write a Jasmin program and assemble it, or use some other similar JASM assembler.
Generate the hex byte codes directly. You might write them to disk and load them in the conventional way with Class.forName , or leave them in RAM and load them with a custom ClassLoader or use java.lang.ClassLoader.defineClass directly.

The easiest way to create class file on the fly is to generate Java source code then invoke the Javac or other compiler. Sometimes it is simpler to generate byte codes directly, such as a spreadsheet engine, a regex parser or a grammar parser since you can use cheating tactics like GOTO, and have precise control of the byte codes generated.

Jeroen Frijters (pronounced Yeroon Frighters) delivered a paper called On the Fly Byte Code Generation at the 1999 Colorado Software Conference. He wrote classes for creating byte codes. His email address is jeroen@sumatra.nl and his website is http://weblog.ikvm.net/.

Probably the easiest way to understand byte codes is to write sample Java code that does what you want, then disassemble it. Then it should become clear what you need to generate. Sun now has some classes for assembling byte code: see sun.reflect.ClassFileAssembler.

Key Byte Op Codes

Some of the more interesting byte codes include:

aastore	store a reference in an array, making sure the type of the reference is compatible with the run-time type of the array.
athrow	throw an exception.
checkcast	checks that a cast to another reference type is valid.
fadd	adds top two floats on the stack and replaces them with the result. The JVM does not have a separate floating point stack.
goto	At the byte code level there has to be a goto to implmement if/else branching.
iadd	adds top two ints on the stack and replaces them with the result.
iload	push the value of a local integer variable to the top of the stack.
iconst	push an integer literal to the stack.
instanceof	replaces reference on top of stack with a boolean.
invokeinterface	call a method when all you have is an interface reference to it.
invokespecial	née invokenonvirtual in JDK 1.0. Call a private instance method, and final instance methods where you can tell ahead of time which variant of the method you want. Also used to call clinit, the code to initialise a new object prior to the constructor running. Also used to call super. someMethod, where you also know the class of the method to invoke at compile time.
invokestatic	call a static method.
invokevirtual	call a non-final instance method.
lookupswitch	used when switch case labels are not dense. Searches for a matching key and jumps.
new	allocates RAM for objects.
pop	drops the top element of the stack.
swap	exchanges the top two elements of the stack.
tableswitch	used when switch case labels are dense. Indexes into table for offset.

Richer Class Files

There are several techniques for persuading the compiler to add extra information into the class files:

Specifying -g:vars as a compiler option will result in saving the names of method parameters in LocalVariableTable_attribute structure of the generated class file.
Specifying -g as a compiler option will generate all the additional information needede by debuggers.
With @annotations.

Learning More

Sun’s VM (Virtual Machine) Specification: class file format

ANTLR: byte code parser
ASM Java byte code generator
BCEL (Jakarta Byte Code Engineering Library)
cglib: code generation library
Class.forName
ClassLoader
disassembler
Jasmin
Java Bytecode Assembler
Java Class file format
Javac.exe
Jenesis
Jeroen Frijters’ presentation : on on-the-fly byte code generation
Jeroen Frijters’ source code : on on-the-fly byte code generation
JikesBT
JVM
ObjectWeb ASM
on the fly byte code generation and run
Oolong
Soot
spreadsheet amanuensis

	Please email your feedback for publication, errors, omissions, broken/redirected link reports and suggestions to improve this page to Roedy Green :
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
	Your face IP:[38.103.63.16]	The information on this page is for non-military use only.
	You are visitor number 18,674.	Military use includes use by defence contractors.
	You can get a fresh copy of this page from:	or possibly from your local J: drive (Java virtual drive/Mindprod website mirror)
	http://mindprod.com/jgloss/jasm.html	J:\mindprod\jgloss\jasm.html