org.apache.royale.compiler.clients

Class JSConfiguration

java.lang.Object

org.apache.royale.compiler.config.Configuration

org.apache.royale.compiler.clients.JSConfiguration

Direct Known Subclasses:

JSGoogCompcConfiguration, JSGoogConfiguration

public class JSConfiguration
extends Configuration

The JSConfiguration class holds all compiler arguments needed for compiling ActionScript to JavaScript.

Specific flags are implemented here for the configuration to be loaded by the configure() method of MXMLJSC.

This class inherits all compiler arguments from the MXMLC compiler.

Author:

Michael Schmalle

Field Summary

Fields

Modifier and Type	Field and Description
protected List<String>	targets

Fields inherited from class org.apache.royale.compiler.config.Configuration

AIR_HOME_TOKEN, AS3, date, dateFormat, DEFAULT_OUTPUT_DIRECTORY_TOKEN, ES, FLEX_VERSION_TOKEN, includeFilesNamePath, langs, locales, MXML_CURRENT_VERSION, MXML_EARLIEST_MAJOR_VERSION, MXML_LATEST_MAJOR_VERSION, MXML_LATEST_MINOR_VERSION, MXML_VERSION_2_0, MXML_VERSION_2_0_1, MXML_VERSION_3_0, MXML_VERSION_4_0, MXML_VERSION_4_5, MXML_VERSION_4_6, MXML_VERSION_4_7, PLAYERGLOBAL_HOME_TOKEN, reportMissingCompilerLibraries, reportMissingCompilerSwfLibraries, STRICT, SWC_AIRGLOBAL, TARGET_PLAYER_MAJOR_VERSION_MIN, TARGET_PLAYER_MINOR_VERSION_MIN

Constructor Summary

Constructors

Constructor and Description
JSConfiguration()

Method Summary

Modifier and Type	Method and Description
List<String>	getCompilerJsExternalLibraryPath()
List<String>	getCompilerJsLibraryPath()
List<MXMLNamespaceMapping>	getCompilerJsNamespacesManifestMappings()
List<String>	getCompilerTargets()
Map<String,String>	getJsCompilerDefine()
boolean	getJsComplexImplicitCoercions()
boolean	getJsDefaultInitializers()
boolean	getJsDynamicAccessUnknownMembers()
String	getJsLoadConfig()
boolean	getJsResolveUncertain()
String	getJsVectorEmulationClass()
boolean	getJsVectorIndexChecks()
String	getJsxFactory()
String	getModuleOutput() if used, the js-debug and js-release folders are calculated by removing the folders specified from the output folder.
String	getOutput()
boolean	getSourceMap()
void	setCompilerJsExternalLibraryPath(ConfigurationValue cv, String[] pathlist)
void	setCompilerJsLibraryPath(ConfigurationValue cv, String[] pathlist) Links SWC files to the resulting application SWF file.
void	setCompilerJsNamespacesNamespace(ConfigurationValue cfgval, List<String> args) Configures a list of many manifests mapped to a single namespace URI.
void	setCompilerTargets(ConfigurationValue cv, String[] targetlist) The list of compiler outputs to generate
void	setJsCompilerDefine(ConfigurationValue cv, String name, String value)
void	setJsComplexImplicitCoercions(ConfigurationValue cv, boolean value) Support for including/avoiding more complex implicit assignment coercions example var array:Array = [new MyClass()]; var myOtherClass:MyOtherClass = array[0]; In the above example, the compiler will (by default) output an implicit coercion that is equivalent in actionscript to: var myOtherClass:MyOtherClass = MyOtherClass(array[0]); By setting this configuration option to false, the implicit coercion code in situations similar to the above is not generated (other primitive implicit coercions, such as int/uint/Number/String and Boolean coercions remain) This is a global setting for the current source code being compiled, it is possible to leave it on and specifically avoid it via doc settings.
void	setJsDefaultInitializers(ConfigurationValue cv, boolean value)
void	setJsDynamicAccessUnknownMembers(ConfigurationValue cv, boolean value) If the definition of a member cannot be resolved, emit dynamic access instead of normal member access.
void	setJsLoadConfig(ConfigurationValue cv, String filename) Placeholder.
void	setJsOutput(ConfigurationValue val, String output)
void	setJSOutputType(ConfigurationValue cv, String value)
void	setJsResolveUncertain(ConfigurationValue cv, boolean value) Support for avoiding more overhead of resolving instantiations from unknown constructors example var myClass:Class = String; var myString:* = new myClass("test"); In the above example, the compiler will (by default) output a call to a Language.resolveUncertain method which wraps the 'new myClass("test")' This normalizes the return value for some primitive constructors, so that (for example) strict equality and inequality operators provide the same results between compiler targets.
void	setJsVectorEmulationClass(ConfigurationValue cv, String b) The class to use instead of default Vector implementation for handling Vector.
void	setJsVectorIndexChecks(ConfigurationValue cv, boolean value) Support for avoiding more overhead of adding checks into assignments via Vector index access example var myVector:Vector. = new Vector.(); myVector[0] = 42; In the above example, the compiler will (by default) wrap the '0' inside myVector[0] with a method call on the vector instance that checks to see if the index is valid for the Vector it is being used against This check will throw an error if the index is out of range, and the range checking differs if the Vector is 'fixed' or non-'fixed' In situations where it is certain that the index will always be valid for Vector instance being targeted, or where all cases in a given codebase are certain to be valid, it is possible to avoid the overhead of this check.
void	setJsxFactory(ConfigurationValue cv, String value) Customize the factory to use for JSX.
void	setModuleOutput(ConfigurationValue val, String output)
void	setSourceMap(ConfigurationValue cv, boolean value)

