org.checkerframework.checker.nullness

Class AbstractNullnessChecker

java.lang.Object

javax.annotation.processing.AbstractProcessor

org.checkerframework.javacutil.AbstractTypeProcessor

org.checkerframework.framework.source.SourceChecker

org.checkerframework.common.basetype.BaseTypeChecker

org.checkerframework.checker.initialization.InitializationChecker

org.checkerframework.checker.nullness.AbstractNullnessChecker

All Implemented Interfaces:

Processor, BaseTypeContext, BaseContext, CFContext, OptionConfiguration, ErrorHandler

Direct Known Subclasses:

NullnessChecker, NullnessRawnessChecker

@SupportedLintOptions(value={"noInitForMonotonicNonNull","redundantNullComparison","forbidnonnullarraycomponents"})
public abstract class AbstractNullnessChecker
extends InitializationChecker

An implementation of the nullness type-system, parameterized by an initialization type-system for safe initialization. It can use freedom-before-commitment or rawness as its initialization type system.

Nested Class Summary

Nested classes/interfaces inherited from class org.checkerframework.framework.source.SourceChecker

SourceChecker.CheckerError

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	LINT_DEFAULT_NOINITFORMONOTONICNONNULL Default for LINT_NOINITFORMONOTONICNONNULL.
static boolean	LINT_DEFAULT_REDUNDANTNULLCOMPARISON Default for LINT_REDUNDANTNULLCOMPARISON.
static String	LINT_NOINITFORMONOTONICNONNULL Should we be strict about initialization of MonotonicNonNull variables.
static String	LINT_REDUNDANTNULLCOMPARISON Warn about redundant comparisons of expressions with null, if the expressions is known to be non-null.

Fields inherited from class org.checkerframework.checker.initialization.InitializationChecker

useFbc

Fields inherited from class org.checkerframework.framework.source.SourceChecker

currentRoot, DETAILS_SEPARATOR, errsOnLastExit, messager, messages, MSGS_FILE, parentChecker, SUPPRESS_ALL_KEY, trees, upstreamCheckerNames, visitor

Fields inherited from class javax.annotation.processing.AbstractProcessor

processingEnv

Constructor Summary

Constructors

Constructor and Description
AbstractNullnessChecker(boolean useFbc)

Method Summary

Modifier and Type	Method and Description
protected BaseTypeVisitor<?>	createSourceVisitor() Returns the appropriate visitor that type-checks the compilation unit according to the type system rules.
protected LinkedHashSet<Class<? extends BaseTypeChecker>>	getImmediateSubcheckerClasses() Returns the set of subchecker classes this checker depends on.
Collection<String>	getSuppressWarningsKeys()

Methods inherited from class org.checkerframework.checker.initialization.InitializationChecker

getAllFields

Methods inherited from class org.checkerframework.common.basetype.BaseTypeChecker

getAnnotationProvider, getChecker, getContext, getOptions, getSubchecker, getSupportedLintOptions, getSupportedOptions, getTypeFactory, getTypeFactoryOfSubchecker, getVisitor, initChecker, invokeConstructorFor, processArg, shouldResolveReflection, typeProcess, typeProcessingOver

Methods inherited from class org.checkerframework.framework.source.SourceChecker

addOptions, createSupportedLintOptions, errorAbort, errorAbort, expandCFOptions, formatStackTrace, fullMessageOf, getElementUtils, getLintOption, getLintOption, getMessages, getOption, getOption, getOptionConfiguration, getProcessingEnvironment, getProperties, getStandardSuppressWarningsKeys, getSupportedAnnotationTypes, getSupportedSourceVersion, getTreeUtils, getTypeUtils, getUpstreamCheckerNames, hasOption, init, message, message, printStats, report, setLintOption, setParentChecker, setProcessingEnvironment, setSupportedLintOptions, shouldAddShutdownHook, shouldSkipDefs, shouldSkipDefs, shouldSkipUses, shouldSkipUses, shouldSuppressWarnings, shutdownHook, treeToFilePositionString, typeProcessingStart, userErrorAbort, useUncheckedCodeDefault

Methods inherited from class org.checkerframework.javacutil.AbstractTypeProcessor

process

Methods inherited from class javax.annotation.processing.AbstractProcessor

getCompletions, isInitialized

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.checkerframework.framework.util.BaseContext

getElementUtils, getOptionConfiguration, getProcessingEnvironment, getTreeUtils, getTypeUtils

Field Detail

LINT_NOINITFORMONOTONICNONNULL

public static final String LINT_NOINITFORMONOTONICNONNULL

Should we be strict about initialization of MonotonicNonNull variables.

See Also:

Constant Field Values

LINT_DEFAULT_NOINITFORMONOTONICNONNULL

public static final boolean LINT_DEFAULT_NOINITFORMONOTONICNONNULL

Default for LINT_NOINITFORMONOTONICNONNULL.

See Also:

Constant Field Values

LINT_REDUNDANTNULLCOMPARISON

public static final String LINT_REDUNDANTNULLCOMPARISON

Warn about redundant comparisons of expressions with null, if the expressions is known to be non-null.

See Also:

Constant Field Values

LINT_DEFAULT_REDUNDANTNULLCOMPARISON

public static final boolean LINT_DEFAULT_REDUNDANTNULLCOMPARISON

Default for LINT_REDUNDANTNULLCOMPARISON.

See Also:

Constant Field Values

Constructor Detail

AbstractNullnessChecker

public AbstractNullnessChecker(boolean useFbc)

Method Detail

getImmediateSubcheckerClasses

protected LinkedHashSet<Class<? extends BaseTypeChecker>> getImmediateSubcheckerClasses()

Description copied from class: BaseTypeChecker

Returns the set of subchecker classes this checker depends on. Returns an empty set if this checker does not depend on any others. Subclasses need to override this method if they have dependencies. Each subclass of BaseTypeChecker must declare all dependencies it relies on if there are any. Each subchecker of this checker is in turn free to change its own dependencies. It's OK for various checkers to declare a dependency on the same subchecker, since the BaseTypeChecker will ensure that each subchecker is instantiated only once. WARNING: Circular dependencies are not supported. We do not check for their absence. Make sure no circular dependencies are created when overriding this method. This method is protected so it can be overridden, but it is only intended to be called internally by the BaseTypeChecker. Please override this method but do not call it from classes other than BaseTypeChecker. Subclasses that override this method should call super and added dependencies so that checkers required for reflection resolution are included if reflection resolution is requested. The BaseTypeChecker will not modify the list returned by this method.

Overrides:

getImmediateSubcheckerClasses in class BaseTypeChecker

getSuppressWarningsKeys

public Collection<String> getSuppressWarningsKeys()

Overrides:

getSuppressWarningsKeys in class InitializationChecker

Returns:

String keys that a checker honors for suppressing warnings and errors that it issues. Each such key suppresses all warnings issued by the checker.

See Also:

SuppressWarningsKeys

createSourceVisitor

protected BaseTypeVisitor<?> createSourceVisitor()

Description copied from class: BaseTypeChecker

Returns the appropriate visitor that type-checks the compilation unit according to the type system rules.

This implementation uses the checker naming convention to create the appropriate visitor. If no visitor is found, it returns an instance of BaseTypeVisitor. It reflectively invokes the constructor that accepts this checker and the compilation unit tree (in that order) as arguments.

Subclasses have to override this method to create the appropriate visitor if they do not follow the checker naming convention.

Overrides:

createSourceVisitor in class BaseTypeChecker

Returns:

the type-checking visitor