MinimalRebuildCache (GWT 2.8.2)

java.lang.Object
- com.google.gwt.dev.MinimalRebuildCache

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

NullRebuildCache
```
public class MinimalRebuildCache
extends Object
implements Serializable
```
MinimalRebuildCache contains compiler information that can be persisted between compiles to decrease compilation time.
Cached information is specific to a single permutation and it is the responsibility of the framework driving the Compiler to supply the right Cache instance for the right Module configuration and to make sure that the Compiler is only processing one permutation at a time.
All type names referenced here are assumed to be binary names.
A "typeName" here might be a root type or nested type but a "compilationUnitName" here will always be the name of just the root type in a compilation unit.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

protected JTypeOracle.ImmediateTypeRelations immediateTypeRelations

Fields
Modifier and Type	Field and Description
`protected JTypeOracle.ImmediateTypeRelations`	`immediateTypeRelations`

Constructor Summary

Constructors
Constructor and Description

MinimalRebuildCache()

Constructors
Constructor and Description
`MinimalRebuildCache()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`addExportedGlobalName(String exportedGlobalName, String description, String inTypeName)`
`void`	`addGeneratedArtifacts(ArtifactSet generatedArtifacts)` Accumulates generated artifacts so that they can be output on recompiles even if no generators are run.
`void`	`addModifiedCompilationUnitNames(TreeLogger logger, Set<String> modifiedCompilationUnitNames)`
`void`	`addSourceCompilationUnitName(String sourceCompilationUnitName)`
`void`	`addTypeReference(String fromTypeName, String toTypeName)`
`void`	`associateReboundTypeWithGeneratedCompilationUnitName(String reboundTypeName, String generatedCompilationUnitName)`
`void`	`associateReboundTypeWithInputResource(String reboundTypeName, String inputResourcePath)` Record that a Generator that was ran as a result of a GWT.create(ReboundType.class) call read a particular resource.
`void`	`clearPerTypeJsCache()`
`void`	`clearRebinderTypeAssociations(String rebinderTypeName)`
`void`	`clearReboundTypeAssociations(String reboundTypeName)`
`Set<String>`	`computeAndClearStaleTypesCache(TreeLogger logger, JTypeOracle typeOracle)` Calculates the set of stale types and clears their cached Js, StatementRanges and SourceMaps.
`Set<String>`	`computeDeletedTypeNames()` Computes and returns the set of names of deleted types.
`Set<String>`	`computeModifiedTypeNames()` Computes and returns the set of names of modified types.
`Set<String>`	`computeReachableTypeNames()` Computes and returns the names of the set of types that are referenceable within the method level control flow starting from the entry methods, immortal codegen types and exported JsInterop methods.
`void`	`copyFrom(MinimalRebuildCache that)` Replaces the contents of this cache with the contents of the given cache.
`Set<String>`	`filterUnreachableTypeNames(Set<String> typeNames)` Return the set of provided typeNames with unreachable types filtered out.
`ArtifactSet`	`getGeneratedArtifacts()`
`JTypeOracle.ImmediateTypeRelations`	`getImmediateTypeRelations()`
`String`	`getJs(String typeName)`
`int`	`getLastLinkedJsBytes()`
`Set<String>`	`getModifiedCompilationUnitNames()`
`JsIncrementalNamer.JsIncrementalNamerState`	`getPersistentPrettyNamerState()`
`Set<String>`	`getPreambleTypeNames()`
`Set<String>`	`getProcessedStaleTypeNames()` Returns the set of the names of types that were processed as stale.
`JsSourceMap`	`getSourceMap(String typeName)`
`Set<String>`	`getStaleTypeNames()`
`StatementRanges`	`getStatementRanges(String typeName)`
`StringAnalyzableTypeEnvironment`	`getTypeEnvironment()`
`ResolveRuntimeTypeReferences.IntTypeMapper`	`getTypeMapper()`
`boolean`	`hasJs(String typeName)`
`boolean`	`hasPreambleTypeNames()`
`boolean`	`isPopulated()` Returns true if there is cached data to reuse in the next recompile.
`boolean`	`isSourceCompilationUnit(String compilationUnitName)`
`boolean`	`knowsLastLinkedJsBytes()`
`void`	`markSourceFileStale(String typeName)`
`void`	`recordBuildResources(ModuleDef module)` Records the resource paths and modification dates of build resources in the current compile and builds a list of known modified resource paths by comparing the resource paths and modification dates of build resources in the previous compile with those of the current compile.
`void`	`recordDiskSourceResources(Map<String,Long> currentModifiedByDiskSourcePath)` Records the paths and modification dates of source resources in the current compile and builds a list of known modified paths by comparing the paths and modification dates of source resources in the previous compile with those of the current compile.
`void`	`recordDiskSourceResources(ModuleDef module)` Records the paths and modification dates of source resources in the current compile and builds a list of known modified paths by comparing the paths and modification dates of source resources in the previous compile with those of the current compile.
`void`	`recordGeneratedUnits(Collection<GeneratedUnit> generatedUnits)` Records the paths and content ids of generated source resources in the current compile and updates a list of known modified paths by comparing the paths and content ids of generated source resources in the previous compile with those of the current compile.
`void`	`recordNestedTypeName(String compilationUnitTypeName, String nestedTypeName)`
`void`	`recordNestedTypeNamesPerType(CompilationUnit compilationUnit)`
`void`	`recordRebinderTypeForReboundType(String reboundTypeName, String rebinderType)` Records that rebinder type Foo contains a GWT.create(ReboundTypeBar.class) call.
`void`	`removeExportedNames(String inTypeName)`
`void`	`removeReferencesFrom(String fromTypeName)`
`void`	`setEntryMethodNames(List<String> entryMethodNames)`
`void`	`setJsForType(TreeLogger logger, String typeName, String typeJs)`
`void`	`setJsoTypeNames(Set<String> jsoTypeNames, Set<String> singleJsoImplInterfaceNames, Set<String> dualJsoImplInterfaceNames)` Records the names of JSO subtypes, single impl interfaces and dual impl interfaces as well as keeps track of types that entered or left one of the lists in the most recent iteration.
`void`	`setLastLinkedJsBytes(int lastLinkedJsBytes)`
`void`	`setPreambleTypeNames(TreeLogger logger, Set<String> preambleTypeNames)`
`void`	`setProcessedStaleTypeNames(Set<String> processedStaleTypeNames)`
`void`	`setRootTypeNames(Collection<String> rootTypeNames)`
`void`	`setSourceMapForType(String typeName, JsSourceMap sourceMap)`
`void`	`setStatementRangesForType(String typeName, StatementRanges statementRanges)`

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, toString

- Field Detail
  - immediateTypeRelations
```
protected final JTypeOracle.ImmediateTypeRelations immediateTypeRelations
```
- Constructor Detail
  - MinimalRebuildCache
```
public MinimalRebuildCache()
```
- Method Detail
  - addExportedGlobalName
```
public String addExportedGlobalName(String exportedGlobalName,
                                    String description,
                                    String inTypeName)
