Class JavadocPackageCheck

java.lang.Object

com.puppycrawl.tools.checkstyle.AbstractAutomaticBean

com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter

com.puppycrawl.tools.checkstyle.api.AbstractFileSetCheck

com.puppycrawl.tools.checkstyle.checks.javadoc.JavadocPackageCheck

All Implemented Interfaces:

Configurable, Contextualizable, FileSetCheck

public class JavadocPackageCheck
extends AbstractFileSetCheck

Checks that each Java package has a Javadoc file used for commenting. By default, it only allows a package-info.java file, but can be configured to allow a package.html file.

A violation will be reported if both files exist as this is not allowed by the Javadoc tool.

Since:

5.0

Nested Class Summary

Nested classes/interfaces inherited from class AbstractAutomaticBean

AbstractAutomaticBean.OutputStreamOptions

Field Summary

Fields

Modifier and Type	Field	Description
private boolean	allowLegacy	Allow legacy package.html file to be used.
private final Set<File>	directoriesChecked	The directories checked.
static final String	MSG_LEGACY_PACKAGE_HTML	A key is pointing to the warning message text in "messages.properties" file.
static final String	MSG_PACKAGE_INFO	A key is pointing to the warning message text in "messages.properties" file.

Constructor Summary

Constructors

Constructor	Description
JavadocPackageCheck()	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
protected void	processFiltered(File file, FileText fileText)	Called to process a file that matches the specified file extensions.
void	setAllowLegacy(boolean allowLegacy)	Setter to allow legacy package.html file to be used.
final void	setFileExtensions(String... extensions)	Setter to specify the file extensions of the files to process.

Methods inherited from class AbstractFileSetCheck

addViolations, beginProcessing, destroy, finishProcessing, fireErrors, getFileContents, getFileExtensions, getMessageDispatcher, getTabWidth, getViolations, init, log, log, process, setFileContents, setMessageDispatcher, setTabWidth

Methods inherited from class AbstractViolationReporter

finishLocalSetup, getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, setId, setSeverity

Methods inherited from class AbstractAutomaticBean

configure, contextualize, getConfiguration, setupChild

Methods inherited from class Object

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

Methods inherited from interface Configurable

configure

Methods inherited from interface Contextualizable

contextualize

Field Details

MSG_LEGACY_PACKAGE_HTML

public static final String MSG_LEGACY_PACKAGE_HTML

A key is pointing to the warning message text in "messages.properties" file.

See Also:

• Constant Field Values

MSG_PACKAGE_INFO

public static final String MSG_PACKAGE_INFO

A key is pointing to the warning message text in "messages.properties" file.

See Also:

• Constant Field Values

directoriesChecked

private final Set<File> directoriesChecked

The directories checked.

allowLegacy

private boolean allowLegacy

Allow legacy package.html file to be used.

Constructor Details

JavadocPackageCheck

public JavadocPackageCheck()

Creates a new instance.

Method Details

setFileExtensions

public final void setFileExtensions(String... extensions)

Setter to specify the file extensions of the files to process.

Overrides:

setFileExtensions in class AbstractFileSetCheck

Parameters:

extensions - the set of file extensions. A missing initial '.' character of an extension is automatically added.

Throws:

IllegalArgumentException - is argument is null

processFiltered

protected void processFiltered(File file,
 FileText fileText)
                        throws CheckstyleException

Description copied from class: AbstractFileSetCheck

Called to process a file that matches the specified file extensions.

Specified by:

processFiltered in class AbstractFileSetCheck

Parameters:

file - the file to be processed

fileText - the contents of the file.

Throws:

CheckstyleException - if error condition within Checkstyle occurs.

setAllowLegacy

public void setAllowLegacy(boolean allowLegacy)

Setter to allow legacy package.html file to be used.

Parameters:

allowLegacy - whether to allow support.

Since:

5.0