Table of Contents

Interface IJVMWrapperManagement

Namespace
MASES.JCOBridge.C2JBridge.JVMInterop
Assembly
C2JBridge.dll

Interface defining methods to manage special behaviors of the CLR/JVM interaction

public interface IJVMWrapperManagement
Extension Methods

Properties

EnableCriticalMethods

Always enable/disable use of critical methods within JNI interface, to get/set native type arrays, single wrapper for EnableCriticalMethodsOnGet and EnableCriticalMethodsOnSet

bool? EnableCriticalMethods { get; set; }

Property Value

bool?

EnableCriticalMethodsOnGet

Always enable/disable use of critical methods, within JNI interface, to get native type arrays

bool? EnableCriticalMethodsOnGet { get; set; }

Property Value

bool?

EnableCriticalMethodsOnGetThreshold

Enable/Disable use of critical methods, within JNI interface, to get native type arrays if the length is over the EnableCriticalMethodsOnSetThreshold. Default is MaxValue

int EnableCriticalMethodsOnGetThreshold { get; set; }

Property Value

int

EnableCriticalMethodsOnSet

Always enable/disable use of critical methods, within JNI interface, to set native type arrays

bool? EnableCriticalMethodsOnSet { get; set; }

Property Value

bool?

EnableCriticalMethodsOnSetThreshold

Enable/Disable use of critical methods, within JNI interface, to set native type arrays if the length is over the EnableCriticalMethodsOnSetThreshold. Default is MaxValue

int EnableCriticalMethodsOnSetThreshold { get; set; }

Property Value

int

FeatureLevel

Reports the feature level of the JVM in use

int FeatureLevel { get; }

Property Value

int

Remarks

-1 means the feature level was not identified

Methods

GetCLRGlobal(string)

Get previously registered object from CLR global mapper

object GetCLRGlobal(string key)

Parameters

key string

The key to identify the registered object

Returns

object

Previously registered global object

GetJCGraphicContainer(IJavaObject, bool)

Requests to allocate a remote graphic container to host the Component in graphicObject

IJCGraphicContainer GetJCGraphicContainer(IJavaObject graphicObject, bool isWPF)

Parameters

graphicObject IJavaObject

The object, in the form of IJavaObject, to be inserted in the grphical hierarchy

isWPF bool

true if the request come from a WPF host application, false for WinForms host application

Returns

IJCGraphicContainer

A IJCGraphicContainer reference to the newly allocated container

Remarks

This version supports a single JCGraphicContainer needing direct management of Windows Message Pump, other JCGraphicContainer must internally manages message pump, setting the property IsRemoteManaged to true.

GetJCGraphicContainer(string, bool)

Requests to allocate a remote graphic container to host the Component with class name className

IJCGraphicContainer GetJCGraphicContainer(string className, bool isWPF)

Parameters

className string

The name of the class to allocate and insert in the grphical hierarchy

isWPF bool

true if the request come from a WPF host application, false for WinForms host application

Returns

IJCGraphicContainer

A IJCGraphicContainer reference to the newly allocated container

Remarks

This version supports a single JCGraphicContainer needing direct management of Windows Message Pump, other JCGraphicContainer must internally manages message pump, setting the property IsRemoteManaged to true.

GetJVMGlobal(string)

Get previously registered IJavaObject from JVM global mapper

IJavaObject GetJVMGlobal(string key)

Parameters

key string

The key to identify the registered object

Returns

IJavaObject

Previously registered global IJavaObject

GetListener(IJavaObject)

Returns the IJVMBridgeBase listener reference associated to the JVM reference

IJVMBridgeBase GetListener(IJavaObject eventListener)

Parameters

eventListener IJavaObject

The JVM reference associated to the IJVMBridgeBase

Returns

IJVMBridgeBase

The IJVMBridgeBase associated to the eventListener

InitializeListener(IJVMBridgeBase)

Request the initialization of the Listener from the JVM. The listener is a new class which inherits from JVMBridgeListener or JVMBridgeListener

void InitializeListener(IJVMBridgeBase listener)

Parameters

listener IJVMBridgeBase

The IJVMBridgeBase listener reference to be initialized

RegisterCLRGlobal(string, object)

Register the object into the global CLR mapper.

void RegisterCLRGlobal(string key, object obj)

Parameters

key string

The key to identify the registered

obj object

The object to register

ReleaseJCGraphicContainer(IJCGraphicContainer)

Reelase a IJCGraphicContainer from the JVM

void ReleaseJCGraphicContainer(IJCGraphicContainer container)

Parameters

container IJCGraphicContainer

The IJCGraphicContainer to be released

ReleaseListener(IJVMBridgeBase)

Release a IJVMBridgeBase listener reference from the JVM

void ReleaseListener(IJVMBridgeBase listener)

Parameters

listener IJVMBridgeBase

The IJVMBridgeBase listener reference to be released

UnregisterCLRGlobal(string)

Unregister the object from the global CLR mapper.

void UnregisterCLRGlobal(string key)

Parameters

key string

The key to identify the registered