View Javadoc
1   package org.apache.maven.plugins.site.render;
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 org.apache.maven.archiver.MavenArchiveConfiguration;
26  import org.apache.maven.archiver.MavenArchiver;
27  import org.apache.maven.artifact.DependencyResolutionRequiredException;
28  import org.apache.maven.plugin.MojoExecutionException;
29  import org.apache.maven.plugin.MojoFailureException;
30  import org.apache.maven.plugins.annotations.Component;
31  import org.apache.maven.plugins.annotations.LifecyclePhase;
32  import org.apache.maven.plugins.annotations.Mojo;
33  import org.apache.maven.plugins.annotations.Parameter;
34  import org.apache.maven.plugins.annotations.ResolutionScope;
35  import org.apache.maven.project.MavenProjectHelper;
36  import org.codehaus.plexus.archiver.Archiver;
37  import org.codehaus.plexus.archiver.ArchiverException;
38  import org.codehaus.plexus.archiver.jar.JarArchiver;
39  import org.codehaus.plexus.archiver.jar.ManifestException;
40  
41  /**
42   * Bundles the site output into a JAR so that it can be deployed to a repository.
43   *
44   * @author <a href="mailto:mbeerman@yahoo.com">Matthew Beermann</a>
45   *
46   * @since 2.0-beta-6
47   */
48  // MSITE-665: requiresDependencyResolution workaround for MPLUGIN-253 
49  @Mojo( name = "jar", defaultPhase = LifecyclePhase.PACKAGE, requiresDependencyResolution = ResolutionScope.TEST,
50         requiresReports = true )
51  public class SiteJarMojo
52      extends SiteMojo
53  {
54      private static final String[] DEFAULT_ARCHIVE_EXCLUDES = new String[]{ };
55  
56      private static final String[] DEFAULT_ARCHIVE_INCLUDES = new String[]{ "**/**" };
57  
58      /**
59       * Specifies the directory where the generated jar file will be put.
60       */
61      @Parameter( property = "project.build.directory", required = true )
62      private String jarOutputDirectory;
63  
64      /**
65       * Specifies the filename that will be used for the generated jar file.
66       * Please note that "-site" will be appended to the file name.
67       */
68      @Parameter( property = "project.build.finalName", required = true )
69      private String finalName;
70  
71      /**
72       * Used for attaching the artifact in the project.
73       */
74      @Component
75      private MavenProjectHelper projectHelper;
76  
77      /**
78       * Specifies whether to attach the generated artifact to the project.
79       */
80      @Parameter( property = "site.attach", defaultValue = "true" )
81      private boolean attach;
82  
83      /**
84       * The Jar archiver.
85       *
86       * @since 3.1
87       */
88      @Component( role = Archiver.class, hint = "jar" )
89      private JarArchiver jarArchiver;
90  
91      /**
92       * The archive configuration to use.
93       * See <a href="http://maven.apache.org/shared/maven-archiver/index.html">Maven Archiver Reference</a>.
94       *
95       * @since 3.1
96       */
97      @Parameter
98      private MavenArchiveConfiguration archive = new MavenArchiveConfiguration();
99  
100     /**
101      * List of files to include. Specified as file set patterns which are relative to the input directory whose contents
102      * is being packaged into the JAR.
103      *
104      * @since 3.1
105      */
106     @Parameter
107     private String[] archiveIncludes;
108 
109     /**
110      * List of files to exclude. Specified as file set patterns which are relative to the input directory whose contents
111      * is being packaged into the JAR.
112      *
113      * @since 3.1
114      */
115     @Parameter
116     private String[] archiveExcludes;
117 
118     /**
119      * Timestamp for reproducible output archive entries, either formatted as ISO 8601
120      * <code>yyyy-MM-dd'T'HH:mm:ssXXX</code> or as an int representing seconds since the epoch (like
121      * <a href="https://reproducible-builds.org/docs/source-date-epoch/">SOURCE_DATE_EPOCH</a>).
122      *
123      * @since 3.9.0
124      */
125     @Parameter( defaultValue = "${project.build.outputTimestamp}" )
126     private String outputTimestamp;
127 
128     /**
129      * @see org.apache.maven.plugin.Mojo#execute()
130      */
131     public void execute()
132         throws MojoExecutionException, MojoFailureException
133     {
134         if ( skip )
135         {
136             getLog().info( "maven.site.skip = true: Skipping jar generation" );
137             return;
138         }
139 
140         if ( !outputDirectory.exists() )
141         {
142             super.execute();
143         }
144 
145         try
146         {
147             File outputFile = createArchive( outputDirectory,
148                                              finalName + "-" + getClassifier() + "." + getArtifactType() );
149 
150             if ( attach )
151             {
152                 projectHelper.attachArtifact( project, getArtifactType(), getClassifier(), outputFile );
153             }
154             else
155             {
156                 getLog().info( "NOT adding site jar to the list of attached artifacts." );
157             }
158         }
159         catch ( ArchiverException | IOException | ManifestException | DependencyResolutionRequiredException e )
160         {
161             throw new MojoExecutionException( "Error while creating archive.", e );
162         }
163     }
164 
165     protected String getArtifactType()
166     {
167         return "jar";
168     }
169 
170     protected String getClassifier()
171     {
172         return "site";
173     }
174 
175     /**
176      * Method that creates the jar file.
177      *
178      * @param siteDirectory the directory where the site files are located
179      * @param jarFilename   the filename of the created jar file
180      * @return a File object that contains the created jar file
181      * @throws ArchiverException
182      * @throws IOException
183      * @throws ManifestException
184      * @throws DependencyResolutionRequiredException
185      */
186     private File createArchive( File siteDirectory, String jarFilename )
187         throws ArchiverException, IOException, ManifestException, DependencyResolutionRequiredException
188     {
189         File siteJar = new File( jarOutputDirectory, jarFilename );
190 
191         MavenArchiver archiver = new MavenArchiver();
192         archiver.setCreatedBy( "Maven Site Plugin", "org.apache.maven.plugins", "maven-site-plugin" );
193 
194         archiver.setArchiver( this.jarArchiver );
195 
196         archiver.setOutputFile( siteJar );
197 
198         // configure for Reproducible Builds based on outputTimestamp value
199         archiver.configureReproducible( outputTimestamp );
200 
201         if ( !siteDirectory.isDirectory() )
202         {
203             getLog().warn( "JAR will be empty - no content was marked for inclusion!" );
204         }
205         else
206         {
207             archiver.getArchiver().addDirectory( siteDirectory, getArchiveIncludes(), getArchiveExcludes() );
208         }
209 
210         archiver.createArchive( getSession(), getProject(), archive );
211 
212         return siteJar;
213     }
214 
215     private String[] getArchiveIncludes()
216     {
217         if ( this.archiveIncludes != null && this.archiveIncludes.length > 0 )
218         {
219             return this.archiveIncludes;
220         }
221 
222         return DEFAULT_ARCHIVE_INCLUDES;
223     }
224 
225     private String[] getArchiveExcludes()
226     {
227         if ( this.archiveExcludes != null && this.archiveExcludes.length > 0 )
228         {
229             return this.archiveExcludes;
230         }
231         return DEFAULT_ARCHIVE_EXCLUDES;
232     }
233 }