org.macroing.cel4j.java.binary.reader

Interface AttributeInfoReader

public interface AttributeInfoReader

A means to read AttributeInfos.

It's also used as a Service Provider Interface (SPI) for the same reason.

Since:

1.0.0

Author:

Jörgen Lundgren

Method Summary

Modifier and Type	Method and Description
boolean	isAttributeInfoReadingSupportedFor(java.lang.String name) Returns true if, and only if, this AttributeInfoReader supports reading an AttributeInfo given a String with its name, false otherwise.
AttributeInfo	readAttributeInfo(java.io.DataInput dataInput, int attributeNameIndex, java.util.List<CPInfo> constantPool) Returns an AttributeInfo based on the data provided by dataInput.

Method Detail

readAttributeInfo

AttributeInfo readAttributeInfo(java.io.DataInput dataInput,
                                int attributeNameIndex,
                                java.util.List<CPInfo> constantPool)

Returns an AttributeInfo based on the data provided by dataInput.

If either dataInput, constantPool or any entries in constantPool are null, a NullPointerException may be thrown. But no guarantees can be made.

If the AttributeInfo cannot be read, a NodeFormatException should be thrown.

If attributeNameIndex is less than or equal to 0, an IllegalArgumentException may be thrown. But no guarantees can be made.

Parameters:

dataInput - the DataInput to read the data from

attributeNameIndex - the attribute_name_index of the AttributeInfo to read

constantPool - a List of CPInfos that represents the constant_pool table

Returns:

an AttributeInfo based on the data provided by dataInput

Throws:

java.lang.IllegalArgumentException - thrown if, and only if, attributeNameIndex is less than or equal to 0

NodeFormatException - thrown if, and only if, the AttributeInfo cannot be read

java.lang.NullPointerException - thrown if, and only if, either dataInput, constantPool or any entries in constantPool are null

isAttributeInfoReadingSupportedFor

boolean isAttributeInfoReadingSupportedFor(java.lang.String name)

Returns true if, and only if, this AttributeInfoReader supports reading an AttributeInfo given a String with its name, false otherwise.

If name is null, a NullPointerException may be thrown. But no guarantees can be made.

Parameters:

name - the String with the name for the AttributeInfo we are eventually about to read

Returns:

true if, and only if, this AttributeInfoReader supports reading an AttributeInfo given a String with its name, false otherwise

Throws:

java.lang.NullPointerException - thrown if, and only if, name is null