org.sonar.java.model

Class DefaultJavaFileScannerContext

java.lang.Object

org.sonar.java.model.DefaultJavaFileScannerContext

All Implemented Interfaces:

JavaFileScannerContext

Direct Known Subclasses:

VisitorsBridgeForTests.TestJavaFileScannerContext

public class DefaultJavaFileScannerContext
extends Object
implements JavaFileScannerContext

Nested Class Summary

Nested classes/interfaces inherited from interface org.sonar.plugins.java.api.JavaFileScannerContext

JavaFileScannerContext.Location

Constructor Summary

Constructors

Constructor and Description
DefaultJavaFileScannerContext(CompilationUnitTree tree, File file, SemanticModel semanticModel, SonarComponents sonarComponents, JavaVersion javaVersion, boolean fileParsed)

Method Summary

Modifier and Type	Method and Description
void	addIssue(File file, JavaCheck check, int line, String message) Report an issue at a specific line of a given file.
void	addIssue(int line, JavaCheck javaCheck, String message) Report an issue on a specific line.
void	addIssue(int line, JavaCheck javaCheck, String message, Integer cost) Report an issue on a specific line.
void	addIssueOnFile(JavaCheck javaCheck, String message) Report an issue at file level.
protected static AnalyzerMessage	createAnalyzerMessage(File file, JavaCheck javaCheck, Tree startTree, Tree endTree, String message, List<JavaFileScannerContext.Location> secondary, Integer cost)
boolean	fileParsed() Checks if file has been parsed correctly.
List<Tree>	getComplexityNodes(Tree tree) Computes the list of syntax nodes which are contributing to increase the complexity for the given methodTree.
File	getFile() File under analysis.
String	getFileKey() FileKey of currently analyzed file.
JavaVersion	getJavaVersion() Java version defined for the analysis using sonar.java.version parameter.
List<Tree>	getMethodComplexityNodes(ClassTree enclosingClass, MethodTree methodTree) Computes the list of syntax nodes which are contributing to increase the complexity for the given methodTree.
Object	getSemanticModel() Get semantic analysis.
CompilationUnitTree	getTree() Parsed tree of the current file.
void	reportIssue(JavaCheck javaCheck, Tree tree, String message) Report an issue.
void	reportIssue(JavaCheck javaCheck, Tree syntaxNode, String message, List<JavaFileScannerContext.Location> secondary, Integer cost) Report an issue.
void	reportIssue(JavaCheck javaCheck, Tree startTree, Tree endTree, String message) Report an issue.
void	reportIssue(JavaCheck javaCheck, Tree startTree, Tree endTree, String message, List<JavaFileScannerContext.Location> secondary, Integer cost) Report an issue.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultJavaFileScannerContext

public DefaultJavaFileScannerContext(CompilationUnitTree tree,
                                     File file,
                                     SemanticModel semanticModel,
                                     @Nullable
                                     SonarComponents sonarComponents,
                                     JavaVersion javaVersion,
                                     boolean fileParsed)

Method Detail

getTree

public CompilationUnitTree getTree()

Description copied from interface: JavaFileScannerContext

Parsed tree of the current file.

Specified by:

getTree in interface JavaFileScannerContext

Returns:

CompilationUnitTree ready for scan by checks.

addIssueOnFile

public void addIssueOnFile(JavaCheck javaCheck,
                           String message)

Description copied from interface: JavaFileScannerContext

Report an issue at file level.

Specified by:

addIssueOnFile in interface JavaFileScannerContext

Parameters:

javaCheck - The check raising the issue.

message - Message to display to the user

addIssue

public void addIssue(int line,
                     JavaCheck javaCheck,
                     String message)

Description copied from interface: JavaFileScannerContext

Report an issue on a specific line.

Specified by:

addIssue in interface JavaFileScannerContext

Parameters:

line - line on which to report the issue

javaCheck - The check raising the issue.

message - Message to display to the user

See Also:

JavaFileScannerContext#reportIssue(JavaCheck, Tree, String)} which should be prefered as reporting will be more precise.

addIssue

public void addIssue(int line,
                     JavaCheck javaCheck,
                     String message,
                     @Nullable
                     Integer cost)

Description copied from interface: JavaFileScannerContext

Report an issue on a specific line.

Specified by:

addIssue in interface JavaFileScannerContext

Parameters:

line - line on which to report the issue

javaCheck - The check raising the issue.

message - Message to display to the user

cost - computed remediation cost if applicable, null if not.

See Also:

JavaFileScannerContext#reportIssue(JavaCheck, Tree, String, List, Integer)} which should be prefered as reporting will be more precise.

getSemanticModel

@Nullable
public Object getSemanticModel()

Description copied from interface: JavaFileScannerContext

Get semantic analysis.

Specified by:

