Package org.apache.bcel.classfile
Class Unknown
java.lang.Object
org.apache.bcel.classfile.Attribute
org.apache.bcel.classfile.Unknown
This class represents a reference to an unknown (that is, application-specific) attribute of a class. It is instantiated
from the
Attribute.readAttribute(java.io.DataInput, ConstantPool) method. Applications that need to read in
application-specific attributes should create an UnknownAttributeReader implementation and attach it via
Attribute.addAttributeReader(String, UnknownAttributeReader).- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate byte[](package private) static final intArbitrary to limit the maximum length of unknown attributes to avoid OOM errors.private static final Stringprivate final StringFields inherited from class org.apache.bcel.classfile.Attribute
constant_pool, EMPTY_ARRAY, length, name_index, tag -
Constructor Summary
ConstructorsConstructorDescriptionUnknown(int nameIndex, int length, byte[] bytes, ConstantPool constantPool) Constructs a new instance for a non-standard attribute.Unknown(int nameIndex, int length, DataInput input, ConstantPool constantPool) Constructs a new instance from a DataInput.Constructs a new instance from another instance. -
Method Summary
Modifier and TypeMethodDescriptionvoidCalled by objects that are traversing the nodes of the tree implicitly defined by the contents of a Java class.copy(ConstantPool constantPool) Creates a deep copy of this attribute.voiddump(DataOutputStream file) Dumps unknown bytes to file stream.byte[]getBytes()Gets the data bytes.getName()Gets the name of attribute.voidsetBytes(byte[] bytes) Sets the data bytes.toString()Methods inherited from class org.apache.bcel.classfile.Attribute
addAttributeReader, addAttributeReader, clone, getConstantPool, getLength, getNameIndex, getTag, println, readAttribute, readAttribute, removeAttributeReader, setConstantPool, setLength, setNameIndex
-
Field Details
-
MAX_LEN
static final int MAX_LENArbitrary to limit the maximum length of unknown attributes to avoid OOM errors.- See Also:
-
MAX_LEN_PROP
- See Also:
-
bytes
private byte[] bytes -
name
-
-
Constructor Details
-
Unknown
Constructs a new instance for a non-standard attribute.- Parameters:
nameIndex- Index in constant pool.length- Content length in bytes.bytes- Attribute contents.constantPool- Array of constants.
-
Unknown
Unknown(int nameIndex, int length, DataInput input, ConstantPool constantPool) throws IOException Constructs a new instance from a DataInput.The size of an Attribute unknown to the JVM specification is limited to 1 MB and is overridden with the system property
BCEL.Attribute.Unknown.max_attribute_length.- Parameters:
nameIndex- Index in constant pool.length- Content length in bytes.input- Input stream.constantPool- Array of constants.- Throws:
IOException- Thrown if an I/O error occurs.- See Also:
-
Unknown
Constructs a new instance from another instance. Note that both objects use the same references (shallow copy). Use clone() for a physical copy.- Parameters:
unknown- Source.
-
-
Method Details
-
accept
Called by objects that are traversing the nodes of the tree implicitly defined by the contents of a Java class. I.e., the hierarchy of methods, fields, attributes, etc. spawns a tree of objects. -
copy
Description copied from class:AttributeCreates a deep copy of this attribute. -
dump
Dumps unknown bytes to file stream.- Overrides:
dumpin classAttribute- Parameters:
file- Output file stream.- Throws:
IOException- Thrown if an I/O error occurs.
-
getBytes
public byte[] getBytes()Gets the data bytes.- Returns:
- data bytes.
-
getName
Description copied from class:AttributeGets the name of attribute. -
setBytes
public void setBytes(byte[] bytes) Sets the data bytes.- Parameters:
bytes- The bytes to set.
-
toString
-