Class NormalCompletionVisitor
java.lang.Object
com.github.javaparser.ast.visitor.GenericVisitorWithDefaults<Boolean,Void>
com.github.javaparser.symbolsolver.javaparsermodel.NormalCompletionVisitor
- All Implemented Interfaces:
GenericVisitor<Boolean,
Void>
When deciding into which scope pattern variables should be introduced, it is sometimes necessary to determine whether
a statement can complete normally .
The JLS specifies that a statement can complete normally only if it is reachable and specifies rules for what it
means for a statement to be reachable, but that part can be ignored in JavaParser since having unreachable code
results in a compilation error and is thus not supported. This means that all of the rules are implemented with the
assumption that provided nodes are reachable.
An example of where this is needed is for the following rule regarding pattern variables introduced by if-statements.
6.3.2.2. if Statements :
The following rules apply to a statement if (e) S (ยง14.9.1):
A pattern variable is introduced by if (e) S iff (i) it is introduced by e when false and (ii) S cannot complete
normally.
This means that in this example:
if (!(x instanceof Foo f)) {
return;
}
System.out.println(f);
f will be in scope for the println call since the block making up the then-block of the if statement (S in the rule
above) cannot complete normally (since the last statement, return, cannot complete normally).
But, in this example:
if (!(x instanceof Foo f)) { }
f is not introduced by the if statement since the empty then-block can complete normally.-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
containsCorrespondingBreak
(Statement statement) defaultAction
(Node n, Void unused) This will be called by every node visit method that is not overridden.private static boolean
isEnhanced
(SwitchStmt stmt) From https://docs.oracle.com/javase/specs/jls/se21/html/jls-14.html#jls-14.11.2 An enhanced switch statement is one where either (i) the type of the selector expression is not char, byte, short, int, Character, Byte, Short, Integer, String, or an enum type, or (ii) there is a case pattern or null literal associated with the switch block.private boolean
switchRuleCompletesNormally
(SwitchEntry switchEntry, Void unused) A switch statement whose switch block consists of switch rules can complete normally iff at least one of the following is true: - One of the switch rules introduces a switch rule expression (which is necessarily a statement expression).An empty block that is not a switch block can complete normally iff it is reachable.A break statement cannot complete normally.visit
(ContinueStmt continueStmt, Void unused) A continue statement cannot complete normally.A do statement can complete normally iff at least one of the following is true: - The contained statement can complete normally and the condition expression is not a constant expression with value true.A basic for statement can complete normally iff at least one of the following is true: - The for statement is reachable, there is a condition expression, and the condition expression is not a constant expression with value true.An if-then statement can complete normally iff it is reachable.visit
(LabeledStmt labeledStmt, Void unused) A labeled statement can complete normally if at least one of the following is true: - The contained statement can complete normally.visit
(ReturnStmt returnStmt, Void unused) A return statement cannot complete normally.visit
(SwitchStmt switchStmt, Void unused) A switch statement whose switch block is empty, or contains only switch labels, can complete normally.visit
(SynchronizedStmt synchronizedStmt, Void unused) A synchronized statement can complete normally iff the contained statement can complete normally.A throw statement cannot complete normally.A try statement can complete normally iff both of the following are true: - The try block can complete normally or any catch block can complete normally.A while statement can complete normally iff at least one of the following is true: - The while statement is reachable and the condition expression is not a constant expression with value true.A yield statement cannot complete normally.Methods inherited from class com.github.javaparser.ast.visitor.GenericVisitorWithDefaults
defaultAction, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit
-
Field Details
-
nonEnhancedSwitchTypes
-
-
Constructor Details
-
NormalCompletionVisitor
public NormalCompletionVisitor()
-
-
Method Details
-
defaultAction
Description copied from class:GenericVisitorWithDefaults
This will be called by every node visit method that is not overridden.- Overrides:
defaultAction
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A break statement cannot complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A continue statement cannot complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A return statement cannot complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A throw statement cannot complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A yield statement cannot complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
An empty block that is not a switch block can complete normally iff it is reachable. A non-empty block that is not a switch block can complete normally iff the last statement in it can complete normally. The first statement in a non-empty block that is not a switch block is reachable iff the block is reachable. Every other statement S in a non-empty block that is not a switch block is reachable iff the statement preceding S can complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A labeled statement can complete normally if at least one of the following is true: - The contained statement can complete normally. - There is a reachable break statement that exits the labeled statement.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
An if-then statement can complete normally iff it is reachable. An if-then-else statement can complete normally iff the then-statement can complete normally or the else-statement can complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A while statement can complete normally iff at least one of the following is true: - The while statement is reachable and the condition expression is not a constant expression with value true. - There is a reachable break statement that exits the while statement.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A do statement can complete normally iff at least one of the following is true: - The contained statement can complete normally and the condition expression is not a constant expression with value true. - The do statement contains a reachable continue statement with no label, and the do statement is the innermost while, do, or for statement that contains that continue statement, and the continue statement continues that do statement, and the condition expression is not a constant expression with value true. - The do statement contains a reachable continue statement with label L, and the do statement has label L, and the continue statement continues that do statement, and the condition expression is not a constant expression with value true. - There is a reachable break statement that exits the do statement.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A basic for statement can complete normally iff at least one of the following is true: - The for statement is reachable, there is a condition expression, and the condition expression is not a constant expression with value true. - There is a reachable break statement that exits the for statement.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A synchronized statement can complete normally iff the contained statement can complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A try statement can complete normally iff both of the following are true: - The try block can complete normally or any catch block can complete normally. - If the try statement has a finally block, then the finally block can complete normally.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
visit
A switch statement whose switch block is empty, or contains only switch labels, can complete normally. A switch statement whose switch block consists of switch labeled statement groups can complete normally iff at least one of the following is true: - The last statement in the switch block can complete normally. - There is at least one switch label after the last switch block statement group. - There is a reachable break statement that exits the switch statement. - The switch statement is not enhanced and its switch block does not contain a default label. A switch statement whose switch block consists of switch rules can complete normally iff at least one of the following is true: - One of the switch rules introduces a switch rule expression (which is necessarily a statement expression). - One of the switch rules introduces a switch rule block that can complete normally. - One of the switch rules introduces a switch rule block that contains a reachable break statement which exits the switch statement. - The switch statement is not enhanced and its switch block does not contain a default label.- Specified by:
visit
in interfaceGenericVisitor<Boolean,
Void> - Overrides:
visit
in classGenericVisitorWithDefaults<Boolean,
Void>
-
switchRuleCompletesNormally
A switch statement whose switch block consists of switch rules can complete normally iff at least one of the following is true: - One of the switch rules introduces a switch rule expression (which is necessarily a statement expression). - One of the switch rules introduces a switch rule block that can complete normally. -
containsCorrespondingBreak
- Parameters:
statement
- should be one of: SwitchStatement, WhileStatement, DoStatement, ForStatement- Returns:
- true if a break corresponding to the statement is found; false otherwise
-
isEnhanced
From https://docs.oracle.com/javase/specs/jls/se21/html/jls-14.html#jls-14.11.2 An enhanced switch statement is one where either (i) the type of the selector expression is not char, byte, short, int, Character, Byte, Short, Integer, String, or an enum type, or (ii) there is a case pattern or null literal associated with the switch block. Since this relies on resolving the type of the selector expression, it might not be possible to determine whether a given switch statement is enhanced or not. If this cannot be determined, assume that it is enhanced.
-