Spill The Beans!

Spill The Beans! Classes (28K)
Sources (28K)

This week I provide the Java 1.1 version of Spill The Beans!. You can find the version for Java 1.0.2 in Weekly Applets - Issue 2. This is not a simple applet but a complete application. It's useful to view in an understandable form class files, showing them in three ways: a dump view, an assembly view with the VM sintax and an assembly view with a simplified sintax. To execute Spill The Beans! you need to download the TETRACTYS Enhanced Apis too.

Installation

To use this application simply download SpillTheBeans1.zip, unzip it in a directory of your choice and open the SpillTheBeans.bat file. Change the variables in the bat file according to your directory tree. You need also to download the Tetractys Enhanced Apis (follow the instruction in the TEA APIs page). Finally, execute SpillTheBeans.bat.

If something goes wrong, it's important that you check the correct directories: in PATH you must add the directory where java.exe is stored, while in CLASSPATH you must put the directory you have created for spill.jar and tea.jar (it's not a bad idea to add the path for the classes.zip of Java 1.1, too). Remember that the icons (GIF images) must be in a directory called /icons.

If the problem persists, write directly to TETRACTYS Freeware with a description of what goes wrong. For any comment or suggestion, please use the comments form.

Controls

As usual there is a text area, a status bar, a tool bar and a menu bar. The use is very simple and the items in the menus are few.

FILE
- NEW Creates a new document.
- OPEN Opens an existing document.
- SAVE Saves the document.
- PRINTER SETTINGS Changes the printer settings.
- PRINT PREVIEW Shows a print preview of the document.
- PRINT Prints the document.
- EXIT Exits.
EDIT
- UNDO Undoes the last edit action.
- CUT Cuts the selected Text.
- COPY Copies the selected text..
- PASTE Pastes the copied text.
- FIND Finds a specified string.
- NEXT Repeats the find operation.
- REPLACE Replaces a string with another string.
OPTIONS
- FONT
  - TEXT Chooses a font for the text area.
  - WINDOW Chooses a font for the dialogs.
- LANGUAGE
  - List of supported languages Chooses a language from the available ones.
- SAVE Saves the preferences including language, fonts, sizes and locations of dialogs.
HELP
- INFO Shows the LOGO dialog.
MODE
- DUMP If checked, shows the dump view.
- SHOW PACKAGES If checked, shows the package of the objects.
- SIMPLE SINTAX If checked, uses a simplified sintax instead of the usual one.

Sparse notices

When a class file is selected and DUMP is not checked, in the tool bar appears the list of the methods. If a method is large, it is spanned on multiple text areas (due to a text size limit for standard text areas).

Changes in the check of SIMPLE SINTAX and SHOW PACKAGES involve only the current method, unless the text area shows the class header (first page).

To understand the DUMP view and the VM sintax read The Java Virtual Machine Specification. You can find it somewhere at JavaSoft.

Simplified sintax instructions

Remember that the Java Virtual Machine uses only stack, no registers.

nop	no operation	load	loads a value from the stack	store	store a value into the stack
pop	pops a value	pop2	pops two values	dup	duplicates a value
dup_x1	...,x2,x1-> ...,x1,x2,x1	dup_x2	...,x3,x2,x1-> ...,x1,x3,x2,x1	dup2	duplicates two values
dup2_x1	...,x4,x3,x2,x1-> ...,x2,x1,x4,x3,x2,x1	dup2_x2	...,x4,x3,x2,x1-> ...,x2,x1,x4,x3,x2,x1	swap	...,x2,x1-> ...,x1,x2
add	adds	sub	subtracts	mul	multiplies
div	divides	mod	finds the remainder	neg	negates
shl	shift left	shr	signed shift right	ushr	unsigned shift right
and	logical and	or	logical or	xor	logical xor
long	conversion	float	conversion	double	conversion
byte	conversion	char	conversion	short	conversion
cmpl	true if equal or less	cmpg	true if equal or greater	ifXX	jumps if XX is satisfied
goto	jumps	jsr	jumps to subroutine	ret	returns from subroutine
switch	switch clause	return	returns from method	invoke	invokes a method
new	new object	newarray	new array	checkcast	checks casting
instanceof	checks if instance of

	In the next Issue Weekly Applet will be StreetGuide

In the next Issue Weekly Applet will be

StreetGuide