Package net.sourceforge.pmd.lang.java.ast

Class ASTVariableDeclaratorId

java.lang.Object

net.sourceforge.pmd.lang.ast.AbstractNode

net.sourceforge.pmd.lang.java.ast.AbstractJavaNode

net.sourceforge.pmd.lang.java.ast.AbstractJavaTypeNode

net.sourceforge.pmd.lang.java.ast.ASTVariableDeclaratorId

All Implemented Interfaces:

net.sourceforge.pmd.lang.ast.Node, Dimensionable, JavaNode, TypeNode, net.sourceforge.pmd.lang.symboltable.ScopedNode

public class ASTVariableDeclaratorId
extends AbstractJavaTypeNode
implements Dimensionable

Field Summary

Fields inherited from class net.sourceforge.pmd.lang.java.ast.AbstractJavaNode

parser

Fields inherited from class net.sourceforge.pmd.lang.ast.AbstractNode

beginColumn, beginLine, childIndex, children, endColumn, endLine, firstToken, id, lastToken, parent

Constructor Summary

Constructors

Constructor	Description
ASTVariableDeclaratorId(int id)
ASTVariableDeclaratorId(JavaParser p, int id)

Method Summary

Modifier and Type	Method	Description
void	bumpArrayDepth()
int	getArrayDepth()
VariableNameDeclaration	getNameDeclaration()
java.lang.Class<?>	getType()	Returns the type of the declared variable.
net.sourceforge.pmd.lang.ast.Node	getTypeNameNode()	Returns the first child of the node returned by getTypeNode().
ASTType	getTypeNode()	Determines the type node of this variable id, that is, the type node belonging to the variable declaration of this node (either a FormalParameter, LocalVariableDeclaration or FieldDeclaration).
java.util.List<net.sourceforge.pmd.lang.symboltable.NameOccurrence>	getUsages()
boolean	isArray()
boolean	isExceptionBlockParameter()
boolean	isExplicitReceiverParameter()
boolean	isTypeInferred()	Returns true if the declared variable's type is inferred by the compiler.
java.lang.Object	jjtAccept(JavaParserVisitor visitor, java.lang.Object data)	Accept the visitor.
void	setExplicitReceiverParameter()
void	setNameDeclaration(VariableNameDeclaration decl)

Methods inherited from class net.sourceforge.pmd.lang.java.ast.AbstractJavaNode

childrenAccept, comment, comment, getScope, getXPathNodeName, jjtClose, jjtOpen, setScope

Methods inherited from class net.sourceforge.pmd.lang.java.ast.AbstractJavaTypeNode

getTypeDefinition, setType, setTypeDefinition

Methods inherited from class net.sourceforge.pmd.lang.ast.AbstractNode

appendElement, findChildNodesWithXPath, findChildrenOfType, findDescendantsOfType, findDescendantsOfType, findDescendantsOfType, getAsDocument, getBeginColumn, getBeginLine, getDataFlowNode, getEndColumn, getEndLine, getFirstChildOfType, getFirstDescendantOfType, getFirstParentOfAnyType, getFirstParentOfType, getImage, getNthParent, getParentsOfType, getUserData, hasDecendantOfAnyType, hasDescendantMatchingXPath, hasDescendantOfAnyType, hasDescendantOfType, hasImageEqualTo, isFindBoundary, isSingleLine, jjtAddChild, jjtGetChild, jjtGetChildIndex, jjtGetFirstToken, jjtGetId, jjtGetLastToken, jjtGetNumChildren, jjtGetParent, jjtSetChildIndex, jjtSetFirstToken, jjtSetLastToken, jjtSetParent, remove, removeChildAtIndex, setDataFlowNode, setImage, setUserData, testingOnlySetBeginColumn, testingOnlySetBeginLine, testingOnlySetEndColumn, testingOnlySetEndLine, toString

Methods inherited from interface net.sourceforge.pmd.lang.ast.Node

findChildNodesWithXPath, findChildrenOfType, findDescendantsOfType, findDescendantsOfType, getAsDocument, getBeginColumn, getBeginLine, getDataFlowNode, getEndColumn, getEndLine, getFirstChildOfType, getFirstDescendantOfType, getFirstParentOfAnyType, getFirstParentOfType, getImage, getNthParent, getParentsOfType, getUserData, getXPathNodeName, hasDescendantMatchingXPath, hasDescendantOfType, hasImageEqualTo, isFindBoundary, jjtAddChild, jjtClose, jjtGetChild, jjtGetChildIndex, jjtGetId, jjtGetNumChildren, jjtGetParent, jjtOpen, jjtSetChildIndex, jjtSetParent, remove, removeChildAtIndex, setDataFlowNode, setImage, setUserData

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ASTVariableDeclaratorId

public ASTVariableDeclaratorId(int id)

ASTVariableDeclaratorId

public ASTVariableDeclaratorId(JavaParser p,
                               int id)

Method Detail

jjtAccept

public java.lang.Object jjtAccept(JavaParserVisitor visitor,
                                  java.lang.Object data)

Accept the visitor. *

Specified by:

jjtAccept in interface JavaNode

Overrides:

jjtAccept in class AbstractJavaNode

getNameDeclaration

public VariableNameDeclaration getNameDeclaration()

setNameDeclaration

public void setNameDeclaration(VariableNameDeclaration decl)

getUsages

public java.util.List<net.sourceforge.pmd.lang.symboltable.NameOccurrence> getUsages()

bumpArrayDepth

public void bumpArrayDepth()

getArrayDepth

public int getArrayDepth()

Specified by:

getArrayDepth in interface Dimensionable

isArray

public boolean isArray()

Specified by:

isArray in interface Dimensionable

isExceptionBlockParameter

public boolean isExceptionBlockParameter()

setExplicitReceiverParameter

public void setExplicitReceiverParameter()

isExplicitReceiverParameter

public boolean isExplicitReceiverParameter()

isTypeInferred

public boolean isTypeInferred()

Returns true if the declared variable's type is inferred by the compiler. In Java 8, this can happen if it's in a formal parameter of a lambda with an inferred type (e.g. (a, b) -> a + b). Since Java 10, the type of local variables can be inferred too, e.g. var i = 2;.

This method returns true for declarator IDs in those contexts, in which case getTypeNode() returns null, since the type node is absent.

getTypeNameNode

public net.sourceforge.pmd.lang.ast.Node getTypeNameNode()

Returns the first child of the node returned by getTypeNode(). The image of that node can usually be interpreted as the image of the type.

getTypeNode

public ASTType getTypeNode()

Determines the type node of this variable id, that is, the type node belonging to the variable declaration of this node (either a FormalParameter, LocalVariableDeclaration or FieldDeclaration).

The type of the returned node is not necessarily the type of this node. See getType() for an explanation.

Returns:

the type node, or null if there is no explicit type, e.g. if isTypeInferred() returns true.

getType

public java.lang.Class<?> getType()

Returns the type of the declared variable. The type of a declarator ID is

• 1. not necessarily the same as the type written out at the start of the declaration, e.g. int a[];
• 2. not necessarily the same as the types of other variables declared in the same statement, e.g. int a[], b;.

These are consequences of Java's allowing programmers to declare additional pairs of brackets on declarator ids. The type of the node returned by getTypeNode() doesn't take into account those additional array dimensions, whereas this node's type takes into account the total number of dimensions, i.e. those declared on this node plus those declared on the type node.

The returned type also takes into account whether this variable is a varargs formal parameter.

The type of the declarator ID is thus always the real type of the variable.

Specified by:

getType in interface TypeNode

Overrides:

getType in class AbstractJavaTypeNode

Returns:

The Java Class, may return null.