org.jruby
Class RubyException

java.lang.Object
  extended by org.jruby.RubyBasicObject
      extended by org.jruby.RubyObject
          extended by org.jruby.RubyException
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<IRubyObject>, InstanceVariables, InternalVariables, IRubyObject, CoreObjectType
Direct Known Subclasses:
NativeException, RubyIconv.RubyFailure, RubyLocalJumpError, RubyNameError, RubySystemCallError, RubySystemExit

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, RubyObject.ObjectMethods
 
Nested classes/interfaces inherited from class org.jruby.RubyBasicObject
RubyBasicObject.BasicObjectMethods, RubyBasicObject.Finalizer
 
Field Summary
 IRubyObject message
           
static int RAW
           
static int RAW_FILTERED
           
static int RAW_FRAME_CROP_COUNT
           
static int RUBINIUS
           
static int RUBY_COMPILED
           
static int RUBY_FRAMED
           
static int RUBY_HYBRID
           
static int TRACE_HEAD
           
static int TRACE_MAX
           
static int TRACE_TAIL
           
static int TRACE_TYPE
           
 
Fields inherited from class org.jruby.RubyObject
OBJECT_ALLOCATOR
 
Fields inherited from class org.jruby.RubyBasicObject
ALL_F, COMPARE_BY_IDENTITY_F, ERR_INSECURE_SET_INST_VAR, FALSE_F, FL_USHIFT, flags, FROZEN_F, metaClass, NEVER, NIL_F, TAINTED_F, UNDEF, UNTRUSTED_F, USER0_F, USER1_F, USER2_F, USER3_F, USER4_F, USER5_F, USER6_F, USER7_F
 
Fields inherited from interface org.jruby.runtime.builtin.IRubyObject
NULL_ARRAY
 
Constructor Summary
protected RubyException(Ruby runtime, RubyClass rubyClass)
           
  RubyException(Ruby runtime, RubyClass rubyClass, java.lang.String message)
           
 
Method Summary
 IRubyObject backtrace()
           
 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)
           
 IRubyObject getBacktrace()
           
 ThreadContext.RubyStackTraceElement[] getBacktraceFrames()
           
 void initBacktrace()
           
 IRubyObject initialize(IRubyObject[] args, Block block)
           
 IRubyObject inspect(ThreadContext context)
          inspects an object and return a kind of debug information
 IRubyObject message(ThreadContext context)
           
static RubyException newException(Ruby runtime, RubyClass excptnClass, java.lang.String msg)
           
static IRubyObject newException(ThreadContext context, RubyClass exceptionClass, IRubyObject message)
           
 void printBacktrace(java.io.PrintStream errorStream)
           
 IRubyObject set_backtrace(IRubyObject obj)
           
 void setBacktraceFrames(ThreadContext.RubyStackTraceElement[] backtraceFrames)
           
 IRubyObject to_s(ThreadContext context)
           
 IRubyObject to_str(ThreadContext context)
           
 
Methods inherited from class org.jruby.RubyObject
as, attachToObjectSpace, callInit, checkFrozen, convertToType, createObjectClass, display, dup, eql_p, eqlInternal, equal_p, equalInternal, equals, evalUnder, evalUnder, extend, freeze, frozen_p, getNativeTypeIndex, hash, hashCode, id_deprecated, id, initialize_copy, initialize, inspect, instance_eval, instance_eval, instance_eval, instance_eval, instance_eval, instance_exec, instance_of_p, instance_variable_defined_p, instance_variable_get, instance_variable_set, instance_variables, kind_of_p, method, methods, methods, methods19, nil_p, op_eqq, op_equal, op_match, op_not_match, private_methods, private_methods19, protected_methods, protected_methods19, public_methods, public_methods19, puts, rbClone, remove_instance_variable, respond_to_p, respond_to_p, send, send, send, send, send, singleton_methods, singleton_methods19, singletonMethods, specificEval, specificEval, specificEval, specificEval, specificEval, taint, tainted_p, to_a, to_java, to_s, toString, trust, type_deprecated, type, untaint, untrust, untrusted_p, validateInstanceVariable
 
Methods inherited from class org.jruby.RubyBasicObject
addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkStringType, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, ensureInstanceVariablesSettable, eql, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, getFlag, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getJavaClass, getMetaClass, getRuntime, getSingletonClass, getSingletonClassClone, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hasInstanceVariable, hasInternalVariable, hasVariables, infectBy, isClass, isFalse, isFrozen, isImmediate, isModule, isNil, isTaint, isTrue, isUntrusted, makeMetaClass, op_not_equal, op_not, removeFinalizers, removeInstanceVariable, removeInternalVariable, respondsTo, setFlag, setFrozen, setInstanceVariable, setInternalVariable, setMetaClass, setTaint, setUntrusted, setVariable, syncVariables, taint, testFrozen, testFrozen, toJava, variableTableContains, variableTableFastContains, variableTableFastFetch, variableTableFastStore, variableTableFetch, variableTableGetSize, variableTableRemove, variableTableStore, variableTableSync
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

message

public IRubyObject message

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

RAW

public static final int RAW
See Also:
Constant Field Values

RAW_FILTERED

public static final int RAW_FILTERED
See Also:
Constant Field Values

RUBY_FRAMED

public static final int RUBY_FRAMED
See Also:
Constant Field Values

RUBY_COMPILED

public static final int RUBY_COMPILED
See Also:
Constant Field Values

RUBY_HYBRID

public static final int RUBY_HYBRID
See Also:
Constant Field Values

RUBINIUS

public static final int RUBINIUS
See Also:
Constant Field Values

RAW_FRAME_CROP_COUNT

public static final int RAW_FRAME_CROP_COUNT
See Also:
Constant Field Values

TRACE_TYPE

public static int TRACE_TYPE
Constructor Detail

RubyException

protected RubyException(Ruby runtime,
                        RubyClass rubyClass)

RubyException

public RubyException(Ruby runtime,
                     RubyClass rubyClass,
                     java.lang.String message)
Method Detail

createExceptionClass

public static RubyClass createExceptionClass(Ruby runtime)

newException

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

setBacktraceFrames

public void setBacktraceFrames(ThreadContext.RubyStackTraceElement[] backtraceFrames)

getBacktraceFrames

public ThreadContext.RubyStackTraceElement[] getBacktraceFrames()

getBacktrace

public IRubyObject getBacktrace()

initBacktrace

public void initBacktrace()

initialize

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

backtrace

public IRubyObject backtrace()

set_backtrace

public IRubyObject set_backtrace(IRubyObject obj)

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_str

public IRubyObject to_str(ThreadContext context)

message

public IRubyObject message(ThreadContext context)

inspect

public IRubyObject inspect(ThreadContext context)
inspects an object and return a kind of debug information

Returns:
A RubyString containing the debug information.

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(java.io.PrintStream errorStream)

newException

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


Copyright © 2002-2009 JRuby Team. All Rights Reserved.