org.jruby

Class RubyException

java.lang.Object

org.jruby.RubyBasicObject

org.jruby.RubyObject

org.jruby.RubyException

All Implemented Interfaces:

Serializable, Cloneable, Comparable<IRubyObject>, InstanceVariables, InternalVariables, IRubyObject, CoreObjectType

Direct Known Subclasses:

NativeException, RubyLocalJumpError, RubyNameError, RubyStopIteration, RubySystemCallError, RubySystemExit, RubyUncaughtThrowError

public class RubyException
extends RubyObject

Author:

jpetersen

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.jruby.RubyObject

RubyObject.Data

Nested classes/interfaces inherited from class org.jruby.RubyBasicObject

RubyBasicObject.Finalizer

Field Summary

Fields

Modifier and Type	Field and Description
static ObjectAllocator	EXCEPTION_ALLOCATOR
IRubyObject	message Deprecated. do not access the field directly
static int	TRACE_HEAD
static int	TRACE_MAX
static int	TRACE_TAIL

Fields inherited from class org.jruby.RubyObject

FIELD_ALLOCATED_CLASSES, FIELD_ALLOCATORS, IVAR_INSPECTING_OBJECT_ALLOCATOR, OBJECT_ALLOCATOR, OBJECT_VAR0_ALLOCATOR, OBJECT_VAR1_ALLOCATOR, OBJECT_VAR2_ALLOCATOR, OBJECT_VAR3_ALLOCATOR, OBJECT_VAR4_ALLOCATOR, OBJECT_VAR5_ALLOCATOR, OBJECT_VAR6_ALLOCATOR, OBJECT_VAR7_ALLOCATOR, OBJECT_VAR8_ALLOCATOR, OBJECT_VAR9_ALLOCATOR, REIFYING_OBJECT_ALLOCATOR

Fields inherited from class org.jruby.RubyBasicObject

ALL_F, BASICOBJECT_ALLOCATOR, COMPARE_BY_IDENTITY_F, ERR_INSECURE_SET_INST_VAR, FALSE_F, FL_USHIFT, flags, FROZEN_F, IS_OVERLAID_F, metaClass, NEVER, NIL_F, REFINED_MODULE_F, STAMP_OFFSET, TAINTED_F, UNDEF, UNTRUST_F, USER0_F, USER1_F, USER2_F, USER3_F, USER4_F, USER5_F, USER6_F, USER7_F, USER8_F, USER9_F, USERA_F, VAR_TABLE_OFFSET, varTable, varTableStamp

Fields inherited from interface org.jruby.runtime.builtin.IRubyObject

NULL_ARRAY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RubyException(Ruby runtime, RubyClass rubyClass)
	RubyException(Ruby runtime, RubyClass rubyClass, String message)

Method Summary

