com.google.gwt.dev.jjs

Class JavaToJavaScriptCompiler.PermutationCompiler

java.lang.Object

com.google.gwt.dev.jjs.JavaToJavaScriptCompiler.PermutationCompiler

Enclosing class:

JavaToJavaScriptCompiler

protected abstract class JavaToJavaScriptCompiler.PermutationCompiler
extends Object

Compile a permutation.

Constructor Summary

Constructors

Constructor and Description
PermutationCompiler(Permutation permutation)

Method Summary

Modifier and Type	Method and Description
PermutationResult	compilePermutation(UnifiedAst unifiedAst) Takes as input an unresolved Java AST (a Java AST wherein all rebind result classes are available and have not yet been pruned down to the set applicable for a particular permutation) that was previously constructed by the Precompiler and from that constructs output Js source code and related information.
protected abstract ResolveRuntimeTypeReferences.TypeMapper<?>	normalizeSemantics() Transform patterns that can't be represented in JS (such as multiple catch blocks) into equivalent but compatible patterns and take JVM semantics (such as numeric casts) that are not explicit in the AST and make them explicit. These passes can not be reordering because of subtle interdependencies.
protected abstract void	optimizeJava()
protected abstract void	optimizeJs(Set<JsNode> inlinableJsFunctions)
protected void	optimizeJsLoop(Collection<JsNode> toInline)
protected abstract void	postNormalizationOptimizeJava()
protected abstract Map<JsName,JsLiteral>	runDetailedNamer(ConfigProps config)
protected abstract Pair<SyntheticArtifact,MultipleDependencyGraphRecorder>	splitJsIntoFragments(PermProps props, int permutationId, JavaToJavaScriptMap jjsmap)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Constructor Detail

PermutationCompiler

public PermutationCompiler(Permutation permutation)

Method Detail

compilePermutation

public PermutationResult compilePermutation(UnifiedAst unifiedAst)
                                     throws UnableToCompleteException

Takes as input an unresolved Java AST (a Java AST wherein all rebind result classes are available and have not yet been pruned down to the set applicable for a particular permutation) that was previously constructed by the Precompiler and from that constructs output Js source code and related information. This Js source and related information is packaged into a Permutation instance and then returned. Permutation compilation is INTENDED to progress as a series of stages:

 1. initialize local state
 2. transform unresolved Java AST to resolved Java AST
 3. normalize the resolved Java AST
 4. optimize the resolved Java AST
 5. construct the Js AST
 6. normalize the Js AST
 7. optimize the Js AST
 8. generate Js source
 9. construct and return a value
 

There are some other types of work here (mostly metrics and data gathering) which do not serve the goal of output program construction. This work should really be moved into subclasses or some sort of callback or plugin system so as not to visually pollute the real compile logic.
Significant amounts of visitors implementing the intended above stages are triggered here but in the wrong order. They have been noted for future cleanup.

Throws:

UnableToCompleteException

optimizeJs

protected abstract void optimizeJs(Set<JsNode> inlinableJsFunctions)
                            throws InterruptedException

Throws:

InterruptedException

optimizeJava

protected abstract void optimizeJava()
                              throws InterruptedException

Throws:

InterruptedException

postNormalizationOptimizeJava

protected abstract void postNormalizationOptimizeJava()

runDetailedNamer

protected abstract Map<JsName,JsLiteral> runDetailedNamer(ConfigProps config)
                                                   throws JsNamer.IllegalNameException

Throws:

JsNamer.IllegalNameException

splitJsIntoFragments

protected abstract Pair<SyntheticArtifact,MultipleDependencyGraphRecorder> splitJsIntoFragments(PermProps props,
                                                                                                int permutationId,
                                                                                                JavaToJavaScriptMap jjsmap)

normalizeSemantics

protected abstract ResolveRuntimeTypeReferences.TypeMapper<?> normalizeSemantics()

Transform patterns that can't be represented in JS (such as multiple catch blocks) into equivalent but compatible patterns and take JVM semantics (such as numeric casts) that are not explicit in the AST and make them explicit.
These passes can not be reordering because of subtle interdependencies.

optimizeJsLoop

protected void optimizeJsLoop(Collection<JsNode> toInline)
                       throws InterruptedException

Throws:

InterruptedException