org.graalvm.compiler.phases

Class SingleRunSubphase<C>

java.lang.Object

org.graalvm.compiler.phases.BasePhase<C>

org.graalvm.compiler.phases.SingleRunSubphase<C>

All Implemented Interfaces:

PhaseSizeContract

public abstract class SingleRunSubphase<C>
extends BasePhase<C>

A subclass of BasePhase whose instances may only be applied once. An error will be raised at runtime if a single instance of such a phase is applied more than once, whether or not it is applied to the same graph as before.

Such phases are typically used as part of another phase, allocated and immediately applied like this:

 new SomeSubphase(some, context, information).apply(graph, options);
 

or like this:

 SomeSubphase mySubphase = new Subphase(some, context, information);
 mySubphase.apply(graph, options);
 mySubphase.getResults();  // process information computed by the phase
 

Unlike other subclasses of BasePhase, such phases may retain internal state. Due to the check for multiple applications, this state can only be used to communicate results to the phase's client. It cannot be used to carry over state information to another run of the phase.

Nested Class Summary

Nested classes/interfaces inherited from class org.graalvm.compiler.phases.BasePhase

BasePhase.ApplyScope, BasePhase.BasePhaseStatistics, BasePhase.PhaseOptions, BasePhase.SharedGlobalPhaseState

Constructor Summary

Constructors

Constructor and Description
SingleRunSubphase()

Method Summary

Modifier and Type	Method and Description
protected BasePhase.ApplyScope	applyScope(StructuredGraph graph, C context) Return an BasePhase.ApplyScope which will surround all the work performed by the call to BasePhase.run(org.graalvm.compiler.nodes.StructuredGraph, C) in BasePhase.apply(StructuredGraph, Object, boolean).

Methods inherited from class org.graalvm.compiler.phases.BasePhase

apply, apply, codeSizeIncrease, contractorName, equals, getName, hashCode, run, shouldDumpAfterAtBasicLevel, shouldDumpBeforeAtBasicLevel

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.graalvm.compiler.phases.contract.PhaseSizeContract

checkContract

Constructor Detail

SingleRunSubphase

public SingleRunSubphase()

Method Detail

applyScope

protected final BasePhase.ApplyScope applyScope(StructuredGraph graph,
                                                C context)

Description copied from class: BasePhase

Return an BasePhase.ApplyScope which will surround all the work performed by the call to BasePhase.run(org.graalvm.compiler.nodes.StructuredGraph, C) in BasePhase.apply(StructuredGraph, Object, boolean). This allows subclaseses to inject work which will performed before and after the application of this phase.

Overrides:

applyScope in class BasePhase<C>