org.mule.tools.tooling.maven

Class StudioAbstractIdeSupportMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.mule.tools.tooling.maven.StudioAbstractIdeSupportMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo, org.codehaus.plexus.logging.LogEnabled

Direct Known Subclasses:

StudioEclipsePlugin

public abstract class StudioAbstractIdeSupportMojo
extends org.apache.maven.plugin.AbstractMojo
implements org.codehaus.plexus.logging.LogEnabled

Abstract base plugin which takes care of the common stuff usually needed by maven IDE plugins. A plugin extending AbstractIdeSupportMojo should implement the setup() and writeConfiguration() methods, plus the getters needed to get the various configuration flags and required components. The lifecycle:

       *** calls setup() where you can configure your specific stuff and stop the mojo from execute if appropriate ***
       - manually resolve project dependencies, NOT failing if a dependency is missing
       - compute project references (reactor projects) if the getUseProjectReferences() flag is set
       - download sources/javadocs if the getDownloadSources() flag is set
       *** calls writeConfiguration(), passing the list of resolved referenced dependencies ***
       - report the list of missing sources or just tell how to turn this feature on if the flag was disabled
 

Version:

$Id: AbstractIdeSupportMojo.java 628794 2008-02-18 16:09:11Z aheritier $

Author:

Fabrizio Giustina

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.maven.artifact.resolver.ArtifactCollector	artifactCollector Artifact collector, needed to resolve dependencies.
protected org.apache.maven.artifact.factory.ArtifactFactory	artifactFactory Artifact factory, needed to download source jars for inclusion in classpath.
protected org.apache.maven.artifact.metadata.ArtifactMetadataSource	artifactMetadataSource
protected org.apache.maven.artifact.resolver.ArtifactResolver	artifactResolver Artifact resolver, needed to download source jars for inclusion in classpath.
protected boolean	downloadJavadocs Enables/disables the downloading of javadoc attachments.
protected boolean	downloadSources Enables/disables the downloading of source attachments.
protected org.apache.maven.project.MavenProject	executedProject The currently executed project (can be a reactor project).
protected org.apache.maven.artifact.repository.ArtifactRepository	localRepository Local maven repository.
protected org.codehaus.plexus.logging.Logger	logger Plexus logger needed for debugging manual artifact resolution.
protected String	packaging The project packaging.
protected org.apache.maven.project.MavenProject	project The project whose project files to create.
protected List	reactorProjects If the executed project is a reactor project, this will contains the full list of projects in the reactor.
protected List	remoteArtifactRepositories Remote repositories which will be searched for source attachments.

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

ROLE

Constructor Summary

Constructors

Constructor and Description
StudioAbstractIdeSupportMojo()

Method Summary

Methods

