Class JVMBridgeException

Namespace

MASES.JCOBridge.C2JBridge

Assembly

C2JBridge.dll

Java Exception base class

public class JVMBridgeException : Exception, ISerializable, _Exception, IJVMBridgeCore

Inheritance

object

Exception

JVMBridgeException

Implements

ISerializable

_Exception

IJVMBridgeCore

Derived

JVMBridgeException<TException>

Inherited Members

Exception.GetBaseException()

Exception.ToString()

Exception.GetObjectData(SerializationInfo, StreamingContext)

Exception.GetType()

Exception.Message

Exception.Data

Exception.InnerException

Exception.TargetSite

Exception.HelpLink

Exception.Source

Exception.HResult

Exception.SerializeObjectState

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.MemberwiseClone()

Extension Methods

JCOBridge.Globalize(IJVMBridgeCore, bool)

JCOBridgeExtensions.Convert<TReturn>(object)

JCOBridgeExtensions.Convert<TReturn>(object)

JCOBridgeExtensions.Convert<TReturn>(object)

JCOBridgeExtensions.Convert<TReturn>(object)

JCOBridgeExtensions.ToNative(object)

JCOBridgeExtensions.ToNative(object)

JCOBridgeExtensions.ToNative(object)

JCOBridgeExtensions.ToNative(object)

Constructors

JVMBridgeException()

Initializes a new instance of the Exception class.

public JVMBridgeException()

JVMBridgeException(string)

Initializes a new instance of the Exception class with a specified error message.

public JVMBridgeException(string message)

Parameters

message string

The message that describes the error.

JVMBridgeException(string, Exception)

Initializes a new instance of the Exception class with a specified error message and a reference to the inner exception that is the cause of this exception.

public JVMBridgeException(string message, Exception innerException)

Parameters

message string

The error message that explains the reason for the exception.

innerException Exception

The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.

Properties

BridgeClassName

Java class name of the exception

public virtual string BridgeClassName { get; }

Property Value

string

BridgeInstance

The instance of BridgeClassName

public IJavaObject BridgeInstance { get; protected set; }

Property Value

IJavaObject

DynBridgeInstance

The dynamic accessor to BridgeInstance

public dynamic DynBridgeInstance { get; }

Property Value

dynamic

StackTrace

Gets a string representation of the immediate frames on the call stack.

public override string StackTrace { get; }

Property Value

string

A string that describes the immediate frames of the call stack.

Methods

BiThrow<TException>(params object[])

Initialize and throw an instance of TException in JVM and then in CLR

public static void BiThrow<TException>(params object[] args) where TException : JVMBridgeException

Parameters

args object[]

The arguments of the TException constructor

Type Parameters

TException

A Type extending JVMBridgeException

CreateWithSignature<TException>(string, params object[])

Used to create instance of TException

public static TException CreateWithSignature<TException>(string signature, params object[] args) where TException : JVMBridgeException

Parameters

signature string

The JNI constructor signature to be used

args object[]

The arguments of constructor

Returns

TException

A Java instance of TException

Type Parameters

TException

A Type extending JVMBridgeException

Remarks

You cannot use throw on the returned TException to raise an exception to Java context. This is a special method to allocate an exception in Java context. It avoids reflection problems with the behavior used to report back in .NET the exceptions raised from Java methods.

Create<TException>(params object[])

Used to create instance of TException

public static TException Create<TException>(params object[] args) where TException : JVMBridgeException

Parameters

args object[]

The arguments of constructor

Returns

TException

A Java instance of TException

Type Parameters

TException

A Type extending JVMBridgeException

Remarks

You cannot use throw on the returned TException to raise an exception to Java context. This is a special method to allocate an exception in Java context. It avoids reflection problems with the behavior used to report back in .NET the exceptions raised from Java methods.

IExecute(string, params object[])

Executes an instance method

public object IExecute(string methodName, params object[] args)

Parameters

methodName string

The instance method to be invoked

args object[]

Possible arguments

Returns

object

The result of execution. Void functions returns null.

IExecuteArray<TArrayType>(string, params object[])

Execute the method and build the result as an array of TArrayType

public TArrayType[] IExecuteArray<TArrayType>(string methodName, params object[] args)

Parameters

methodName string

The method to execute

args object[]

The aruments

Returns

TArrayType[]

An array of TArrayType

Type Parameters

TArrayType

The expected Type of the resulting array

IExecuteWithSignature(string, string, params object[])

Executes an instance method

public object IExecuteWithSignature(string methodName, string signature, params object[] args)

Parameters

methodName string

The instance method to be invoked

signature string

Method signature to use in search criteria

args object[]

Possible arguments

Returns

object

The result of execution. Void functions returns null.

IExecuteWithSignatureArray<TArrayType>(string, string, params object[])

Execute the method and build the result as an array of TArrayType

public TArrayType[] IExecuteWithSignatureArray<TArrayType>(string methodName, string signature, params object[] args)

Parameters

methodName string

The method to execute

signature string

Method signature to use in search criteria

args object[]

The aruments

Returns

TArrayType[]

An array of TArrayType

Type Parameters