```
  - addGeneratedArtifacts
```
public void addGeneratedArtifacts(ArtifactSet generatedArtifacts)
```
    Accumulates generated artifacts so that they can be output on recompiles even if no generators are run.
  - addModifiedCompilationUnitNames
```
public void addModifiedCompilationUnitNames(TreeLogger logger,
                                            Set<String> modifiedCompilationUnitNames)
```
  - addSourceCompilationUnitName
```
public void addSourceCompilationUnitName(String sourceCompilationUnitName)
```
  - addTypeReference
```
public void addTypeReference(String fromTypeName,
                             String toTypeName)
```
  - associateReboundTypeWithGeneratedCompilationUnitName
```
public void associateReboundTypeWithGeneratedCompilationUnitName(String reboundTypeName,
                                                                 String generatedCompilationUnitName)
```
  - associateReboundTypeWithInputResource
```
public void associateReboundTypeWithInputResource(String reboundTypeName,
                                                  String inputResourcePath)
```
    Record that a Generator that was ran as a result of a GWT.create(ReboundType.class) call read a particular resource.
  - clearPerTypeJsCache
```
public void clearPerTypeJsCache()
```
  - clearRebinderTypeAssociations
```
public void clearRebinderTypeAssociations(String rebinderTypeName)
```
  - clearReboundTypeAssociations
```
public void clearReboundTypeAssociations(String reboundTypeName)
```
  - computeAndClearStaleTypesCache
```
public Set<String> computeAndClearStaleTypesCache(TreeLogger logger,
                                                  JTypeOracle typeOracle)