Modifier and Type	Method and Description
protected org.apache.maven.plugin.ide.IdeDependency[]	doDependencyResolution() Resolve project dependencies.
void	enableLogging(org.codehaus.plexus.logging.Logger logger)
void	execute()
org.apache.maven.artifact.factory.ArtifactFactory	getArtifactFactory() Getter for artifactFactory.
org.apache.maven.artifact.metadata.ArtifactMetadataSource	getArtifactMetadataSource() Getter for artifactMetadataSource.
org.apache.maven.artifact.resolver.ArtifactResolver	getArtifactResolver() Getter for artifactResolver.
abstract MuleDistributionDataProvider	getDistributionDataProvider()
boolean	getDownloadJavadocs() Getter for downloadJavadocs.
boolean	getDownloadSources() Getter for downloadSources.
abstract List	getExcludes()
org.apache.maven.project.MavenProject	getExecutedProject() Getter for executedProject.
org.apache.maven.artifact.repository.ArtifactRepository	getLocalRepository() Getter for localRepository.
org.apache.maven.project.MavenProject	getProject() Getter for project.
protected Set	getProjectArtifacts() Returns the list of project artifacts.
abstract String	getProjectNameForArifact(org.apache.maven.artifact.Artifact artifact) Find the name of the project as used in eclipse.
List	getReactorProjects() Getter for reactorProjects.
List	getRemoteArtifactRepositories() Getter for remoteArtifactRepositories.
protected abstract boolean	getUseProjectReferences() return false if projects available in a reactor build should be considered normal dependencies, true if referenced project will be linked and not need artifact resolution.
protected org.apache.maven.plugin.ide.IdeDependency[]	getWorkspaceArtefacts()
protected boolean	hasToResolveJar(org.apache.maven.artifact.Artifact art) Checks if jar has to be resolved for the given artifact
protected boolean	isAvailableAsAReactorProject(org.apache.maven.artifact.Artifact artifact) Utility method that locates a project producing the given artifact.
protected boolean	isResolveDependencies()
void	setArtifactFactory(org.apache.maven.artifact.factory.ArtifactFactory artifactFactory) Setter for artifactFactory.
void	setArtifactMetadataSource(org.apache.maven.artifact.metadata.ArtifactMetadataSource artifactMetadataSource) Setter for artifactMetadataSource.
void	setArtifactResolver(org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver) Setter for artifactResolver.
void	setDownloadJavadocs(boolean downloadJavadoc) Setter for downloadJavadocs.
void	setDownloadSources(boolean downloadSources) Setter for downloadSources.
void	setExecutedProject(org.apache.maven.project.MavenProject executedProject) Setter for executedProject.
void	setLocalRepository(org.apache.maven.artifact.repository.ArtifactRepository localRepository) Setter for localRepository.
void	setProject(org.apache.maven.project.MavenProject project) Setter for project.
void	setReactorProjects(List reactorProjects) Setter for reactorProjects.
void	setRemoteArtifactRepositories(List remoteArtifactRepositories) Setter for remoteArtifactRepositories.
protected void	setResolveDependencies(boolean resolveDependencies)
protected abstract boolean	setup() Hook for preparation steps before the actual plugin execution.
protected boolean	useProjectReference(org.apache.maven.artifact.Artifact art) Checks if a projects reference has to be used for the given artifact
protected abstract void	writeConfiguration(org.apache.maven.plugin.ide.IdeDependency[] deps) Main plugin method where dependencies should be processed in order to generate IDE configuration files.

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 Detail

project

protected org.apache.maven.project.MavenProject project

The project whose project files to create.

executedProject

protected org.apache.maven.project.MavenProject executedProject

The currently executed project (can be a reactor project).

packaging

protected String packaging

The project packaging.

artifactFactory

protected org.apache.maven.artifact.factory.ArtifactFactory artifactFactory

Artifact factory, needed to download source jars for inclusion in classpath.

artifactResolver

protected org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver

Artifact resolver, needed to download source jars for inclusion in classpath.

artifactCollector

protected org.apache.maven.artifact.resolver.ArtifactCollector artifactCollector

Artifact collector, needed to resolve dependencies.

artifactMetadataSource

protected org.apache.maven.artifact.metadata.ArtifactMetadataSource artifactMetadataSource

remoteArtifactRepositories

protected List remoteArtifactRepositories

Remote repositories which will be searched for source attachments.

localRepository

protected org.apache.maven.artifact.repository.ArtifactRepository localRepository

Local maven repository.

reactorProjects

protected List reactorProjects

If the executed project is a reactor project, this will contains the full list of projects in the reactor.

downloadSources

protected boolean downloadSources

Enables/disables the downloading of source attachments. Defaults to false. When this flag is true remote repositories are checked for sources: in order to avoid repeated check for unavailable source archives, a status cache is mantained into the target dir of the root project. Run mvn:clean or delete the file mvn-eclipse-cache.properties in order to reset this cache.

downloadJavadocs

protected boolean downloadJavadocs

