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

Class ASTFormalParameter

java.lang.Object

net.sourceforge.pmd.lang.ast.AbstractNode

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

net.sourceforge.pmd.lang.java.ast.AbstractJavaAccessNode

net.sourceforge.pmd.lang.java.ast.AbstractJavaAccessTypeNode

net.sourceforge.pmd.lang.java.ast.ASTFormalParameter

All Implemented Interfaces:

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

Direct Known Subclasses:

ASTResource

public class ASTFormalParameter
extends AbstractJavaAccessTypeNode
implements Dimensionable, CanSuppressWarnings

Formal parameter node. Used in the ASTFormalParameters production of ASTMethodDeclarator to represent a method's formal parameter. Also used in the ASTCatchStatement production to represent the declared exception variable. Also used in LambdaExpressions for the LambdaParameters.

      ( "final" | Annotation )* Type ( "|" Type )* [ "..." ] VariableDeclaratorId
 

Field Summary

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

typeDefinition

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

Fields inherited from interface net.sourceforge.pmd.lang.java.ast.AccessNode

ABSTRACT, DEFAULT, FINAL, NATIVE, PRIVATE, PROTECTED, PUBLIC, STATIC, STRICTFP, SYNCHRONIZED, TRANSIENT, VOLATILE

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
ASTAnnotation	getAnnotation(java.lang.String annotQualifiedName)	Get specific annotaion on this node.
int	getArrayDepth()	Deprecated.
protected ASTVariableDeclaratorId	getDecl()	Deprecated. use getVariableDeclaratorId()
java.util.List<ASTAnnotation>	getDeclaredAnnotations()	Get all annotations present on this node.
java.lang.Class<?>	getType()	Returns the type of this formal parameter.
JavaTypeDefinition	getTypeDefinition()	Get the TypeDefinition associated with this node.
ASTType	getTypeNode()	Returns the type node of this formal parameter.
ASTVariableDeclaratorId	getVariableDeclaratorId()	Returns the declarator ID of this formal parameter.
boolean	hasSuppressWarningsAnnotationFor(net.sourceforge.pmd.Rule rule)
boolean	isAnnotationPresent(java.lang.String annotQualifiedName)	Checks whether the annotation is present on this node.
boolean	isAnyAnnotationPresent(java.util.Collection<java.lang.String> annotQualifiedNames)	Checks whether any annotation is present on this node.
boolean	isArray()	Deprecated.
boolean	isExplicitReceiverParameter()	Returns true if this node is the explicit receiver parameter, e.g. in
boolean	isTypeInferred()	If true, this formal parameter represents one without explit types.
boolean	isVarargs()	Returns true if this node is a varargs parameter.
java.lang.Object	jjtAccept(JavaParserVisitor visitor, java.lang.Object data)	Accept the visitor
void	setType(java.lang.Class<?> type)	Noop, the type of this node is defined by the type of the declarator id.
void	setTypeDefinition(JavaTypeDefinition type)	Noop, the type of this node is defined by the type of the declarator id.
void	setVarargs()	Deprecated. Will be made private in 7.0.0

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

getModifiers, isAbstract, isDefault, isFinal, isNative, isPackagePrivate, isPrivate, isProtected, isPublic, isStatic, isStrictfp, isSynchronized, isTransient, isVolatile, setAbstract, setDefault, setFinal, setModifiers, setNative, setPrivate, setProtected, setPublic, setStatic, setStrictfp, setSynchronized, setTransient, setVolatile

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.ast.AbstractNode

appendElement, findChildNodesWithXPath, findChildrenOfType, findDescendantsOfType, findDescendantsOfType, findDescendantsOfType, getAsDocument, getBeginColumn, getBeginLine, getDataFlowNode, getEndColumn, getEndLine, getFirstChildOfType, getFirstDescendantOfType, getFirstParentOfAnyType, getFirstParentOfType, getImage, getNthParent, getParentsOfType, getUserData, getXPathAttributesIterator, 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 class java.lang.Object

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

Methods inherited from interface net.sourceforge.pmd.lang.java.ast.JavaNode

childrenAccept, getScope, setScope

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, getXPathAttributesIterator, getXPathNodeName, hasDescendantMatchingXPath, hasDescendantOfType, hasImageEqualTo, isFindBoundary, jjtAddChild, jjtClose, jjtGetChild, jjtGetChildIndex, jjtGetId, jjtGetNumChildren, jjtGetParent, jjtOpen, jjtSetChildIndex, jjtSetParent, remove, removeChildAtIndex, setDataFlowNode, setImage, setUserData

Constructor Detail

ASTFormalParameter

public ASTFormalParameter(int id)

ASTFormalParameter

