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( Set<Artifact> artifacts, Artifact originatingArtifact,
50                                                    ArtifactRepository localRepository,
51                                                    List<ArtifactRepository> remoteRepositories,
52                                                    ArtifactMetadataSource source, ArtifactFilter filter )
53          throws ArtifactResolutionException, ArtifactNotFoundException;
54  
55      // USED BY MAVEN ASSEMBLY PLUGIN
56      @Deprecated
57      ArtifactResolutionResult resolveTransitively( Set<Artifact> artifacts, Artifact originatingArtifact,
58                                                    Map managedVersions, ArtifactRepository localRepository,
59                                                    List<ArtifactRepository> remoteRepositories,
60                                                    ArtifactMetadataSource source )
61          throws ArtifactResolutionException, ArtifactNotFoundException;
62  
63      // USED BY MAVEN ASSEMBLY PLUGIN
64      @Deprecated
65      ArtifactResolutionResult resolveTransitively( Set<Artifact> artifacts, Artifact originatingArtifact,
66                                                    Map managedVersions, ArtifactRepository localRepository,
67                                                    List<ArtifactRepository> remoteRepositories,
68                                                    ArtifactMetadataSource source, ArtifactFilter filter )
69          throws ArtifactResolutionException, ArtifactNotFoundException;
70  
71      @Deprecated
72      ArtifactResolutionResult resolveTransitively( Set<Artifact> artifacts, Artifact originatingArtifact,
73                                                    List<ArtifactRepository> remoteRepositories,
74                                                    ArtifactRepository localRepository, ArtifactMetadataSource source )
75          throws ArtifactResolutionException, ArtifactNotFoundException;
76  
77      @Deprecated
78      ArtifactResolutionResult resolveTransitively( Set<Artifact> artifacts, Artifact originatingArtifact,
79                                                    Map managedVersions, ArtifactRepository localRepository,
80                                                    List<ArtifactRepository> remoteRepositories,
81                                                    ArtifactMetadataSource source, ArtifactFilter filter,
82                                                    List<ResolutionListener> listeners )
83          throws ArtifactResolutionException, ArtifactNotFoundException;
84  
85      @Deprecated
86      ArtifactResolutionResult resolveTransitively( Set<Artifact> artifacts, Artifact originatingArtifact,
87                                                    List<ArtifactRepository> remoteRepositories,
88                                                    ArtifactRepository localRepository, ArtifactMetadataSource source,
89                                                    List<ResolutionListener> listeners )
90          throws ArtifactResolutionException, ArtifactNotFoundException;
91  
92      // USED BY REMOTE RESOURCES PLUGIN, DEPENDENCY PLUGIN
93      @Deprecated
94      void resolve( Artifact artifact, List<ArtifactRepository> remoteRepositories, ArtifactRepository localRepository )
95          throws ArtifactResolutionException, ArtifactNotFoundException;
96  
97      // USED BY REMOTE RESOURCES PLUGIN
98      @Deprecated
99      void resolve( Artifact artifact, List<ArtifactRepository> remoteRepositories, ArtifactRepository localRepository,
100                   TransferListener downloadMonitor )
101         throws ArtifactResolutionException, ArtifactNotFoundException;
102 
103     // USED BY DEPENDENCY PLUGIN, ARCHETYPE DOWNLOADER
104     @Deprecated
105     void resolveAlways( Artifact artifact, List<ArtifactRepository> remoteRepositories,
106                         ArtifactRepository localRepository )
107         throws ArtifactResolutionException, ArtifactNotFoundException;
108 }