Package org.codehaus.mojo.xml

Class CheckFormatMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.codehaus.mojo.xml.AbstractXmlMojo

org.codehaus.mojo.xml.CheckFormatMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

@Mojo(defaultPhase=VALIDATE,
      name="check-format",
      threadSafe=true)
public class CheckFormatMojo
extends AbstractXmlMojo

An XML indentation check over a set of files.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	CheckFormatMojo.ViolationCollector

Nested classes/interfaces inherited from class org.codehaus.mojo.xml.AbstractXmlMojo

AbstractXmlMojo.CatalogHandling

Field Summary

Fields

Modifier and Type	Field	Description
private String	encoding	The encoding of files included in formatFileSets.
private boolean	failOnFormatViolation	Tells the mojo what to do in case XML formatting violations are found.
private List<FormatFileSet>	formatFileSets	File patterns to include.
private int	indentSize	The number of spaces expected for indentation.
private SAXParserFactory	saxParserFactory	A SAXParserFactory
private boolean	useDefaultFormatFileSet	If set to true, the result of invalid reference FormatFileSet#getDefault(String, int) will be appended to formatFileSets before the processing.

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor	Description
CheckFormatMojo()	Creates a new CheckFormatMojo instance.

Method Summary

Modifier and Type	Method	Description
private void	check(File file, String encoding, XmlFormatViolationHandler violationHandler)	Checks the formatting of the given file.
void	execute()	Called by Maven for executing the Mojo.
private String[]	scan(org.apache.maven.model.FileSet fileSet)	A DirectoryScanner boiler plate.
void	setIndentSize(int indentSize)	Sets the number of spaces for indentation.

Methods inherited from class org.codehaus.mojo.xml.AbstractXmlMojo

activateProxy, asAbsoluteFile, asFiles, checkCatalogHandling, getBasedir, getCatalogHandling, getExcludes, getFileNames, getFiles, getLocator, getProject, getResolver, getResource, isSkipping, passivateProxy, setCatalogs

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

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

Field Details

encoding

@Parameter(property="xml.encoding",
           defaultValue="${project.build.sourceEncoding}")
private String encoding

The encoding of files included in formatFileSets. Note that the encoding can be set also per FormatFileSet.

failOnFormatViolation

@Parameter(property="xml.failOnFormatViolation",
           defaultValue="true")
private boolean failOnFormatViolation

Tells the mojo what to do in case XML formatting violations are found. if true, all violations will be reported on the console as ERRORs and the build will fail. if false, all violations will be reported on the console as WARNs and the build will proceed further.

formatFileSets

@Parameter
private List<FormatFileSet> formatFileSets

File patterns to include. The patterns are relative to the current project's baseDir.

indentSize

@Parameter(property="xml.indentSize",
           defaultValue="2")
private int indentSize

The number of spaces expected for indentation. Note that indentSize can be configuread also per FormatFileSet.

saxParserFactory

private SAXParserFactory saxParserFactory

A SAXParserFactory

useDefaultFormatFileSet

@Parameter(property="xml.useDefaultFormatFileSet",
           defaultValue="true")
private boolean useDefaultFormatFileSet

If set to true, the result of

invalid reference

FormatFileSet#getDefault(String, int)

will be appended to formatFileSets before the processing.

Constructor Details

CheckFormatMojo

public CheckFormatMojo()

Creates a new CheckFormatMojo instance.

Method Details

check

private void check(File file,
 String encoding,
 XmlFormatViolationHandler violationHandler)
            throws org.apache.maven.plugin.MojoExecutionException

Checks the formatting of the given file. The file is read using the given encoding and the violations are reported to the given violationHandler.

Parameters:

file - the file to check

encoding - the encoding to use for reading the file

violationHandler - the XmlFormatViolationHandler to report violations

Throws:

org.apache.maven.plugin.MojoExecutionException - if there is any lover level exception reading or parsing the file.

execute

public void execute()
             throws org.apache.maven.plugin.MojoExecutionException,
org.apache.maven.plugin.MojoFailureException

Called by Maven for executing the Mojo.

Throws:

org.apache.maven.plugin.MojoExecutionException - Running the Mojo failed.

org.apache.maven.plugin.MojoFailureException - A configuration error was detected.

scan

private String[] scan(org.apache.maven.model.FileSet fileSet)

A DirectoryScanner boiler plate.

Parameters:

fileSet - FileSet to scan

Returns:

the included paths

setIndentSize

public void setIndentSize(int indentSize)

Sets the number of spaces for indentation.

Parameters:

indentSize - the number of spaces