Package com.pnfsoftware.jeb.core.units.code.java

Interface IJavaCall

All Superinterfaces:

IJavaElement, IJavaExpression, IJavaStatement

@Ser
public interface IJavaCall
extends IJavaStatement, IJavaExpression

Java AST interface to represent a method invocation. This interface is not used to represent new-object or new-array creation.

Example:

 foo(0, 1, "bar")
 

See Also:

• IJavaMethod

Field Summary

Fields

Modifier and Type	Field	Description
static final int	CALLTYPE_LAMBDA	Lambda implementation call.
static final int	CALLTYPE_REGULAR	Regular virtual or direct call.
static final int	CALLTYPE_STATIC	Static method call.
static final int	CALLTYPE_SUPER	Super-class method call.

Fields inherited from interface com.pnfsoftware.jeb.core.units.code.java.IJavaElement

FLAG_BUILT, FLAG_FIELD_REFERENCES_OUTERCLASS, FLAG_LAMBDA_CLASS, FLAG_LAMBDA_IMPL, FLAG_OPTIONAL_RENDERING, FLAG_SECOND_PARAMETER_IS_OUTER_REF, FLAG_STICKY

Method Summary

Modifier and Type	Method	Description
void	addArgument(IJavaExpression arg)	Append an argument to this method call.
IJavaCall	duplicate()	Duplicate this element.
IJavaExpression	getArgument(int index)	Retrieve an argument by index.
int	getArgumentCount()	Get the number of arguments.
List<IJavaExpression>	getArguments()	Retrieve the list of arguments passed to the method.
int	getCallType()	Retrieve the call type.
IJavaMethod	getMethod()	Get the method element.
String	getMethodClass()	Retrieve the signature of the method owner class.
String	getMethodName()	Get the original method simple name.
String	getMethodSignature()	Get the original method jvm name (fully qualified canonical name).
void	insertArgument(int index, IJavaExpression arg)	Insert an argument to the list of arguments.
boolean	isLambdaCall()	Determine whether the call represents a lambda implementation call.
boolean	isStaticCall()	Determine whether the call is static.
boolean	isSuperCall()	Determine if the call is to a super-class method.
IJavaExpression	removeArgument(int index)	Pull an argument from the list of arguments.
void	setArgument(int index, IJavaExpression arg)	Replace an argument.
void	setMethod(IJavaMethod method, int calltype)	Set the method to be called.

Methods inherited from interface com.pnfsoftware.jeb.core.units.code.java.IJavaElement

addFlags, addTag, canCauseException, collectAllPhysicalOffsets, generate, getData, getElementType, getFlags, getOrigin, getPhysicalMethodIndex, getPhysicalOffset, getReconAnon, getReconEnum, getReconEnummap, getReconLambda, getSubElements, getTags, hasFlags, hasPhysicalMethodIndex, hasPhysicalOffset, isReconArtifact, removeFlags, removeTag, replaceSubElement, setData, setFlags, setLambdaRecon, setOrigin, setPhysicalMethodIndex, setPhysicalOffset, setReconAnon, setReconEnum, setReconEnummap, toShortString, visitDepthPost, visitDepthPost, visitDepthPost, visitDepthPost, visitDepthPre, visitDepthPre, visitDepthPre

Methods inherited from interface com.pnfsoftware.jeb.core.units.code.java.IJavaStatement

getIntermediateOffset, setIntermediateOffset

Field Details

CALLTYPE_REGULAR

static final int CALLTYPE_REGULAR

Regular virtual or direct call.

See Also:

• Constant Field Values

CALLTYPE_SUPER

static final int CALLTYPE_SUPER

Super-class method call.

See Also:

• Constant Field Values

CALLTYPE_LAMBDA

static final int CALLTYPE_LAMBDA

Lambda implementation call.

See Also:

• Constant Field Values

CALLTYPE_STATIC

static final int CALLTYPE_STATIC

Static method call.

See Also:

• Constant Field Values

Method Details

getMethod

IJavaMethod getMethod()

Get the method element.

Returns:

the method element

setMethod

void setMethod(IJavaMethod method,
 int calltype)

Set the method to be called.

Parameters:

method - mandatory method

calltype - one of CALLTYPE_xxx constant

getCallType

int getCallType()

Retrieve the call type.

Returns:

one of the CALLTYPE_xxx constants

isSuperCall

boolean isSuperCall()

Determine if the call is to a super-class method.

Returns:

true if the method being called is a super-class method

isLambdaCall

boolean isLambdaCall()

Determine whether the call represents a lambda implementation call.

Returns:

true if this call is a lambda call

isStaticCall

boolean isStaticCall()

Determine whether the call is static.

Returns:

true if this call is static

getMethodSignature

String getMethodSignature()

Get the original method jvm name (fully qualified canonical name).

Returns:

the method signature

getMethodClass

String getMethodClass()

Retrieve the signature of the method owner class.

Returns:

the method owner class signature

getMethodName

String getMethodName()

Get the original method simple name.

Returns:

the method simple name

getArgumentCount

int getArgumentCount()

Get the number of arguments.

Returns:

the number of arguments

getArguments

List<IJavaExpression> getArguments()

Retrieve the list of arguments passed to the method.

If the method being called is a virtual method, the first argument will be an expression representing the object on which this method is called.

Returns:

the list of arguments, the elements in the list cannot be null

getArgument

IJavaExpression getArgument(int index)

Retrieve an argument by index.

Parameters:

index - 0-based argument index

Returns:

the argument expression

addArgument

void addArgument(IJavaExpression arg)

Append an argument to this method call.

Parameters:

arg - mandatory argument to append

insertArgument

void insertArgument(int index,
 IJavaExpression arg)

Insert an argument to the list of arguments.

Parameters:

index - 0-based argument index

arg - mandatory argument to be inserted

setArgument

void setArgument(int index,
 IJavaExpression arg)

Replace an argument.

Parameters:

index - 0-based argument index

arg - mandatory replacement argument

removeArgument

IJavaExpression removeArgument(int index)

Pull an argument from the list of arguments.

Parameters:

index - 0-based argument index

Returns:

the argument object that was pulled out

duplicate

IJavaCall duplicate()

Description copied from interface: IJavaElement

Duplicate this element.

Specified by:

duplicate in interface IJavaElement

Specified by:

duplicate in interface IJavaExpression

Specified by:

duplicate in interface IJavaStatement

Returns:

a (possibly) duplicated object of the same type