Class Description

java.lang.Object

com.google.errorprone.matchers.Description

public class Description
extends Object

Simple data object containing the information captured about an AST match. Can be printed in a UI, or output in structured format for use by tools.

Author:

alexeagle@google.com (Alex Eagle)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Description.Builder	Builder for Descriptions.

Field Summary

Fields

Modifier and Type	Field	Description
final String	checkName	The name of the check that produced the match.
final com.google.common.collect.ImmutableList<Fix>	fixes	A list of fixes to suggest in an error message or use in automated refactoring.
static final Description	NO_MATCH	Describes the sentinel value of the case where the match failed.
final com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition	position	The position of the match.

Method Summary

Modifier and Type	Method	Description
Description	applySeverityOverride(BugPattern.SeverityLevel severity)	Internal-only.
static Description.Builder	builder(com.sun.source.tree.Tree node, String name, @Nullable String link, String message)	Returns a new builder for Descriptions.
static Description.Builder	builder(com.sun.tools.javac.tree.JCTree tree, String name, @Nullable String link, String message)	Returns a new builder for Descriptions.
static Description.Builder	builder(com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition position, String name, @Nullable String link, String message)	Returns a new builder for Descriptions.
@Nullable String	getLink()	Returns a link associated with this finding or null if there is no link.
String	getMessage()	Returns the message to be printed by the compiler when a match is found in interactive use.
String	getMessageWithoutCheckName()	Returns the message, not including the check name but including the link.
String	getRawMessage()	Returns the raw message, not including a link or check name.
BugPattern.SeverityLevel	severity()

Methods inherited from class java.lang.Object

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

Field Details

NO_MATCH

public static final Description NO_MATCH

Describes the sentinel value of the case where the match failed.

position

public final com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition position

The position of the match.

checkName

public final String checkName

The name of the check that produced the match.

fixes

public final com.google.common.collect.ImmutableList<Fix> fixes

A list of fixes to suggest in an error message or use in automated refactoring. Fixes are in order of decreasing preference, from most preferred to least preferred.

Method Details

severity

public BugPattern.SeverityLevel severity()

getMessage

public String getMessage()

Returns the message to be printed by the compiler when a match is found in interactive use. Includes the name of the check and a link for more information.

getLink

public @Nullable String getLink()

Returns a link associated with this finding or null if there is no link.

getRawMessage

public String getRawMessage()

Returns the raw message, not including a link or check name.

getMessageWithoutCheckName

public String getMessageWithoutCheckName()

Returns the message, not including the check name but including the link.

applySeverityOverride

@CheckReturnValue
public Description applySeverityOverride(BugPattern.SeverityLevel severity)

Internal-only.

builder

public static Description.Builder builder(com.sun.source.tree.Tree node,
 String name,
 @Nullable String link,
 String message)

Returns a new builder for Descriptions.

builder

public static Description.Builder builder(com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition position,
 String name,
 @Nullable String link,
 String message)

Returns a new builder for Descriptions.

builder

public static Description.Builder builder(com.sun.tools.javac.tree.JCTree tree,
 String name,
 @Nullable String link,
 String message)

Returns a new builder for Descriptions.