org.jruby.exceptions

Class RaiseException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.jruby.exceptions.JumpException

org.jruby.exceptions.RaiseException

All Implemented Interfaces:

java.io.Serializable

public class RaiseException
extends JumpException

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.jruby.exceptions.JumpException

JumpException.BreakJump, JumpException.FlowControlException, JumpException.NextJump, JumpException.RedoJump, JumpException.RetryJump, JumpException.ReturnJump, JumpException.SpecialJump

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG
private RubyException	exception
private boolean	nativeException
private java.lang.String	providedMessage
private static long	serialVersionUID

Fields inherited from class org.jruby.exceptions.JumpException

NEXT_JUMP, REDO_JUMP, RETRY_JUMP, SPECIAL_JUMP

Constructor Summary

Constructors

Constructor and Description
RaiseException(RubyException actException) Construct a new RaiseException to wrap the given Ruby exception for Java-land throwing purposes.
RaiseException(RubyException exception, boolean isNativeException)
RaiseException(RubyException exception, IRubyObject backtrace) Construct a new RaiseException to wrap the given Ruby exception for Java-land throwing purposes.
RaiseException(Ruby runtime, RubyClass excptnClass, java.lang.String msg, boolean nativeException)
RaiseException(Ruby runtime, RubyClass excptnClass, java.lang.String msg, IRubyObject backtrace, boolean nativeException)
RaiseException(java.lang.Throwable cause, NativeException nativeException)

Method Summary

Modifier and Type	Method and Description
private static java.lang.String	buildMessage(java.lang.Throwable exception)
static RaiseException	createNativeRaiseException(Ruby runtime, java.lang.Throwable cause) Method still in use by jruby-openssl <= 0.5.2
static RaiseException	createNativeRaiseException(Ruby runtime, java.lang.Throwable cause, java.lang.reflect.Member target)
private void	doCallEventHook(ThreadContext context)
private void	doSetLastError(ThreadContext context)
RubyException	getException() Gets the exception
java.lang.String	getMessage()
static java.lang.StackTraceElement[]	javaTraceFromRubyTrace(RubyStackTraceElement[] trace)
private void	preRaise(ThreadContext context)
private void	preRaise(ThreadContext context, IRubyObject backtrace)
private void	preRaise(ThreadContext context, java.lang.StackTraceElement[] javaTrace)
protected void	setException(RubyException newException, boolean nativeException) Sets the exception

Methods inherited from class org.jruby.exceptions.JumpException

fillInStackTrace, originalFillInStackTrace

Methods inherited from class java.lang.Throwable

addSuppressed, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static final boolean DEBUG

See Also:

Constant Field Values

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

exception

private RubyException exception

providedMessage

private java.lang.String providedMessage

nativeException

private boolean nativeException

Constructor Detail

RaiseException

public RaiseException(RubyException actException)

Construct a new RaiseException to wrap the given Ruby exception for Java-land throwing purposes. This constructor will generate a backtrace using the Java stack trace and the interpreted Ruby frames for the current thread.

Parameters:

actException - The Ruby exception to wrap

RaiseException

public RaiseException(RubyException exception,
                      IRubyObject backtrace)

Construct a new RaiseException to wrap the given Ruby exception for Java-land throwing purposes. This constructor will not generate a backtrace and will instead use the one specified by the

Parameters:

exception - The Ruby exception to wrap

backtrace -

RaiseException

public RaiseException(Ruby runtime,
                      RubyClass excptnClass,
                      java.lang.String msg,
                      boolean nativeException)

RaiseException

public RaiseException(Ruby runtime,
                      RubyClass excptnClass,
                      java.lang.String msg,
                      IRubyObject backtrace,
                      boolean nativeException)

RaiseException

public RaiseException(RubyException exception,
                      boolean isNativeException)

RaiseException

public RaiseException(java.lang.Throwable cause,
                      NativeException nativeException)

Method Detail

createNativeRaiseException

public static RaiseException createNativeRaiseException(Ruby runtime,
                                                        java.lang.Throwable cause)

Method still in use by jruby-openssl <= 0.5.2

createNativeRaiseException

public static RaiseException createNativeRaiseException(Ruby runtime,
                                                        java.lang.Throwable cause,
                                                        java.lang.reflect.Member target)

buildMessage

private static java.lang.String buildMessage(java.lang.Throwable exception)

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable

getException

public RubyException getException()

Gets the exception

Returns:

Returns a RubyException

preRaise

private void preRaise(ThreadContext context)

preRaise

private void preRaise(ThreadContext context,
                      java.lang.StackTraceElement[] javaTrace)

preRaise

private void preRaise(ThreadContext context,
                      IRubyObject backtrace)

doCallEventHook

private void doCallEventHook(ThreadContext context)

doSetLastError

private void doSetLastError(ThreadContext context)

setException

protected void setException(RubyException newException,
                            boolean nativeException)

Sets the exception

Parameters:

newException - The exception to set

javaTraceFromRubyTrace

public static java.lang.StackTraceElement[] javaTraceFromRubyTrace(RubyStackTraceElement[] trace)