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.repository.ArtifactRepository;
27  import org.apache.maven.artifact.resolver.filter.ArtifactFilter;
28  import org.apache.maven.enforcer.rule.api.EnforcerRule;
29  import org.apache.maven.enforcer.rule.api.EnforcerRuleException;
30  import org.apache.maven.enforcer.rule.api.EnforcerRuleHelper;
31  import org.apache.maven.execution.MavenSession;
32  import org.apache.maven.plugin.logging.Log;
33  import org.apache.maven.plugins.enforcer.utils.DependencyVersionMap;
34  import org.apache.maven.project.DefaultProjectBuildingRequest;
35  import org.apache.maven.project.MavenProject;
36  import org.apache.maven.project.ProjectBuildingRequest;
37  import org.apache.maven.shared.dependency.graph.DependencyCollectorBuilder;
38  import org.apache.maven.shared.dependency.graph.DependencyCollectorBuilderException;
39  import org.apache.maven.shared.dependency.graph.DependencyNode;
40  import org.codehaus.plexus.component.configurator.expression.ExpressionEvaluationException;
41  import org.codehaus.plexus.component.repository.exception.ComponentLookupException;
42  
43  /**
44   * @author <a href="mailto:rex@e-hoffman.org">Rex Hoffman</a>
45   */
46  public class DependencyConvergence
47      implements EnforcerRule
48  {
49      private static Log log;
50  
51      private boolean uniqueVersions;
52  
53      public void setUniqueVersions( boolean uniqueVersions )
54      {
55          this.uniqueVersions = uniqueVersions;
56      }
57  
58      // CHECKSTYLE_OFF: LineLength
59      /**
60       * Uses the {@link EnforcerRuleHelper} to populate the values of the
61       * {@link DependencyTreeBuilder#buildDependencyTree(MavenProject, ArtifactRepository, ArtifactFactory, ArtifactMetadataSource, ArtifactFilter, ArtifactCollector)}
62       * factory method. <br/>
63       * This method simply exists to hide all the ugly lookup that the {@link EnforcerRuleHelper} has to do.
64       * 
65       * @param helper
66       * @return a Dependency Node which is the root of the project's dependency tree
67       * @throws EnforcerRuleException
68       */
69      // CHECKSTYLE_ON: LineLength
70      private DependencyNode getNode( EnforcerRuleHelper helper )
71          throws EnforcerRuleException
72      {
73          try
74          {
75              MavenProject project = (MavenProject) helper.evaluate( "${project}" );
76              MavenSession session = (MavenSession) helper.evaluate( "${session}" );
77              DependencyCollectorBuilder dependencyCollectorBuilder =
78                  helper.getComponent( DependencyCollectorBuilder.class );
79              ArtifactRepository repository = (ArtifactRepository) helper.evaluate( "${localRepository}" );
80  
81              ProjectBuildingRequest buildingRequest =
82                  new DefaultProjectBuildingRequest( session.getProjectBuildingRequest() );
83              buildingRequest.setProject( project );
84              buildingRequest.setLocalRepository( repository );
85              ArtifactFilter filter = null; // we need to evaluate all scopes
86  
87              return dependencyCollectorBuilder.collectDependencyGraph( buildingRequest, filter );
88          }
89          catch ( ExpressionEvaluationException | ComponentLookupException e )
90          {
91              throw new EnforcerRuleException( "Unable to lookup a component " + e.getLocalizedMessage(), e );
92          }
93          catch ( DependencyCollectorBuilderException e )
94          {
95              throw new EnforcerRuleException( "Could not build dependency tree " + e.getLocalizedMessage(), e );
96          }
97      }
98  
99      @Override
100     public void execute( EnforcerRuleHelper helper )
101         throws EnforcerRuleException
102     {
103         if ( log == null )
104         {
105             log = helper.getLog();
106         }
107         try
108         {
109             DependencyNode node = getNode( helper );
110             DependencyVersionMap visitor = new DependencyVersionMap( log );
111             visitor.setUniqueVersions( uniqueVersions );
112             node.accept( visitor );
113             List<CharSequence> errorMsgs = new ArrayList<>();
114             errorMsgs.addAll( getConvergenceErrorMsgs( visitor.getConflictedVersionNumbers() ) );
115             for ( CharSequence errorMsg : errorMsgs )
116             {
117                 log.warn( errorMsg );
118             }
119             if ( errorMsgs.size() > 0 )
120             {
121                 throw new EnforcerRuleException( "Failed while enforcing releasability. "
122                     + "See above detailed error message." );
123             }
124         }
125         catch ( Exception e )
126         {
127             throw new EnforcerRuleException( e.getLocalizedMessage(), e );
128         }
129     }
130 
131     private StringBuilder buildTreeString( DependencyNode node )
132     {
133         List<String> loc = new ArrayList<>();
134         DependencyNode currentNode = node;
135         while ( currentNode != null )
136         {
137             loc.add( currentNode.getArtifact().toString() );
138             currentNode = currentNode.getParent();
139         }
140         Collections.reverse( loc );
141         StringBuilder builder = new StringBuilder();
142         for ( int i = 0; i < loc.size(); i++ )
143         {
144             for ( int j = 0; j < i; j++ )
145             {
146                 builder.append( "  " );
147             }
148             builder.append( "+-" + loc.get( i ) );
149             builder.append( System.lineSeparator() );
150         }
151         return builder;
152     }
153 
154     private List<String> getConvergenceErrorMsgs( List<List<DependencyNode>> errors )
155     {
156         List<String> errorMsgs = new ArrayList<>();
157         for ( List<DependencyNode> nodeList : errors )
158         {
159             errorMsgs.add( buildConvergenceErrorMsg( nodeList ) );
160         }
161         return errorMsgs;
162     }
163 
164     private String buildConvergenceErrorMsg( List<DependencyNode> nodeList )
165     {
166         StringBuilder builder = new StringBuilder();
167         builder.append( System.lineSeparator() + "Dependency convergence error for "
168             + nodeList.get( 0 ).getArtifact().toString()
169             + " paths to dependency are:" + System.lineSeparator() );
170         if ( nodeList.size() > 0 )
171         {
172             builder.append( buildTreeString( nodeList.get( 0 ) ) );
173         }
174         for ( DependencyNode node : nodeList.subList( 1, nodeList.size() ) )
175         {
176             builder.append( "and" + System.lineSeparator() );
177             builder.append( buildTreeString( node ) );
178         }
179         return builder.toString();
180     }
181 
182     @Override
183     public String getCacheId()
184     {
185         return "";
186     }
187 
188     @Override
189     public boolean isCacheable()
190     {
191         return false;
192     }
193 
194     @Override
195     public boolean isResultValid( EnforcerRule rule )
196     {
197         return false;
198     }
199 }