package org.apache.maven.tools.plugin.extractor.annotations; /* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ import java.io.File; import java.net.MalformedURLException; import java.net.URL; import java.net.URLClassLoader; import java.util.ArrayList; import java.util.Arrays; import java.util.Collection; import java.util.Collections; import java.util.HashMap; import java.util.HashSet; import java.util.List; import java.util.Map; import java.util.Set; import java.util.TreeMap; import java.util.TreeSet; import org.apache.maven.artifact.Artifact; import org.apache.maven.artifact.factory.ArtifactFactory; import org.apache.maven.artifact.resolver.ArtifactNotFoundException; import org.apache.maven.artifact.resolver.ArtifactResolutionException; import org.apache.maven.artifact.resolver.ArtifactResolver; import org.apache.maven.plugin.descriptor.DuplicateParameterException; import org.apache.maven.plugin.descriptor.InvalidParameterException; import org.apache.maven.plugin.descriptor.InvalidPluginDescriptorException; import org.apache.maven.plugin.descriptor.MojoDescriptor; import org.apache.maven.plugin.descriptor.PluginDescriptor; import org.apache.maven.plugin.descriptor.Requirement; import org.apache.maven.project.MavenProject; import org.apache.maven.tools.plugin.ExtendedMojoDescriptor; import org.apache.maven.tools.plugin.PluginToolsRequest; import org.apache.maven.tools.plugin.extractor.ExtractionException; import org.apache.maven.tools.plugin.extractor.MojoDescriptorExtractor; import org.apache.maven.tools.plugin.extractor.annotations.datamodel.ComponentAnnotationContent; import org.apache.maven.tools.plugin.extractor.annotations.datamodel.ExecuteAnnotationContent; import org.apache.maven.tools.plugin.extractor.annotations.datamodel.MojoAnnotationContent; import org.apache.maven.tools.plugin.extractor.annotations.datamodel.ParameterAnnotationContent; import org.apache.maven.tools.plugin.extractor.annotations.scanner.MojoAnnotatedClass; import org.apache.maven.tools.plugin.extractor.annotations.scanner.MojoAnnotationsScanner; import org.apache.maven.tools.plugin.extractor.annotations.scanner.MojoAnnotationsScannerRequest; import org.apache.maven.tools.plugin.util.PluginUtils; import org.codehaus.plexus.archiver.UnArchiver; import org.codehaus.plexus.archiver.manager.ArchiverManager; import org.codehaus.plexus.archiver.manager.NoSuchArchiverException; import org.codehaus.plexus.component.annotations.Component; import org.codehaus.plexus.logging.AbstractLogEnabled; import org.codehaus.plexus.util.StringUtils; import com.thoughtworks.qdox.JavaProjectBuilder; import com.thoughtworks.qdox.library.SortedClassLibraryBuilder; import com.thoughtworks.qdox.model.DocletTag; import com.thoughtworks.qdox.model.JavaClass; import com.thoughtworks.qdox.model.JavaField; /** * JavaMojoDescriptorExtractor, a MojoDescriptor extractor to read descriptors from java classes with annotations. * Notice that source files are also parsed to get description, since and deprecation information. * * @author Olivier Lamy * @since 3.0 */ @Component( role = MojoDescriptorExtractor.class, hint = "java-annotations" ) public class JavaAnnotationsMojoDescriptorExtractor extends AbstractLogEnabled implements MojoDescriptorExtractor { @org.codehaus.plexus.component.annotations.Requirement private MojoAnnotationsScanner mojoAnnotationsScanner; @org.codehaus.plexus.component.annotations.Requirement private ArtifactResolver artifactResolver; @org.codehaus.plexus.component.annotations.Requirement private ArtifactFactory artifactFactory; @org.codehaus.plexus.component.annotations.Requirement private ArchiverManager archiverManager; public List<MojoDescriptor> execute( PluginToolsRequest request ) throws ExtractionException, InvalidPluginDescriptorException { Map<String, MojoAnnotatedClass> mojoAnnotatedClasses = scanAnnotations( request ); Map<String, JavaClass> javaClassesMap = scanJavadoc( request, mojoAnnotatedClasses.values() ); populateDataFromJavadoc( mojoAnnotatedClasses, javaClassesMap ); return toMojoDescriptors( mojoAnnotatedClasses, request.getPluginDescriptor() ); } private Map<String, MojoAnnotatedClass> scanAnnotations( PluginToolsRequest request ) throws ExtractionException { MojoAnnotationsScannerRequest mojoAnnotationsScannerRequest = new MojoAnnotationsScannerRequest(); File output = new File( request.getProject().getBuild().getOutputDirectory() ); mojoAnnotationsScannerRequest.setClassesDirectories( Arrays.asList( output ) ); mojoAnnotationsScannerRequest.setDependencies( request.getDependencies() ); mojoAnnotationsScannerRequest.setProject( request.getProject() ); return mojoAnnotationsScanner.scan( mojoAnnotationsScannerRequest ); } private Map<String, JavaClass> scanJavadoc( PluginToolsRequest request, Collection<MojoAnnotatedClass> mojoAnnotatedClasses ) throws ExtractionException { // found artifact from reactors to scan sources // we currently only scan sources from reactors List<MavenProject> mavenProjects = new ArrayList<MavenProject>(); // if we need to scan sources from external artifacts Set<Artifact> externalArtifacts = new HashSet<Artifact>(); for ( MojoAnnotatedClass mojoAnnotatedClass : mojoAnnotatedClasses ) { if ( StringUtils.equals( mojoAnnotatedClass.getArtifact().getArtifactId(), request.getProject().getArtifact().getArtifactId() ) ) { continue; } if ( !isMojoAnnnotatedClassCandidate( mojoAnnotatedClass ) ) { // we don't scan sources for classes without mojo annotations continue; } MavenProject mavenProject = getFromProjectReferences( mojoAnnotatedClass.getArtifact(), request.getProject() ); if ( mavenProject != null ) { mavenProjects.add( mavenProject ); } else { externalArtifacts.add( mojoAnnotatedClass.getArtifact() ); } } Map<String, JavaClass> javaClassesMap = new HashMap<String, JavaClass>(); // try to get artifact with sources classifier, extract somewhere then scan for @since, @deprecated for ( Artifact artifact : externalArtifacts ) { // parameter for test-sources too ?? olamy I need that for it test only if ( StringUtils.equalsIgnoreCase( "tests", artifact.getClassifier() ) ) { javaClassesMap.putAll( discoverClassesFromSourcesJar( artifact, request, "test-sources" ) ); } else { javaClassesMap.putAll( discoverClassesFromSourcesJar( artifact, request, "sources" ) ); } } for ( MavenProject mavenProject : mavenProjects ) { javaClassesMap.putAll( discoverClasses( request.getEncoding(), mavenProject ) ); } javaClassesMap.putAll( discoverClasses( request ) ); return javaClassesMap; } private boolean isMojoAnnnotatedClassCandidate( MojoAnnotatedClass mojoAnnotatedClass ) { return mojoAnnotatedClass != null && mojoAnnotatedClass.hasAnnotations(); } protected Map<String, JavaClass> discoverClassesFromSourcesJar( Artifact artifact, PluginToolsRequest request, String classifier ) throws ExtractionException { try { Artifact sourcesArtifact = artifactFactory.createArtifactWithClassifier( artifact.getGroupId(), artifact.getArtifactId(), artifact.getVersion(), artifact.getType(), classifier ); artifactResolver.resolve( sourcesArtifact, request.getRemoteRepos(), request.getLocal() ); if ( sourcesArtifact.getFile() == null || !sourcesArtifact.getFile().exists() ) { // could not get artifact sources return Collections.emptyMap(); } // extract sources to target/maven-plugin-plugin-sources/${groupId}/${artifact}/sources File extractDirectory = new File( request.getProject().getBuild().getDirectory(), "maven-plugin-plugin-sources/" + sourcesArtifact.getGroupId() + "/" + sourcesArtifact.getArtifactId() + "/" + sourcesArtifact.getVersion() + "/" + sourcesArtifact.getClassifier() ); extractDirectory.mkdirs(); UnArchiver unArchiver = archiverManager.getUnArchiver( "jar" ); unArchiver.setSourceFile( sourcesArtifact.getFile() ); unArchiver.setDestDirectory( extractDirectory ); unArchiver.extract(); return discoverClasses( request.getEncoding(), Arrays.asList( extractDirectory ), request.getDependencies() ); } catch ( ArtifactResolutionException e ) { throw new ExtractionException( e.getMessage(), e ); } catch ( ArtifactNotFoundException e ) { //throw new ExtractionException( e.getMessage(), e ); getLogger().debug( "skip ArtifactNotFoundException:" + e.getMessage() ); getLogger().warn( "Unable to get sources artifact for " + artifact.getGroupId() + ":" + artifact.getArtifactId() + ":" + artifact.getVersion() + ". Some javadoc tags (@since, @deprecated and comments) won't be used" ); return Collections.emptyMap(); } catch ( NoSuchArchiverException e ) { throw new ExtractionException( e.getMessage(), e ); } } /** * from sources scan to get @since and @deprecated and description of classes and fields. * * @param mojoAnnotatedClasses * @param javaClassesMap */ protected void populateDataFromJavadoc( Map<String, MojoAnnotatedClass> mojoAnnotatedClasses, Map<String, JavaClass> javaClassesMap ) { for ( Map.Entry<String, MojoAnnotatedClass> entry : mojoAnnotatedClasses.entrySet() ) { JavaClass javaClass = javaClassesMap.get( entry.getKey() ); if ( javaClass == null ) { continue; } // populate class-level content MojoAnnotationContent mojoAnnotationContent = entry.getValue().getMojo(); if ( mojoAnnotationContent != null ) { mojoAnnotationContent.setDescription( javaClass.getComment() ); DocletTag since = findInClassHierarchy( javaClass, "since" ); if ( since != null ) { mojoAnnotationContent.setSince( since.getValue() ); } DocletTag deprecated = findInClassHierarchy( javaClass, "deprecated" ); if ( deprecated != null ) { mojoAnnotationContent.setDeprecated( deprecated.getValue() ); } } Map<String, JavaField> fieldsMap = extractFieldParameterTags( javaClass, javaClassesMap ); // populate parameters Map<String, ParameterAnnotationContent> parameters = getParametersParentHierarchy( entry.getValue(), new HashMap<String, ParameterAnnotationContent>(), mojoAnnotatedClasses ); parameters = new TreeMap<String, ParameterAnnotationContent>( parameters ); for ( Map.Entry<String, ParameterAnnotationContent> parameter : parameters.entrySet() ) { JavaField javaField = fieldsMap.get( parameter.getKey() ); if ( javaField == null ) { continue; } ParameterAnnotationContent parameterAnnotationContent = parameter.getValue(); parameterAnnotationContent.setDescription( javaField.getComment() ); DocletTag deprecated = javaField.getTagByName( "deprecated" ); if ( deprecated != null ) { parameterAnnotationContent.setDeprecated( deprecated.getValue() ); } DocletTag since = javaField.getTagByName( "since" ); if ( since != null ) { parameterAnnotationContent.setSince( since.getValue() ); } } // populate components Map<String, ComponentAnnotationContent> components = entry.getValue().getComponents(); for ( Map.Entry<String, ComponentAnnotationContent> component : components.entrySet() ) { JavaField javaField = fieldsMap.get( component.getKey() ); if ( javaField == null ) { continue; } ComponentAnnotationContent componentAnnotationContent = component.getValue(); componentAnnotationContent.setDescription( javaField.getComment() ); DocletTag deprecated = javaField.getTagByName( "deprecated" ); if ( deprecated != null ) { componentAnnotationContent.setDeprecated( deprecated.getValue() ); } DocletTag since = javaField.getTagByName( "since" ); if ( since != null ) { componentAnnotationContent.setSince( since.getValue() ); } } } } /** * @param javaClass not null * @param tagName not null * @return docletTag instance */ private DocletTag findInClassHierarchy( JavaClass javaClass, String tagName ) { DocletTag tag = javaClass.getTagByName( tagName ); if ( tag == null ) { JavaClass superClass = javaClass.getSuperJavaClass(); if ( superClass != null ) { tag = findInClassHierarchy( superClass, tagName ); } } return tag; } /** * extract fields that are either parameters or components. * * @param javaClass not null * @return map with Mojo parameters names as keys */ private Map<String, JavaField> extractFieldParameterTags( JavaClass javaClass, Map<String, JavaClass> javaClassesMap ) { Map<String, JavaField> rawParams = new TreeMap<String, com.thoughtworks.qdox.model.JavaField>(); // we have to add the parent fields first, so that they will be overwritten by the local fields if // that actually happens... JavaClass superClass = javaClass.getSuperJavaClass(); if ( superClass != null ) { if ( superClass.getFields().size() > 0 ) { rawParams = extractFieldParameterTags( superClass, javaClassesMap ); } // maybe sources comes from scan of sources artifact superClass = javaClassesMap.get( superClass.getFullyQualifiedName() ); if ( superClass != null ) { rawParams = extractFieldParameterTags( superClass, javaClassesMap ); } } else { rawParams = new TreeMap<String, JavaField>(); } for ( JavaField field : javaClass.getFields() ) { rawParams.put( field.getName(), field ); } return rawParams; } protected Map<String, JavaClass> discoverClasses( final PluginToolsRequest request ) { return discoverClasses( request.getEncoding(), request.getProject() ); } @SuppressWarnings( "unchecked" ) protected Map<String, JavaClass> discoverClasses( final String encoding, final MavenProject project ) { List<File> sources = new ArrayList<File>(); for ( String source : (List<String>) project.getCompileSourceRoots() ) { sources.add( new File( source ) ); } // TODO be more dynamic File generatedPlugin = new File( project.getBasedir(), "target/generated-sources/plugin" ); if ( !project.getCompileSourceRoots().contains( generatedPlugin.getAbsolutePath() ) && generatedPlugin.exists() ) { sources.add( generatedPlugin ); } return discoverClasses( encoding, sources, project.getArtifacts() ); } protected Map<String, JavaClass> discoverClasses( final String encoding, List<File> sourceDirectories, Set<Artifact> artifacts ) { JavaProjectBuilder builder = new JavaProjectBuilder( new SortedClassLibraryBuilder() ); builder.setEncoding( encoding ); // Build isolated Classloader with only the artifacts of the project (none of this plugin) List<URL> urls = new ArrayList<URL>( artifacts.size() ); for ( Artifact artifact : artifacts ) { try { urls.add( artifact.getFile().toURI().toURL() ); } catch ( MalformedURLException e ) { // noop } } builder.addClassLoader( new URLClassLoader( urls.toArray( new URL[0] ), ClassLoader.getSystemClassLoader() ) ); for ( File source : sourceDirectories ) { builder.addSourceTree( source ); } Collection<JavaClass> javaClasses = builder.getClasses(); if ( javaClasses == null || javaClasses.size() < 1 ) { return Collections.emptyMap(); } Map<String, JavaClass> javaClassMap = new HashMap<String, JavaClass>( javaClasses.size() ); for ( JavaClass javaClass : javaClasses ) { javaClassMap.put( javaClass.getFullyQualifiedName(), javaClass ); } return javaClassMap; } private List<MojoDescriptor> toMojoDescriptors( Map<String, MojoAnnotatedClass> mojoAnnotatedClasses, PluginDescriptor pluginDescriptor ) throws DuplicateParameterException, InvalidParameterException { List<MojoDescriptor> mojoDescriptors = new ArrayList<MojoDescriptor>( mojoAnnotatedClasses.size() ); for ( MojoAnnotatedClass mojoAnnotatedClass : mojoAnnotatedClasses.values() ) { // no mojo so skip it if ( mojoAnnotatedClass.getMojo() == null ) { continue; } ExtendedMojoDescriptor mojoDescriptor = new ExtendedMojoDescriptor(); //mojoDescriptor.setRole( mojoAnnotatedClass.getClassName() ); //mojoDescriptor.setRoleHint( "default" ); mojoDescriptor.setImplementation( mojoAnnotatedClass.getClassName() ); mojoDescriptor.setLanguage( "java" ); MojoAnnotationContent mojo = mojoAnnotatedClass.getMojo(); mojoDescriptor.setDescription( mojo.getDescription() ); mojoDescriptor.setSince( mojo.getSince() ); mojo.setDeprecated( mojo.getDeprecated() ); mojoDescriptor.setProjectRequired( mojo.requiresProject() ); mojoDescriptor.setRequiresReports( mojo.requiresReports() ); mojoDescriptor.setComponentConfigurator( mojo.configurator() ); mojoDescriptor.setInheritedByDefault( mojo.inheritByDefault() ); mojoDescriptor.setInstantiationStrategy( mojo.instantiationStrategy().id() ); mojoDescriptor.setAggregator( mojo.aggregator() ); mojoDescriptor.setDependencyResolutionRequired( mojo.requiresDependencyResolution().id() ); mojoDescriptor.setDependencyCollectionRequired( mojo.requiresDependencyCollection().id() ); mojoDescriptor.setDirectInvocationOnly( mojo.requiresDirectInvocation() ); mojoDescriptor.setDeprecated( mojo.getDeprecated() ); mojoDescriptor.setThreadSafe( mojo.threadSafe() ); ExecuteAnnotationContent execute = findExecuteInParentHierarchy( mojoAnnotatedClass, mojoAnnotatedClasses ); if ( execute != null ) { mojoDescriptor.setExecuteGoal( execute.goal() ); mojoDescriptor.setExecuteLifecycle( execute.lifecycle() ); if ( execute.phase() != null ) { mojoDescriptor.setExecutePhase( execute.phase().id() ); } } mojoDescriptor.setExecutionStrategy( mojo.executionStrategy() ); // ??? //mojoDescriptor.alwaysExecute(mojo.a) mojoDescriptor.setGoal( mojo.name() ); mojoDescriptor.setOnlineRequired( mojo.requiresOnline() ); mojoDescriptor.setPhase( mojo.defaultPhase().id() ); // Parameter annotations Map<String, ParameterAnnotationContent> parameters = getParametersParentHierarchy( mojoAnnotatedClass, new HashMap<String, ParameterAnnotationContent>(), mojoAnnotatedClasses ); for ( ParameterAnnotationContent parameterAnnotationContent : new TreeSet<ParameterAnnotationContent>( parameters.values() ) ) { org.apache.maven.plugin.descriptor.Parameter parameter = new org.apache.maven.plugin.descriptor.Parameter(); String name = StringUtils.isEmpty( parameterAnnotationContent.name() ) ? parameterAnnotationContent.getFieldName() : parameterAnnotationContent.name(); parameter.setName( name ); parameter.setAlias( parameterAnnotationContent.alias() ); parameter.setDefaultValue( parameterAnnotationContent.defaultValue() ); parameter.setDeprecated( parameterAnnotationContent.getDeprecated() ); parameter.setDescription( parameterAnnotationContent.getDescription() ); parameter.setEditable( !parameterAnnotationContent.readonly() ); String property = parameterAnnotationContent.property(); if ( StringUtils.contains( property, '$' ) || StringUtils.contains( property, '{' ) || StringUtils.contains( property, '}' ) ) { throw new InvalidParameterException( "Invalid property for parameter '" + parameter.getName() + "', " + "forbidden characters ${}: " + property, null ); } parameter.setExpression( StringUtils.isEmpty( property ) ? "" : "${" + property + "}" ); parameter.setType( parameterAnnotationContent.getClassName() ); parameter.setSince( parameterAnnotationContent.getSince() ); parameter.setRequired( parameterAnnotationContent.required() ); mojoDescriptor.addParameter( parameter ); } // Component annotations Map<String, ComponentAnnotationContent> components = getComponentsParentHierarchy( mojoAnnotatedClass, new HashMap<String, ComponentAnnotationContent>(), mojoAnnotatedClasses ); for ( ComponentAnnotationContent componentAnnotationContent : new TreeSet<ComponentAnnotationContent>( components.values() ) ) { org.apache.maven.plugin.descriptor.Parameter parameter = new org.apache.maven.plugin.descriptor.Parameter(); parameter.setName( componentAnnotationContent.getFieldName() ); // recognize Maven-injected objects as components annotations instead of parameters String expression = PluginUtils.MAVEN_COMPONENTS.get( componentAnnotationContent.getRoleClassName() ); if ( expression == null ) { // normal component parameter.setRequirement( new Requirement( componentAnnotationContent.getRoleClassName(), componentAnnotationContent.hint() ) ); } else { // not a component but a Maven object to be transformed into an expression/property: deprecated getLogger().warn( "Deprecated @Component annotation for '" + parameter.getName() + "' field in " + mojoAnnotatedClass.getClassName() + ": replace with @Parameter( defaultValue = \"" + expression + "\", readonly = true )" ); parameter.setDefaultValue( expression ); parameter.setType( componentAnnotationContent.getRoleClassName() ); parameter.setRequired( true ); } parameter.setDeprecated( componentAnnotationContent.getDeprecated() ); parameter.setSince( componentAnnotationContent.getSince() ); // same behaviour as JavaMojoDescriptorExtractor //parameter.setRequired( ... ); parameter.setEditable( false ); mojoDescriptor.addParameter( parameter ); } mojoDescriptor.setPluginDescriptor( pluginDescriptor ); mojoDescriptors.add( mojoDescriptor ); } return mojoDescriptors; } protected ExecuteAnnotationContent findExecuteInParentHierarchy( MojoAnnotatedClass mojoAnnotatedClass, Map<String, MojoAnnotatedClass> mojoAnnotatedClasses ) { if ( mojoAnnotatedClass.getExecute() != null ) { return mojoAnnotatedClass.getExecute(); } String parentClassName = mojoAnnotatedClass.getParentClassName(); if ( StringUtils.isEmpty( parentClassName ) ) { return null; } MojoAnnotatedClass parent = mojoAnnotatedClasses.get( parentClassName ); if ( parent == null ) { return null; } return findExecuteInParentHierarchy( parent, mojoAnnotatedClasses ); } protected Map<String, ParameterAnnotationContent> getParametersParentHierarchy( MojoAnnotatedClass mojoAnnotatedClass, Map<String, ParameterAnnotationContent> parameters, Map<String, MojoAnnotatedClass> mojoAnnotatedClasses ) { List<ParameterAnnotationContent> parameterAnnotationContents = new ArrayList<ParameterAnnotationContent>(); parameterAnnotationContents = getParametersParent( mojoAnnotatedClass, parameterAnnotationContents, mojoAnnotatedClasses ); // move to parent first to build the Map Collections.reverse( parameterAnnotationContents ); Map<String, ParameterAnnotationContent> map = new HashMap<String, ParameterAnnotationContent>( parameterAnnotationContents.size() ); for ( ParameterAnnotationContent parameterAnnotationContent : parameterAnnotationContents ) { map.put( parameterAnnotationContent.getFieldName(), parameterAnnotationContent ); } return map; } protected List<ParameterAnnotationContent> getParametersParent( MojoAnnotatedClass mojoAnnotatedClass, List<ParameterAnnotationContent> parameterAnnotationContents, Map<String, MojoAnnotatedClass> mojoAnnotatedClasses ) { parameterAnnotationContents.addAll( mojoAnnotatedClass.getParameters().values() ); String parentClassName = mojoAnnotatedClass.getParentClassName(); if ( parentClassName != null ) { MojoAnnotatedClass parent = mojoAnnotatedClasses.get( parentClassName ); if ( parent != null ) { return getParametersParent( parent, parameterAnnotationContents, mojoAnnotatedClasses ); } } return parameterAnnotationContents; } protected Map<String, ComponentAnnotationContent> getComponentsParentHierarchy( MojoAnnotatedClass mojoAnnotatedClass, Map<String, ComponentAnnotationContent> components, Map<String, MojoAnnotatedClass> mojoAnnotatedClasses ) { List<ComponentAnnotationContent> componentAnnotationContents = new ArrayList<ComponentAnnotationContent>(); componentAnnotationContents = getComponentParent( mojoAnnotatedClass, componentAnnotationContents, mojoAnnotatedClasses ); // move to parent first to build the Map Collections.reverse( componentAnnotationContents ); Map<String, ComponentAnnotationContent> map = new HashMap<String, ComponentAnnotationContent>( componentAnnotationContents.size() ); for ( ComponentAnnotationContent componentAnnotationContent : componentAnnotationContents ) { map.put( componentAnnotationContent.getFieldName(), componentAnnotationContent ); } return map; } protected List<ComponentAnnotationContent> getComponentParent( MojoAnnotatedClass mojoAnnotatedClass, List<ComponentAnnotationContent> componentAnnotationContents, Map<String, MojoAnnotatedClass> mojoAnnotatedClasses ) { componentAnnotationContents.addAll( mojoAnnotatedClass.getComponents().values() ); String parentClassName = mojoAnnotatedClass.getParentClassName(); if ( parentClassName != null ) { MojoAnnotatedClass parent = mojoAnnotatedClasses.get( parentClassName ); if ( parent != null ) { return getComponentParent( parent, componentAnnotationContents, mojoAnnotatedClasses ); } } return componentAnnotationContents; } protected MavenProject getFromProjectReferences( Artifact artifact, MavenProject project ) { if ( project.getProjectReferences() == null || project.getProjectReferences().isEmpty() ) { return null; } @SuppressWarnings( "unchecked" ) Collection<MavenProject> mavenProjects = project.getProjectReferences().values(); for ( MavenProject mavenProject : mavenProjects ) { if ( StringUtils.equals( mavenProject.getId(), artifact.getId() ) ) { return mavenProject; } } return null; } }