package org.apache.maven.plugin.changes;

 /*

  * 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.io.IOException;

 import java.net.URL;

 import java.util.Locale;

 import java.util.Map;

 import java.util.ResourceBundle;

 import org.apache.maven.reporting.MavenReportException;

 import org.codehaus.plexus.util.FileUtils;

 /**

  * Goal which creates a nicely formatted Changes Report in html format from a changes.xml file.

  *

  * @goal changes-report

  * @author <a href="mailto:jruiz@exist.com">Johnny R. Ruiz III</a>

  * @version $Id: org.apache.maven.plugin.changes.ChangesMojo.html 816588 2012-05-08 12:37:27Z hboutemy $

  */

 public class ChangesMojo

     extends AbstractChangesReport

 {

     /**

      * The path of the <code>changes.xml</code> file that will be converted into an HTML report.

      *

      * @parameter expression="${changes.xmlPath}" default-value="src/changes/changes.xml"

      */

     private File xmlPath;

     /**

      * Template string that is used to discover the URL to use to display an issue report.

      * There are 2 template tokens you can use. <code>%URL%</code>: this is computed by getting the

      * <code>&lt;issueManagement&gt;/&lt;url&gt;</code> value from the POM, and removing the last '/'

      * and everything that comes after it. <code>%ISSUE%</code>: this is the issue number.

      * <p>

      * <strong>Note:</strong> In versions of this plugin prior to 2.0-beta-2 this parameter was called

      * <code>link_template</code>.

      * </p>

      *

      * @parameter expression="${changes.issueLinkTemplate}" default-value="%URL%/ViewIssue.jspa?key=%ISSUE%"

      * @since 2.0-beta-2

      * @deprecated As of 2.1 use issueLinkTemplatePerSystem : this one will be with system default

      */

     private String issueLinkTemplate;

     /**

      * Template strings per system that is used to discover the URL to use to display an issue report. Each key in this

      * map denotes the (case-sensitive) identifier of the issue tracking system and its value gives the URL template.

      * <p>

      * There are 2 template tokens you can use. <code>%URL%</code>: this is computed by getting the

      * <code>&lt;issueManagement&gt;/&lt;url&gt;</code> value from the POM, and removing the last '/'

      * and everything that comes after it. <code>%ISSUE%</code>: this is the issue number.

      * </p>

      * <p>

      * <strong>Note:</strong> The deprecated issueLinkTemplate will be used for a system called "default".

      * </p>

      *

      * @parameter

      * @since 2.1

      */    

     private Map issueLinkTemplatePerSystem;

     /**

      * @parameter default-value="${project.issueManagement.url}"

      * @readonly

      */

     private String url;

     /**

      * A flag whether the report should also include the dates of individual actions. If set to <code>false</code>, only

      * the dates of releases will be written to the report.

      * 

      * @parameter expression="${changes.addActionDate}" default-value="false"

      * @since 2.1

      */        

     private boolean addActionDate;    

     public boolean canGenerateReport()

     {

         return xmlPath.isFile();

     }

     private void copyStaticResources()

         throws MavenReportException

     {

         final String pluginResourcesBase = "org/apache/maven/plugin/changes";

         String resourceNames[] = {

             "images/add.gif",

             "images/fix.gif",

             "images/icon_help_sml.gif",

             "images/remove.gif",

             "images/rss.png",

             "images/update.gif" };

         try

         {

             getLog().debug( "Copying static resources." );

             for ( int i = 0; i < resourceNames.length; i++ )

             {

                 URL url = this.getClass().getClassLoader().getResource( pluginResourcesBase + "/" + resourceNames[i] );

                 FileUtils.copyURLToFile( url, new File( getReportOutputDirectory(), resourceNames[i] ) );

             }

         }

         catch ( IOException e )

         {

             throw new MavenReportException( "Unable to copy static resources." );

         }

     }

     public void executeReport( Locale locale )

         throws MavenReportException

     {

         if ( !xmlPath.exists() )

         {

             getLog().warn( "changes.xml file " + xmlPath.getAbsolutePath() + " does not exist." );

             return;

         }

         ChangesReportGenerator report = new ChangesReportGenerator( xmlPath, getLog() );

         report.setIssueLinksPerSystem( issueLinkTemplatePerSystem ); 

         report.setIssueLink( issueLinkTemplate );

         report.setUrl( url );

         report.setAddActionDate( addActionDate );

         if ( !report.canGenerateIssueLinks() )

         {

             getLog().warn( "No issue management URL defined in POM. Links to your issues will not work correctly." );

         }

         report.doGenerateReport( getBundle( locale ), getSink() );

         // Copy the images

         copyStaticResources();

     }

     public String getName( Locale locale )

     {

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

     }

     public String getDescription( Locale locale )

     {

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

     }

     public String getOutputName()

     {

         return "changes-report";

     }

     private ResourceBundle getBundle( Locale locale )

     {

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

     }

 }