Methods inherited from class org.apache.royale.compiler.config.Configuration

addThemeCssFiles, assertThatAllPathsAreDirectories, csetCompilerWarnDuplicateVariableDef, debug, expandTokens, expandTokens, getAdjustOpDebugLine, getAliases, getAllowSourcePathOverlap, getApiReport, getApplicationDomain, getBindingEventHandlerClass, getBindingEventHandlerEvent, getBindingEventHandlerInterface, getBindingValueChangeEvent, getBindingValueChangeEventKind, getBindingValueChangeEventType, getByteArrayEmbedClass, getCompilerAccessible, getCompilerActionscriptFileEncoding, getCompilerAllowAbstractClasses, getCompilerAllowImportAliases, getCompilerAllowPrivateConstructors, getCompilerAllowPrivateNameConflicts, getCompilerAllowSubclassOverrides, getCompilerCompatibilityVersion, getCompilerCompatibilityVersionString, getCompilerContextRoot, getCompilerDefaultsCssUrl, getCompilerDefine, getCompilerDoc, getCompilerExternalLibraryPath, getCompilerGenerateAbstractSyntaxTree, getCompilerGeneratedDirectory, getCompilerIncludeLibraries, getCompilerInfoFlex, getCompilerIsolateStyles, getCompilerKeepAs3Metadata, getCompilerLibraryPath, getCompilerLocales, getCompilerMinimumSupportedVersion, getCompilerMinimumSupportedVersionString, getCompilerMxmlChildrenAsData, getCompilerMxmlCompatibilityVersion, getCompilerMxmlCompatibilityVersionString, getCompilerMxmlImplicitImports, getCompilerMxmlMajorCompatibilityVersion, getCompilerMxmlMinimumSupportedVersion, getCompilerMxmlMinimumSupportedVersionString, getCompilerMxmlMinorCompatibilityVersion, getCompilerMxmlRevisionCompatibilityVersion, getCompilerNamespacesManifestMappings, getCompilerOptimize, getCompilerPreloader, getCompilerResourceBundlePathForLocale, getCompilerServices, getCompilerSourcePath, getCompilerSourcePathInfo, getCompilerStrictIdentifierNames, getCompilerSwfExternalLibraryPath, getCompilerSwfLibraryPath, getCompilerThemeCssFiles, getCompilerThemeFiles, getCompilingForAIR, getComponentFactoryClass, getComponentFactoryInterface, getConfigurationProblems, getCreateTargetWithErrors, getDebugPassword, getDefaultBackgroundColor, getDefaultFrameRate, getDefaultHeight, getDefaultsCSSFiles, getDefaultWidth, getDependencyGraphOutput, getDiagnosticsLevel, getDumpConfig, getEnableRuntimeDesignLayers, getEnableSwcVersionFiltering, getErrorProblems, getExcludeDefaultsCSSFiles, getExterns, getFileSpecs, getForceRsls, getFrameList, getFxgBaseClass, getIgnoreProblems, getIncludeClasses, getIncludeFiles, getIncludeInheritanceDependenciesOnly, getIncludeLookupOnly, getIncludeNamespaces, getIncludeResourceBundles, getIncludes, getIncludeSources, getIncludeStyleSheets, getLinkReport, getLoadConfig, getLocaleDependentSources, getMainDefinition, getMetadataDate, getMetadataDateFormat, getMobile, getOutputPath, getOutputSwcAsDirectory, getPreloader, getProxyBaseClass, getRawMetadata, getRemoveDeadCode, getRemoveUnusedRsls, getReportInvalidStylesAsWarnings, getResourceBundleList, getRslExcludedLibraries, getRslPathInfo, getRuntimeSharedLibraries, getScriptRecursionLimit, getScriptTimeLimit, getShowInvalidCSSPropertyWarnings, getSizeReport, getStatesClass, getStatesEventOverrideClass, getStatesInstanceOverrideClass, getStatesPropertyOverrideClass, getStatesStyleOverrideClass, getStaticLinkRsl, getSwfDebugfileAlias, getSwfVersion, getTargetFile, getTargetFileDirectory, getTargetPlayerMajorVersion, getTargetPlayerMinorVersion, getTargetPlayerRevision, getToolsLocale, getUseDirectBlit, getUseFlashBuilderProjectFiles, getUseGpu, getUseNetwork, getVerifyDigests, getWarningProblems, getWarnings, getWarnOnRoyaleOnlyOptionUsage, isCompilerMxmlMinimumSupportedVersionConfigured, isDebuggingEnabled, isDumpAst, isEnableTelemetry, isExcludeNativeJSLibraries, isHeadlessServer, isInliningEnabled, isRoyale, isStrictXML, isVerbose, keepAllTypeSelectors, metadataExport, omitTraceStatements, optimize, release, reportMissingRequiredSkinPartsAsWarnings, resolvePathStrict, scriptLimitsSet, setApiReport, setApplicationDomain, setAS3, setBenchmark, setCompilerAccessible, setCompilerActionscriptFileEncoding, setCompilerAdjustOpdebugline, setCompilerAllowAbstractClasses, setCompilerAllowImportAliases, setCompilerAllowPrivateConstructors, setCompilerAllowPrivateNameConflicts, setCompilerAllowSourcePathOverlap, setCompilerAllowSubclassOverrides, setCompilerBindingEventHandlerClass, setCompilerBindingEventHandlerEvent, setCompilerBindingEventHandlerInterface, setCompilerBindingValueChangeEvent, setCompilerBindingValueChangeEventKind, setCompilerBindingValueChangeEventType, setCompilerByteArrayEmbedClass, setCompilerComponentFactoryClass, setCompilerComponentFactoryInterface, setCompilerConservative, setCompilerContextRoot, setCompilerDebug, setCompilerDefaultsCssUrl, setCompilerDefine, setCompilerDoc, setCompilerEnableRuntimeDesignLayers, setCompilerEnableSwcVersionFiltering, setCompilerExternalLibraryPath, setCompilerFontsAdvancedAntiAliasing, setCompilerFontsLanguagesLanguageRange, setCompilerFontsLocalFontPaths, setCompilerFontsLocalFontsSnapshot, setCompilerFontsManagers, setCompilerFontsMaxCachedFonts, setCompilerFontsMaxGlyphsPerFace, setCompilerFxgBaseClass, setCompilerGenerateAbstractSyntaxTree, setCompilerGeneratedDirectory, setCompilerHeadlessServer, setCompilerIncludeLibraries, setCompilerIncremental, setCompilerInfoFlex, setCompilerIsolateStyles, setCompilerKeepAllTypeSelectors, setCompilerKeepAs3Metadata, setCompilerKeepGeneratedActionscript, setCompilerKeepGeneratedSignatures, setCompilerLibraryPath, setCompilerLocale, setCompilerMetadataExport, setCompilerMinimumSupportedVersion, setCompilerMxmlChildrenAsData, setCompilerMxmlCompatibilityVersion, setCompilerMxmlImplicitImports, setCompilerMxmlMinimumSupportedVersion, setCompilerMxmlMinimumSupportedVersion, setCompilerMxmlQualifiedTypeSelectors, setCompilerNamespacesNamespace, setCompilerOmitTraceStatements, setCompilerOptimize, setCompilerPreloader, setCompilerProxyBaseClass, setCompilerReportInvalidStylesAsWarnings, setCompilerReportMissingRequiredSkinPartsAsWarnings, setCompilerServices, setCompilerShowActionscriptWarnings, setCompilerShowBindingWarnings, setCompilerShowDependencyWarnings, setCompilerShowDeprecationWarnings, setCompilerShowMultipleDefinitionWarnings, setCompilerShowShadowedDeviceFontWarnings, setCompilerShowUnusedTypeSelectorWarnings, setCompilerSourcePath, setCompilerStatesClass, setCompilerStatesEventOverrideClass, setCompilerStatesInstanceOverrideClass, setCompilerStatesPropertyOverrideClass, setCompilerStatesStyleOverrideClass, setCompilerStrict, setCompilerStrictIdentifierNames, setCompilerSuppressWarningsInIncremental, setCompilerSwfExternalLibraryPath, setCompilerSwfLibraryPath, setCompilerTheme, setCompilerUseResourceBundleMetadata, setCompilerVerboseStacktraces, setCompilerWarnArrayTostringChanges, setCompilerWarnAssignmentWithinConditional, setCompilerWarnBadArrayCast, setCompilerWarnBadBoolAssignment, setCompilerWarnBadDateCast, setCompilerWarnBadEs3TypeMethod, setCompilerWarnBadEs3TypeProp, setCompilerWarnBadNanComparison, setCompilerWarnBadNullAssignment, setCompilerWarnBadNullComparison, setCompilerWarnBadUndefinedComparison, setCompilerWarnBooleanConstructorWithNoArgs, setCompilerWarnChangesInResolve, setCompilerWarnClassIsSealed, setCompilerWarnConstNotInitialized, setCompilerWarnConstructorReturnsValue, setCompilerWarnDeprecatedEventHandlerError, setCompilerWarnDeprecatedFunctionError, setCompilerWarnDeprecatedPropertyError, setCompilerWarnDuplicateArgumentNames, setCompilerWarnForVarInChanges, setCompilerWarnImportHidesClass, setCompilerWarnInstanceOfChanges, setCompilerWarnInternalError, setCompilerWarnLevelNotSupported, setCompilerWarnMissingNamespaceDecl, setCompilerWarnNegativeUintLiteral, setCompilerWarnNoConstructor, setCompilerWarnNoExplicitSuperCallInConstructor, setCompilerWarnNoTypeDecl, setCompilerWarnNumberFromStringChanges, setCompilerWarnScopingChangeInThis, setCompilerWarnSlowTextFieldAddition, setCompilerWarnThisWithinClosure, setCompilerWarnUnlikelyFunctionValue, setCompilerWarnXmlClassHasChanged, setCompress, setComputeDigest, setCreateTargetWithErrors, setDebug, setDebugPassword, setDefaultBackgroundColor, setDefaultFrameRate, setDefaultScriptLimits, setDefaultsCSSFiles, setDefaultSize, setDependencyGraphOutput, setDiagnostics, setDumpAst, setDumpConfig, setEnableInlining, setEnableTelemetry, setEnableTelemetry, setErrorProblems, setES, setExcludeDefaultsCSSFiles, setExcludeNativeJSLibraries, setExtension, setExterns, setFileSpecs, setForceRsls, setFramesFrame, setFramework, setHelp, setIgnoreProblems, setIncludeClasses, setIncludeFiles, setIncludeInheritanceDependenciesOnly, setIncludeLookupOnly, setIncludeNamespaces, setIncludeResourceBundles, setIncludes, setIncludeSources, setIncludeStyleSheets, setLegacyMessageFormat, setLicensesLicense, setLinkReport, setLoadConfig, setLoadExterns, setMainDefinition, setMetadataContributor, setMetadataCreator, setMetadataDate, setMetadataDateFormat, setMetadataDescription, setMetadataLanguage, setMetadataLocalizedDescription, setMetadataLocalizedTitle, setMetadataPublisher, setMetadataTitle, setMobile, setOutput, setOutputSwcAsDirectory, setOverrideStaticLinkRsl, setPathResolver, setRawMetadata, setRemoveDeadCode, setRemoveUnusedRsls, setReportMissingCompilerLibraries, setReportMissingCompilerSwfLibraries, setResourceBundleList, setRoyale, setRuntimeSharedLibraries, setRuntimeSharedLibraryPath, setShowInvalidCssPropertyWarnings, setSizeReport, setStaticLinkRuntimeSharedLibraries, setStrictXML, setStrictXML, setSwfDebugfileAlias, setSwfVersion, setTargetFile, setTargetPlayer, setToolsLocale, setUseDirectBlit, setUseFlashBuilderProjectFiles, setUseGpu, setUseNetwork, setVerbose, setVerifyDigests, setVersion, setWarningProblems, setWarnings, setWarnOnRoyaleOnlyOptionUsage, showBindingWarnings, showDependencyWarnings, showDeprecationWarnings, showMultipleDefinitionWarnings, showUnusedTypeSelectorWarnings, strict, suppressWarningsInIncremental, useCompression, useConservativeAlgorithm, useLegacyMessageFormat, validate, validateNoCompcOnlyOptions, warn_array_tostring_changes, warn_assignment_within_conditional, warn_bad_array_cast, warn_bad_bool_assignment, warn_bad_date_cast, warn_bad_es3_type_method, warn_bad_es3_type_prop, warn_bad_nan_comparison, warn_bad_null_assignment, warn_bad_null_comparison, warn_bad_undefined_comparison, warn_boolean_constructor_with_no_args, warn_changes_in_resolve, warn_class_is_sealed, warn_const_not_initialized, warn_constructor_returns_value, warn_deprecated_event_handler_error, warn_deprecated_function_error, warn_deprecated_property_error, warn_duplicate_argument_names, warn_duplicate_variable_def, warn_for_var_in_changes, warn_import_hides_class, warn_instance_of_changes, warn_internal_error, warn_level_not_supported, warn_missing_namespace_decl, warn_negative_uint_literal, warn_no_constructor, warn_no_explicit_super_call_in_constructor, warn_no_type_decl, warn_number_from_string_changes, warn_scoping_change_in_this, warn_slow_text_field_addition, warn_this_within_closure, warn_unlikely_function_value, warn_xml_class_has_changed, warnings

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

