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

Direct Known Subclasses:

Exception

public class RaiseException
extends JumpException

See Also:

Serialized Form

Nested Class Summary

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

JumpException.FlowControlException, JumpException.SpecialJump

Field Summary

Fields inherited from class org.jruby.exceptions.JumpException

SPECIAL_JUMP

Constructor Summary

Constructors

Modifier	Constructor and Description
	RaiseException(RubyException exception) Deprecated.
	RaiseException(RubyException exception, boolean unused) Deprecated.
	RaiseException(RubyException exception, IRubyObject backtrace) Deprecated.
	RaiseException(Ruby runtime, RubyClass exceptionClass, java.lang.String msg) Deprecated.
	RaiseException(Ruby runtime, RubyClass exceptionClass, java.lang.String msg, boolean unused) Deprecated.
	RaiseException(Ruby runtime, RubyClass exceptionClass, java.lang.String msg, IRubyObject backtrace) Deprecated.
	RaiseException(Ruby runtime, RubyClass exceptionClass, java.lang.String msg, IRubyObject backtrace, boolean unused) Deprecated.
protected	RaiseException(java.lang.String message, RubyException exception)
	RaiseException(java.lang.Throwable cause, NativeException nativeException) Deprecated.

Method Summary

Modifier and Type	Method and Description
static RaiseException	createNativeRaiseException(Ruby runtime, java.lang.Throwable cause) Deprecated.
static RaiseException	createNativeRaiseException(Ruby runtime, java.lang.Throwable cause, java.lang.reflect.Member target) Deprecated.
java.lang.Throwable	fillInStackTrace() This method don't do anything for performance reasons.
static RaiseException	from(RubyException exception, IRubyObject backtrace) Deprecated.
static RaiseException	from(Ruby runtime, RubyClass exceptionClass, IRubyObject... args) Construct a new throwable RaiseException appropriate for the target Ruby exception class.
static RaiseException	from(Ruby runtime, RubyClass exceptionClass, java.lang.String msg) Construct a new throwable RaiseException appropriate for the target Ruby exception class.
static RaiseException	from(Ruby runtime, RubyClass exceptionClass, java.lang.String msg, IRubyObject backtrace) Construct a new throwable RaiseException appropriate for the target Ruby exception class.
static RaiseException	from(Ruby runtime, java.lang.String exceptionPath, IRubyObject... args) Construct a new throwable RaiseException appropriate for the target Ruby exception class.
static RaiseException	from(Ruby runtime, java.lang.String exceptionPath, java.lang.String msg) Construct a new throwable RaiseException appropriate for the target Ruby exception class.
static RaiseException	from(Ruby runtime, java.lang.String exceptionPath, java.lang.String msg, IRubyObject backtrace) Construct a new throwable RaiseException appropriate for the target Ruby exception class.
java.lang.Throwable	getCause()
RubyException	getException() Gets the exception
java.lang.String	getMessage()
static java.lang.StackTraceElement[]	javaTraceFromRubyTrace(RubyStackTraceElement[] trace)
protected void	setException(RubyException newException) Sets the exception
protected void	setException(RubyException newException, boolean unused) Deprecated.

Methods inherited from class org.jruby.exceptions.JumpException

originalFillInStackTrace

Methods inherited from class java.lang.Throwable

addSuppressed, 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

Constructor Detail

RaiseException

protected RaiseException(java.lang.String message,
                         RubyException exception)

RaiseException

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

Deprecated.

RaiseException

@Deprecated
public RaiseException(RubyException exception)

Deprecated.

RaiseException

@Deprecated
public RaiseException(RubyException exception,
                                  boolean unused)

Deprecated.

RaiseException

@Deprecated
public RaiseException(RubyException exception,
                                  IRubyObject backtrace)

Deprecated.

RaiseException

@Deprecated
public RaiseException(Ruby runtime,
                                  RubyClass exceptionClass,
                                  java.lang.String msg)

Deprecated.

RaiseException

@Deprecated
public RaiseException(Ruby runtime,
                                  RubyClass exceptionClass,
                                  java.lang.String msg,
                                  boolean unused)