```
    Calculates the set of stale types and clears their cached Js, StatementRanges and SourceMaps.
    The calculation of stale types starts with the list of known modified types and expands that set using various patterns intended to find any types whose output JS would be affected by the changes in the modified types. For example if the parent of class Foo was changed then the castmaps in all children of Foo need to be recreated.
    In some ways this process is similar to that performed by the CompilationUnitInvalidator but it differs both in what type of cached objects are being cleared (JS versus CompilationUnits) and in what invalidation rules must be applied. CompilationUnitInvalidator is concerned only with changes in interface while the invalidation here must also look at JSO promotion/demotion and cast references because of the peculiarities of output JS format.
  - computeDeletedTypeNames
```
public Set<String> computeDeletedTypeNames()
```
    Computes and returns the set of names of deleted types.
    Deleted types are all those types that are nested within compilation units that are known to have been deleted.
  - computeModifiedTypeNames
```
public Set<String> computeModifiedTypeNames()
```
    Computes and returns the set of names of modified types.
    Modified types are all those types that are nested within compilation units that are known to have been modified.
  - computeReachableTypeNames
```
public Set<String> computeReachableTypeNames()
```
    Computes and returns the names of the set of types that are referenceable within the method level control flow starting from the entry methods, immortal codegen types and exported JsInterop methods.
    Should only be called once per compile, so that the "lastReachableTypeNames" list accurately reflects the reachable types of the immediately previous compile.
  - copyFrom
```
public void copyFrom(MinimalRebuildCache that)
```
    Replaces the contents of this cache with the contents of the given cache.
    This operation should be kept fast as it will be called once per compile. At the moment it takes about 2.5% of the time in an incremental recompile. If wanting to recover this time in the future consider parallelizing the copy or grouping the values from hash tables with similar keys into a single data object and hashtable so that fewer references need to be replicated.
  - filterUnreachableTypeNames
```
public Set<String> filterUnreachableTypeNames(Set<String> typeNames)
```
    Return the set of provided typeNames with unreachable types filtered out.
  - getGeneratedArtifacts
```
public ArtifactSet getGeneratedArtifacts()
```
  - getImmediateTypeRelations
```
public JTypeOracle.ImmediateTypeRelations getImmediateTypeRelations()
```
  - getJs
```
public String getJs(String typeName)
```
  - getLastLinkedJsBytes
```
public int getLastLinkedJsBytes()
```
  - getModifiedCompilationUnitNames
```
public Set<String> getModifiedCompilationUnitNames()
```
  - getPersistentPrettyNamerState
```
public JsIncrementalNamer.JsIncrementalNamerState getPersistentPrettyNamerState()
```
  - getPreambleTypeNames
```
public Set<String> getPreambleTypeNames()
```
  - getProcessedStaleTypeNames
```
public Set<String> getProcessedStaleTypeNames()
```
    Returns the set of the names of types that were processed as stale. This list can be larger than the calculated list of stale types for example when a new reference is created to a type that had not been processed in a previous compile.
  - getSourceMap
```
public JsSourceMap getSourceMap(String typeName)
```
  - getStaleTypeNames
```
public Set<String> getStaleTypeNames()
```
  - getStatementRanges
```
public StatementRanges getStatementRanges(String typeName)
```
  - getTypeEnvironment
```
public StringAnalyzableTypeEnvironment getTypeEnvironment()
```
  - getTypeMapper
```
public ResolveRuntimeTypeReferences.IntTypeMapper getTypeMapper()
```
  - hasJs
```
public boolean hasJs(String typeName)
```
  - hasPreambleTypeNames
```
public boolean hasPreambleTypeNames()
```
  - isPopulated
```
public boolean isPopulated()
```
    Returns true if there is cached data to reuse in the next recompile.
  - isSourceCompilationUnit
```
public boolean isSourceCompilationUnit(String compilationUnitName)
```
  - knowsLastLinkedJsBytes
```
public boolean knowsLastLinkedJsBytes()
```
  - markSourceFileStale
```
public void markSourceFileStale(String typeName)
```
  - recordBuildResources
```
public void recordBuildResources(ModuleDef module)
```
    Records the resource paths and modification dates of build resources in the current compile and builds a list of known modified resource paths by comparing the resource paths and modification dates of build resources in the previous compile with those of the current compile.
  - recordDiskSourceResources
```
public void recordDiskSourceResources(Map<String,Long> currentModifiedByDiskSourcePath)
```
    Records the paths and modification dates of source resources in the current compile and builds a list of known modified paths by comparing the paths and modification dates of source resources in the previous compile with those of the current compile.
  - recordDiskSourceResources
```
public void recordDiskSourceResources(ModuleDef module)
```
    Records the paths and modification dates of source resources in the current compile and builds a list of known modified paths by comparing the paths and modification dates of source resources in the previous compile with those of the current compile.
  - recordGeneratedUnits
```
public void recordGeneratedUnits(Collection<GeneratedUnit> generatedUnits)
```
    Records the paths and content ids of generated source resources in the current compile and updates a list of known modified paths by comparing the paths and content ids of generated source resources in the previous compile with those of the current compile.
  - recordNestedTypeName
```
public void recordNestedTypeName(String compilationUnitTypeName,
                                 String nestedTypeName)
