Netbeans: JASM Module
User View

Version: 0.1
Author: David Kaspar, Sun Microsystems/NetBeans

Abstract:

This document briefly describes user view of JASM (java assembly) module. This module adds support for generating JRAW and class files from each other and editing JRAW files into IDE.

Document History:

[12/29/2000] : version 0.1 : First version of the document

Contents:

1. Disassembling Class file into JRAW file

2. Editing of JRAW file

3. Assembling JRAW file into Class file

4. Disassembling Class file using external disassembler

5. JASM settings

1. Disassembling Class file into JRAW file

Disassebling is done using internal Class to JRAW convertor. This action is available in the Tools popup menu on JAVA and CLASS nodes as "Generate JRAW from Class file" menu item. It converts all class files that are holded by node. As an output there are JRAW file in the same directory. They have same name as class files (that represent it) and JRAW extension. For one JRAW file there is exacly one node in the explorer.

2. Editing of JRAW file

When you use Open action on JRAW file, the JRAW editor is shown. It allows editing this file. It supports syntax highlighting - coloring main keyword, numbers and strings. Also shows invalid characters in the numbers and strings.

3. Assembling JRAW file into Class file

This action is available in the Tools popup menu on JRAW nodes and allows convert JRAW file back to class file.

4. Disassembling Class file using external disassembler

This action is available in the Tools popup menu on JAVA and CLASS nodes as "Generate from Class file" menu item. It converts all class files that are holded by node using active external disassembler that is set in the JASM settings. If it is set then after disassembling generated files could be renamed to the desired file extension.

5. JASM settings

Settings are in the Project settings. In the JASM settings are there is choising of active external disassembler. For now there is only supported two disassembler: JAD and MOCHA. The JASM settings node contains subnodes - one for each disassembler. Dissassembler settings allows to set command name (name in the active disassembler choicer), command line (command line of externaly started program - arument {0} is class file name, {1} is full directory path), enabler for automatic output file extension renaming, extension of generated file, desired extension of output file.