public ASTFormalParameter(JavaParser p,
                          int id)

Method Detail

setVarargs

@Deprecated
public void setVarargs()

Deprecated.

Will be made private in 7.0.0

isVarargs

public boolean isVarargs()

Returns true if this node is a varargs parameter.

isExplicitReceiverParameter

public boolean isExplicitReceiverParameter()

Returns true if this node is the explicit receiver parameter, e.g. in

 class Foo {
   abstract void foo(@Bar Foo this);
 }
 

isTypeInferred

public boolean isTypeInferred()

If true, this formal parameter represents one without explit types. This can appear as part of a lambda expression with java11 using "var".

See Also:

ASTVariableDeclaratorId.isTypeInferred()

jjtAccept

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

Description copied from class: AbstractJavaNode

Accept the visitor. *

Specified by:

jjtAccept in interface JavaNode

Overrides:

jjtAccept in class AbstractJavaNode

getVariableDeclaratorId

public ASTVariableDeclaratorId getVariableDeclaratorId()

Returns the declarator ID of this formal parameter.

hasSuppressWarningsAnnotationFor

public boolean hasSuppressWarningsAnnotationFor(net.sourceforge.pmd.Rule rule)

Specified by:

hasSuppressWarningsAnnotationFor in interface CanSuppressWarnings

isArray

@Deprecated
public boolean isArray()

Deprecated.

Returns true if this formal parameter is of an array type. This includes varargs parameters.

Specified by:

isArray in interface Dimensionable

getArrayDepth

@Deprecated
public int getArrayDepth()

Deprecated.

Specified by:

getArrayDepth in interface Dimensionable

getTypeNode

public ASTType getTypeNode()

Returns the type node of this formal parameter. The type of that node is not necessarily the type of the parameter itself, see ASTVariableDeclaratorId.getType().

In particular, the type of the returned node doesn't take into account whether this formal parameter is varargs or not.

getDecl

@Deprecated
protected ASTVariableDeclaratorId getDecl()

Deprecated.

use getVariableDeclaratorId()

getType

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

Returns the type of this formal parameter. That type is exactly that of the variable declarator id, which means that the declarator id's type takes into account whether this parameter is varargs or not.

Specified by:

getType in interface TypeNode

Overrides:

getType in class AbstractJavaAccessTypeNode

Returns:

The Java Class, may return null.

getTypeDefinition

public JavaTypeDefinition getTypeDefinition()

Description copied from interface: TypeNode

Get the TypeDefinition associated with this node. The Class object contained in the TypeDefinition will always be equal to that which is returned by getType().

Specified by:

getTypeDefinition in interface TypeNode

Overrides:

getTypeDefinition in class AbstractJavaAccessTypeNode

Returns:

The TypeDefinition, may return null

setTypeDefinition

public void setTypeDefinition(JavaTypeDefinition type)

Noop, the type of this node is defined by the type of the declarator id.

Specified by:

setTypeDefinition in interface TypeNode

Overrides:

setTypeDefinition in class AbstractJavaAccessTypeNode

Parameters:

type - A TypeDefinition object

setType

public void setType(java.lang.Class<?> type)

Noop, the type of this node is defined by the type of the declarator id.

Specified by:

setType in interface TypeNode

Overrides:

setType in class AbstractJavaAccessTypeNode

Parameters:

type - A Java Class

getDeclaredAnnotations

public java.util.List<ASTAnnotation> getDeclaredAnnotations()

Description copied from interface: Annotatable

Get all annotations present on this node.

Specified by:

getDeclaredAnnotations in interface Annotatable

Returns:

all annotations present on this node.

getAnnotation

public ASTAnnotation getAnnotation(java.lang.String annotQualifiedName)

Description copied from interface: Annotatable

Get specific annotaion on this node.

Specified by:

getAnnotation in interface Annotatable

Parameters:

annotQualifiedName - qulified name of the annotation.

Returns:

ASTAnnotaion node if the annotation is present on this node, else null

isAnnotationPresent

public boolean isAnnotationPresent(java.lang.String annotQualifiedName)

Description copied from interface: Annotatable

Checks whether the annotation is present on this node.

Specified by:

isAnnotationPresent in interface Annotatable

Parameters:

annotQualifiedName - qulified name of the annotation.

Returns:

true if the annotation is present on this node, else false

isAnyAnnotationPresent

public boolean isAnyAnnotationPresent(java.util.Collection<java.lang.String> annotQualifiedNames)

Description copied from interface: Annotatable

Checks whether any annotation is present on this node.

Specified by:

isAnyAnnotationPresent in interface Annotatable

Parameters:

annotQualifiedNames - collection that cotains qulified name of annotations.

Returns:

true if any annotation is present on this node, else false