Modifier and Type	Method and Description
IRubyObject	backtrace_locations(ThreadContext context)
IRubyObject	backtrace()
IRubyObject	cause(ThreadContext context)
void	copySpecialInstanceVariables(IRubyObject clone) Lots of MRI objects keep their state in non-lookupable ivars (e:g.
static RubyClass	createExceptionClass(Ruby runtime)
RubyException	exception(IRubyObject[] args)
static IRubyObject	exception(ThreadContext context, IRubyObject recv, IRubyObject[] args, Block block)
void	forceBacktrace(IRubyObject backtrace)
IRubyObject	getBacktrace()
BacktraceData	getBacktraceData()
RubyStackTraceElement[]	getBacktraceElements()
Object	getCause()
IRubyObject	getMessage()
String	getMessageAsJavaString()
void	initBacktrace()
IRubyObject	initialize(IRubyObject[] args, Block block)
RubyString	inspect(ThreadContext context) inspects an object and return a kind of debug information
IRubyObject	message(ThreadContext context)
static RubyException	newException(Ruby runtime, RubyClass excptnClass, String msg)
static IRubyObject	newException(ThreadContext context, RubyClass exceptionClass, IRubyObject message)
static IRubyObject	op_eqq(ThreadContext context, IRubyObject recv, IRubyObject other)
RubyBoolean	op_equal(ThreadContext context, IRubyObject other) rb_obj_equal Will by default use identity equality to compare objects.
void	prepareBacktrace(ThreadContext context, boolean nativeException)
void	prepareIntegratedBacktrace(ThreadContext context, StackTraceElement[] javaTrace) Prepare an "integrated" backtrace that includes the normal Ruby trace plus non-filtered Java frames.
void	printBacktrace(PrintStream errorStream) Print the Ruby exception's backtrace to the given PrintStream.
void	printBacktrace(PrintStream errorStream, int skip) Print the Ruby exception's backtrace to the given PrintStream.
IRubyObject	set_backtrace(IRubyObject obj)
void	setBacktraceData(BacktraceData backtraceData)
void	setCause(IRubyObject cause)
IRubyObject	to_s(ThreadContext context)
IRubyObject	to_s19(ThreadContext context) Deprecated.

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, createObjectClass, dig, eqlInternal, equalInternal, equals, getNativeClassIndex, hashCode, inspect, op_eqq, puts, specificEval, toString

Methods inherited from class org.jruby.RubyBasicObject

addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkCallMethod, checkFrozen, checkStringType, checkStringType19, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, display, dup, ensureInstanceVariablesSettable, eql_p, eql, equal_p, equal_p19, evalUnder, extend, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, freeze, frozen_p, getFFIHandle, getFlag, getInstanceEvalClass, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getJavaClass, getMetaClass, getNativeHandle, getNativeTypeIndex, getObjectId, getRuntime, getSingletonClass, getSingletonClassClone, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hash, hashyInspect, hasInstanceVariable, hasInternalVariable, hasVariables, id, infectBy, initialize_copy, initialize, initialize, initialize19, inspect, inspectHashCode, instance_eval, instance_eval, instance_eval, instance_eval, instance_eval19, instance_eval19, instance_eval19, instance_eval19, instance_exec, instance_exec19, instance_of_p, instance_variable_defined_p, instance_variable_get, instance_variable_set, instance_variables, instance_variables19, isBuiltin, isClass, isFalse, isFrozen, isImmediate, isModule, isNil, isSpecialConst, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, method_missing19, method, method19, methods, methods, methods19, nil_p, nonFixnumHashCode, OBJ_INIT_COPY, objInitCopy, op_cmp, op_equal_19, op_match, op_match19, op_not_equal, op_not_match, op_not, private_methods, private_methods19, protected_methods, protected_methods19, public_methods, public_methods19, rbClone, rbInspect, remove_instance_variable, removeFinalizers, removeInstanceVariable, removeInternalVariable, respond_to_p, respond_to_p, respond_to_p19, respond_to_p19, respondsTo, respondsToMissing, respondsToMissing, send, send, send, send, send, send19, send19, send19, send19, setFFIHandle, setFlag, setFrozen, setInstanceVariable, setInternalVariable, setMetaClass, setNativeHandle, setTaint, setUntrusted, setVariable, singleton_method_added19, singleton_method_removed19, singleton_method_undefined19, singleton_methods, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, taint, tainted_p, testFrozen, testFrozen, to_a, to_s, toJava, trust, type_deprecated, type, untaint, untrust, untrusted_p, validateInstanceVariable, validateInstanceVariable, variableTableContains, variableTableFastContains, variableTableFastFetch, variableTableFastStore, variableTableFetch, variableTableRemove, variableTableStore, variableTableSync, yieldUnder, yieldUnder

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

EXCEPTION_ALLOCATOR

public static ObjectAllocator EXCEPTION_ALLOCATOR

message

public IRubyObject message

Deprecated. do not access the field directly

See Also:

getMessage()

TRACE_HEAD

public static final int TRACE_HEAD

See Also:

Constant Field Values

TRACE_TAIL

public static final int TRACE_TAIL

See Also:

Constant Field Values

TRACE_MAX

public static final int TRACE_MAX

See Also:

Constant Field Values

Constructor Detail

RubyException

protected RubyException(Ruby runtime,
                        RubyClass rubyClass)

RubyException

public RubyException(Ruby runtime,
                     RubyClass rubyClass,
                     String message)

Method Detail

initialize

public IRubyObject initialize(IRubyObject[] args,
                              Block block)

backtrace

public IRubyObject backtrace()

set_backtrace

public IRubyObject set_backtrace(IRubyObject obj)

backtrace_locations

public IRubyObject backtrace_locations(ThreadContext context)

exception

public static IRubyObject exception(ThreadContext context,
                                    IRubyObject recv,
                                    IRubyObject[] args,
                                    Block block)

exception

public RubyException exception(IRubyObject[] args)

to_s

public IRubyObject to_s(ThreadContext context)

to_s19

@Deprecated
public IRubyObject to_s19(ThreadContext context)

Deprecated.

message

public IRubyObject message(ThreadContext context)

inspect

public RubyString inspect(ThreadContext context)

inspects an object and return a kind of debug information

Returns:

A RubyString containing the debug information.

op_equal

public RubyBoolean op_equal(ThreadContext context,
                            IRubyObject other)

Description copied from class: RubyBasicObject

rb_obj_equal Will by default use identity equality to compare objects. This follows the Ruby semantics. The name of this method doesn't follow the convention because hierarchy problems

Specified by:

op_equal in interface IRubyObject

Overrides:

op_equal in class RubyBasicObject

op_eqq

public static IRubyObject op_eqq(ThreadContext context,
                                 IRubyObject recv,
                                 IRubyObject other)

cause

public IRubyObject cause(ThreadContext context)

setCause

public void setCause(IRubyObject cause)

getCause

public Object getCause()

setBacktraceData

public void setBacktraceData(BacktraceData backtraceData)

getBacktraceData

public BacktraceData getBacktraceData()

getBacktraceElements

public RubyStackTraceElement[] getBacktraceElements()

prepareBacktrace

public void prepareBacktrace(ThreadContext context,
                             boolean nativeException)

prepareIntegratedBacktrace

public void prepareIntegratedBacktrace(ThreadContext context,
                                       StackTraceElement[] javaTrace)

Prepare an "integrated" backtrace that includes the normal Ruby trace plus non-filtered Java frames. Used by Java integration to show the Java frames for a JI-called method.

Parameters:

context -

javaTrace -

forceBacktrace

public void forceBacktrace(IRubyObject backtrace)

getBacktrace

public IRubyObject getBacktrace()

initBacktrace

public void initBacktrace()

copySpecialInstanceVariables

public void copySpecialInstanceVariables(IRubyObject clone)

Description copied from class: RubyBasicObject

Lots of MRI objects keep their state in non-lookupable ivars (e:g. Range, Struct, etc). This method is responsible for dupping our java field equivalents

Specified by:

copySpecialInstanceVariables in interface IRubyObject

Overrides:

copySpecialInstanceVariables in class RubyBasicObject

printBacktrace

public void printBacktrace(PrintStream errorStream)

Print the Ruby exception's backtrace to the given PrintStream.

Parameters:

errorStream - the PrintStream to which backtrace should be printed

printBacktrace

public void printBacktrace(PrintStream errorStream,
                           int skip)

Print the Ruby exception's backtrace to the given PrintStream. This version accepts a number of lines to skip and is primarily used internally for exception printing where the first line is treated specially.

Parameters:

errorStream - the PrintStream to which backtrace should be printed

createExceptionClass

public static RubyClass createExceptionClass(Ruby runtime)

newException

public static RubyException newException(Ruby runtime,
                                         RubyClass excptnClass,
                                         String msg)

newException

public static IRubyObject newException(ThreadContext context,
                                       RubyClass exceptionClass,
                                       IRubyObject message)

getMessage

public IRubyObject getMessage()

Returns:

error message if provided or nil

getMessageAsJavaString

public String getMessageAsJavaString()