Class Field

java.lang.Object

org.apache.bcel.classfile.AccessFlags

org.apache.bcel.classfile.FieldOrMethod

org.apache.bcel.classfile.Field

All Implemented Interfaces:

Cloneable, Node

public final class Field
extends FieldOrMethod

This class represents the field info structure, that is, the representation for a variable in the class. See JVM specification for details.

Field Summary

Fields

Modifier and Type	Field	Description
static final Field[]	EMPTY_ARRAY	Empty array constant.

Fields inherited from class FieldOrMethod

attributes, attributes_count, constant_pool, name_index, signature_index

Modifier and Type	Field	Description
protected Attribute[]	attributes	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter.
protected int	attributes_count	Deprecated. (since 6.0) will be removed (not needed)
protected ConstantPool	constant_pool	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter.
protected int	name_index	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter.
protected int	signature_index	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter.

Fields inherited from class AccessFlags

access_flags

Modifier and Type	Field	Description
protected int	access_flags	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter.

Constructor Summary

Constructors

Constructor	Description
Field(int accessFlags, int nameIndex, int signatureIndex, Attribute[] attributes, ConstantPool constantPool)	Constructs a Field.
Field(Field c)	Initialize from another object.

Method Summary

Modifier and Type	Method	Description
void	accept(Visitor v)	Called by objects that are traversing the nodes of the tree implicitly defined by the contents of a Java class.
Field	copy(ConstantPool constantPool)	Creates a deep copy of this field.
boolean	equals(Object obj)	Return value as defined by given BCELComparator strategy.
static BCELComparator<Field>	getComparator()	Gets the comparison strategy object.
ConstantValue	getConstantValue()	Gets the constant value associated with this field.
Type	getType()	Gets the field type.
int	hashCode()	Return value as defined by given BCELComparator strategy.
static void	setComparator(BCELComparator<Field> comparator)	Sets the comparison strategy object.
String	toString()	Return string representation close to declaration format, for example: 'public static final short MAX = 100'.

Methods inherited from class FieldOrMethod

copy_, dump, getAnnotationEntries, getAttribute, getAttributes, getConstantPool, getGenericSignature, getName, getNameIndex, getSignature, getSignatureIndex, setAttributes, setConstantPool, setNameIndex, setSignatureIndex

Modifier and Type	Method	Description
protected FieldOrMethod	copy_(ConstantPool constantPool)	Creates a deep copy of this field.
final void	dump(DataOutputStream file)	Dumps object to file stream on binary format.
AnnotationEntry[]	getAnnotationEntries()	Gets annotations on the field or method.
final <T extends Attribute> T	getAttribute(byte tag)	Gets attribute for given tag.
final Attribute[]	getAttributes()	Gets the collection of object attributes.
final ConstantPool	getConstantPool()	Gets the constant pool used by this object.
final String	getGenericSignature()	Gets the contents of the signature attribute on this member.
final String	getName()	Gets the name of object.
final int	getNameIndex()	Gets the index in constant pool of object's name.
final String	getSignature()	Gets the string representation of object's type signature.
final int	getSignatureIndex()	Gets the index in constant pool of field signature.
final void	setAttributes(Attribute[] attributes)	Sets the collection of object attributes.
final void	setConstantPool(ConstantPool constantPool)	Sets the constant pool to be used for this object.
final void	setNameIndex(int nameIndex)	Sets the index in constant pool of object's name.
final void	setSignatureIndex(int signatureIndex)	Sets the index in constant pool of field signature.

Methods inherited from class AccessFlags

getAccessFlags, getModifiers, isAbstract, isAbstract, isAnnotation, isAnnotation, isEnum, isEnum, isFinal, isFinal, isInterface, isInterface, isNative, isNative, isPrivate, isPrivate, isProtected, isProtected, isPublic, isPublic, isStatic, isStatic, isStrictfp, isStrictfp, isSynchronized, isSynchronized, isSynthetic, isSynthetic, isTransient, isTransient, isVarArgs, isVarArgs, isVolatile, isVolatile, setAccessFlags, setModifiers

