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 inherited from class com.android.tools.lint.detector.api.Context

file, mDriver

Constructor Summary

JavaContext(LintDriver driver, Project project, Project main, java.io.File file, JavaParser parser)
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

Location.Handle	createLocationHandle(lombok.ast.Node node)
static lombok.ast.ClassDeclaration	findSurroundingClass(lombok.ast.Node scope)
static lombok.ast.Node	findSurroundingMethod(lombok.ast.Node scope)
lombok.ast.Node	getCompilationUnit()
Location	getLocation(lombok.ast.Node node) Returns a location for the given node
JavaParser	getParser()
protected java.lang.String	getSuppressCommentPrefix() Returns the comment marker used in Studio to suppress statements for language, if any
JavaParser.TypeDescriptor	getType(lombok.ast.Node node)
boolean	isContextMethod(lombok.ast.MethodInvocation node) Returns true if the given method invocation node corresponds to a call on a android.content.Context
boolean	isSuppressedWithComment(lombok.ast.Node scope, Issue issue)
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.
JavaParser.ResolvedNode	resolve(lombok.ast.Node node)
void	setCompilationUnit(lombok.ast.Node compilationUnit) Sets the compilation result.

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

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

Methods inherited from class java.lang.Object

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

Constructor Detail

JavaContext

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

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

parser - the parser to use

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

getParser

@NonNull
public JavaParser getParser()

getCompilationUnit

@Nullable
public lombok.ast.Node getCompilationUnit()

setCompilationUnit

public void setCompilationUnit(@Nullable
                               lombok.ast.Node compilationUnit)

Sets the compilation result. Not intended for client usage; the lint infrastructure will set this when a context has been processed

Parameters:

compilationUnit - the parse tree

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(@Nullable
                                                                        lombok.ast.Node scope)

getSuppressCommentPrefix

@Nullable
protected java.lang.String getSuppressCommentPrefix()

Description copied from class: Context

Returns the comment marker used in Studio to suppress statements for language, if any

Overrides:

getSuppressCommentPrefix in class Context

isSuppressedWithComment

public boolean isSuppressedWithComment(@NonNull
                                       lombok.ast.Node scope,
                                       @NonNull
                                       Issue issue)

createLocationHandle

@NonNull
public Location.Handle createLocationHandle(@NonNull
                                                    lombok.ast.Node node)

resolve

@Nullable
public JavaParser.ResolvedNode resolve(@NonNull
                                                lombok.ast.Node node)

getType

@Nullable
public JavaParser.TypeDescriptor getType(@NonNull
                                                  lombok.ast.Node node)

isContextMethod

public boolean isContextMethod(@NonNull
                               lombok.ast.MethodInvocation node)

Returns true if the given method invocation node corresponds to a call on a android.content.Context

Parameters:

node - the method call node

Returns:

true iff the method call is on a class extending context