Enables/disables the downloading of javadoc attachments. Defaults to false. When this flag is true remote repositories are checked for javadocs: in order to avoid repeated check for unavailable javadoc archives, a status cache is mantained into the target dir of the root project. Run mvn:clean or delete the file mvn-eclipse-cache.properties in order to reset this cache.

logger

protected org.codehaus.plexus.logging.Logger logger

Plexus logger needed for debugging manual artifact resolution.

Constructor Detail

StudioAbstractIdeSupportMojo

public StudioAbstractIdeSupportMojo()

Method Detail

getArtifactMetadataSource

public org.apache.maven.artifact.metadata.ArtifactMetadataSource getArtifactMetadataSource()

Getter for artifactMetadataSource.

Returns:

Returns the artifactMetadataSource.

setArtifactMetadataSource

public void setArtifactMetadataSource(org.apache.maven.artifact.metadata.ArtifactMetadataSource artifactMetadataSource)

Setter for artifactMetadataSource.

Parameters:

artifactMetadataSource - The artifactMetadataSource to set.

getProject

public org.apache.maven.project.MavenProject getProject()

Getter for project.

Returns:

Returns the project.

setProject

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

Setter for project.

Parameters:

project - The project to set.

getReactorProjects

public List getReactorProjects()

Getter for reactorProjects.

Returns:

Returns the reactorProjects.

setReactorProjects

public void setReactorProjects(List reactorProjects)

Setter for reactorProjects.

Parameters:

reactorProjects - The reactorProjects to set.

getRemoteArtifactRepositories

public List getRemoteArtifactRepositories()

Getter for remoteArtifactRepositories.

Returns:

Returns the remoteArtifactRepositories.

setRemoteArtifactRepositories

public void setRemoteArtifactRepositories(List remoteArtifactRepositories)

Setter for remoteArtifactRepositories.

Parameters:

remoteArtifactRepositories - The remoteArtifactRepositories to set.

getArtifactFactory

public org.apache.maven.artifact.factory.ArtifactFactory getArtifactFactory()

Getter for artifactFactory.

Returns:

Returns the artifactFactory.

setArtifactFactory

public void setArtifactFactory(org.apache.maven.artifact.factory.ArtifactFactory artifactFactory)

Setter for artifactFactory.

Parameters:

artifactFactory - The artifactFactory to set.

getArtifactResolver

public org.apache.maven.artifact.resolver.ArtifactResolver getArtifactResolver()

Getter for artifactResolver.

Returns:

Returns the artifactResolver.

setArtifactResolver

public void setArtifactResolver(org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver)

Setter for artifactResolver.

Parameters:

artifactResolver - The artifactResolver to set.

getExecutedProject

public org.apache.maven.project.MavenProject getExecutedProject()

Getter for executedProject.

Returns:

Returns the executedProject.

setExecutedProject

public void setExecutedProject(org.apache.maven.project.MavenProject executedProject)

Setter for executedProject.

Parameters:

executedProject - The executedProject to set.

getLocalRepository

public org.apache.maven.artifact.repository.ArtifactRepository getLocalRepository()

Getter for localRepository.

Returns:

Returns the localRepository.

setLocalRepository

public void setLocalRepository(org.apache.maven.artifact.repository.ArtifactRepository localRepository)

Setter for localRepository.

Parameters:

localRepository - The localRepository to set.

getDownloadJavadocs

public boolean getDownloadJavadocs()

Getter for downloadJavadocs.

Returns:

Returns the downloadJavadocs.

setDownloadJavadocs

public void setDownloadJavadocs(boolean downloadJavadoc)

Setter for downloadJavadocs.

Parameters:

downloadJavadocs - The downloadJavadocs to set.

getDownloadSources

public boolean getDownloadSources()

Getter for downloadSources.

Returns:

Returns the downloadSources.

setDownloadSources

public void setDownloadSources(boolean downloadSources)

Setter for downloadSources.

Parameters:

downloadSources - The downloadSources to set.