Modifier and Type	Method	Description
final int	getAccessFlags()	Gets access flags.
final int	getModifiers()	Gets access flags.
final boolean	isAbstract()	Tests whether the abstract bit is on.
final void	isAbstract(boolean flag)	Sets the abstract bit.
final boolean	isAnnotation()	Tests whether the annotation bit is on.
final void	isAnnotation(boolean flag)	Sets the annotation bit.
final boolean	isEnum()	Tests whether the enum bit is on.
final void	isEnum(boolean flag)	Sets the enum bit.
final boolean	isFinal()	Tests whether the final bit is on.
final void	isFinal(boolean flag)	Sets the final bit.
final boolean	isInterface()	Tests whether the interface bit is on.
final void	isInterface(boolean flag)	Sets the interface bit.
final boolean	isNative()	Tests whether the native bit is on.
final void	isNative(boolean flag)	Sets the native bit.
final boolean	isPrivate()	Tests whether the private bit is on.
final void	isPrivate(boolean flag)	Sets the private bit.
final boolean	isProtected()	Tests whether the protected bit is on.
final void	isProtected(boolean flag)	Sets the protected bit.
final boolean	isPublic()	Tests whether the public bit is on.
final void	isPublic(boolean flag)	Sets the public bit.
final boolean	isStatic()	Tests whether the static bit is on.
final void	isStatic(boolean flag)	Sets the static bit.
final boolean	isStrictfp()	Tests whether the strict bit is on.
final void	isStrictfp(boolean flag)	Sets the strict bit.
final boolean	isSynchronized()	Tests whether the synchronized bit is on.
final void	isSynchronized(boolean flag)	Sets the synchronized bit.
final boolean	isSynthetic()	Tests whether the synthetic bit is on.
final void	isSynthetic(boolean flag)	Sets the synthetic bit.
final boolean	isTransient()	Tests whether the transient bit is on.
final void	isTransient(boolean flag)	Sets the transient bit.
final boolean	isVarArgs()	Tests whether the varargs bit is on.
final void	isVarArgs(boolean flag)	Sets the varargs bit.
final boolean	isVolatile()	Tests whether the volatile bit is on.
final void	isVolatile(boolean flag)	Sets the volatile bit.
final void	setAccessFlags(int accessFlags)	Sets access flags also known as modifiers.
final void	setModifiers(int accessFlags)	Sets access flags aka "modifiers".

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

EMPTY_ARRAY

public static final Field[] EMPTY_ARRAY

Empty array constant.

Since:

6.6.0

Constructor Details

Field

public Field(Field c)

Initialize from another object. Note that both objects use the same references (shallow copy). Use clone() for a physical copy.

Parameters:

c - Source to copy.

Field

public Field(int accessFlags,
 int nameIndex,
 int signatureIndex,
 Attribute[] attributes,
 ConstantPool constantPool)

Constructs a Field.

Parameters:

accessFlags - Access rights of field.

nameIndex - Points to field name in constant pool.

signatureIndex - Points to encoded signature.

attributes - Collection of attributes.

constantPool - Array of constants.

Method Details

getComparator

public static BCELComparator<Field> getComparator()

Gets the comparison strategy object.

Returns:

Comparison strategy object.

setComparator

public static void setComparator(BCELComparator<Field> comparator)

Sets the comparison strategy object.

Parameters:

comparator - Comparison strategy object.

accept

public void accept(Visitor v)

Called by objects that are traversing the nodes of the tree implicitly defined by the contents of a Java class. That is, the hierarchy of methods, fields, attributes, and other elements forms a tree of objects.

Parameters:

v - Visitor object.

copy

public Field copy(ConstantPool constantPool)

Creates a deep copy of this field.

Parameters:

constantPool - The constant pool.

Returns:

deep copy of this field.

equals

public boolean equals(Object obj)

Return value as defined by given BCELComparator strategy. By default two Field objects are said to be equal when their names and signatures are equal.

Overrides:

equals in class Object

See Also:

• Object.equals(Object)

getConstantValue

public ConstantValue getConstantValue()

Gets the constant value associated with this field.

Returns:

constant value associated with this field (may be null).

getType

public Type getType()

Gets the field type. See https://docs.oracle.com/javase/specs/jvms/se8/html/jvms-4.html#jvms-4.2.2

Returns:

type of field.

hashCode

public int hashCode()

Return value as defined by given BCELComparator strategy. By default return the hash code of the field's name XOR signature.

Overrides:

hashCode in class Object

See Also:

• Object.hashCode()

toString

public String toString()

Return string representation close to declaration format, for example: 'public static final short MAX = 100'.

Overrides:

toString in class Object

Returns:

String representation of field, including the signature.