/*
    * 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.
   */
  package org.apache.maven.plugins.war.packaging;
  
  import java.io.File;
  import java.util.List;
  
  import org.apache.maven.archiver.MavenArchiveConfiguration;
  import org.apache.maven.artifact.factory.ArtifactFactory;
  import org.apache.maven.execution.MavenSession;
  import org.apache.maven.plugin.logging.Log;
  import org.apache.maven.plugins.war.util.WebappStructure;
  import org.apache.maven.project.MavenProject;
  import org.apache.maven.shared.filtering.FilterWrapper;
  import org.apache.maven.shared.filtering.MavenFileFilter;
  import org.codehaus.plexus.archiver.jar.JarArchiver;
  import org.codehaus.plexus.archiver.manager.ArchiverManager;
  
  /**
   * The packaging context.
   *
   * @author Stephane Nicoll
   */
  public interface WarPackagingContext {
      /**
       * Returns the maven project.
       *
       * @return the project
       */
      MavenProject getProject();
  
      /**
       * Returns the webapp directory. Packaging tasks should use this directory to generate the webapp.
       *
       * @return the webapp directory
       */
      File getWebappDirectory();
  
      /**
       * Returns the main webapp source directory.
       *
       * @return the webapp source directory
       */
      File getWebappSourceDirectory();
  
      /**
       * Returns the webapp source includes.
       *
       * @return the webapp source includes
       */
      String[] getWebappSourceIncludes();
  
      /**
       * Returns {@code true} if empty directories should be includes, otherwise {@code false}
       *
       * @return {@code true} if empty directories should be includes, otherwise {@code false}
       */
      boolean isWebappSourceIncludeEmptyDirectories();
  
      /**
       * Returns the webapp source excludes.
       *
       * @return the webapp source excludes
       */
      String[] getWebappSourceExcludes();
  
      /**
       * Returns the directory holding generated classes.
       *
       * @return the classes directory
       */
      File getClassesDirectory();
  
      /**
       * Specify whether the classes resources should be archived in the {@code WEB-INF/lib} of the generated web app.
       *
       * @return true if the classes should be archived, false otherwise
       */
      boolean archiveClasses();
  
      /**
       * Returns the logger to use to output logging event.
       *
      * @return the logger
      */
     Log getLog();
 
     /**
      * Returns the directory to unpack dependent WARs into if needed.
      *
      * @return the overlays work directory
      */
     File getOverlaysWorkDirectory();
 
     /**
      * Returns the archiver manager to use.
      *
      * @return the archiver manager
      */
     ArchiverManager getArchiverManager();
 
     /**
      * The maven archive configuration to use.
      *
      * @return the maven archive configuration
      */
     MavenArchiveConfiguration getArchive();
 
     /**
      * Returns the Jar archiver needed for archiving classes directory into jar file under WEB-INF/lib.
      *
      * @return the jar archiver to user
      */
     JarArchiver getJarArchiver();
 
     /**
      * Returns the output file name mapping to use, if any. Returns {@code null} if no file name mapping is set.
      *
      * @return the output file name mapping or {@code null}
      */
     String getOutputFileNameMapping();
 
     /**
      * Returns the list of filter files to use.
      *
      * @return a list of filter files
      */
     List<String> getFilters();
 
     /**
      * Returns the {@link WebappStructure}.
      *
      * @return the webapp structure
      */
     WebappStructure getWebappStructure();
 
     /**
      * Returns the list of registered overlays for this session.
      *
      * @return the list of registered overlays, including the current project
      */
     List<String> getOwnerIds();
 
     /**
      * Returns the {@link MavenFileFilter} instance to use.
      *
      * @return the maven file filter to use
      * @since 2.1-alpha-2
      */
     MavenFileFilter getMavenFileFilter();
 
     /**
      * @return {@link List} of {@link FilterWrapper}
      * @since 2.1-alpha-2
      */
     List<FilterWrapper> getFilterWrappers();
 
     /**
      * Specify if the given {@code fileName} belongs to the list of extensions that must not be filtered
      *
      * @param fileName the name of file
      * @return {@code true} if it should not be filtered, {@code false} otherwise
      * @since 2.1-alpha-2
      */
     boolean isNonFilteredExtension(String fileName);
 
     /**
      * @return filtering deployment descriptor.
      */
     boolean isFilteringDeploymentDescriptors();
 
     /**
      * @return {@link ArtifactFactory}
      */
     ArtifactFactory getArtifactFactory();
 
     /**
      * Returns the Maven session.
      *
      * @return the Maven session
      * @since 2.2
      */
     MavenSession getSession();
 
     /**
      * Returns the encoding to use for resources.
      *
      * @return the resource encoding
      * @since 2.3
      */
     String getResourceEncoding();
 
     /**
      * Returns the encoding to use for resources that are properties files.
      *
      * @return the encoding for properties files
      * @since 3.4.0
      */
     String getPropertiesEncoding();
 
     /**
      * @return to use jvmChmod rather than forking chmod cli
      * @since 2.4
      */
     boolean isUseJvmChmod();
 
     /**
      * Returns the flag that switch on/off the missing web.xml validation
      *
      * @return failOnMissingWebXml
      */
     Boolean isFailOnMissingWebXml();
 
     /**
      * Add a live resource to the war.
      * Used to keep track of existing resources and all copied files.
      * All others are outdated and will be removed.
      * This prevent calling <code>mvn clean</code> when resources are removed.
      *
      * @param resource the resource that is to me marked as not outdated
      * @since 3.3.0
      * @see #deleteOutdatedResources()
      */
     void addResource(String resource);
 
     /**
      * Delete outdated resources, ie resources that are found in the war but that were not added by the current
      * packaging process, then are supposed to be content from a previous run.
      * This prevent calling <code>mvn clean</code> when resources are removed.
      *
      * @since 3.3.0
      * @see #addResource
      */
     void deleteOutdatedResources();
 
     /**
      * Output timestamp for reproducible archive creation.
      *
      * @return the output timestamp (may be null)
      * @since 3.3.0
      */
     String getOutputTimestamp();
 }