1 /*******************************************************************************
2 * Copyright (c) 2010, 2014 Sonatype, Inc.
3 * All rights reserved. This program and the accompanying materials
4 * are made available under the terms of the Eclipse Public License v1.0
5 * which accompanies this distribution, and is available at
6 * http://www.eclipse.org/legal/epl-v10.html
7 *
8 * Contributors:
9 * Sonatype, Inc. - initial API and implementation
10 *******************************************************************************/
11 package org.eclipse.aether.transfer;
12
13 import org.eclipse.aether.artifact.Artifact;
14 import org.eclipse.aether.artifact.ArtifactProperties;
15 import org.eclipse.aether.repository.RemoteRepository;
16
17 /**
18 * Thrown when an artifact was not found in a particular repository.
19 */
20 public class ArtifactNotFoundException
21 extends ArtifactTransferException
22 {
23
24 /**
25 * Creates a new exception with the specified artifact and repository.
26 *
27 * @param artifact The missing artifact, may be {@code null}.
28 * @param repository The involved remote repository, may be {@code null}.
29 */
30 public ArtifactNotFoundException( Artifact artifact, RemoteRepository repository )
31 {
32 super( artifact, repository, getMessage( artifact, repository ) );
33 }
34
35 private static String getMessage( Artifact artifact, RemoteRepository repository )
36 {
37 StringBuilder buffer = new StringBuilder( 256 );
38 buffer.append( "Could not find artifact " ).append( artifact );
39 buffer.append( getString( " in ", repository ) );
40 if ( artifact != null )
41 {
42 String localPath = artifact.getProperty( ArtifactProperties.LOCAL_PATH, null );
43 if ( localPath != null && repository == null )
44 {
45 buffer.append( " at specified path " ).append( localPath );
46 }
47 String downloadUrl = artifact.getProperty( ArtifactProperties.DOWNLOAD_URL, null );
48 if ( downloadUrl != null )
49 {
50 buffer.append( ", try downloading from " ).append( downloadUrl );
51 }
52 }
53 return buffer.toString();
54 }
55
56 /**
57 * Creates a new exception with the specified artifact, repository and detail message.
58 *
59 * @param artifact The missing artifact, may be {@code null}.
60 * @param repository The involved remote repository, may be {@code null}.
61 * @param message The detail message, may be {@code null}.
62 */
63 public ArtifactNotFoundException( Artifact artifact, RemoteRepository repository, String message )
64 {
65 super( artifact, repository, message );
66 }
67
68 /**
69 * Creates a new exception with the specified artifact, repository and detail message.
70 *
71 * @param artifact The missing artifact, may be {@code null}.
72 * @param repository The involved remote repository, may be {@code null}.
73 * @param message The detail message, may be {@code null}.
74 * @param fromCache {@code true} if the exception was played back from the error cache, {@code false} if the
75 * exception actually just occurred.
76 */
77 public ArtifactNotFoundException( Artifact artifact, RemoteRepository repository, String message, boolean fromCache )
78 {
79 super( artifact, repository, message, fromCache );
80 }
81
82 /**
83 * Creates a new exception with the specified artifact, repository, detail message and cause.
84 *
85 * @param artifact The missing artifact, may be {@code null}.
86 * @param repository The involved remote repository, may be {@code null}.
87 * @param message The detail message, may be {@code null}.
88 * @param cause The exception that caused this one, may be {@code null}.
89 */
90 public ArtifactNotFoundException( Artifact artifact, RemoteRepository repository, String message, Throwable cause )
91 {
92 super( artifact, repository, message, cause );
93 }
94
95 }