getSemanticModel in interface JavaFileScannerContext

Returns:

SemanticModel if semantic analysis was successful, null otherwise.

getJavaVersion

public JavaVersion getJavaVersion()

Description copied from interface: JavaFileScannerContext

Java version defined for the analysis using sonar.java.version parameter.

Specified by:

getJavaVersion in interface JavaFileScannerContext

Returns:

JavaVersion object with API to act on it.

fileParsed

public boolean fileParsed()

Description copied from interface: JavaFileScannerContext

Checks if file has been parsed correctly.

Specified by:

fileParsed in interface JavaFileScannerContext

Returns:

true if parsing was successful

getFileKey

public String getFileKey()

Description copied from interface: JavaFileScannerContext

FileKey of currently analyzed file.

Specified by:

getFileKey in interface JavaFileScannerContext

Returns:

the fileKey of the file currently analyzed.

addIssue

public void addIssue(File file,
                     JavaCheck check,
                     int line,
                     String message)

Description copied from interface: JavaFileScannerContext

Report an issue at a specific line of a given file. This method is used for one

Specified by:

addIssue in interface JavaFileScannerContext

Parameters:

file - File on which to report

check - The check raising the issue.

line - line on which to report the issue

message - Message to display to the user

reportIssue

public void reportIssue(JavaCheck javaCheck,
                        Tree tree,
                        String message)

Description copied from interface: JavaFileScannerContext

Report an issue.

Specified by:

reportIssue in interface JavaFileScannerContext

Parameters:

javaCheck - check raising the issue

tree - syntax node on which to raise the issue.

message - Message to display to the user.

reportIssue

public void reportIssue(JavaCheck javaCheck,
                        Tree syntaxNode,
                        String message,
                        List<JavaFileScannerContext.Location> secondary,
                        @Nullable
                        Integer cost)

Description copied from interface: JavaFileScannerContext

Report an issue.

Specified by:

reportIssue in interface JavaFileScannerContext

Parameters:

javaCheck - check raising the issue

syntaxNode - syntax node on which to raise the issue.

message - Message to display to the user.

secondary - List of JavaFileScannerContext.Location to display secondary location for the issue.

cost - computed remediation cost if applicable, null if not.

reportIssue

public void reportIssue(JavaCheck javaCheck,
                        Tree startTree,
                        Tree endTree,
                        String message)

Description copied from interface: JavaFileScannerContext

Report an issue.

Specified by:

reportIssue in interface JavaFileScannerContext

Parameters:

javaCheck - check raising the issue

startTree - syntax node on which to start the highlighting of the issue.

endTree - syntax node on which to end the highlighting of the issue.

message - Message to display to the user.

reportIssue

public void reportIssue(JavaCheck javaCheck,
                        Tree startTree,
                        Tree endTree,
                        String message,
                        List<JavaFileScannerContext.Location> secondary,
                        @Nullable
                        Integer cost)

Description copied from interface: JavaFileScannerContext

Report an issue.

Specified by:

reportIssue in interface JavaFileScannerContext

Parameters:

javaCheck - check raising the issue

startTree - syntax node on which to start the highlighting of the issue.

endTree - syntax node on which to end the highlighting of the issue.

message - Message to display to the user.

secondary - List of JavaFileScannerContext.Location to display secondary location for the issue.

cost - computed remediation cost if applicable, null if not.

createAnalyzerMessage

protected static AnalyzerMessage createAnalyzerMessage(File file,
                                                       JavaCheck javaCheck,
                                                       Tree startTree,
                                                       @Nullable
                                                       Tree endTree,
                                                       String message,
                                                       List<JavaFileScannerContext.Location> secondary,
                                                       @Nullable
                                                       Integer cost)

getFile

public File getFile()

Description copied from interface: JavaFileScannerContext

File under analysis.

Specified by:

getFile in interface JavaFileScannerContext

Returns:

the currently analysed file.

getComplexityNodes

public List<Tree> getComplexityNodes(Tree tree)

Description copied from interface: JavaFileScannerContext

Computes the list of syntax nodes which are contributing to increase the complexity for the given methodTree.

Specified by:

getComplexityNodes in interface JavaFileScannerContext

Parameters:

tree - the tree to compute the complexity.

Returns:

the list of syntax nodes incrementing the complexity.

getMethodComplexityNodes

public List<Tree> getMethodComplexityNodes(ClassTree enclosingClass,
                                           MethodTree methodTree)

Description copied from interface: JavaFileScannerContext

Computes the list of syntax nodes which are contributing to increase the complexity for the given methodTree.

Specified by:

getMethodComplexityNodes in interface JavaFileScannerContext

Parameters:

enclosingClass - not used.

methodTree - the methodTree to compute the complexity.

Returns:

the list of syntax nodes incrementing the complexity.