View Javadoc
1   package org.apache.maven.plugins.enforcer;
2   
3   /*
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   *
12   *  http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing,
15   * software distributed under the License is distributed on an
16   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17   * KIND, either express or implied.  See the License for the
18   * specific language governing permissions and limitations
19   * under the License.
20   */
21  
22  import java.util.ArrayList;
23  import java.util.Collections;
24  import java.util.List;
25  
26  import org.apache.maven.artifact.Artifact;
27  import org.apache.maven.artifact.factory.ArtifactFactory;
28  import org.apache.maven.artifact.metadata.ArtifactMetadataSource;
29  import org.apache.maven.artifact.repository.ArtifactRepository;
30  import org.apache.maven.artifact.resolver.ArtifactCollector;
31  import org.apache.maven.artifact.resolver.filter.ArtifactFilter;
32  import org.apache.maven.enforcer.rule.api.EnforcerRule;
33  import org.apache.maven.enforcer.rule.api.EnforcerRuleException;
34  import org.apache.maven.enforcer.rule.api.EnforcerRuleHelper;
35  import org.apache.maven.plugin.logging.Log;
36  import org.apache.maven.plugins.enforcer.utils.DependencyVersionMap;
37  import org.apache.maven.project.MavenProject;
38  import org.apache.maven.shared.dependency.tree.DependencyNode;
39  import org.apache.maven.shared.dependency.tree.DependencyTreeBuilder;
40  import org.apache.maven.shared.dependency.tree.DependencyTreeBuilderException;
41  import org.codehaus.plexus.component.configurator.expression.ExpressionEvaluationException;
42  import org.codehaus.plexus.component.repository.exception.ComponentLookupException;
43  
44  /**
45   * @author <a href="mailto:rex@e-hoffman.org">Rex Hoffman</a>
46   */
47  public class DependencyConvergence
48      implements EnforcerRule
49  {
50  
51      private static Log log;
52  
53      private boolean uniqueVersions;
54  
55      public void setUniqueVersions( boolean uniqueVersions )
56      {
57          this.uniqueVersions = uniqueVersions;
58      }
59  
60      // CHECKSTYLE_OFF: LineLength
61      /**
62       * Uses the {@link EnforcerRuleHelper} to populate the values of the
63       * {@link DependencyTreeBuilder#buildDependencyTree(MavenProject, ArtifactRepository, ArtifactFactory, ArtifactMetadataSource, ArtifactFilter, ArtifactCollector)}
64       * factory method. <br/>
65       * This method simply exists to hide all the ugly lookup that the {@link EnforcerRuleHelper} has to do.
66       * 
67       * @param helper
68       * @return a Dependency Node which is the root of the project's dependency tree
69       * @throws EnforcerRuleException
70       */
71      // CHECKSTYLE_ON: LineLength
72      private DependencyNode getNode( EnforcerRuleHelper helper )
73          throws EnforcerRuleException
74      {
75          try
76          {
77              MavenProject project = (MavenProject) helper.evaluate( "${project}" );
78              DependencyTreeBuilder dependencyTreeBuilder =
79                  (DependencyTreeBuilder) helper.getComponent( DependencyTreeBuilder.class );
80              ArtifactRepository repository = (ArtifactRepository) helper.evaluate( "${localRepository}" );
81              ArtifactFactory factory = (ArtifactFactory) helper.getComponent( ArtifactFactory.class );
82              ArtifactMetadataSource metadataSource =
83                  (ArtifactMetadataSource) helper.getComponent( ArtifactMetadataSource.class );
84              ArtifactCollector collector = (ArtifactCollector) helper.getComponent( ArtifactCollector.class );
85              ArtifactFilter filter = null; // we need to evaluate all scopes
86              DependencyNode node = dependencyTreeBuilder.buildDependencyTree( project, repository, factory,
87                                                                               metadataSource, filter, collector );
88              return node;
89          }
90          catch ( ExpressionEvaluationException e )
91          {
92              throw new EnforcerRuleException( "Unable to lookup an expression " + e.getLocalizedMessage(), e );
93          }
94          catch ( ComponentLookupException e )
95          {
96              throw new EnforcerRuleException( "Unable to lookup a component " + e.getLocalizedMessage(), e );
97          }
98          catch ( DependencyTreeBuilderException e )
99          {
100             throw new EnforcerRuleException( "Could not build dependency tree " + e.getLocalizedMessage(), e );
101         }
102     }
103 
104     @Override
105     public void execute( EnforcerRuleHelper helper )
106         throws EnforcerRuleException
107     {
108         if ( log == null )
109         {
110             log = helper.getLog();
111         }
112         try
113         {
114             DependencyNode node = getNode( helper );
115             DependencyVersionMap visitor = new DependencyVersionMap( log );
116             visitor.setUniqueVersions( uniqueVersions );
117             node.accept( visitor );
118             List<CharSequence> errorMsgs = new ArrayList<CharSequence>();
119             errorMsgs.addAll( getConvergenceErrorMsgs( visitor.getConflictedVersionNumbers() ) );
120             for ( CharSequence errorMsg : errorMsgs )
121             {
122                 log.warn( errorMsg );
123             }
124             if ( errorMsgs.size() > 0 )
125             {
126                 throw new EnforcerRuleException( "Failed while enforcing releasability. "
127                     + "See above detailed error message." );
128             }
129         }
130         catch ( Exception e )
131         {
132             throw new EnforcerRuleException( e.getLocalizedMessage(), e );
133         }
134     }
135 
136     private String getFullArtifactName( Artifact artifact )
137     {
138         return artifact.getGroupId() + ":" + artifact.getArtifactId() + ":" + artifact.getVersion();
139     }
140 
141     private StringBuilder buildTreeString( DependencyNode node )
142     {
143         List<String> loc = new ArrayList<String>();
144         DependencyNode currentNode = node;
145         while ( currentNode != null )
146         {
147             loc.add( getFullArtifactName( currentNode.getArtifact() ) );
148             currentNode = currentNode.getParent();
149         }
150         Collections.reverse( loc );
151         StringBuilder builder = new StringBuilder();
152         for ( int i = 0; i < loc.size(); i++ )
153         {
154             for ( int j = 0; j < i; j++ )
155             {
156                 builder.append( "  " );
157             }
158             builder.append( "+-" + loc.get( i ) );
159             builder.append( "\n" );
160         }
161         return builder;
162     }
163 
164     private List<String> getConvergenceErrorMsgs( List<List<DependencyNode>> errors )
165     {
166         List<String> errorMsgs = new ArrayList<String>();
167         for ( List<DependencyNode> nodeList : errors )
168         {
169             errorMsgs.add( buildConvergenceErrorMsg( nodeList ) );
170         }
171         return errorMsgs;
172     }
173 
174     private String buildConvergenceErrorMsg( List<DependencyNode> nodeList )
175     {
176         StringBuilder builder = new StringBuilder();
177         builder.append( "\nDependency convergence error for " + getFullArtifactName( nodeList.get( 0 ).getArtifact() )
178             + " paths to dependency are:\n" );
179         if ( nodeList.size() > 0 )
180         {
181             builder.append( buildTreeString( nodeList.get( 0 ) ) );
182         }
183         for ( DependencyNode node : nodeList.subList( 1, nodeList.size() ) )
184         {
185             builder.append( "and\n" );
186             builder.append( buildTreeString( node ) );
187         }
188         return builder.toString();
189     }
190 
191     @Override
192     public String getCacheId()
193     {
194         return "";
195     }
196 
197     @Override
198     public boolean isCacheable()
199     {
200         return false;
201     }
202 
203     @Override
204     public boolean isResultValid( EnforcerRule rule )
205     {
206         return false;
207     }
208 }