Coverage Report - org.apache.maven.plugins.site.SiteMojo
 
Classes in this File Line Coverage Branch Coverage Complexity
SiteMojo
2%
1/40
0%
0/14
0
 
 1  
 package org.apache.maven.plugins.site;
 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 org.apache.maven.doxia.siterenderer.DocumentRenderer;
 23  
 import org.apache.maven.doxia.siterenderer.RendererException;
 24  
 import org.apache.maven.doxia.siterenderer.SiteRenderingContext;
 25  
 import org.apache.maven.plugin.MojoExecutionException;
 26  
 import org.apache.maven.plugin.MojoFailureException;
 27  
 import org.apache.maven.reporting.MavenReport;
 28  
 
 29  
 import java.io.File;
 30  
 import java.io.IOException;
 31  
 import java.util.Collections;
 32  
 import java.util.List;
 33  
 import java.util.Locale;
 34  
 import java.util.Map;
 35  
 
 36  
 /**
 37  
  * Generates the site for a single project.
 38  
  * <p>
 39  
  * Note that links between module sites in a multi module build will <b>not</b>
 40  
  * work.
 41  
  * </p>
 42  
  *
 43  
  * @author <a href="mailto:evenisse@apache.org">Emmanuel Venisse</a>
 44  
  * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
 45  
  * @version $Id: org.apache.maven.plugins.site.SiteMojo.html 816556 2012-05-08 11:58:34Z hboutemy $
 46  
  * @goal site
 47  
  * @requiresDependencyResolution test
 48  
  */
 49  1
 public class SiteMojo
 50  
     extends AbstractSiteRenderingMojo
 51  
 {
 52  
     /**
 53  
      * Directory containing the generated project sites and report distributions.
 54  
      *
 55  
      * @parameter expression="${siteOutputDirectory}" default-value="${project.reporting.outputDirectory}"
 56  
      * @required
 57  
      */
 58  
     protected File outputDirectory;
 59  
 
 60  
     /**
 61  
      * Convenience parameter that allows you to disable report generation.
 62  
      *
 63  
      * @parameter expression="${generateReports}" default-value="true"
 64  
      */
 65  
     private boolean generateReports;
 66  
 
 67  
     /**
 68  
      * Generate a sitemap. The result will be a "sitemap.html" file at the site root.
 69  
      *
 70  
      * @parameter expression="${generateSitemap}" default-value="false"
 71  
      * @since 2.1
 72  
      */
 73  
     private boolean generateSitemap;
 74  
 
 75  
     /**
 76  
      * Whether to validate xml input documents.
 77  
      * If set to true, <strong>all</strong> input documents in xml format
 78  
      * (in particular xdoc and fml) will be validated and any error will
 79  
      * lead to a build failure.
 80  
      *
 81  
      * @parameter expression="${validate}" default-value="false"
 82  
      * @since 2.1.1
 83  
      */
 84  
     private boolean validate;
 85  
 
 86  
     /**
 87  
      * {@inheritDoc}
 88  
      *
 89  
      * Generate the project site
 90  
      * <p/>
 91  
      * throws MojoExecutionException if any
 92  
      *
 93  
      * @see org.apache.maven.plugin.Mojo#execute()
 94  
      */
 95  
     public void execute()
 96  
         throws MojoExecutionException, MojoFailureException
 97  
     {
 98  
         List<MavenReport> filteredReports;
 99  0
         if ( generateReports )
 100  
         {
 101  0
             filteredReports = filterReports( reports );
 102  
         }
 103  
         else
 104  
         {
 105  0
             filteredReports = Collections.EMPTY_LIST;
 106  
         }
 107  
 
 108  
         try
 109  
         {
 110  0
             List<Locale> localesList = siteTool.getAvailableLocales( locales );
 111  
 
 112  
             // Default is first in the list
 113  0
             Locale defaultLocale = localesList.get( 0 );
 114  0
             Locale.setDefault( defaultLocale );
 115  
 
 116  0
             for ( Locale locale : localesList )
 117  
             {
 118  0
                 renderLocale( locale, filteredReports );
 119  
             }
 120  
         }
 121  0
         catch ( RendererException e )
 122  
         {
 123  0
             throw new MojoExecutionException( "Error during page generation", e );
 124  
         }
 125  0
         catch ( IOException e )
 126  
         {
 127  0
             throw new MojoExecutionException( "Error during site generation", e );
 128  0
         }
 129  0
     }
 130  
 
 131  
     private void renderLocale( Locale locale, List<MavenReport> reports )
 132  
         throws IOException, RendererException, MojoFailureException, MojoExecutionException
 133  
     {
 134  0
         SiteRenderingContext context = createSiteRenderingContext( locale );
 135  
 
 136  0
         context.setInputEncoding( getInputEncoding() );
 137  0
         context.setOutputEncoding( getOutputEncoding() );
 138  0
         context.setValidate( validate );
 139  0
         if ( validate )
 140  
         {
 141  0
             getLog().info( "Validation is switched on, xml input documents will be validated!" );
 142  
         }
 143  
 
 144  0
         Map<String, DocumentRenderer> documents = locateDocuments( context, reports, locale );
 145  
 
 146  0
         File outputDir = getOutputDirectory( locale );
 147  
 
 148  
         // For external reports
 149  0
         for ( MavenReport report : reports )
 150  
         {
 151  0
             report.setReportOutputDirectory( outputDir );
 152  
         }
 153  
 
 154  0
         siteRenderer.render( documents.values(), context, outputDir );
 155  
 
 156  0
         if ( generateSitemap )
 157  
         {
 158  0
             getLog().info( "Generating Sitemap." );
 159  
 
 160  0
             new SiteMap( getOutputEncoding(), i18n )
 161  
                     .generate( context.getDecoration(), generatedSiteDirectory, locale );
 162  
         }
 163  
 
 164  
         // Generated docs must be done afterwards as they are often generated by reports
 165  0
         context.getSiteDirectories().clear();
 166  0
         context.addSiteDirectory( generatedSiteDirectory );
 167  
 
 168  0
         documents = siteRenderer.locateDocumentFiles( context );
 169  
 
 170  0
         siteRenderer.render( documents.values(), context, outputDir );
 171  0
     }
 172  
 
 173  
     private File getOutputDirectory( Locale locale )
 174  
     {
 175  
         File file;
 176  0
         if ( locale.getLanguage().equals( Locale.getDefault().getLanguage() ) )
 177  
         {
 178  0
             file = outputDirectory;
 179  
         }
 180  
         else
 181  
         {
 182  0
             file = new File( outputDirectory, locale.getLanguage() );
 183  
         }
 184  
 
 185  
         // Safety
 186  0
         if ( !file.exists() )
 187  
         {
 188  0
             file.mkdirs();
 189  
         }
 190  
 
 191  0
         return file;
 192  
     }
 193  
 }