source.dussan.org Git - archiva.git/blob

   1 package org.apache.maven.repository.discovery;
   2
   3 /*
   4  * Copyright 2005-2006 The Apache Software Foundation.
   5  *
   6  * Licensed under the Apache License, Version 2.0 (the "License");
   7  * you may not use this file except in compliance with the License.
   8  * 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, software
  13  * distributed under the License is distributed on an "AS IS" BASIS,
  14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  * See the License for the specific language governing permissions and
  16  * limitations under the License.
  17  */
  18
  19 import org.apache.maven.artifact.repository.ArtifactRepository;
  20
  21 import java.util.Iterator;
  22 import java.util.List;
  23
  24 /**
  25  * Interface for implementation that can discover artifacts within a repository.
  26  *
  27  * @author John Casey
  28  * @author Brett Porter
  29  */
  30 public interface ArtifactDiscoverer
  31 {
  32     String ROLE = ArtifactDiscoverer.class.getName();
  33
  34     /**
  35      * Discover artifacts in the repository.
  36      *
  37      * @param repository          the location of the repository
  38      * @param blacklistedPatterns pattern that lists any files to prevent from being included when scanning
  39      * @param includeSnapshots    whether to discover snapshots
  40      * @return the list of artifacts discovered
  41      * @todo replace repositoryBase with wagon repository
  42      * @todo do we want blacklisted patterns in another form? Part of the object construction?
  43      * @todo should includeSnapshots be configuration on the component?
  44      * @todo instead of a returned list, should a listener be passed in?
  45      */
  46     List discoverArtifacts( ArtifactRepository repository, String blacklistedPatterns, boolean includeSnapshots );
  47
  48     /**
  49      * Get the list of paths kicked out during the discovery process.
  50      *
  51      * @return the paths as Strings.
  52      */
  53     Iterator getKickedOutPathsIterator();
  54
  55     /**
  56      * Get the list of paths excluded during the discovery process.
  57      *
  58      * @return the paths as Strings.
  59      */
  60     Iterator getExcludedPathsIterator();
  61 }