org.multijava.util.classfile
Class MJAttributeParser

java.lang.Object
  org.multijava.util.classfile.MJAttributeParser

All Implemented Interfaces:

AttributeParser

public class MJAttributeParser

extends Object

implements AttributeParser

This class implements a parser for the additional bytecode attributes defined in the MultiJava language specification.

Version:

$Revision: 1.4 $

Author:

Curtis Clifton

Field Summary
private static int	firstInterestingPos
private static String	tagPrefix

 

Constructor Summary

MJAttributeParser()

 

Method Summary
private  boolean	isOurs(String tag)           Returns true if the attribute named by the given tag String is an attribute of org.multijava.
Attribute	read(String tag, DataInput in, ConstantPool cp)           Checks the next attribute in the given input, in, and parses it if it is recognized.
Attribute	readCodeInfoAttribute(String tag, DataInput in, ConstantPool cp, Instruction[] insns)           Checks the next attribute in the given input, in, and parses it if it is recognized, but only parses attributes that may appear within a CodeInfo attribute.
Attribute	readInterfaceOnly(String tag, DataInput in, ConstantPool cp)           Checks the next attribute in the given input, in, and parses it if it is recognized, but skips CodeInfo attributes.

 

Methods inherited from class java.lang.Object

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

 

Field Detail

tagPrefix

private static final String tagPrefix

firstInterestingPos

private static final int firstInterestingPos

MJAttributeParser

public MJAttributeParser()

read

public Attribute read(String tag,
                      DataInput in,
                      ConstantPool cp)
               throws IOException,
                      ClassFileFormatException

Checks the next attribute in the given input, in, and parses it if it is recognized.

Specified by:

read in interface AttributeParser

Parameters:

tag - a String giving the name of the next attribute in in

in - an input stream for the bytecode ClassInfo being parsed, whose read cursor is positioned just after the attribute_name_index of the next attribute (see JVM2, 4.7)

cp - the ConstantPool for the bytecode ClassInfo being parsed

Returns:

an Attribute value if the next bytes in in represent an Attribute recognized by this, or null if the next bytes are not recognized

Throws:

IOException - if an error occurs while reading from the bytecode file represented by in

ClassFileFormatException - if the next bytes begin like a recognized Attribute but are then malformed

readInterfaceOnly

public Attribute readInterfaceOnly(String tag,
                                   DataInput in,
                                   ConstantPool cp)
                            throws IOException,
                                   ClassFileFormatException

Checks the next attribute in the given input, in, and parses it if it is recognized, but skips CodeInfo attributes.

Specified by:

readInterfaceOnly in interface AttributeParser

Parameters:

tag - a String giving the name of the next attribute in in

in - an input stream for the bytecode ClassInfo being parsed, whose read cursor is positioned just after the attribute_name_index of the next attribute (see JVM2, 4.7)

cp - the ConstantPool for the bytecode ClassInfo being parsed

Returns:

an Attribute value if the next bytes in in represent an Attribute recognized by this, or null if the next bytes are not recognized

Throws:

IOException - if an error occurs while reading from the bytecode file represented by in

ClassFileFormatException - if the next bytes begin like a recognized Attribute but are then malformed

readCodeInfoAttribute

public Attribute readCodeInfoAttribute(String tag,
                                       DataInput in,
                                       ConstantPool cp,
                                       Instruction[] insns)
                                throws IOException,
                                       ClassFileFormatException

Checks the next attribute in the given input, in, and parses it if it is recognized, but only parses attributes that may appear within a CodeInfo attribute.

Specified by:

readCodeInfoAttribute in interface AttributeParser

Parameters:

tag - a String giving the name of the next attribute in in

in - an input stream for the bytecode ClassInfo being parsed, whose read cursor is positioned just after the attribute_name_index of the next attribute (see JVM2, 4.7)

cp - the ConstantPool for the bytecode ClassInfo being parsed

insns - (sparse) array of instructions

Returns:

an Attribute value if the next bytes in in represent an Attribute recognized by this, or null if the next bytes are not recognized

Throws:

IOException - if an error occurs while reading from the bytecode file represented by in

ClassFileFormatException - if the next bytes begin like a recognized Attribute but are then malformed or if the next bytes are not valid within a CodeInfo attribute

isOurs

private boolean isOurs(String tag)

Returns true if the attribute named by the given tag String is an attribute of org.multijava.