```
  - recordNestedTypeNamesPerType
```
public void recordNestedTypeNamesPerType(CompilationUnit compilationUnit)
```
  - recordRebinderTypeForReboundType
```
public void recordRebinderTypeForReboundType(String reboundTypeName,
                                             String rebinderType)
```
    Records that rebinder type Foo contains a GWT.create(ReboundTypeBar.class) call.
  - removeExportedNames
```
public void removeExportedNames(String inTypeName)
```
  - removeReferencesFrom
```
public void removeReferencesFrom(String fromTypeName)
```
  - setEntryMethodNames
```
public void setEntryMethodNames(List<String> entryMethodNames)
```
  - setJsForType
```
public void setJsForType(TreeLogger logger,
                         String typeName,
                         String typeJs)
```
  - setJsoTypeNames
```
public void setJsoTypeNames(Set<String> jsoTypeNames,
                            Set<String> singleJsoImplInterfaceNames,
                            Set<String> dualJsoImplInterfaceNames)
```
    Records the names of JSO subtypes, single impl interfaces and dual impl interfaces as well as keeps track of types that entered or left one of the lists in the most recent iteration.
  - setLastLinkedJsBytes
```
public void setLastLinkedJsBytes(int lastLinkedJsBytes)
```
  - setPreambleTypeNames
```
public void setPreambleTypeNames(TreeLogger logger,
                                 Set<String> preambleTypeNames)
```
  - setProcessedStaleTypeNames
```
public void setProcessedStaleTypeNames(Set<String> processedStaleTypeNames)
```
  - setRootTypeNames
```
public void setRootTypeNames(Collection<String> rootTypeNames)
```
  - setSourceMapForType
```
public void setSourceMapForType(String typeName,
                                JsSourceMap sourceMap)
```
  - setStatementRangesForType
```
public void setStatementRangesForType(String typeName,
                                      StatementRanges statementRanges)
```

Class MinimalRebuildCache

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

immediateTypeRelations

Constructor Detail

MinimalRebuildCache

Method Detail

addExportedGlobalName

addGeneratedArtifacts

addModifiedCompilationUnitNames

addSourceCompilationUnitName

addTypeReference

associateReboundTypeWithGeneratedCompilationUnitName

associateReboundTypeWithInputResource

clearPerTypeJsCache

clearRebinderTypeAssociations

clearReboundTypeAssociations

computeAndClearStaleTypesCache

computeDeletedTypeNames

computeModifiedTypeNames

computeReachableTypeNames

copyFrom

filterUnreachableTypeNames

getGeneratedArtifacts

getImmediateTypeRelations

getJs

getLastLinkedJsBytes

getModifiedCompilationUnitNames

getPersistentPrettyNamerState

getPreambleTypeNames

getProcessedStaleTypeNames

getSourceMap

getStaleTypeNames

getStatementRanges

getTypeEnvironment

getTypeMapper

hasJs

hasPreambleTypeNames

isPopulated

isSourceCompilationUnit

knowsLastLinkedJsBytes

markSourceFileStale

recordBuildResources

recordDiskSourceResources

recordDiskSourceResources

recordGeneratedUnits

recordNestedTypeName

recordNestedTypeNamesPerType

recordRebinderTypeForReboundType

removeExportedNames

removeReferencesFrom

setEntryMethodNames

setJsForType

setJsoTypeNames

setLastLinkedJsBytes

setPreambleTypeNames

setProcessedStaleTypeNames

setRootTypeNames

setSourceMapForType

setStatementRangesForType