targets

protected final List<String> targets

Constructor Detail

JSConfiguration

public JSConfiguration()

Method Detail

getCompilerTargets

public List<String> getCompilerTargets()

setCompilerTargets

public void setCompilerTargets(ConfigurationValue cv,
                               String[] targetlist)

The list of compiler outputs to generate

setJSOutputType

public void setJSOutputType(ConfigurationValue cv,
                            String value)
                     throws ConfigurationException

Throws:

ConfigurationException

getSourceMap

public boolean getSourceMap()

setSourceMap

public void setSourceMap(ConfigurationValue cv,
                         boolean value)
                  throws ConfigurationException

Throws:

ConfigurationException

getJsDefaultInitializers

public boolean getJsDefaultInitializers()

setJsDefaultInitializers

public void setJsDefaultInitializers(ConfigurationValue cv,
                                     boolean value)
                              throws ConfigurationException

Throws:

ConfigurationException

getJsDynamicAccessUnknownMembers

public boolean getJsDynamicAccessUnknownMembers()

setJsDynamicAccessUnknownMembers

public void setJsDynamicAccessUnknownMembers(ConfigurationValue cv,
                                             boolean value)
                                      throws ConfigurationException

If the definition of a member cannot be resolved, emit dynamic access instead of normal member access. Ensures that dynamic members aren't renamed. myObject.memberAccess becomes myObject["memberAccess"]

