xapi.bytecode

Class MethodInfo

java.lang.Object

xapi.bytecode.MemberInfo

xapi.bytecode.MethodInfo

All Implemented Interfaces:

Annotated

public class MethodInfo
extends MemberInfo

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	doPreverify If this value is true, Javassist maintains a StackMap attribute generated by the preverify tool of J2ME (CLDC).
static String	nameClinit The name of class initializer (static initializer): <clinit>.
static String	nameInit The name of constructors: <init>.

Constructor Summary

Constructors

Constructor and Description
MethodInfo(ConstPool cp, String methodname, MethodInfo src, Map<?,?> classnameMap) Constructs a copy of method_info structure.
MethodInfo(ConstPool cp, String methodname, String desc) Constructs a method_info structure.

Method Summary

Modifier and Type	Method and Description
void	addAttribute(AttributeInfo info) Appends an attribute.
int	getAccessFlags() Returns access flags.
CodeAttribute	getCodeAttribute() Returns a Code attribute.
ConstPool	getConstPool() Returns a constant pool table used by this method.
String	getDescriptor() Returns a method descriptor.
ExceptionsAttribute	getExceptionsAttribute() Returns an Exceptions attribute.
int	getLineNumber(int pos) Returns the line number of the source line corresponding to the specified bytecode contained in this method.
String	getName() Returns a method name.
String	getSignature()
boolean	isConstructor() Returns true if this is a constructor.
boolean	isMethod() Returns true if this is not a constructor or a class initializer (static initializer).
boolean	isStaticInitializer() Returns true if this is a class initializer (static initializer).
void	removeCodeAttribute() Removes a Code attribute.
void	removeExceptionsAttribute() Removes an Exception attribute.
void	setAccessFlags(int acc) Sets access flags.
void	setCodeAttribute(CodeAttribute cattr) Adds a Code attribute.
void	setDescriptor(String desc) Sets a method descriptor.
void	setExceptionsAttribute(ExceptionsAttribute cattr) Adds an Exception attribute.
void	setName(String newName) Sets a method name.
void	setSuperclass(String superclass) Changes a super constructor called by this constructor.
String	toString() Returns a string representation of the object.

Methods inherited from class xapi.bytecode.MemberInfo

equals, getAnnotation, getAnnotations, getAttribute, getAttributes, hasAnnotation, hashCode

Methods inherited from class java.lang.Object

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

Field Detail

doPreverify

public static boolean doPreverify

If this value is true, Javassist maintains a StackMap attribute generated by the preverify tool of J2ME (CLDC). The initial value of this field is false.

nameInit

public static final String nameInit

The name of constructors: <init>.

See Also:

Constant Field Values

nameClinit

public static final String nameClinit

The name of class initializer (static initializer): <clinit>.

See Also:

Constant Field Values

Constructor Detail

MethodInfo

public MethodInfo(ConstPool cp,
                  String methodname,
                  String desc)

Constructs a method_info structure. The initial value of access_flags is zero.

Parameters:

cp - a constant pool table

methodname - method name

desc - method descriptor

See Also:

Descriptor

MethodInfo

public MethodInfo(ConstPool cp,
                  String methodname,
                  MethodInfo src,
                  Map<?,?> classnameMap)
           throws BadBytecode

Constructs a copy of method_info structure. Class names appearing in the source method_info are renamed according to classnameMap.

Note: only Code and Exceptions attributes are copied from the source. The other attributes are ignored.

Parameters:

cp - a constant pool table

methodname - a method name

src - a source method_info

classnameMap - specifies pairs of replaced and substituted name.

Throws:

BadBytecode

See Also:

Descriptor

Method Detail

toString

public String toString()

Returns a string representation of the object.

Overrides:

toString in class Object

getSignature

public String getSignature()

Specified by:

getSignature in class MemberInfo

getName

public String getName()

Returns a method name.

setName

public void setName(String newName)

Sets a method name.

isMethod

public boolean isMethod()

Returns true if this is not a constructor or a class initializer (static initializer).

getConstPool

public ConstPool getConstPool()

Returns a constant pool table used by this method.

isConstructor

public boolean isConstructor()

Returns true if this is a constructor.

isStaticInitializer

public boolean isStaticInitializer()

Returns true if this is a class initializer (static initializer).

getAccessFlags

public int getAccessFlags()

Returns access flags.

See Also:

AccessFlag

setAccessFlags

public void setAccessFlags(int acc)

Sets access flags.

See Also:

AccessFlag

getDescriptor

public String getDescriptor()

Returns a method descriptor.

See Also:

Descriptor

setDescriptor

public void setDescriptor(String desc)

Sets a method descriptor.

See Also:

Descriptor

addAttribute

public void addAttribute(AttributeInfo info)

Appends an attribute. If there is already an attribute with the same name, the new one substitutes for it.

See Also:

MemberInfo.getAttributes()

getExceptionsAttribute

public ExceptionsAttribute getExceptionsAttribute()

Returns an Exceptions attribute.

Returns:

an Exceptions attribute or null if it is not specified.

getCodeAttribute

public CodeAttribute getCodeAttribute()

Returns a Code attribute.

Returns:

a Code attribute or null if it is not specified.

removeExceptionsAttribute

public void removeExceptionsAttribute()

Removes an Exception attribute.

setExceptionsAttribute

public void setExceptionsAttribute(ExceptionsAttribute cattr)

Adds an Exception attribute.

The added attribute must share the same constant pool table as this method_info structure.

removeCodeAttribute

public void removeCodeAttribute()

Removes a Code attribute.

setCodeAttribute

public void setCodeAttribute(CodeAttribute cattr)

Adds a Code attribute.

The added attribute must share the same constant pool table as this method_info structure.

getLineNumber

public int getLineNumber(int pos)

Returns the line number of the source line corresponding to the specified bytecode contained in this method.

Parameters:

pos - the position of the bytecode (>= 0). an index into the code array.

Returns:

-1 if this information is not available.

setSuperclass

public void setSuperclass(String superclass)
                   throws BadBytecode

Changes a super constructor called by this constructor.

This method modifies a call to super(), which should be at the head of a constructor body, so that a constructor in a different super class is called. This method does not change actual parameters. Hence the new super class must have a constructor with the same signature as the original one.

This method should be called when the super class of the class declaring this method is changed.

This method does not perform anything unless this MethodInfo represents a constructor.

Parameters:

superclass - the new super class

Throws:

BadBytecode