* Flexmojos is a set of maven goals to allow maven users to compile, optimize and test Flex SWF, Flex SWC, Air SWF and Air SWC.

* Copyright (C) 2008-2012  Marvin Froeder <marvin@flexmojos.net>

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program.  If not, see <http://www.gnu.org/licenses/>.

*/

    extends AbstractMavenMojo

    implements ICompilerConfiguration, IFramesConfiguration, ILicensesConfiguration, IMetadataConfiguration,

    IMxmlConfiguration, INamespacesConfiguration, IExtensionsConfiguration, Cacheable, Cloneable, FlexMojo,

    IRuntimeSharedLibrarySettingsConfiguration

    private static final Object lock = new Object();

    public static final String PROJECT_TYPE = "getProjectType";

    /**

     * Generate an accessible SWF

     * <p>

     * Equivalent to -compiler.accessible

     * </p>

     *

     * @parameter expression="${flex.accessible}"

     */

    private Boolean accessible;

    /**

     * Specifies actionscript file encoding. If there is no BOM in the AS3 source files, the compiler will use this file

     * encoding.

     * <p>

     * Equivalent to -compiler.actionscript-file-encoding

     * </p>

     *

     * @parameter expression="${flex.actionscriptFileEncoding}"

     */

    private String actionscriptFileEncoding;

    /**

     * DOCME undocumented by adobe

     * <p>

     * Equivalent to -compiler.adjust-opdebugline

     * </p>

     *

     * @parameter expression="${flex.adjustOpdebugline}"

     */

    private Boolean adjustOpdebugline;

    /**

     * If true, a style manager will add style declarations to the local style manager without checking to see if the

     * parent already has the same style selector with the same properties. If false, a style manager will check the

     * parent to make sure a style with the same properties does not already exist before adding one locally.<BR>

     * If there is no local style manager created for this application, then don't check for duplicates. Just use the

     * old "selector exists" test.

     * <p>

     * Equivalent to -compiler.allow-duplicate-style-declaration

     * </p>

     *

     * @parameter expression="${flex.allowDuplicateDefaultStyleDeclarations}"

     */

    private Boolean allowDuplicateDefaultStyleDeclarations;

    /**

     * checks if a source-path entry is a subdirectory of another source-path entry. It helps make the package names of

     * MXML components unambiguous.

     * <p>

     * Equivalent to -compiler.allow-source-path-overlap

     * </p>

     *

     * @parameter expression="${flex.allowSourcePathOverlap}"

     */

    private Boolean allowSourcePathOverlap;

    /**

     * Override the application domain an RSL is loaded into. The supported values are 'current', 'default', 'parent',

     * or 'top-level'

     * <p>

     * Equivalent to -runtime-shared-library-settings.application-domains

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;applicationDomains&gt;

     *   &lt;applicationDomain&gt;

     *     &lt;pathElement&gt;path&lt;/pathElement&gt;

     *     &lt;applicationDomain&gt;current&lt;/applicationDomain&gt;

     *   &lt;/applicationDomain&gt;

     *   &lt;applicationDomain&gt;

     *     &lt;pathElement&gt;path&lt;/pathElement&gt;

     *     &lt;applicationDomain&gt;default&lt;/applicationDomain&gt;

     *   &lt;/applicationDomain&gt;

     * &lt;/applicationDomains&gt;

     * </pre>

     *

     * @parameter

     */

    private MavenApplicationDomains[] applicationDomains;

    /**

     * DOCME undocumented by adobe

     * <p>

     * Equivalent to -compiler.archive-classes-and-assets

     * </p>

     *

     * @parameter expression="${flex.archiveClassesAndAssets}"

     */

    private Boolean archiveClassesAndAssets;

    /**

     * Use the ActionScript 3 class based object model for greater performance and better error reporting. In the class

     * based object model most built-in functions are implemented as fixed methods of classes

     * <p>

     * Equivalent to -compiler.as3

     * </p>

     *

     * @parameter expression="${flex.as3}"

     */

    private Boolean as3;

    /**

     * Output performance benchmark

     * <p>

     * Equivalent to -benchmark

     * </p>

     *

     * @parameter expression="${flex.benchmark}"

     */

    protected Boolean benchmark;

    /**

     * DOCME undocumented by adobe

     * <p>

     * Equivalent to -benchmark-compiler-details

     * </p>

     * 0 = none, 1 = light, 5 = verbose

     *

     * @parameter expression="${flex.benchmarkCompilerDetails}"

     */

    private Integer benchmarkCompilerDetails;

    /**

     * DOCME undocumented by adobe

     * <p>

     * Equivalent to -benchmark-time-filter

     * </p>

     * min time of units to log in ms

     *

     * @parameter expression="${flex.benchmarkTimeFilter}"

     */

    private Long benchmarkTimeFilter;

    /**

     * Classifier to add to the artifact generated. If given, the artifact will be an attachment instead.

     *

     * @parameter expression="${flex.classifier}"

     */

    protected String classifier;

    /**

     * Specifies a compatibility version

     * <p>

     * Equivalent to -compiler.mxml.compatibility-version

     * </p>

     *

     * @parameter expression="${flex.compatibilityVersion}"

     */

    private String compatibilityVersion;

    /**

     * @component

     * @readonly

     */

    protected net.flexmojos.oss.compiler.FlexCompiler compiler;

    /**

     * A list of warnings that should be enabled/disabled

     * <p>

     * Equivalent to -compiler.show-actionscript-warnings, -compiler.show-binding-warnings,

     * -compiler.show-shadowed-device-font-warnings, -compiler.show-unused-type-selector-warnings and -compiler.warn-*

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;compilerWarnings&gt;

     *   &lt;show-actionscript-warnings&gt;true&lt;/show-actionscript-warnings&gt;

     *   &lt;warn-bad-nan-comparison&gt;false&lt;/warn-bad-nan-comparison&gt;

     * &lt;/compilerWarnings&gt;

     * </pre>

     *

     * @parameter

     */

    private final Map<String, String> compilerWarnings = new LinkedHashMap<String, String>();

    /**

     * The maven compile source roots

     * <p>

     * Equivalent to -compiler.source-path

     * </p>

     * List of path elements that form the roots of ActionScript class

     *

     * @parameter expression="${project.compileSourceRoots}"

     * @required

     * @readonly

     */

    private List<String> compileSourceRoots;

    /**

     * DOCME Guess what, undocumented by adobe.

     * <p>

     * Equivalent to -compiler.compress

     * </p>

     *

     * @parameter expression="${flex.compress}"

     */

    private Boolean compress;

    /**

     * DOCME undocumented by adobe

     * <p>

     * Equivalent to -compiler.conservative

     * </p>

     * compiler algorithm settings

     *

     * @parameter expression="${flex.conservative}"

     */

    private Boolean conservative;

    /**

     * Path to replace {context.root} tokens for service channel endpoints

     * <p>

     * Equivalent to -compiler.context-root

     * </p>

     *

     * @parameter expression="${flex.contextRoot}"

     */

    private String contextRoot;

    /**

     * Generates a movie that is suitable for debugging

     * <p>

     * Equivalent to -compiler.debug

     * </p>

     *

     * @parameter expression="${flex.debug}"

     */

    private Boolean debug;

    /**

     * The password to include in debuggable SWFs

     * <p>

     * Equivalent to -debug-password

     * </p>

     *

     * @parameter expression="${flex.debugPassword}"

     */

    protected String debugPassword;

    /**

     * Default background color (may be overridden by the application code)

     * <p>

     * Equivalent to -default-background-color

     * </p>

     *

     * @parameter expression="${flex.defaultBackgroundColor}"

     */

    private Integer defaultBackgroundColor;

    /**

     * Default frame rate to be used in the SWF

     * <p>

     * Equivalent to -default-frame-rate

     * </p>

     *

     * @parameter expression="${flex.defaultFrameRate}"

     */

    private Integer defaultFrameRate;

    /**

     * Default value of resourceBundleList used when it is not defined

     *

     * @parameter default-value= "${project.build.directory}/${project.build.finalName}-rb.properties"

     * @readonly

     */

    private File defaultResourceBundleList;

    /**

     * Default script execution limits (may be overridden by root attributes)

     * <p>

     * Equivalent to -default-script-limits

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;defaultScriptLimits&gt;

     *   &lt;maxExecutionTime&gt;???&lt;/maxExecutionTime&gt;

     *   &lt;maxRecursionDepth&gt;???&lt;/maxRecursionDepth&gt;

     * &lt;/defaultScriptLimits&gt;

     * </pre>

     *

     * @parameter

     */

    private MavenDefaultScriptLimits defaultScriptLimits;

    /**

     * Location of defaults style stylesheets

     * <p>

     * Equivalent to -compiler.defaults-css-url

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;defaultsCssFiles&gt;

     *   &lt;defaultsCssFile&gt;???&lt;/defaultsCssFile&gt;

     *   &lt;defaultsCssFile&gt;???&lt;/defaultsCssFile&gt;

     * &lt;/defaultsCssFiles&gt;

     * </pre>

     *

     * @parameter

     */

    private File[] defaultsCssFiles;

    /**

     * Defines the location of the default style sheet. Setting this option overrides the implicit use of the

     * defaults.css style sheet in the framework.swc file

     * <p>

     * Equivalent to -compiler.defaults-css-url

     * </p>

     *

     * @parameter expression="${flex.defaultsCssUrl}"

     */

    private String defaultsCssUrl;

    /**

     * Default application size (may be overridden by root attributes in the application)

     * <p>

     * Equivalent to -default-size

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;defaultSize&gt;

     *   &lt;height&gt;???&lt;/height&gt;

     *   &lt;width&gt;???&lt;/width&gt;

     * &lt;/defaultSize&gt;

     * </pre>

     *

     * @parameter

     */

    private MavenDefaultSize defaultSize;

    /**

     * Define a global AS3 conditional compilation definition, e.g. -define=CONFIG::debugging,true or

     * -define+=CONFIG::debugging,true (to append to existing definitions in flex-config.xml)

     * <p>

     * Equivalent to -compiler.define

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;defines&gt;

     *   &lt;property&gt;

     *     &lt;name&gt;SOMETHING::aNumber&lt;/name&gt;

     *     &lt;value&gt;2.2&lt;/value&gt;

     *   &lt;/property&gt;

     *   &lt;property&gt;

     *     &lt;name&gt;SOMETHING::aString&lt;/name&gt;

     *     &lt;value&gt;&quot;text&quot;&lt;/value&gt;

     *   &lt;/property&gt;

     * &lt;/defines&gt;

     * </pre>

     *

     * @parameter

     */

    private Properties defines;

    /**

     * Back-door to disable optimizations in case they are causing problems

     * <p>

     * Equivalent to -compiler.disable-incremental-optimizations

     * </p>

     *

     * @parameter expression="${flex.disableIncrementalOptimizations}"

     */

    private Boolean disableIncrementalOptimizations;

    /**

     * DOCME undocumented

     * <p>

     * Equivalent to -compiler.doc

     * </p>

     *

     * @parameter expression="${flex.doc}"

     */

    private Boolean doc;

    /**

     * Write a file containing all currently set configuration values in a format suitable for use as a flex config file

     * <p>

     * Equivalent to -dump-config

     * </p>

     *

     * @parameter expression="${flex.dumpConfig}"

     */

    private boolean dumpConfigAttach;

    /**

     * DOCME undocumented by adobe

     * <p>

     * Equivalent to -compiler.enable-runtime-design-layers

     * </p>

     *

     * @parameter expression="${flex.enableRuntimeDesignLayers}"

     */

    private Boolean enableRuntimeDesignLayers;

    /**

     * DOCME undocumented by adobe

     * <p>

     * Equivalent to -compiler.enable-swc-version-filtering

     * </p>

     *

     * @parameter expression="${flex.enableSwcVersionFiltering}"

     */

    private Boolean enableSwcVersionFiltering;

    /**

     * Use the ECMAScript edition 3 prototype based object model to allow dynamic overriding of prototype properties. In

     * the prototype based object model built-in functions are implemented as dynamic properties of prototype objects

     * <p>

     * Equivalent to -compiler.es

     * </p>

     *

     * @parameter expression="${flex.es}"

     */

    private Boolean es;

    /**

     * Configure extensions to flex compiler

     * <p>

     * Equivalent to -compiler.extensions.extension

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;extensions&gt;

     *   &lt;extension&gt;

     *     &lt;extensionArtifact&gt;

     *       &lt;groupId&gt;org.myproject&lt;/groupId&gt;

     *       &lt;artifactId&gt;my-extension&lt;/artifactId&gt;

     *       &lt;version&gt;1.0&lt;/version&gt;

     *     &lt;/extensionArtifact&gt;

     *     &lt;parameters&gt;

     *       &lt;parameter&gt;param1&lt;/parameter&gt;

     *       &lt;parameter&gt;param2&lt;/parameter&gt;

     *       &lt;parameter&gt;param3&lt;/parameter&gt;

     *     &lt;/parameters&gt;

     *   &lt;/extension&gt;

     * &lt;/extensions&gt;

     * </pre>

     *

     * @parameter

     */

    private MavenExtension[] extensions;

    /**

     * A list of symbols to omit from linking when building a SWF

     * <p>

     * Equivalent to -externs

     * </p>

     * Usage:

     *

     * <pre>

     * &lt;externs&gt;

     *   &lt;extern&gt;???&lt;/extern&gt;

     *   &lt;extern&gt;???&lt;/extern&gt;

     * &lt;/externs&gt;

     * </pre>

     *

     * @parameter

     */

    private String[] externs;