Throws:

ConfigurationException

getCompilerJsExternalLibraryPath

public List<String> getCompilerJsExternalLibraryPath()

setCompilerJsExternalLibraryPath

public void setCompilerJsExternalLibraryPath(ConfigurationValue cv,
                                             String[] pathlist)
                                      throws ConfigurationException

Throws:

ConfigurationException

getCompilerJsLibraryPath

public List<String> getCompilerJsLibraryPath()

setCompilerJsLibraryPath

public void setCompilerJsLibraryPath(ConfigurationValue cv,
                                     String[] pathlist)
                              throws ConfigurationException.CannotOpen

Links SWC files to the resulting application SWF file. The compiler only links in those classes for the SWC file that are required. You can specify a directory or individual SWC files.

Throws:

ConfigurationException.CannotOpen

getJsCompilerDefine

public Map<String,String> getJsCompilerDefine()

Returns:

A list of ConfigVars

setJsCompilerDefine

public void setJsCompilerDefine(ConfigurationValue cv,
                                String name,
                                String value)
                         throws ConfigurationException

Throws:

ConfigurationException

getOutput

public String getOutput()

Overrides:

getOutput in class Configuration

setJsOutput

public void setJsOutput(ConfigurationValue val,
                        String output)
                 throws ConfigurationException

