com.android.tools.lint.detector.api

Class JavaContext

java.lang.Object

com.android.tools.lint.detector.api.Context

com.android.tools.lint.detector.api.JavaContext

public class JavaContext
extends Context

A Context used when checking Java files.

NOTE: This is not a public or final API; if you rely on this be prepared to adjust your code for the next tools release.

Field Summary

Fields

Modifier and Type	Field and Description
lombok.ast.Node	compilationUnit The parse tree
IJavaParser	parser The parser which produced the parse tree

Fields inherited from class com.android.tools.lint.detector.api.Context

file, mDriver

Constructor Summary

Constructors

Constructor and Description
JavaContext(LintDriver driver, Project project, Project main, java.io.File file) Constructs a JavaContext for running lint on the given file, with the given scope, in the given project reporting errors to the given client.

Method Summary

Methods

Modifier and Type	Method and Description
static lombok.ast.ClassDeclaration	findSurroundingClass(lombok.ast.Node scope)
static lombok.ast.Node	findSurroundingMethod(lombok.ast.Node scope)
Location	getLocation(lombok.ast.Node node) Returns a location for the given node
void	report(Issue issue, Location location, java.lang.String message, java.lang.Object data) Reports an issue.
void	report(Issue issue, lombok.ast.Node scope, Location location, java.lang.String message, java.lang.Object data) Reports an issue applicable to a given AST node.

Methods inherited from class com.android.tools.lint.detector.api.Context

getClient, getConfiguration, getContents, getDriver, getFolderVersion, getFolderVersion, getMainProject, getPhase, getProject, getProperty, getScope, getSdkInfo, isEnabled, log, requestRepeat, setProperty

Methods inherited from class java.lang.Object

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

Field Detail

compilationUnit

public lombok.ast.Node compilationUnit

The parse tree

parser

public IJavaParser parser

The parser which produced the parse tree

Constructor Detail

JavaContext

public JavaContext(@NonNull
           LintDriver driver,
           @NonNull
           Project project,
           @Nullable
           Project main,
           @NonNull
           java.io.File file)

Constructs a JavaContext for running lint on the given file, with the given scope, in the given project reporting errors to the given client.

Parameters:

driver - the driver running through the checks

project - the project to run lint on which contains the given file

main - the main project if this project is a library project, or null if this is not a library project. The main project is the root project of all library projects, not necessarily the directly including project.

file - the file to be analyzed

Method Detail

getLocation

@NonNull
public Location getLocation(@NonNull
                           lombok.ast.Node node)

Returns a location for the given node

Parameters:

node - the AST node to get a location for

Returns:

a location for the given node

report

public void report(@NonNull
          Issue issue,
          @Nullable
          Location location,
          @NonNull
          java.lang.String message,
          @Nullable
          java.lang.Object data)

Description copied from class: Context

Reports an issue. Convenience wrapper around LintClient.report(com.android.tools.lint.detector.api.Context, com.android.tools.lint.detector.api.Issue, com.android.tools.lint.detector.api.Severity, com.android.tools.lint.detector.api.Location, java.lang.String, java.lang.Object)

Overrides:

report in class Context

Parameters:

issue - the issue to report

location - the location of the issue, or null if not known

message - the message for this warning

data - any associated data, or null

report

public void report(@NonNull
          Issue issue,
          @Nullable
          lombok.ast.Node scope,
          @Nullable
          Location location,
          @NonNull
          java.lang.String message,
          @Nullable
          java.lang.Object data)

Reports an issue applicable to a given AST node. The AST node is used as the scope to check for suppress lint annotations.

Parameters:

issue - the issue to report

scope - the AST node scope the error applies to. The lint infrastructure will check whether there are suppress annotations on this node (or its enclosing nodes) and if so suppress the warning without involving the client.

location - the location of the issue, or null if not known

message - the message for this warning

data - any associated data, or null

findSurroundingMethod

@Nullable
public static lombok.ast.Node findSurroundingMethod(lombok.ast.Node scope)

findSurroundingClass

@Nullable
public static lombok.ast.ClassDeclaration findSurroundingClass(lombok.ast.Node scope)