org.mases.jcobridge

Class JCNativeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.mases.jcobridge.JCException

org.mases.jcobridge.JCNativeException

All Implemented Interfaces:

Serializable

public class JCNativeException
extends JCException

Exception thrown when a CLR exception crosses the JNI boundary into the JVM.

When a CLR method invoked via JCOBridge throws a .NET exception, the bridge catches it, serializes the exception type and message into a structured string of the form "CLRExceptionFromJVM [FullyQualifiedTypeName] message...", and re-throws it as a JCNativeException. The CLR exception type is extracted from this string by checkForCLRException(java.lang.String) and stored in _clrType.

The original CLR exception object may also be available via getCLRException() as a JCObject, allowing further inspection of the CLR exception properties from the JVM side.

See also: JCOReflector for usage examples.

Since:

2.0.0.0

Author:

MASES S.R.L.

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
JCObject	getCLRException() Returns the CLR exception object wrapped as a JCObject, allowing further inspection of CLR exception properties (e.g.
String	getCLRType() Returns the fully qualified CLR exception type name, or null if this exception did not originate from the CLR side.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getCLRType

public String getCLRType()

Returns the fully qualified CLR exception type name, or null if this exception did not originate from the CLR side.

Returns:

the CLR exception type name, e.g. "System.InvalidOperationException", or null.

getCLRException

public JCObject getCLRException()

Returns the CLR exception object wrapped as a JCObject, allowing further inspection of CLR exception properties (e.g. InnerException, StackTrace) from the JVM side. Returns null if the CLR exception object was not attached.

Returns:

the CLR exception as a JCObject, or null.