Throws:

ConfigurationException

getJsLoadConfig

public String getJsLoadConfig()

Returns:

JS equivalent of -load-config

getModuleOutput

public String getModuleOutput()

if used, the js-debug and js-release folders are calculated by removing the folders specified from the output folder. This is useful in some cases when using module that are in the same source path as the main app as opposed to being in separate projects. For example in TourDeFlex, the main app is in the src folder, and a module example may be in src/mx/controls/ such as mx/controls/ButtonExample.mxml. Without this options, the output might end up in src/mx/controls/bin/js-debug and src/mx/controls/bin/js-release when it would be better if the output was relative to the main app and go in bin/js-debug/mx/controls and bin/js-release/mx/controls. Even specifying js-output doesn't work as setting it to the main app's bin folder would result in the output .JS going in the same folder as the main app instead of being nested in mx/controls. So, by setting this option to mx/controls, the compiler will calculate the desired folder structure.

setModuleOutput

public void setModuleOutput(ConfigurationValue val,
                            String output)
                     throws ConfigurationException

Throws:

ConfigurationException

setJsLoadConfig

public void setJsLoadConfig(ConfigurationValue cv,
                            String filename)
                     throws ConfigurationException

Placeholder. MXMLJSC picks off these values and changes them to load-config for the JS compilers

