jdk.internal.jvmci.meta

Class DefaultProfilingInfo

java.lang.Object

jdk.internal.jvmci.meta.DefaultProfilingInfo

All Implemented Interfaces:

ProfilingInfo

public final class DefaultProfilingInfo
extends Object
implements ProfilingInfo

An implementation of ProfilingInfo that can used in the absence of real profile information.

Field Summary

Fields

Modifier and Type	Field and Description
private TriState	exceptionSeen
private static ProfilingInfo[]	NO_PROFILING_INFO

Constructor Summary

Constructors

Constructor and Description
DefaultProfilingInfo(TriState exceptionSeen)

Method Summary

Modifier and Type	Method and Description
static ProfilingInfo	get(TriState exceptionSeen)
double	getBranchTakenProbability(int bci) Returns an estimate of how often the branch at the given byte code was taken.
int	getCodeSize() Returns the length of the bytecodes associated with this profile.
int	getCompilerIRSize(Class<?> irType) Gets the size of the compiler intermediate representation (IR) associated with this method last recorded by ProfilingInfo.setCompilerIRSize(Class, int).
int	getDeoptimizationCount(DeoptimizationReason reason) Returns how frequently a method was deoptimized for the given deoptimization reason.
TriState	getExceptionSeen(int bci) Returns information if the given BCI did ever throw an exception.
int	getExecutionCount(int bci) Returns an estimate how often the current BCI was executed.
JavaMethodProfile	getMethodProfile(int bci) Returns the MethodProfile for the given BCI.
TriState	getNullSeen(int bci) Returns information if null was ever seen for the given BCI.
double[]	getSwitchProbabilities(int bci) Returns an estimate of how often the switch cases are taken at the given BCI.
JavaTypeProfile	getTypeProfile(int bci) Returns the TypeProfile for the given BCI.
boolean	isMature() Returns true if the profiling information can be assumed as sufficiently accurate.
boolean	setCompilerIRSize(Class<?> irType, int nodeCount) Records the size of the compiler intermediate representation (IR) associated with this method.
void	setMature() Force data to be treated as mature if possible.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface jdk.internal.jvmci.meta.ProfilingInfo

toString

Field Detail

NO_PROFILING_INFO

private static final ProfilingInfo[] NO_PROFILING_INFO

exceptionSeen

private final TriState exceptionSeen

Constructor Detail

DefaultProfilingInfo

DefaultProfilingInfo(TriState exceptionSeen)

Method Detail

getCodeSize

public int getCodeSize()

Description copied from interface: ProfilingInfo

Returns the length of the bytecodes associated with this profile.

Specified by:

getCodeSize in interface ProfilingInfo

getTypeProfile

public JavaTypeProfile getTypeProfile(int bci)

Description copied from interface: ProfilingInfo

Returns the TypeProfile for the given BCI.

Specified by:

getTypeProfile in interface ProfilingInfo

Returns:

Returns a JavaTypeProfile object, or null if not available.

getMethodProfile

public JavaMethodProfile getMethodProfile(int bci)

Description copied from interface: ProfilingInfo

Returns the MethodProfile for the given BCI.

Specified by:

getMethodProfile in interface ProfilingInfo

Returns:

Returns a JavaMethodProfile object, or null if not available.

getBranchTakenProbability

public double getBranchTakenProbability(int bci)

Description copied from interface: ProfilingInfo

Returns an estimate of how often the branch at the given byte code was taken.

Specified by:

getBranchTakenProbability in interface ProfilingInfo

Returns:

The estimated probability, with 0.0 meaning never and 1.0 meaning always, or -1 if this information is not available.

getSwitchProbabilities

public double[] getSwitchProbabilities(int bci)

Description copied from interface: ProfilingInfo

Returns an estimate of how often the switch cases are taken at the given BCI. The default case is stored as the last entry.

Specified by:

getSwitchProbabilities in interface ProfilingInfo

Returns:

A double value that contains the estimated probabilities, with 0.0 meaning never and 1.0 meaning always, or -1 if this information is not available.

getExceptionSeen

public TriState getExceptionSeen(int bci)

Description copied from interface: ProfilingInfo

Returns information if the given BCI did ever throw an exception.

Specified by:

getExceptionSeen in interface ProfilingInfo

Returns:

TriState.TRUE if the instruction has thrown an exception at least once, TriState.FALSE if it never threw an exception, and TriState.UNKNOWN if this information was not recorded.

getNullSeen

public TriState getNullSeen(int bci)

Description copied from interface: ProfilingInfo

Returns information if null was ever seen for the given BCI. This information is collected for the aastore, checkcast and instanceof bytecodes.

Specified by:

getNullSeen in interface ProfilingInfo

Returns:

TriState.TRUE if null was seen for the instruction, TriState.FALSE if null was NOT seen, and TriState.UNKNOWN if this information was not recorded.

getExecutionCount

public int getExecutionCount(int bci)

Description copied from interface: ProfilingInfo

Returns an estimate how often the current BCI was executed. Avoid comparing execution counts to each other, as the returned value highly depends on the time of invocation.

Specified by:

getExecutionCount in interface ProfilingInfo

Returns:

the estimated execution count or -1 if not available.

get

public static ProfilingInfo get(TriState exceptionSeen)

getDeoptimizationCount

public int getDeoptimizationCount(DeoptimizationReason reason)

Description copied from interface: ProfilingInfo

Returns how frequently a method was deoptimized for the given deoptimization reason. This only indicates how often the method did fall back to the interpreter for the execution and does not indicate how often it was recompiled.

Specified by:

getDeoptimizationCount in interface ProfilingInfo

Parameters:

reason - the reason for which the number of deoptimizations should be queried

Returns:

the number of times the compiled method deoptimized for the given reason.

isMature

public boolean isMature()

Description copied from interface: ProfilingInfo

Returns true if the profiling information can be assumed as sufficiently accurate.

Specified by:

isMature in interface ProfilingInfo

Returns:

true if the profiling information was recorded often enough mature enough, false otherwise.

toString

public String toString()

Overrides:

toString in class Object

setMature

public void setMature()

Description copied from interface: ProfilingInfo

Force data to be treated as mature if possible.

Specified by:

setMature in interface ProfilingInfo

setCompilerIRSize

public boolean setCompilerIRSize(Class<?> irType,
                                 int nodeCount)

Description copied from interface: ProfilingInfo

Records the size of the compiler intermediate representation (IR) associated with this method.

Specified by:

setCompilerIRSize in interface ProfilingInfo

Parameters:

irType - the IR type for which the size is being recorded

nodeCount - the IR size to be recorded. The unit depends on the IR.

Returns:

whether recording this information for irType is supported

getCompilerIRSize

public int getCompilerIRSize(Class<?> irType)

Description copied from interface: ProfilingInfo

Gets the size of the compiler intermediate representation (IR) associated with this method last recorded by ProfilingInfo.setCompilerIRSize(Class, int).

Specified by:

getCompilerIRSize in interface ProfilingInfo

Parameters:

irType - the IR type for which the size is being requested

Returns:

the requested IR size or -1 if it is unavailable for irType