Deprecated.

RaiseException

@Deprecated
public RaiseException(Ruby runtime,
                                  RubyClass exceptionClass,
                                  java.lang.String msg,
                                  IRubyObject backtrace)

Deprecated.

RaiseException

@Deprecated
public RaiseException(Ruby runtime,
                                  RubyClass exceptionClass,
                                  java.lang.String msg,
                                  IRubyObject backtrace,
                                  boolean unused)

Deprecated.

Method Detail

fillInStackTrace

public final java.lang.Throwable fillInStackTrace()

Description copied from class: JumpException

This method don't do anything for performance reasons.

Overrides:

fillInStackTrace in class JumpException

See Also:

Throwable.fillInStackTrace()

from

public static RaiseException from(Ruby runtime,
                                  RubyClass exceptionClass,
                                  java.lang.String msg)

Construct a new throwable RaiseException appropriate for the target Ruby exception class.

Parameters:

runtime - the current JRuby runtime

exceptionClass - the class of the exception to construct and raise

msg - a simple message for the exception

Returns:

a RaiseException instance appropriate for the target Ruby exception class

from

public static RaiseException from(Ruby runtime,
                                  RubyClass exceptionClass,
                                  java.lang.String msg,
                                  IRubyObject backtrace)

Construct a new throwable RaiseException appropriate for the target Ruby exception class.

Parameters:

runtime - the current JRuby runtime

exceptionClass - the class of the exception to construct and raise

msg - a simple message for the exception

backtrace - a Ruby object (usually an Array) to use for the exception's backtrace

Returns:

a RaiseException instance appropriate for the target Ruby exception class

from

public static RaiseException from(Ruby runtime,
                                  RubyClass exceptionClass,
                                  IRubyObject... args)

Construct a new throwable RaiseException appropriate for the target Ruby exception class.

Parameters:

runtime - the current JRuby runtime

exceptionClass - the class of the exception to construct and raise

args - the arguments for the exception's constructor

Returns:

a RaiseException instance appropriate for the target Ruby exception class

from

public static RaiseException from(Ruby runtime,
                                  java.lang.String exceptionPath,
                                  java.lang.String msg)

Construct a new throwable RaiseException appropriate for the target Ruby exception class.

Parameters:

runtime - the current JRuby runtime

exceptionPath - a string representing the fully-qualified constant path to look up the exception

msg - a simple message for the exception

Returns:

a RaiseException instance appropriate for the target Ruby exception class

from

public static RaiseException from(Ruby runtime,
                                  java.lang.String exceptionPath,
                                  java.lang.String msg,
                                  IRubyObject backtrace)

Construct a new throwable RaiseException appropriate for the target Ruby exception class.

Parameters:

runtime - the current JRuby runtime

exceptionPath - a string representing the fully-qualified constant path to look up the exception

msg - a simple message for the exception

backtrace - a Ruby object (usually an Array) to use for the exception's backtrace

Returns:

a RaiseException instance appropriate for the target Ruby exception class

from

public static RaiseException from(Ruby runtime,
                                  java.lang.String exceptionPath,
                                  IRubyObject... args)

Construct a new throwable RaiseException appropriate for the target Ruby exception class.

Parameters:

runtime - the current JRuby runtimeString exceptionPath

args - the arguments for the exception's constructor

Returns:

a RaiseException instance appropriate for the target Ruby exception class

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable

getCause

public java.lang.Throwable getCause()

Overrides:

getCause in class java.lang.Throwable

getException

public final RubyException getException()

Gets the exception

Returns:

Returns a RubyException

setException

protected final void setException(RubyException newException)

Sets the exception

Parameters:

newException - The exception to set

javaTraceFromRubyTrace

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

createNativeRaiseException

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

Deprecated.

createNativeRaiseException

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

Deprecated.

setException

@Deprecated
protected final void setException(RubyException newException,
                                              boolean unused)

Deprecated.

from

@Deprecated
public static RaiseException from(RubyException exception,
                                              IRubyObject backtrace)

Deprecated.