org.apache.maven.plugin.internal
Class DefaultMavenPluginManager

java.lang.Object
  org.apache.maven.plugin.internal.DefaultMavenPluginManager

All Implemented Interfaces:

MavenPluginManager

@Component(role=MavenPluginManager.class)
public class DefaultMavenPluginManager
extends Object
implements MavenPluginManager

Provides basic services to manage Maven plugins and their mojos. This component is kept general in its design such that the plugins/mojos can be used in arbitrary contexts. In particular, the mojos can be used for ordinary build plugins as well as special purpose plugins like reports.

Since:

3.0

Author:

Benjamin Bentmann

DefaultMavenPluginManager

public DefaultMavenPluginManager()

getPluginDescriptor

public PluginDescriptor getPluginDescriptor(Plugin plugin,
                                            List<RemoteRepository> repositories,
                                            RepositorySystemSession session)
                                     throws PluginResolutionException,
                                            PluginDescriptorParsingException,
                                            InvalidPluginDescriptorException

Description copied from interface: MavenPluginManager

Retrieves the descriptor for the specified plugin from its main artifact.

Specified by:

getPluginDescriptor in interface MavenPluginManager

Parameters:

plugin - The plugin whose descriptor should be retrieved, must not be null.

repositories - The plugin repositories to use for resolving the plugin's main artifact, must not be null.

session - The repository session to use for resolving the plugin's main artifact, must not be null.

Returns:

The plugin descriptor, never null.

Throws:

PluginResolutionException

PluginDescriptorParsingException

InvalidPluginDescriptorException

getMojoDescriptor

public MojoDescriptor getMojoDescriptor(Plugin plugin,
                                        String goal,
                                        List<RemoteRepository> repositories,
                                        RepositorySystemSession session)
                                 throws MojoNotFoundException,
                                        PluginResolutionException,
                                        PluginDescriptorParsingException,
                                        InvalidPluginDescriptorException

Description copied from interface: MavenPluginManager

Retrieves the descriptor for the specified plugin goal from the plugin's main artifact.

Specified by:

getMojoDescriptor in interface MavenPluginManager

Parameters:

plugin - The plugin whose mojo descriptor should be retrieved, must not be null.

goal - The simple name of the mojo whose descriptor should be retrieved, must not be null.

repositories - The plugin repositories to use for resolving the plugin's main artifact, must not be null.

session - The repository session to use for resolving the plugin's main artifact, must not be null.

Returns:

The mojo descriptor, never null.

Throws:

MojoNotFoundException

PluginResolutionException

PluginDescriptorParsingException

InvalidPluginDescriptorException

checkRequiredMavenVersion

public void checkRequiredMavenVersion(PluginDescriptor pluginDescriptor)
                               throws PluginIncompatibleException

Description copied from interface: MavenPluginManager

Verifies the specified plugin is compatible with the current Maven runtime.

Specified by:

checkRequiredMavenVersion in interface MavenPluginManager

Parameters:

pluginDescriptor - The descriptor of the plugin to check, must not be null.

Throws:

PluginIncompatibleException

setupPluginRealm

public void setupPluginRealm(PluginDescriptor pluginDescriptor,
                             MavenSession session,
                             ClassLoader parent,
                             List<String> imports,
                             DependencyFilter filter)
                      throws PluginResolutionException,
                             PluginContainerException

Description copied from interface: MavenPluginManager

Sets up the class realm for the specified plugin. Both the class realm and the plugin artifacts that constitute it will be stored in the plugin descriptor.

Specified by:

setupPluginRealm in interface MavenPluginManager

Parameters:

pluginDescriptor - The plugin descriptor in which to save the class realm and the plugin artifacts, must not be null.

session - The build session from which to pick the current project and repository settings, must not be null.

parent - The parent class realm for the plugin, may be null to use the Maven core realm.

imports - The packages/types to import from the parent realm, may be null.

filter - The filter used to exclude certain plugin dependencies, may be null.

Throws:

PluginResolutionException

PluginContainerException

getConfiguredMojo

public <T> T getConfiguredMojo(Class<T> mojoInterface,
                               MavenSession session,
                               MojoExecution mojoExecution)
                    throws PluginConfigurationException,
                           PluginContainerException

Description copied from interface: MavenPluginManager

Looks up the mojo for the specified mojo execution and populates its parameters from the configuration given by the mojo execution. The mojo/plugin descriptor associated with the mojo execution provides the class realm to lookup the mojo from. Warning: The returned mojo instance must be released via MavenPluginManager.releaseMojo(Object, MojoExecution) when the mojo is no longer needed to free any resources allocated for it.

Specified by:

getConfiguredMojo in interface MavenPluginManager

Parameters:

mojoInterface - The component role of the mojo, must not be null.

session - The build session in whose context the mojo will be used, must not be null.

mojoExecution - The mojo execution to retrieve the mojo for, must not be null.

Returns:

The ready-to-execute mojo, never null.

Throws:

PluginConfigurationException

PluginContainerException

releaseMojo

public void releaseMojo(Object mojo,
                        MojoExecution mojoExecution)

Description copied from interface: MavenPluginManager

Releases the specified mojo back to the container.

Specified by:

releaseMojo in interface MavenPluginManager

Parameters:

mojo - The mojo to release, may be null.

mojoExecution - The mojo execution the mojo was originally retrieved for, must not be null.