remoteFile from the maven remote repositories
+ * and store it at destinationFile
+ *
+ * @param destinationFile the destination file in the local repository
+ * @param relativePath the relative path to the dependency
+ * @param dependencyId the dependency Id
+ * @return true if the retrieval succeeds, false otherwise.
+ */
+ private boolean getRemoteArtifact( File destinationFile, String relativePath, String dependencyId )
+ {
+
+ // The directory structure for the project this dependency belongs to
+ // may not exists so attempt to create the project directory structure
+ // before attempting to download the dependency.
+ File directory = destinationFile.getParentFile();
+
+ if ( !directory.exists() )
+ {
+ directory.mkdirs();
+ }
+
+ log.info( "Attempting to download sources for " + dependencyId + " ("+relativePath+")" );
+
+ boolean artifactFound = false;
+
+ for ( Iterator i = getProject().getContext().getMavenRepoRemote().iterator(); i.hasNext(); )
+ {
+ String remoteRepo = (String) i.next();
+
+ if ( remoteRepo.endsWith( "/" ) )
+ {
+ remoteRepo = remoteRepo.substring( 0, remoteRepo.length() - 1 );
+ }
+
+ // The username and password parameters are not being
+ // used here. Those are the "" parameters you see below.
+ String url = remoteRepo + "/" + relativePath;
+ url = StringUtils.replace( url, "//", "/" );
+
+ if ( !url.startsWith( "file" ) )
+ {
+ if ( url.startsWith( "https" ) )
+ {
+ url = StringUtils.replace( url, "https:/", "https://" );
+ }
+ else
+ {
+ url = StringUtils.replace( url, "http:/", "http://" );
+ }
+ }
+ log.debug( "Trying to download source at " + url );
+
+ // Attempt to retrieve the artifact and set the checksum if retrieval
+ // of the checksum file was successful.
+ try
+ {
+ String loginHost = (String) getProject().getContext().getVariable( PROXY_LOGINHOST );
+ String loginDomain = (String) getProject().getContext().getVariable( PROXY_LOGINDOMAIN );
+ HttpUtils.getFile( url, destinationFile, false, true, getProject().getContext().getProxyHost(),
+ getProject().getContext().getProxyPort(),
+ getProject().getContext().getProxyUserName(),
+ getProject().getContext().getProxyPassword(), loginHost, loginDomain, true );
+
+ // Artifact was found, continue checking additional remote repos (if any)
+ // in case there is a newer version (i.e. snapshots) in another repo
+ artifactFound = true;
+
+ if ( !isSnapshot() )
+ {
+ log.info( "Downloded source for " + dependencyId + " at " + url );
+ break;
+ }
+ }
+ catch ( FileNotFoundException e )
+ {
+ // Multiple repositories may exist, and if the file is not found
+ // in just one of them, it's no problem, and we don't want to
+ // even print out an error.
+ // if it's not found at all, artifactFound will be false, and the
+ // build _will_ break, and the user will get an error message
+ log.debug( "File not found on one of the repos", e );
+ }
+ catch ( Exception e )
+ {
+ // If there are additional remote repos, then ignore exception
+ // as artifact may be found in another remote repo. If there
+ // are no more remote repos to check and the artifact wasn't found in
+ // a previous remote repo, then artifactFound is false indicating
+ // that the artifact could not be found in any of the remote repos
+ //
+ // arguably, we need to give the user better control (another command-
+ // line switch perhaps) of what to do in this case? Maven already has
+ // a command-line switch to work in offline mode, but what about when
+ // one of two or more remote repos is unavailable? There may be multiple
+ // remote repos for redundancy, in which case you probably want the build
+ // to continue. There may however be multiple remote repos because some
+ // artifacts are on one, and some are on another. In this case, you may
+ // want the build to break.
+ //
+ // print a warning, in any case, so user catches on to mistyped
+ // hostnames, or other snafus
+ // FIXME: localize this message
+ String[] parsedUrl = HttpUtils.parseUrl( url );
+ log.warn( "Error retrieving artifact from [" + parsedUrl[2] + "]: " + e );
+ if ( parsedUrl[0] != null )
+ {
+ log.debug( "Username was '" + parsedUrl[0] + "', password hidden" );
+ }
+ log.debug( "Error details", e );
+ }
+ }
+
+ return artifactFound;
+ }
+}
diff --git a/source/src/main/org/apache/maven/plugin/source/package.html b/source/src/main/org/apache/maven/plugin/source/package.html
new file mode 100644
index 00000000..695d7183
--- /dev/null
+++ b/source/src/main/org/apache/maven/plugin/source/package.html
@@ -0,0 +1,27 @@
+
+
+
+ Handles source archive artifact.
+ + + diff --git a/source/src/plugin-test/codeGenerationTest/maven.xml b/source/src/plugin-test/codeGenerationTest/maven.xml new file mode 100644 index 00000000..911f7da0 --- /dev/null +++ b/source/src/plugin-test/codeGenerationTest/maven.xml @@ -0,0 +1,56 @@ + ++ This plug-in builds an archive of the source code. It is based + on the maven.compile.src.set property so every directory specified + in this property is used to generate the source archive. +
+
+ The generated source archive will be deployed at
+ ${groupId}/java-sources/${artifactId}-{version}-sources.jar.
+
+ For more information on the functionality provided by this plugin, + please see the Goals document. +
++ For more information on how to customise the functionality provided + by this plugin, please see the properties + document. +
++ Similarly to the plugin plugin, the source plugin is able to download + a source archive from the configured repository(ies). The following + parameters might be set at runtime: +
+ Example: +
+| Property | +Optional? | +Description | +
|---|---|---|
| maven.source.excludes | +Yes | +
+ Default value is
+ |
+
| maven.source.final.name | +Yes | +
+ Default value is
+ |
+