Package org.apache.maven.plugins.dependency.analyze

Class AnalyzeDepMgt

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.apache.maven.plugins.dependency.analyze.AnalyzeDepMgt

@Mojo(name="analyze-dep-mgt",
      requiresDependencyResolution=TEST,
      threadSafe=true)
public class AnalyzeDepMgt
extends org.apache.maven.plugin.AbstractMojo

This mojo looks at the dependencies after final resolution and looks for mismatches in your dependencyManagement section. In versions of maven prior to 2.0.6, it was possible to inherit versions that didn't match your dependencyManagement. See MNG-1577 for more info. This mojo is also useful for just detecting projects that override the dependencyManagement directly. Set ignoreDirect to false to detect these otherwise normal conditions.

Since:

2.0-alpha-3

Author:

Brian Fox

Field Summary

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

ROLE

Constructor Summary

Constructors

Constructor	Description
AnalyzeDepMgt()

Method Summary

Modifier and Type	Method	Description
Map<String,org.apache.maven.model.Exclusion>	addExclusions(List<org.apache.maven.model.Exclusion> exclusionList)	Returns a map of the exclusions using the Dependency ManagementKey as the keyset.
void	execute()
String	getArtifactManagementKey(org.apache.maven.artifact.Artifact artifact)	This function returns a string comparable with Dependency.GetManagementKey.
List<org.apache.maven.artifact.Artifact>	getExclusionErrors(Map<String,org.apache.maven.model.Exclusion> exclusions, Set<org.apache.maven.artifact.Artifact> allDependencyArtifacts)	Returns a List of the artifacts that should have been excluded, but were found in the dependency tree.
String	getExclusionKey(org.apache.maven.artifact.Artifact artifact)
String	getExclusionKey(org.apache.maven.model.Exclusion ex)
Map<org.apache.maven.artifact.Artifact,org.apache.maven.model.Dependency>	getMismatch(Map<String,org.apache.maven.model.Dependency> depMgtMap, Set<org.apache.maven.artifact.Artifact> allDependencyArtifacts)	Calculate the mismatches between the DependencyManagement and resolved artifacts
protected org.apache.maven.project.MavenProject	getProject()
protected boolean	isFailBuild()
protected boolean	isIgnoreDirect()
void	logMismatch(org.apache.maven.artifact.Artifact dependencyArtifact, org.apache.maven.model.Dependency dependencyFromDepMgt)	This function displays the log to the screen showing the versions and information about the artifacts that don't match.
void	setFailBuild(boolean theFailBuild)
void	setIgnoreDirect(boolean theIgnoreDirect)
void	setProject(org.apache.maven.project.MavenProject theProject)

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

Constructor Detail

AnalyzeDepMgt

public AnalyzeDepMgt()

Method Detail

execute

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

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

addExclusions

public Map<String,org.apache.maven.model.Exclusion> addExclusions(List<org.apache.maven.model.Exclusion> exclusionList)

Returns a map of the exclusions using the Dependency ManagementKey as the keyset.

Parameters:

exclusionList - to be added to the map.

Returns:

a map of the exclusions using the Dependency ManagementKey as the keyset.

getExclusionErrors

public List<org.apache.maven.artifact.Artifact> getExclusionErrors(Map<String,org.apache.maven.model.Exclusion> exclusions,
                                                                   Set<org.apache.maven.artifact.Artifact> allDependencyArtifacts)

Returns a List of the artifacts that should have been excluded, but were found in the dependency tree.

Parameters:

exclusions - a map of the DependencyManagement exclusions, with the ManagementKey as the key and Dependency as the value.

allDependencyArtifacts - resolved artifacts to be compared.

Returns:

list of artifacts that should have been excluded.

getExclusionKey

public String getExclusionKey(org.apache.maven.artifact.Artifact artifact)

Parameters:

artifact - Artifact

Returns:

The resulting GA.

getExclusionKey

public String getExclusionKey(org.apache.maven.model.Exclusion ex)

Parameters:

ex - The exclusion key.

Returns:

The resulting combination of groupId+artifactId.

getMismatch

public Map<org.apache.maven.artifact.Artifact,org.apache.maven.model.Dependency> getMismatch(Map<String,org.apache.maven.model.Dependency> depMgtMap,
                                                                                             Set<org.apache.maven.artifact.Artifact> allDependencyArtifacts)

Calculate the mismatches between the DependencyManagement and resolved artifacts

Parameters:

depMgtMap - contains the Dependency.GetManagementKey as the keyset for quick lookup.

allDependencyArtifacts - contains the set of all artifacts to compare.

Returns:

a map containing the resolved artifact as the key and the listed dependency as the value.

logMismatch

public void logMismatch(org.apache.maven.artifact.Artifact dependencyArtifact,
                        org.apache.maven.model.Dependency dependencyFromDepMgt)
                 throws org.apache.maven.plugin.MojoExecutionException

This function displays the log to the screen showing the versions and information about the artifacts that don't match.

Parameters:

dependencyArtifact - the artifact that was resolved.

dependencyFromDepMgt - the dependency listed in the DependencyManagement section.

Throws:

org.apache.maven.plugin.MojoExecutionException - in case of errors.

getArtifactManagementKey

public String getArtifactManagementKey(org.apache.maven.artifact.Artifact artifact)

This function returns a string comparable with Dependency.GetManagementKey.

Parameters:

artifact - to gen the key for

Returns:

a string in the form: groupId:ArtifactId:Type[:Classifier]

isFailBuild

protected final boolean isFailBuild()

Returns:

the failBuild

setFailBuild

public void setFailBuild(boolean theFailBuild)

Parameters:

theFailBuild - the failBuild to set

getProject

protected final org.apache.maven.project.MavenProject getProject()

Returns:

the project

setProject

public void setProject(org.apache.maven.project.MavenProject theProject)

Parameters:

theProject - the project to set

isIgnoreDirect

protected final boolean isIgnoreDirect()

Returns:

the ignoreDirect

setIgnoreDirect

public void setIgnoreDirect(boolean theIgnoreDirect)

Parameters:

theIgnoreDirect - the ignoreDirect to set