com.google.gwt.dev.jjs

Class JavaToJavaScriptCompiler.Precompiler

java.lang.Object

com.google.gwt.dev.jjs.JavaToJavaScriptCompiler.Precompiler

Enclosing class:

JavaToJavaScriptCompiler

protected abstract class JavaToJavaScriptCompiler.Precompiler
extends Object

Performs precompilation.

Field Summary

Fields

Modifier and Type	Field and Description
protected String[]	entryPointTypeNames
protected RebindPermutationOracle	rpo

Constructor Summary

Constructors

Constructor and Description
Precompiler(RebindPermutationOracle rpo, String[] entryPointTypeNames)

Method Summary

Modifier and Type	Method and Description
protected abstract void	beforeUnifyAst(Set<String> allRootTypes)
protected abstract void	checkEntryPoints(String[] additionalRootTypes)
protected abstract void	createJProgram(CompilerContext compilerContext)
protected UnifiedAst	precompile(String[] additionalRootTypes, boolean singlePermutation, PrecompilationMetricsArtifact precompilationMetrics) Takes as input a CompilationState and transforms that into a unified by not yet resolved Java AST (a Java AST wherein cross-class references have been connected and all rebind result classes are available and have not yet been pruned down to the set applicable for a particular permutation).

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Field Detail

rpo

protected RebindPermutationOracle rpo

entryPointTypeNames

protected String[] entryPointTypeNames

Constructor Detail

Precompiler

public Precompiler(RebindPermutationOracle rpo,
                   String[] entryPointTypeNames)

Method Detail

beforeUnifyAst

protected abstract void beforeUnifyAst(Set<String> allRootTypes)
                                throws UnableToCompleteException

Throws:

UnableToCompleteException

checkEntryPoints

protected abstract void checkEntryPoints(String[] additionalRootTypes)

createJProgram

protected abstract void createJProgram(CompilerContext compilerContext)

precompile

protected final UnifiedAst precompile(String[] additionalRootTypes,
                                      boolean singlePermutation,
                                      PrecompilationMetricsArtifact precompilationMetrics)
                               throws UnableToCompleteException

Takes as input a CompilationState and transforms that into a unified by not yet resolved Java AST (a Java AST wherein cross-class references have been connected and all rebind result classes are available and have not yet been pruned down to the set applicable for a particular permutation). This AST is packaged into a UnifiedAst instance and then returned. Precompilation is INTENDED to progress as a series of stages:

 1. initialize local state
 2. assert preconditions
 3. construct and unify the unresolved Java AST
 4. normalize the unresolved Java AST  // arguably should be removed
 5. optimize the unresolved Java AST  // arguably should be removed
 6. 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