com.google.javascript.jscomp.deps

Class Es6SortedDependencies<INPUT extends DependencyInfo>

java.lang.Object

com.google.javascript.jscomp.deps.Es6SortedDependencies<INPUT>

All Implemented Interfaces:

SortedDependencies<INPUT>

public final class Es6SortedDependencies<INPUT extends DependencyInfo>
extends java.lang.Object
implements SortedDependencies<INPUT>

A sorted list of inputs following the ES6 module ordering spec.

Orders such that each input always comes after its dependencies. Circular references are allowed by emitting the current input in the moment before a loop would complete.

The resulting order is not the same as the user-provided order but is influenced by it since it may take more than one graph traversal to account for all provided inputs and the graph traversals start with the first user provided input and continue from there.

Also exposes other information about the inputs, like which inputs do not provide symbols.

Author:

[email protected] (John Stalcup)

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.javascript.jscomp.deps.SortedDependencies

SortedDependencies.MissingProvideException

Constructor Summary

Constructors

Constructor and Description
Es6SortedDependencies(java.util.List<INPUT> userOrderedInputs)

Method Summary

Modifier and Type	Method and Description
java.util.List<INPUT>	getDependenciesOf(java.util.List<INPUT> rootInputs, boolean sorted) Gets all the dependencies of the given roots.
INPUT	getInputProviding(java.lang.String symbolName) Return the input that gives us the given symbol.
java.util.List<INPUT>	getInputsWithoutProvides()
java.util.List<INPUT>	getSortedDependenciesOf(java.util.List<INPUT> roots) Gets all the dependencies of the given roots.
java.util.List<INPUT>	getSortedList()
INPUT	maybeGetInputProviding(java.lang.String symbol) Return the input that gives us the given symbol, or null.

Methods inherited from class java.lang.Object

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

Constructor Detail

Es6SortedDependencies

public Es6SortedDependencies(java.util.List<INPUT> userOrderedInputs)

Method Detail

getDependenciesOf

public java.util.List<INPUT> getDependenciesOf(java.util.List<INPUT> rootInputs,
                                               boolean sorted)

Description copied from interface: SortedDependencies

Gets all the dependencies of the given roots. The inputs must be returned in a stable order. In other words, if A comes before B, and A does not transitively depend on B, then A must also come before B in the returned list.

Specified by:

getDependenciesOf in interface SortedDependencies<INPUT extends DependencyInfo>

sorted - If true, get them in topologically sorted order. If false, get them in the original order they were passed to the compiler.

getInputProviding

public INPUT getInputProviding(java.lang.String symbolName)
                        throws SortedDependencies.MissingProvideException

Description copied from interface: SortedDependencies

Return the input that gives us the given symbol.

Specified by:

getInputProviding in interface SortedDependencies<INPUT extends DependencyInfo>

Throws:

SortedDependencies.MissingProvideException - An exception if there is no input for this symbol.

getInputsWithoutProvides

public java.util.List<INPUT> getInputsWithoutProvides()

Specified by:

getInputsWithoutProvides in interface SortedDependencies<INPUT extends DependencyInfo>

getSortedDependenciesOf

public java.util.List<INPUT> getSortedDependenciesOf(java.util.List<INPUT> roots)

Description copied from interface: SortedDependencies

Gets all the dependencies of the given roots. The inputs must be returned in a stable order. In other words, if A comes before B, and A does not transitively depend on B, then A must also come before B in the returned list.

Specified by:

getSortedDependenciesOf in interface SortedDependencies<INPUT extends DependencyInfo>

getSortedList

public java.util.List<INPUT> getSortedList()

Specified by:

getSortedList in interface SortedDependencies<INPUT extends DependencyInfo>

maybeGetInputProviding

public INPUT maybeGetInputProviding(java.lang.String symbol)

Description copied from interface: SortedDependencies

Return the input that gives us the given symbol, or null.

Specified by:

maybeGetInputProviding in interface SortedDependencies<INPUT extends DependencyInfo>