jasmin

Class ClassFile

java.lang.Object

jasmin.ClassFile

public class ClassFile
extends Object

A ClassFile object is used to represent the binary data that makes up a Java class file - it also serves as the public API to the Jasmin assembler, though users should beware: the API is likely to change in future versions (though its such a small API at the moment that changes are likely to have only a small impact).

To assemble a file, you first construct a jasmin.ClassFile object, then call readJasmin() to read in the contents of a Jasmin assembly file, then call write() to write out the binary representation of the class file.

There are a few other utility methods as well. See Main.java for an example which uses all of the public methods provided in ClassFile.

Version:

1.05, 8 Feb 1997

Author:

Jonathan Meyer

Constructor Summary

Constructors

Constructor and Description
ClassFile() Makes a new ClassFile object, used to represent a Java class file.

Method Summary

Modifier and Type	Method and Description
void	addDeprecatedToField()
void	addGenericAttrToClass(GenericAttr g)
void	addGenericAttrToField(String name, byte[] value)
void	addGenericAttrToMethod(String name, byte[] value)
void	addSootCodeAttr(String name, String value)
int	errorCount() Returns the number of warnings/errors encountered while parsing a file.
String	getClassName() Returns the name of the class in the file (i.e.
void	readJasmin(InputStream input, String name, boolean numberLines) Parses a Jasmin file, converting it internally into a binary representation.
void	write(OutputStream outp) Writes the binary data for the class represented by this ClassFile object to the specified output stream, using the Java Class File format.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClassFile

public ClassFile()

Makes a new ClassFile object, used to represent a Java class file. You can then use readJasmin to read in a class file stored in Jasmin assembly format.

Method Detail

addSootCodeAttr

public void addSootCodeAttr(String name,
                            String value)

addGenericAttrToMethod

public void addGenericAttrToMethod(String name,
                                   byte[] value)

addGenericAttrToField

public void addGenericAttrToField(String name,
                                  byte[] value)

addDeprecatedToField

public void addDeprecatedToField()

addGenericAttrToClass

public void addGenericAttrToClass(GenericAttr g)

readJasmin

public void readJasmin(InputStream input,
                       String name,
                       boolean numberLines)
                throws IOException,
                       Exception

Parses a Jasmin file, converting it internally into a binary representation. If something goes wrong, this throws one of an IOException, or a jasError, or one of a few other exceptions. I'll tie this down more formally in the next version.

Parameters:

input - is the stream containing the Jasmin assembly code for the class.

name - is the name of the stream. This name will be concatenated to error messages printed to System.err.

numberLines - true if you want Jasmin to generate line numbers automatically, based on the assembly source, or false if you are using the ".line" directive and don't want Jasmin to help out.

Throws:

IOException

Exception

errorCount

public int errorCount()

Returns the number of warnings/errors encountered while parsing a file. 0 if everything went OK.

getClassName

public String getClassName()

Returns the name of the class in the file (i.e. the string given to the .class parameter in Jasmin)

write

public void write(OutputStream outp)
           throws IOException,
                  jasError

Writes the binary data for the class represented by this ClassFile object to the specified output stream, using the Java Class File format. Throws either an IOException or a jasError if something goes wrong.

Throws:

IOException

jasError