org.jruby.runtime.backtrace

Enum TraceType.Gather

java.lang.Object

java.lang.Enum<TraceType.Gather>

org.jruby.runtime.backtrace.TraceType.Gather

All Implemented Interfaces:

Serializable, Comparable<TraceType.Gather>

Enclosing class:

TraceType

public static enum TraceType.Gather
extends Enum<TraceType.Gather>

Enum Constant Summary

Enum Constants

Enum Constant and Description
CALLER Normal Ruby-style backtrace, showing only Ruby and core class methods.
FULL A backtrace with interpreted frames intact, but don't remove Java frames.
INTEGRATED A normal Ruby-style backtrace, but which includes any non-org.jruby frames
NORMAL Normal Ruby-style backtrace, showing only Ruby and core class methods.
RAW Full raw backtraces with all Java frames included.

Method Summary

Methods

Modifier and Type	Method and Description
BacktraceData	getBacktraceData(ThreadContext context, boolean nativeException) Gather backtrace data for a normal Ruby trace.
abstract BacktraceData	getBacktraceData(ThreadContext context, StackTraceElement[] javaTrace, boolean nativeException)
BacktraceData	getIntegratedBacktraceData(ThreadContext context, StackTraceElement[] javaTrace) Gather backtrace data for an integrated trace if the current gather type is "NORMAL", otherwise use the current gather type.
static TraceType.Gather	valueOf(String name) Returns the enum constant of this type with the specified name.
static TraceType.Gather[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

RAW

public static final TraceType.Gather RAW

Full raw backtraces with all Java frames included.

FULL

public static final TraceType.Gather FULL

A backtrace with interpreted frames intact, but don't remove Java frames.

INTEGRATED

public static final TraceType.Gather INTEGRATED

A normal Ruby-style backtrace, but which includes any non-org.jruby frames

NORMAL

public static final TraceType.Gather NORMAL

Normal Ruby-style backtrace, showing only Ruby and core class methods.

CALLER

public static final TraceType.Gather CALLER

Normal Ruby-style backtrace, showing only Ruby and core class methods.

Method Detail

values

public static TraceType.Gather[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (TraceType.Gather c : TraceType.Gather.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static TraceType.Gather valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getBacktraceData

public BacktraceData getBacktraceData(ThreadContext context,
                             boolean nativeException)

Gather backtrace data for a normal Ruby trace.

Parameters:

context -

nativeException -

Returns:

getIntegratedBacktraceData

public BacktraceData getIntegratedBacktraceData(ThreadContext context,
                                       StackTraceElement[] javaTrace)

Gather backtrace data for an integrated trace if the current gather type is "NORMAL", otherwise use the current gather type.

Parameters:

context -

javaTrace -

Returns:

getBacktraceData

public abstract BacktraceData getBacktraceData(ThreadContext context,
                             StackTraceElement[] javaTrace,
                             boolean nativeException)