Throws:

ConfigurationException

getCompilerJsNamespacesManifestMappings

public List<MXMLNamespaceMapping> getCompilerJsNamespacesManifestMappings()

setCompilerJsNamespacesNamespace

public void setCompilerJsNamespacesNamespace(ConfigurationValue cfgval,
                                             List<String> args)
                                      throws ConfigurationException

Configures a list of many manifests mapped to a single namespace URI. library:adobe/flex/something something-manifest.xml something-else-manifest.xml ...

Parameters:

cfgval - The configuration value context.

args - A List of values for the namespace element, with the first item expected to be the uri and the remaining are manifest paths.

Throws:

ConfigurationException

getJsVectorEmulationClass

public String getJsVectorEmulationClass()

setJsVectorEmulationClass

public void setJsVectorEmulationClass(ConfigurationValue cv,
                                      String b)

The class to use instead of default Vector implementation for handling Vector.

getJsComplexImplicitCoercions

public boolean getJsComplexImplicitCoercions()

setJsComplexImplicitCoercions

public void setJsComplexImplicitCoercions(ConfigurationValue cv,
                                          boolean value)
                                   throws ConfigurationException

Support for including/avoiding more complex implicit assignment coercions example var array:Array = [new MyClass()]; var myOtherClass:MyOtherClass = array[0]; In the above example, the compiler will (by default) output an implicit coercion that is equivalent in actionscript to: var myOtherClass:MyOtherClass = MyOtherClass(array[0]); By setting this configuration option to false, the implicit coercion code in situations similar to the above is not generated (other primitive implicit coercions, such as int/uint/Number/String and Boolean coercions remain) This is a global setting for the current source code being compiled, it is possible to leave it on and specifically avoid it via doc settings. The doc comment compiler directive for that is: @royalesuppresscompleximplicitcoercion Another option is to add the explicit coercions in code and then avoid their output via specific @royaleignorecoercion doc comment directives. Doing so however may add extra unwanted output in other compiler targets (for example, swf bytecode) if the same source code is shared between targets.

