Package net.sourceforge.pmd.cache

Class NoopAnalysisCache

java.lang.Object

net.sourceforge.pmd.cache.NoopAnalysisCache

All Implemented Interfaces:

AnalysisCache

@Deprecated
@InternalApi
public class NoopAnalysisCache
extends Object
implements AnalysisCache

Deprecated.

This is internal API, will be hidden with 7.0.0

A NOOP analysis cache. Easier / safer than null-checking.

Constructor Summary

Constructors

Constructor	Description
NoopAnalysisCache()	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	analysisFailed(TextDocument sourceFile)	Deprecated. Notifies the cache that analysis of the given file has failed and should not be cached.
void	checkValidity(RuleSets ruleSets, ClassLoader auxclassPathClassLoader, Collection<? extends TextFile> files)	Deprecated. Checks if the cache is valid for the configured rulesets and class loader.
List<RuleViolation>	getCachedViolations(TextDocument sourceFile)	Deprecated. Retrieves cached violations for the given file.
boolean	isUpToDate(TextDocument document)	Deprecated. Checks if a given file is up to date in the cache and can be skipped from analysis.
void	persist()	Deprecated. Persists the updated analysis results on whatever medium is used by the cache.
FileAnalysisListener	startFileAnalysis(TextDocument filename)	Deprecated. Returns a listener that will be used like in GlobalAnalysisListener.startFileAnalysis(TextFile).

Methods inherited from class java.lang.Object

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

Constructor Detail

NoopAnalysisCache

public NoopAnalysisCache()

Deprecated.

Method Detail

persist

public void persist()

Deprecated.

Description copied from interface: AnalysisCache

Persists the updated analysis results on whatever medium is used by the cache.

Specified by:

persist in interface AnalysisCache

isUpToDate

public boolean isUpToDate(TextDocument document)

Deprecated.

Description copied from interface: AnalysisCache

Checks if a given file is up to date in the cache and can be skipped from analysis. Regardless of the return value of this method, each call adds the parameter to the updated cache, which allows FileAnalysisListener.onRuleViolation(RuleViolation) to add a rule violation to the file. TODO is this really best behaviour? This side-effects seems counter-intuitive.

Specified by:

isUpToDate in interface AnalysisCache

Parameters:

document - The file to check in the cache

Returns:

True if the cache is a hit, false otherwise

analysisFailed

public void analysisFailed(TextDocument sourceFile)

Deprecated.

Description copied from interface: AnalysisCache

Notifies the cache that analysis of the given file has failed and should not be cached.

Specified by:

analysisFailed in interface AnalysisCache

Parameters:

sourceFile - The file whose analysis failed

checkValidity

public void checkValidity(RuleSets ruleSets,
                          ClassLoader auxclassPathClassLoader,
                          Collection<? extends TextFile> files)

Deprecated.

Description copied from interface: AnalysisCache

Checks if the cache is valid for the configured rulesets and class loader. If the provided rulesets and classpath don't match those of the cache, the cache is invalidated. This needs to be called before analysis, as it conditions the good behaviour of AnalysisCache.isUpToDate(TextDocument).

Specified by:

checkValidity in interface AnalysisCache

Parameters:

ruleSets - The rulesets configured for this analysis.

auxclassPathClassLoader - The class loader for auxclasspath configured for this analysis.

files - Set of files in the current analysis. File records in the cache are matched to the file IDs of these files.

getCachedViolations

public List<RuleViolation> getCachedViolations(TextDocument sourceFile)

Deprecated.

Description copied from interface: AnalysisCache

Retrieves cached violations for the given file. Make sure to call AnalysisCache.isUpToDate(TextDocument) first.

Specified by:

getCachedViolations in interface AnalysisCache

Parameters:

sourceFile - The file to check in the cache

Returns:

The list of cached violations.

startFileAnalysis

public FileAnalysisListener startFileAnalysis(TextDocument filename)

Deprecated.

Description copied from interface: AnalysisCache

Returns a listener that will be used like in GlobalAnalysisListener.startFileAnalysis(TextFile). This should record violations, and call AnalysisCache.analysisFailed(TextDocument) upon error.

Specified by:

startFileAnalysis in interface AnalysisCache