View Javadoc
1   package org.apache.maven.artifact.resolver;
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.List;
23  import java.util.Map;
24  import java.util.Set;
25  
26  import org.apache.maven.artifact.Artifact;
27  import org.apache.maven.artifact.metadata.ArtifactMetadataSource;
28  import org.apache.maven.artifact.repository.ArtifactRepository;
29  import org.apache.maven.artifact.resolver.filter.ArtifactFilter;
30  import org.apache.maven.wagon.events.TransferListener;
31  
32  /**
33   * @author Jason van Zyl
34   */
35  // Just hide the one method we want behind the RepositorySystem interface.
36  public interface ArtifactResolver
37  {
38  
39      ArtifactResolutionResult resolve( ArtifactResolutionRequest request );
40  
41      // The rest is deprecated
42  
43      // USED BY MAVEN ASSEMBLY PLUGIN 2.2-beta-2
44      @Deprecated
45      String ROLE = ArtifactResolver.class.getName();
46  
47      // USED BY SUREFIRE, DEPENDENCY PLUGIN
48      @Deprecated
49      ArtifactResolutionResult resolveTransitively( 
50      		Set<Artifact> artifacts, Artifact originatingArtifact,
51              ArtifactRepository localRepository,
52              List<ArtifactRepository> remoteRepositories,
53              ArtifactMetadataSource source, ArtifactFilter filter )
54          throws ArtifactResolutionException, ArtifactNotFoundException;
55  
56      // USED BY MAVEN ASSEMBLY PLUGIN
57      @Deprecated
58      ArtifactResolutionResult resolveTransitively( 
59      		Set<Artifact> artifacts, Artifact originatingArtifact,
60              Map<String,Artifact> managedVersions, ArtifactRepository localRepository,
61              List<ArtifactRepository> remoteRepositories,
62              ArtifactMetadataSource source )
63          throws ArtifactResolutionException, ArtifactNotFoundException;
64  
65      // USED BY MAVEN ASSEMBLY PLUGIN
66      @Deprecated
67      ArtifactResolutionResult resolveTransitively( 
68      		Set<Artifact> artifacts, Artifact originatingArtifact,
69              Map<String,Artifact> managedVersions, ArtifactRepository localRepository,
70              List<ArtifactRepository> remoteRepositories,
71              ArtifactMetadataSource source, ArtifactFilter filter )
72          throws ArtifactResolutionException, ArtifactNotFoundException;
73  
74      // USED BY INVOKER PLUGIN
75      @Deprecated
76      ArtifactResolutionResult resolveTransitively( 
77      		Set<Artifact> artifacts, Artifact originatingArtifact,
78              List<ArtifactRepository> remoteRepositories,
79              ArtifactRepository localRepository, ArtifactMetadataSource source )
80          throws ArtifactResolutionException, ArtifactNotFoundException;
81  
82      @Deprecated
83      ArtifactResolutionResult resolveTransitively( 
84      		Set<Artifact> artifacts, Artifact originatingArtifact,
85              Map<String,Artifact> managedVersions, ArtifactRepository localRepository,
86              List<ArtifactRepository> remoteRepositories,
87              ArtifactMetadataSource source, ArtifactFilter filter,
88              List<ResolutionListener> listeners )
89          throws ArtifactResolutionException, ArtifactNotFoundException;
90  
91      @Deprecated
92      ArtifactResolutionResult resolveTransitively( 
93      		Set<Artifact> artifacts, Artifact originatingArtifact,
94              List<ArtifactRepository> remoteRepositories,
95              ArtifactRepository localRepository, ArtifactMetadataSource source,
96              List<ResolutionListener> listeners )
97          throws ArtifactResolutionException, ArtifactNotFoundException;
98  
99      // USED BY REMOTE RESOURCES PLUGIN, DEPENDENCY PLUGIN, SHADE PLUGIN
100     @Deprecated
101     void resolve( Artifact artifact, List<ArtifactRepository> remoteRepositories, ArtifactRepository localRepository )
102         throws ArtifactResolutionException, ArtifactNotFoundException;
103 
104     // USED BY REMOTE RESOURCES PLUGIN
105     @Deprecated
106     void resolve( Artifact artifact, List<ArtifactRepository> remoteRepositories, ArtifactRepository localRepository,
107                   TransferListener downloadMonitor )
108         throws ArtifactResolutionException, ArtifactNotFoundException;
109 
110     // USED BY DEPENDENCY PLUGIN, ARCHETYPE DOWNLOADER
111     @Deprecated
112     void resolveAlways( Artifact artifact, List<ArtifactRepository> remoteRepositories,
113                         ArtifactRepository localRepository )
114         throws ArtifactResolutionException, ArtifactNotFoundException;
115 }