Class PackageNamesLoader

java.lang.Object

org.xml.sax.helpers.DefaultHandler

com.puppycrawl.tools.checkstyle.XmlLoader

com.puppycrawl.tools.checkstyle.PackageNamesLoader

All Implemented Interfaces:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler

public final class PackageNamesLoader
extends XmlLoader

Loads a list of package names from a package name XML file.

Nested Class Summary

Nested classes/interfaces inherited from class XmlLoader

XmlLoader.LoadExternalDtdFeatureProvider

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	CHECKSTYLE_PACKAGES	Name of default checkstyle package names resource file.
private static final String	DTD_PUBLIC_CS_ID	The new public ID for the configuration dtd.
private static final String	DTD_PUBLIC_ID	The public ID for the configuration dtd.
private static final String	DTD_RESOURCE_NAME	The resource for the configuration dtd.
private static final String	PACKAGE_ELEMENT_NAME	Qualified name for element 'package'.
private final Set<String>	packageNames	The fully qualified package names.
private final Deque<String>	packageStack	The temporary stack of package name parts.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	PackageNamesLoader()	Creates a new PackageNamesLoader instance.

Method Summary

Modifier and Type	Method	Description
private static Map<String,String>	createIdToResourceNameMap()	Creates mapping between local resources and dtd ids.
void	endElement(String uri, String localName, String qName)
private String	getPackageName()	Creates a full package name from the package names on the stack.
static Set<String>	getPackageNames(ClassLoader classLoader)	Returns the set of package names, compiled from all checkstyle_packages.xml files found on the given class loaders classpath.
private static void	processFile(URL packageFile, PackageNamesLoader namesLoader)	Reads the file provided and parses it with package names loader.
void	startElement(String uri, String localName, String qName, Attributes attributes)

Methods inherited from class XmlLoader

error, parseInputSource, resolveEntity

Methods inherited from class DefaultHandler

characters, endDocument, endPrefixMapping, fatalError, ignorableWhitespace, notationDecl, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class Object

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

Methods inherited from interface ContentHandler

declaration

Field Details

DTD_PUBLIC_ID

private static final String DTD_PUBLIC_ID

The public ID for the configuration dtd.

See Also:

• Constant Field Values

DTD_PUBLIC_CS_ID

private static final String DTD_PUBLIC_CS_ID

The new public ID for the configuration dtd.

See Also:

• Constant Field Values

DTD_RESOURCE_NAME

private static final String DTD_RESOURCE_NAME

The resource for the configuration dtd.

See Also:

• Constant Field Values

CHECKSTYLE_PACKAGES

private static final String CHECKSTYLE_PACKAGES

Name of default checkstyle package names resource file. The file must be in the classpath.

See Also:

• Constant Field Values

PACKAGE_ELEMENT_NAME

private static final String PACKAGE_ELEMENT_NAME

Qualified name for element 'package'.

See Also:

• Constant Field Values

packageStack

private final Deque<String> packageStack

The temporary stack of package name parts.

packageNames

private final Set<String> packageNames

The fully qualified package names.

Constructor Details

PackageNamesLoader

private PackageNamesLoader()
                    throws ParserConfigurationException,
SAXException

Creates a new PackageNamesLoader instance.

Throws:

ParserConfigurationException - if an error occurs

SAXException - if an error occurs

Method Details

startElement

public void startElement(String uri,
 String localName,
 String qName,
 Attributes attributes)

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class DefaultHandler

getPackageName

private String getPackageName()

Creates a full package name from the package names on the stack.

Returns:

the full name of the current package.

endElement

public void endElement(String uri,
 String localName,
 String qName)

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class DefaultHandler

getPackageNames

public static Set<String> getPackageNames(ClassLoader classLoader)
                                   throws CheckstyleException

Returns the set of package names, compiled from all checkstyle_packages.xml files found on the given class loaders classpath.

Parameters:

classLoader - the class loader for loading the checkstyle_packages.xml files.

Returns:

the set of package names.

Throws:

CheckstyleException - if an error occurs.

processFile

private static void processFile(URL packageFile,
 PackageNamesLoader namesLoader)
                         throws SAXException,
CheckstyleException

Reads the file provided and parses it with package names loader.

Parameters:

packageFile - file from package

namesLoader - package names loader

Throws:

SAXException - if an error while parsing occurs

CheckstyleException - if unable to open file

createIdToResourceNameMap

private static Map<String,String> createIdToResourceNameMap()

Creates mapping between local resources and dtd ids.

Returns:

map between local resources and dtd ids.