org.codehaus.mojo.license.api

Class DefaultThirdPartyHelper

java.lang.Object

org.codehaus.mojo.license.api.DefaultThirdPartyHelper

All Implemented Interfaces:

ThirdPartyHelper

public class DefaultThirdPartyHelper
extends Object
implements ThirdPartyHelper

Default implementation of the ThirdPartyHelper.

Since:

1.1

Author:

tchemit dev@tchemit.fr

Constructor Summary

Constructors

Constructor and Description
DefaultThirdPartyHelper(org.apache.maven.project.MavenProject project, String encoding, boolean verbose, DependenciesTool dependenciesTool, ThirdPartyTool thirdPartyTool, org.apache.maven.artifact.repository.ArtifactRepository localRepository, List<org.apache.maven.artifact.repository.ArtifactRepository> remoteRepositories, org.apache.maven.plugin.logging.Log log) Constructor of the helper.

Method Summary

Modifier and Type	Method and Description
void	attachThirdPartyDescriptor(File file) Attach the third-party descriptor to the build.
LicenseMap	createLicenseMap(SortedMap<String,org.apache.maven.project.MavenProject> dependencies) Creates a license map from given dependencies.
SortedProperties	createUnsafeMapping(LicenseMap licenseMap, File missingFile, String missingFileUrl, boolean useRepositoryMissingFiles, SortedSet<org.apache.maven.project.MavenProject> unsafeDependencies, SortedMap<String,org.apache.maven.project.MavenProject> projectDependencies, Set<org.apache.maven.artifact.Artifact> dependencyArtifacts) Loads unsafe mappings.
SortedMap<String,org.apache.maven.project.MavenProject>	getArtifactCache() Obtains the cache of loaded dependencies indexed by their gav.
SortedSet<org.apache.maven.project.MavenProject>	getProjectsWithNoLicense(LicenseMap licenseMap) Obtains all dependencies with no license form the given license map.
SortedMap<String,org.apache.maven.project.MavenProject>	loadDependencies(MavenProjectDependenciesConfigurator configuration, ResolvedProjectDependencies dependencyArtifacts) Load all dependencies given the configuration as MavenProject.
SortedProperties	loadThirdPartyDescriptorForUnsafeMapping(Set<org.apache.maven.artifact.Artifact> topLevelDependencies, SortedSet<org.apache.maven.project.MavenProject> unsafeDependencies, Collection<org.apache.maven.project.MavenProject> projects, LicenseMap licenseMap) Try to load maximum of unsafe license mapping using third-party descriptors (from maven repositories) and return it.
SortedProperties	loadUnsafeMapping(LicenseMap licenseMap, File missingFile, String missingFileUrl, SortedMap<String,org.apache.maven.project.MavenProject> projectDependencies) Load unsafe mapping for all dependencies with no license in their pom, we will load the missing file if it exists and also add all dependencies from licenseMap with no license known.
void	mergeLicenses(List<String> licenseMerges, LicenseMap licenseMap) Merges licenses.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultThirdPartyHelper

public DefaultThirdPartyHelper(org.apache.maven.project.MavenProject project,
                               String encoding,
                               boolean verbose,
                               DependenciesTool dependenciesTool,
                               ThirdPartyTool thirdPartyTool,
                               org.apache.maven.artifact.repository.ArtifactRepository localRepository,
                               List<org.apache.maven.artifact.repository.ArtifactRepository> remoteRepositories,
                               org.apache.maven.plugin.logging.Log log)

Constructor of the helper.

Parameters:

project - Current maven project

encoding - Encoding used to read and write files

verbose - Verbose flag

dependenciesTool - tool to load dependencies

thirdPartyTool - tool to load third-parties descriptors

localRepository - maven local repository

remoteRepositories - maven remote repositories

log - logger

Method Detail

getArtifactCache

public SortedMap<String,org.apache.maven.project.MavenProject> getArtifactCache()

Obtains the cache of loaded dependencies indexed by their gav.

Specified by:

getArtifactCache in interface ThirdPartyHelper

Returns:

the cache of loaded dependencies indexed by their gav

loadDependencies

public SortedMap<String,org.apache.maven.project.MavenProject> loadDependencies(MavenProjectDependenciesConfigurator configuration,
                                                                                ResolvedProjectDependencies dependencyArtifacts)

Load all dependencies given the configuration as MavenProject.

Specified by:

loadDependencies in interface ThirdPartyHelper

Parameters:

configuration - the configuration of the project and include/exclude to do on its dependencies

dependencyArtifacts - the dependency artifacts of the project

Returns:

the dictionary of loaded dependencies as MavenProject indexed by their gav.

loadThirdPartyDescriptorForUnsafeMapping

public SortedProperties loadThirdPartyDescriptorForUnsafeMapping(Set<org.apache.maven.artifact.Artifact> topLevelDependencies,
                                                                 SortedSet<org.apache.maven.project.MavenProject> unsafeDependencies,
                                                                 Collection<org.apache.maven.project.MavenProject> projects,
                                                                 LicenseMap licenseMap)
                                                          throws ThirdPartyToolException,
                                                                 IOException