setResolveDependencies

protected void setResolveDependencies(boolean resolveDependencies)

isResolveDependencies

protected boolean isResolveDependencies()

getUseProjectReferences

protected abstract boolean getUseProjectReferences()

return false if projects available in a reactor build should be considered normal dependencies, true if referenced project will be linked and not need artifact resolution.

Returns:

true if referenced project will be linked and not need artifact resolution

setup

protected abstract boolean setup()
                          throws org.apache.maven.plugin.MojoExecutionException

Hook for preparation steps before the actual plugin execution.

Returns:

true if execution should continue or false if not.

Throws:

org.apache.maven.plugin.MojoExecutionException - generic mojo exception

writeConfiguration

protected abstract void writeConfiguration(org.apache.maven.plugin.ide.IdeDependency[] deps)
                                    throws org.apache.maven.plugin.MojoExecutionException

Main plugin method where dependencies should be processed in order to generate IDE configuration files.

Parameters:

deps - list of IdeDependency objects, with artifacts, sources and javadocs already resolved

Throws:

org.apache.maven.plugin.MojoExecutionException - generic mojo exception

enableLogging

public void enableLogging(org.codehaus.plexus.logging.Logger logger)

Specified by:

enableLogging in interface org.codehaus.plexus.logging.LogEnabled

See Also:

LogEnabled.enableLogging(org.codehaus.plexus.logging.Logger)

execute

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

Specified by:

execute in interface org.apache.maven.plugin.Mojo

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

See Also:

Mojo.execute()

doDependencyResolution

protected org.apache.maven.plugin.ide.IdeDependency[] doDependencyResolution()
                                                                      throws org.apache.maven.plugin.MojoExecutionException

Resolve project dependencies. Manual resolution is needed in order to avoid resolution of multiproject artifacts (if projects will be linked each other an installed jar is not needed) and to avoid a failure when a jar is missing.

Returns:

resolved IDE dependencies, with attached jars for non-reactor dependencies

Throws:

org.apache.maven.plugin.MojoExecutionException - if dependencies can't be resolved

getProjectNameForArifact

public abstract String getProjectNameForArifact(org.apache.maven.artifact.Artifact artifact)

Find the name of the project as used in eclipse.

Parameters:

artifact - The artifact to find the eclipse name for.

Returns:

The name os the eclipse project.

getProjectArtifacts

protected Set getProjectArtifacts()
                           throws org.apache.maven.plugin.MojoExecutionException

Returns the list of project artifacts. Also artifacts generated from referenced projects will be added, but with the resolved property set to true.

Returns:

list of projects artifacts

Throws:

org.apache.maven.plugin.MojoExecutionException - if unable to parse dependency versions

isAvailableAsAReactorProject

protected boolean isAvailableAsAReactorProject(org.apache.maven.artifact.Artifact artifact)

Utility method that locates a project producing the given artifact.

Parameters:

artifact - the artifact a project should produce.

Returns:

true if the artifact is produced by a reactor projectart.

getWorkspaceArtefacts

protected org.apache.maven.plugin.ide.IdeDependency[] getWorkspaceArtefacts()

Returns:

an array with all dependencies avalaible in the workspace, to be implemented by the subclasses.

getExcludes

public abstract List getExcludes()

Returns:

List of dependencies to exclude from eclipse classpath.

Since:

2.5

hasToResolveJar

protected boolean hasToResolveJar(org.apache.maven.artifact.Artifact art)

Checks if jar has to be resolved for the given artifact

Parameters:

art - the artifact to check

Returns:

true if resolution should happen

useProjectReference

protected boolean useProjectReference(org.apache.maven.artifact.Artifact art)

Checks if a projects reference has to be used for the given artifact

Parameters:

art - the artifact to check

Returns:

true if a project reference has to be used.

getDistributionDataProvider

public abstract MuleDistributionDataProvider getDistributionDataProvider()