View Javadoc
1   package org.apache.maven.plugins.site.descriptor;
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.io.File;
23  import java.io.IOException;
24  
25  import java.util.Locale;
26  
27  import org.apache.maven.plugin.MojoExecutionException;
28  import org.apache.maven.plugins.annotations.Component;
29  import org.apache.maven.plugins.annotations.LifecyclePhase;
30  import org.apache.maven.plugins.annotations.Mojo;
31  import org.apache.maven.plugins.annotations.Parameter;
32  import org.apache.maven.project.MavenProjectHelper;
33  import org.apache.maven.shared.utils.PathTool;
34  import org.codehaus.plexus.util.FileUtils;
35  
36  /**
37   * Adds the site descriptor (<code>site.xml</code>) to the list of files to be installed/deployed.<br/>
38   * For Maven-2.x this is enabled by default only when the project has <code>pom</code> packaging since it will be used
39   * by modules inheriting, but this can be enabled for other projects packaging if needed.<br/>
40   * This default execution has been removed from the built-in lifecycle of Maven 3.x for <code>pom</code>-projects.
41   * Users that actually use those projects to provide a common site descriptor for sub modules will need to explicitly
42   * define this goal execution to restore the intended behavior.
43   *
44   * @author <a href="mailto:brett@apache.org">Brett Porter</a>
45   *
46   * @since 2.0
47   */
48  @Mojo( name = "attach-descriptor", defaultPhase = LifecyclePhase.PACKAGE, threadSafe = true )
49  public class SiteDescriptorAttachMojo
50      extends AbstractSiteDescriptorMojo
51  {
52      /**
53       */
54      @Parameter( property = "basedir", required = true, readonly = true )
55      private File basedir;
56  
57      /**
58       * Maven ProjectHelper.
59       *
60       * @since 2.1.1
61       */
62      @Component
63      private MavenProjectHelper projectHelper;
64  
65      /**
66       * Attach site descriptor only if packaging is pom.
67       * @since 3.0
68       */
69      @Parameter( defaultValue = "true" )
70      private boolean pomPackagingOnly;
71  
72      public void execute()
73          throws MojoExecutionException
74      {
75          if ( pomPackagingOnly && !"pom".equals( project.getPackaging() ) )
76          {
77              // https://issues.apache.org/jira/browse/MSITE-597
78              getLog().info( "Skipping because packaging '" + project.getPackaging() + "' is not pom." );
79              return;
80          }
81  
82          boolean attachedSiteDescriptor = false;
83          for ( Locale locale : getLocales() )
84          {
85              File descriptorFile = siteTool.getSiteDescriptor( siteDirectory, locale );
86  
87              if ( descriptorFile.exists() )
88              {
89                  attachedSiteDescriptor = true;
90  
91                  // Calculate the classifier to use
92                  String classifier = getClassifier( descriptorFile );
93                  // Prepare a file for the interpolated site descriptor
94                  String filename = project.getArtifactId() + "-" + project.getVersion() + "-" + descriptorFile.getName();
95                  File targetDescriptorFile = new File( project.getBuild().getDirectory(), filename );
96  
97                  try
98                  {
99                      // Copy the site descriptor to a file
100                     FileUtils.copyFile( descriptorFile, targetDescriptorFile );
101                     // Attach the site descriptor
102                     getLog().info( "Attaching '"
103                         + PathTool.getRelativeFilePath( basedir.getAbsolutePath(), descriptorFile.getAbsolutePath() )
104                         + "' site descriptor with classifier '" + classifier + "'." );
105                     projectHelper.attachArtifact( project, "xml", classifier, targetDescriptorFile );
106                 }
107                 catch ( IOException e )
108                 {
109                     throw new MojoExecutionException( "Unable to copy site descriptor", e );
110                 }
111             }
112         }
113 
114         if ( !attachedSiteDescriptor )
115         {
116             getLog().info( "No site descriptor found: nothing to attach." );
117         }
118     }
119 
120     private static String getClassifier( final File descriptorFile )
121         throws MojoExecutionException
122     {
123         final int index = descriptorFile.getName().lastIndexOf( '.' );
124 
125         if ( index > 0 )
126         {
127             return descriptorFile.getName().substring( 0, index );
128         }
129         else
130         {
131             throw new MojoExecutionException( "Unable to determine the classifier to use" );
132         }
133     }
134 }