package org.apache.maven.artifact;
   
   /*
    * Licensed to the Apache Software Foundation (ASF) under one
    * or more contributor license agreements.  See the NOTICE file
    * distributed with this work for additional information
    * regarding copyright ownership.  The ASF licenses this file
    * to you under the Apache License, Version 2.0 (the
    * "License"); you may not use this file except in compliance
   * with the License.  You may obtain a copy of the License at
   *
   *  http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing,
   * software distributed under the License is distributed on an
   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   * KIND, either express or implied.  See the License for the
   * specific language governing permissions and limitations
   * under the License.
   */
  
  import java.io.File;
  import java.util.Collection;
  import java.util.List;
  import java.util.regex.Pattern;
  
  import org.apache.maven.artifact.handler.ArtifactHandler;
  import org.apache.maven.artifact.metadata.ArtifactMetadata;
  import org.apache.maven.artifact.repository.ArtifactRepository;
  import org.apache.maven.artifact.resolver.filter.ArtifactFilter;
  import org.apache.maven.artifact.versioning.ArtifactVersion;
  import org.apache.maven.artifact.versioning.OverConstrainedVersionException;
  import org.apache.maven.artifact.versioning.VersionRange;
  
  /**
   * Maven Artifact interface. Notice that it mixes artifact definition concepts (groupId, artifactId, version)
   * with dependency information (version range, scope). 
   */
  public interface Artifact
      extends Comparable<Artifact>
  {
  
      String RELEASE_VERSION = "RELEASE";
  
      String LATEST_VERSION = "LATEST";
  
      String SNAPSHOT_VERSION = "SNAPSHOT";
  
      Pattern VERSION_FILE_PATTERN = Pattern.compile( "^(.*)-([0-9]{8}.[0-9]{6})-([0-9]+)$" );
  
      // TODO: into artifactScope handler
  
      String SCOPE_COMPILE = "compile";
  
      String SCOPE_COMPILE_PLUS_RUNTIME = "compile+runtime";
  
      String SCOPE_TEST = "test";
  
      String SCOPE_RUNTIME = "runtime";
  
      String SCOPE_RUNTIME_PLUS_SYSTEM = "runtime+system";
  
      String SCOPE_PROVIDED = "provided";
  
      String SCOPE_SYSTEM = "system";
  
      String SCOPE_IMPORT = "import";   // Used to import dependencyManagement dependencies
  
      String getGroupId();
  
      String getArtifactId();
  
      String getVersion();
  
      void setVersion( String version );
  
      String getScope();
  
      String getType();
  
      String getClassifier();
  
      boolean hasClassifier();
  
      File getFile();
  
      void setFile( File destination );
  
      String getBaseVersion();
  
      void setBaseVersion( String baseVersion );
  
      String getId();
  
      String getDependencyConflictId();
  
      void addMetadata( ArtifactMetadata metadata );
  
      Collection<ArtifactMetadata> getMetadataList();
 
     void setRepository( ArtifactRepository remoteRepository );
 
     ArtifactRepository getRepository();
 
     void updateVersion( String version, ArtifactRepository localRepository );
 
     String getDownloadUrl();
 
     void setDownloadUrl( String downloadUrl );
 
     ArtifactFilter getDependencyFilter();
 
     void setDependencyFilter( ArtifactFilter artifactFilter );
 
     ArtifactHandler getArtifactHandler();
 
     List<String> getDependencyTrail();
 
     void setDependencyTrail( List<String> dependencyTrail );
 
     void setScope( String scope );
 
     VersionRange getVersionRange();
 
     void setVersionRange( VersionRange newRange );
 
     void selectVersion( String version );
 
     void setGroupId( String groupId );
 
     void setArtifactId( String artifactId );
 
     boolean isSnapshot();
 
     void setResolved( boolean resolved );
 
     boolean isResolved();
 
     void setResolvedVersion( String version );
 
     void setArtifactHandler( ArtifactHandler handler );
 
     boolean isRelease();
 
     void setRelease( boolean release );
 
     List<ArtifactVersion> getAvailableVersions();
 
     void setAvailableVersions( List<ArtifactVersion> versions );
 
     boolean isOptional();
 
     void setOptional( boolean optional );
 
     ArtifactVersion getSelectedVersion()
         throws OverConstrainedVersionException;
 
     boolean isSelectedVersionKnown()
         throws OverConstrainedVersionException;
 
 }