TArrayType

The expected Type of the resulting array

IExecuteWithSignature<TReturn>(string, string, params object[])

Executes an instance method

public TReturn IExecuteWithSignature<TReturn>(string methodName, string signature, params object[] args)

Parameters

methodName string

The instance method to be invoked

signature string

Method signature to use in search criteria

args object[]

Possible arguments

Returns

TReturn

The result of execution. Void functions returns default.

Type Parameters

TReturn

The return type expected: class implementing IJVMBridgeBase, IJavaObject, Enum, primitive types or array of primitives types

IExecuteWithSignature<TNewClass, TReturn>(string, string, params object[])

Executes an instance method

public TReturn IExecuteWithSignature<TNewClass, TReturn>(string methodName, string signature, params object[] args) where TNewClass : IJVMBridgeBase, TReturn

Parameters

methodName string

The instance method to be invoked

signature string

Method signature to use in search criteria

args object[]

Possible arguments

Returns

TReturn

The result of execution. Void functions returns default.

Type Parameters

TNewClass

The argument type to be used

TReturn

The return type expected: class implementing IJVMBridgeBase, IJavaObject, Enum, primitive types or array of primitives types

IExecuteWithSignature<TNewClass, TReturn, TConverter>(string, string, params object[])

Executes an instance method

public TReturn IExecuteWithSignature<TNewClass, TReturn, TConverter>(string methodName, string signature, params object[] args) where TNewClass : IJVMBridgeBase, TReturn where TConverter : IJVMBridgeBaseConvert<TNewClass, TReturn>, new()

Parameters

methodName string

The instance method to be invoked

signature string

Method signature to use in search criteria

args object[]

Possible arguments

Returns

TReturn

The result of execution. Void functions returns default.

Type Parameters

TNewClass

The argument type to be used

TReturn

The return type expected: class implementing IJVMBridgeBase, IJavaObject, Enum, primitive types or array of primitives types

TConverter

The converter to be used to convert from TNewClass to TReturn

IExecute<TReturn>(string, params object[])

Executes an instance method

public TReturn IExecute<TReturn>(string methodName, params object[] args)

Parameters

methodName string

The instance method to be invoked

args object[]

Possible arguments

Returns

TReturn

The result of execution. Void functions returns default.

Type Parameters

TReturn

The return type expected: class implementing IJVMBridgeBase, IJavaObject, Enum, primitive types or array of primitives types

IExecute<TNewClass, TReturn>(string, params object[])

Executes an instance method

public TReturn IExecute<TNewClass, TReturn>(string methodName, params object[] args) where TNewClass : IJVMBridgeBase, TReturn

Parameters

methodName string

The instance method to be invoked

args object[]

Possible arguments

Returns

TReturn

The result of execution. Void functions returns default.

Type Parameters

TNewClass

The argument type to be used

TReturn

The return type expected: class implementing IJVMBridgeBase, IJavaObject, Enum, primitive types or array of primitives types

IExecute<TNewClass, TReturn, TConverter>(string, params object[])

Executes an instance method

public TReturn IExecute<TNewClass, TReturn, TConverter>(string methodName, params object[] args) where TNewClass : IJVMBridgeBase, TReturn where TConverter : IJVMBridgeBaseConvert<TNewClass, TReturn>, new()

Parameters

methodName string

The instance method to be invoked

args object[]

Possible arguments

Returns

TReturn

The result of execution. Void functions returns default.

Type Parameters

TNewClass

The argument type to be used

TReturn

The return type expected: class implementing IJVMBridgeBase, IJavaObject, Enum, primitive types or array of primitives types

TConverter

The converter to be used to convert from TNewClass to TReturn

IsInstanceOf(IJavaType)

Verify if this IJavaObject is an instance of clazz

public bool IsInstanceOf(IJavaType clazz)

Parameters

clazz IJavaType

The IJavaType to be checked

Returns

bool

true if this IJavaObject is an instance of clazz, otherwise false

IsInstanceOf<T>()

Verify if this IJavaObject is an instance of T

public bool IsInstanceOf<T>() where T : IJVMBridgeBase

Returns

bool

true if this IJavaObject is an instance of T, otherwise false

Type Parameters

T

A type implementing IJVMBridgeBase

New(IJavaObject)

Initialize a new JVMBridgeException class

public static JVMBridgeException New(IJavaObject javaObject)

Parameters

javaObject IJavaObject

The remote IJavaObject to be used

Returns

JVMBridgeException

An newly initialized JVMBridgeException

New<TException>(IJavaObject)

Initialize a new TException class

public static TException New<TException>(IJavaObject javaObject) where TException : JVMBridgeException

Parameters

javaObject IJavaObject

The remote IJavaObject to be used

Returns

TException

An newly initialized TException

Type Parameters

TException

An exception class inherited from JVMBridgeException<TException>

Throw<TException>(params object[])

Initialize and throw an instance of TException in JVM

public static void Throw<TException>(params object[] args) where TException : JVMBridgeException

Parameters

args object[]

The arguments of the TException constructor

Type Parameters

TException

A Type extending JVMBridgeException