Try to load maximum of unsafe license mapping using third-party descriptors (from maven repositories) and return it.

Specified by:

loadThirdPartyDescriptorForUnsafeMapping in interface ThirdPartyHelper

Parameters:

topLevelDependencies - project dependencies to scan for .license.properties files.

unsafeDependencies - all unsafe dependencies

projects - all projects where to read third parties descriptors

licenseMap - license map where to store new licenses

Returns:

the map of loaded missing from the remote missing third party files

Throws:

ThirdPartyToolException - if any

IOException - if any

loadUnsafeMapping

public SortedProperties loadUnsafeMapping(LicenseMap licenseMap,
                                          File missingFile,
                                          String missingFileUrl,
                                          SortedMap<String,org.apache.maven.project.MavenProject> projectDependencies)
                                   throws IOException,
                                          org.apache.maven.plugin.MojoExecutionException

Load unsafe mapping for all dependencies with no license in their pom, we will load the missing file if it exists and also add all dependencies from licenseMap with no license known.

Specified by:

loadUnsafeMapping in interface ThirdPartyHelper

Parameters:

licenseMap - the license map of all dependencies.

missingFile - location of an optional missing fille (says where you fix missing license).

missingFileUrl - location of an optional missing file extension that can be downloaded from some resource hoster and that will be merged with the content of the missing file.

projectDependencies - project dependencies used to detect which dependencies in the missing file are unknown to the project.

Returns:

the map of all unsafe mapping

Throws:

IOException - if could not load missing file

org.apache.maven.plugin.MojoExecutionException

createLicenseMap

public LicenseMap createLicenseMap(SortedMap<String,org.apache.maven.project.MavenProject> dependencies)

Creates a license map from given dependencies.

Specified by:

createLicenseMap in interface ThirdPartyHelper

Parameters:

dependencies - dependencies to store in the license map

Returns:

the created license map fro the given dependencies

attachThirdPartyDescriptor

public void attachThirdPartyDescriptor(File file)

Attach the third-party descriptor to the build.

Specified by:

attachThirdPartyDescriptor in interface ThirdPartyHelper

Parameters:

file - location of the third-party descriptor

getProjectsWithNoLicense

public SortedSet<org.apache.maven.project.MavenProject> getProjectsWithNoLicense(LicenseMap licenseMap)

Obtains all dependencies with no license form the given license map.

Specified by:

getProjectsWithNoLicense in interface ThirdPartyHelper

Parameters:

licenseMap - license map where to find

Returns:

all dependencies with no license

createUnsafeMapping

public SortedProperties createUnsafeMapping(LicenseMap licenseMap,
                                            File missingFile,
                                            String missingFileUrl,
                                            boolean useRepositoryMissingFiles,
                                            SortedSet<org.apache.maven.project.MavenProject> unsafeDependencies,
                                            SortedMap<String,org.apache.maven.project.MavenProject> projectDependencies,
                                            Set<org.apache.maven.artifact.Artifact> dependencyArtifacts)
                                     throws org.apache.maven.project.ProjectBuildingException,
                                            IOException,
                                            ThirdPartyToolException,
                                            org.apache.maven.plugin.MojoExecutionException

Loads unsafe mappings. Unsafe mappings are files that supply license metadata for artifacts that lack it in their POM models. It's called 'unsafe' because its safer to see actual metadata.

There are three sources of this data:

• the 'missing' file.
• additional property files attached to artifacts; these have classifier=third-party and are expected to contain the license information the base artifact's dependencies. These are controlled by a parameter,
• declared dependencies of type license.properties. These are in the same format, and provide global information.

Specified by:

createUnsafeMapping in interface ThirdPartyHelper

Parameters:

licenseMap - license map to read

missingFile - location of an optional missing file

missingFileUrl - location of an optional missing file extension that can be downloaded from some resource hoster and that will be merged with the content of the missing file.

useRepositoryMissingFiles - flag to use or not third-party descriptors via the 'third-party' classifier from maven repositories

unsafeDependencies - all unsafe dependencies

projectDependencies - all project dependencies

dependencyArtifacts - all project dependency artifacts

Returns:

the loaded unsafe mapping

Throws:

org.apache.maven.project.ProjectBuildingException - if could not build some dependencies maven project

IOException - if could not load missing file

ThirdPartyToolException - if pb with third-party tool

org.apache.maven.plugin.MojoExecutionException

mergeLicenses

public void mergeLicenses(List<String> licenseMerges,
                          LicenseMap licenseMap)
                   throws org.apache.maven.plugin.MojoFailureException

Merges licenses.

Specified by:

mergeLicenses in interface ThirdPartyHelper

Parameters:

licenseMerges - list of license mergeables (each entry is a list of licenses separated by |, the first one is the license to use for all the others of the entry).

licenseMap - license map to merge

Throws:

org.apache.maven.plugin.MojoFailureException - if there is a bad license merge definition (says for example two license with same name)