Throws:

ConfigurationException

getJsResolveUncertain

public boolean getJsResolveUncertain()

setJsResolveUncertain

public void setJsResolveUncertain(ConfigurationValue cv,
                                  boolean value)
                           throws ConfigurationException

Support for avoiding more overhead of resolving instantiations from unknown constructors example var myClass:Class = String; var myString:* = new myClass("test"); In the above example, the compiler will (by default) output a call to a Language.resolveUncertain method which wraps the 'new myClass("test")' This normalizes the return value for some primitive constructors, so that (for example) strict equality and inequality operators provide the same results between compiler targets. In situations where it is certain that the resolveUncertain method is not needed, this option provides a way to switch it off 'globally' for the current source code being compiled. It can also be switched off or on locally using the '@royalesuppressresolveuncertain' doc comment compiler directive.

Throws:

ConfigurationException

getJsVectorIndexChecks

public boolean getJsVectorIndexChecks()

setJsVectorIndexChecks

public void setJsVectorIndexChecks(ConfigurationValue cv,
                                   boolean value)
                            throws ConfigurationException

Support for avoiding more overhead of adding checks into assignments via Vector index access example var myVector:Vector. = new Vector.(); myVector[0] = 42; In the above example, the compiler will (by default) wrap the '0' inside myVector[0] with a method call on the vector instance that checks to see if the index is valid for the Vector it is being used against This check will throw an error if the index is out of range, and the range checking differs if the Vector is 'fixed' or non-'fixed' In situations where it is certain that the index will always be valid for Vector instance being targeted, or where all cases in a given codebase are certain to be valid, it is possible to avoid the overhead of this check. This is especially important in loops. This config setting affects the global setting for the current source code being compiled. It can be adjusted locally within code, using the '@royalesuppressvectorindexcheck' doc comment compiler directive.

Throws:

ConfigurationException

getJsxFactory

public String getJsxFactory()

setJsxFactory

public void setJsxFactory(ConfigurationValue cv,
                          String value)
                   throws ConfigurationException

Customize the factory to use for JSX. Defaults to React.createElement

Throws:

ConfigurationException