View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *   http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing,
13   * software distributed under the License is distributed on an
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   * KIND, either express or implied.  See the License for the
16   * specific language governing permissions and limitations
17   * under the License.
18   */
19  package org.apache.maven.artifact.resolver;
20  
21  import java.util.List;
22  import java.util.Map;
23  import java.util.Set;
24  import org.apache.maven.artifact.Artifact;
25  import org.apache.maven.artifact.metadata.ArtifactMetadataSource;
26  import org.apache.maven.artifact.repository.ArtifactRepository;
27  import org.apache.maven.artifact.resolver.filter.ArtifactFilter;
28  import org.apache.maven.wagon.events.TransferListener;
29  
30  /**
31   * @author Jason van Zyl
32   */
33  // Just hide the one method we want behind the RepositorySystem interface.
34  public interface ArtifactResolver {
35  
36      ArtifactResolutionResult resolve(ArtifactResolutionRequest request);
37  
38      // The rest is deprecated
39      // USED BY MAVEN ASSEMBLY PLUGIN 2.2-beta-2
40      @Deprecated
41      String ROLE = ArtifactResolver.class.getName();
42  
43      // USED BY SUREFIRE, DEPENDENCY PLUGIN
44      @Deprecated
45      ArtifactResolutionResult resolveTransitively(
46              Set<Artifact> artifacts,
47              Artifact originatingArtifact,
48              ArtifactRepository localRepository,
49              List<ArtifactRepository> remoteRepositories,
50              ArtifactMetadataSource source,
51              ArtifactFilter filter)
52              throws ArtifactResolutionException, ArtifactNotFoundException;
53  
54      // USED BY MAVEN ASSEMBLY PLUGIN
55      @Deprecated
56      ArtifactResolutionResult resolveTransitively(
57              Set<Artifact> artifacts,
58              Artifact originatingArtifact,
59              Map<String, Artifact> managedVersions,
60              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,
69              Artifact originatingArtifact,
70              Map<String, Artifact> managedVersions,
71              ArtifactRepository localRepository,
72              List<ArtifactRepository> remoteRepositories,
73              ArtifactMetadataSource source,
74              ArtifactFilter filter)
75              throws ArtifactResolutionException, ArtifactNotFoundException;
76  
77      // USED BY INVOKER PLUGIN
78      @Deprecated
79      ArtifactResolutionResult resolveTransitively(
80              Set<Artifact> artifacts,
81              Artifact originatingArtifact,
82              List<ArtifactRepository> remoteRepositories,
83              ArtifactRepository localRepository,
84              ArtifactMetadataSource source)
85              throws ArtifactResolutionException, ArtifactNotFoundException;
86  
87      @Deprecated
88      @SuppressWarnings("checkstyle:parameternumber")
89      ArtifactResolutionResult resolveTransitively(
90              Set<Artifact> artifacts,
91              Artifact originatingArtifact,
92              Map<String, Artifact> managedVersions,
93              ArtifactRepository localRepository,
94              List<ArtifactRepository> remoteRepositories,
95              ArtifactMetadataSource source,
96              ArtifactFilter filter,
97              List<ResolutionListener> listeners)
98              throws ArtifactResolutionException, ArtifactNotFoundException;
99  
100     @Deprecated
101     ArtifactResolutionResult resolveTransitively(
102             Set<Artifact> artifacts,
103             Artifact originatingArtifact,
104             List<ArtifactRepository> remoteRepositories,
105             ArtifactRepository localRepository,
106             ArtifactMetadataSource source,
107             List<ResolutionListener> listeners)
108             throws ArtifactResolutionException, ArtifactNotFoundException;
109 
110     // USED BY REMOTE RESOURCES PLUGIN, DEPENDENCY PLUGIN, SHADE PLUGIN
111     @Deprecated
112     void resolve(Artifact artifact, List<ArtifactRepository> remoteRepositories, ArtifactRepository localRepository)
113             throws ArtifactResolutionException, ArtifactNotFoundException;
114 
115     // USED BY REMOTE RESOURCES PLUGIN
116     @Deprecated
117     void resolve(
118             Artifact artifact,
119             List<ArtifactRepository> remoteRepositories,
120             ArtifactRepository localRepository,
121             TransferListener downloadMonitor)
122             throws ArtifactResolutionException, ArtifactNotFoundException;
123 
124     // USED BY DEPENDENCY PLUGIN, ARCHETYPE DOWNLOADER
125     @Deprecated
126     void resolveAlways(
127             Artifact artifact, List<ArtifactRepository> remoteRepositories, ArtifactRepository localRepository)
128             throws ArtifactResolutionException, ArtifactNotFoundException;
129 }