package org.apache.maven.plugin.javadoc;

 /*

  * Licensed to the Apache Software Foundation (ASF) under one

  * or more contributor license agreements.  See the NOTICE file

  * distributed with this work for additional information

  * regarding copyright ownership.  The ASF licenses this file

  * to you under the Apache License, Version 2.0 (the

  * "License"); you may not use this file except in compliance

  * with the License.  You may obtain a copy of the License at

  *

  *  http://www.apache.org/licenses/LICENSE-2.0

  *

  * Unless required by applicable law or agreed to in writing,

  * software distributed under the License is distributed on an

  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY

  * KIND, either express or implied.  See the License for the

  * specific language governing permissions and limitations

  * under the License.

  */

 import java.io.File;

 import java.util.List;

 import java.util.Locale;

 import java.util.ResourceBundle;

 import org.apache.maven.doxia.module.xhtml.decoration.render.RenderingContext;

 import org.apache.maven.doxia.siterenderer.sink.SiteRendererSink;

 import org.apache.maven.plugin.MojoExecutionException;

 import org.apache.maven.plugin.MojoFailureException;

 import org.apache.maven.reporting.MavenReport;

 import org.apache.maven.reporting.MavenReportException;

 import org.codehaus.doxia.sink.Sink;

 import org.codehaus.plexus.util.StringUtils;

 /**

  * Generates documentation for the <code>Java code</code> in an <b>NON aggregator</b> project using the standard

  * <a href="http://java.sun.com/j2se/javadoc/">Javadoc Tool</a>.

  *

  * @author <a href="mailto:evenisse@apache.org">Emmanuel Venisse</a>

  * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>

  * @version $Id$

  * @since 2.0

  * @goal javadoc

  * @execute phase="generate-sources"

  * @see <a href="http://java.sun.com/j2se/javadoc/">Javadoc Tool</a>

  * @see <a href="http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/javadoc.html#options">Javadoc Options</a>

  */

 public class JavadocReport

     extends AbstractJavadocMojo

     implements MavenReport

 {

     // ----------------------------------------------------------------------

     // Report Mojo Parameters

     // ----------------------------------------------------------------------

     /**

      * Specifies the destination directory where javadoc saves the generated HTML files.

      *

      * @parameter expression="${project.reporting.outputDirectory}/apidocs"

      * @required

      */

     private File reportOutputDirectory;

     /**

      * The name of the destination directory.

      * <br/>

      *

      * @since 2.1

      * @parameter expression="${destDir}" default-value="apidocs"

      */

     private String destDir;

     /**

      * The name of the Javadoc report.

      *

      * @since 2.1

      * @parameter expression="${name}"

      */

     private String name;

     /**

      * The description of the Javadoc report.

      *

      * @since 2.1

      * @parameter expression="${description}"

      */

     private String description;

     // ----------------------------------------------------------------------

     // Report public methods

     // ----------------------------------------------------------------------

     /** {@inheritDoc} */

     public String getName( Locale locale )

     {

         if ( StringUtils.isEmpty( name ) )

         {

             return getBundle( locale ).getString( "report.javadoc.name" );

         }

         return name;

     }

     /** {@inheritDoc} */

     public String getDescription( Locale locale )

     {

         if ( StringUtils.isEmpty( description ) )

         {

             return getBundle( locale ).getString( "report.javadoc.description" );

         }

         return description;

     }

     /** {@inheritDoc} */

     public void generate( Sink sink, Locale locale )

         throws MavenReportException

     {

         outputDirectory = getReportOutputDirectory();

         executeReport( locale );

     }

     /** {@inheritDoc} */

     public String getOutputName()

     {

         return destDir + "/index";

     }

     /** {@inheritDoc} */

     public boolean isExternalReport()

     {

         return true;

     }

     /**

      * {@inheritDoc}

      *

      * <br/>

      * The logic is the following:

      * <table>

      *   <tbody>

      *     <tr>

      *       <th> isAggregator </th>

      *       <th> hasSourceFiles </th>

      *       <th> isRootProject </th>

      *       <th> Generate Report </th>

      *     </tr>

      *     <tr>

      *       <td>True</td>

      *       <td>True</td>

      *       <td>True</td>

      *       <td>True</td>

      *     </tr>

      *     <tr>

      *       <td>True</td>

      *       <td>True</td>

      *       <td>False</td>

      *       <td>False</td>

      *     </tr>

      *     <tr>

      *       <td>True</td>

      *       <td>False</td>

      *       <td>True</td>

      *       <td>False</td>

      *     </tr>

      *     <tr>

      *       <td>True</td>

      *       <td>False</td>

      *       <td>False</td>

      *       <td>False</td>

      *     </tr>

      *     <tr>

      *       <td>False</td>

      *       <td>True</td>

      *       <td>True</td>

      *       <td>True</td>

      *     </tr>

      *     <tr>

      *       <td>False</td>

      *       <td>True</td>

      *       <td>False</td>

      *       <td>True</td>

      *     </tr>

      *     <tr>

      *        <td>False</td>

      *        <td>False</td>

      *        <td>True</td>

      *        <td>False</td>

      *      </tr>

      *      <tr>

      *        <td>False</td>

      *        <td>False</td>

      *        <td>False</td>

      *        <td>False</td>

      *      </tr>

      *    </tbody>

      *  </table>

      */

     public boolean canGenerateReport()

     {

         boolean canGenerate = false;

         if ( !this.isAggregator() || ( this.isAggregator() && this.project.isExecutionRoot() ) )

         {

             List sourcePaths = getSourcePaths();

             List files = getFiles( sourcePaths );

             canGenerate = canGenerateReport( files );

         }

         return canGenerate;

     }

     /** {@inheritDoc} */

     public String getCategoryName()

     {

         return CATEGORY_PROJECT_REPORTS;

     }

     /** {@inheritDoc} */

     public File getReportOutputDirectory()

     {

         if ( reportOutputDirectory == null )

         {

             return outputDirectory;

         }

         return reportOutputDirectory;

     }

     /**

      * Method to set the directory where the generated reports will be put

      *

      * @param reportOutputDirectory the directory file to be set

      */

     public void setReportOutputDirectory( File reportOutputDirectory )

     {

         if ( ( reportOutputDirectory != null ) && ( !reportOutputDirectory.getAbsolutePath().endsWith( destDir ) ) )

         {

             this.reportOutputDirectory = new File( reportOutputDirectory, destDir );

         }

         else

         {

             this.reportOutputDirectory = reportOutputDirectory;

         }

     }

     /** {@inheritDoc} */

     public void execute()

         throws MojoExecutionException, MojoFailureException

     {

         if ( skip )

         {

             getLog().info( "Skipping javadoc generation" );

             return;

         }

         try

         {

             RenderingContext context = new RenderingContext( outputDirectory, getOutputName() + ".html" );

             SiteRendererSink sink = new SiteRendererSink( context );

             Locale locale = Locale.getDefault();

             generate( sink, locale );

         }

         catch ( MavenReportException e )

         {

             if ( failOnError )

             {

                 throw new MojoExecutionException( "An error has occurred in " + getName( Locale.ENGLISH )

                     + " report generation:" + e.getMessage(), e );

             }

             getLog().error( "An error has occurred in " + getName( Locale.ENGLISH )

                     + " report generation:" + e.getMessage(), e );

         }

         catch ( RuntimeException e )

         {

             if ( failOnError )

             {

                 throw e;

             }

             getLog().error( e.getMessage(), e );

         }

     }

     /** {@inheritDoc} */

     protected boolean isAggregator()

     {

         // only here for backward compatibility, this flag does not work reliably

         return aggregate;

     }

     /**

      * Gets the resource bundle for the specified locale.

      *

      * @param locale The locale of the currently generated report.

      * @return The resource bundle for the requested locale.

      */

     private ResourceBundle getBundle( Locale locale )

     {

         return ResourceBundle.getBundle( "javadoc-report", locale, getClass().getClassLoader() );

     }

 }