JavaVMMBS.Constructor(path as folderitem)

This is a convenience function which initializes the java with version=JNI_VERSION_1_4 and no options except the specified path.
The path can be a folderitem pointing to a jar file or a folder with class files.

This method raises UnsupportedOperationException with error about missing CreateJavaVM function if there is no Java found. Either because it is not installed or the bit number (32 vs. 64) does not match.

Since version 16.5 the plugin will no longer raise exception if an existing JavaVM was found. In that case we use that JavaVM and return normally. Lasterror will be set to -5 which indicates this. In that case your options and paths are not passed to VM.

See also:

• Constructor(path as string)
• Constructor(version as Integer, options() as string, ignoreUnrecognizedOptions as boolean)
• Constructor(version as Integer, options() as string, path as folderitem, ignoreUnrecognizedOptions as boolean)
• Constructor(version as Integer, options() as string, path as string, ignoreUnrecognizedOptions as boolean)

JavaVMMBS.Constructor(path as string)

This is a convenience function which initializes the java engine with version=JNI_VERSION_1_4 and no options except the specified path.
The path can be a path pointing to a jar file or a folder with class files. If you use more than one path, you need to separate them with ";". Seems like on Mac OS X and Linux the separator is ":".

This method raises UnsupportedOperationException with error about missing CreateJavaVM function if there is no Java found. Either because it is not installed or the bit number (32 vs. 64) does not match.

Since version 16.5 the plugin will no longer raise exception if an existing JavaVM was found. In that case we use that JavaVM and return normally. Lasterror will be set to -5 which indicates this. In that case your options and paths are not passed to VM.

See also:

• Constructor(path as folderitem)
• Constructor(version as Integer, options() as string, ignoreUnrecognizedOptions as boolean)
• Constructor(version as Integer, options() as string, path as folderitem, ignoreUnrecognizedOptions as boolean)
• Constructor(version as Integer, options() as string, path as string, ignoreUnrecognizedOptions as boolean)

JavaVMMBS.Constructor(version as Integer, options() as string, ignoreUnrecognizedOptions as boolean)

Only one VM can run at a time with this plugin.
You can specify whatever command line options you need in the options array.
Version must be one of the JNI_VERSION_1_x constants.

A note for Mac OS X and Java versions:

To specify the current preferred JDK in a family of JVM's, say the 1.5.x family, applications should set the environment variable JAVA_JVM_VERSION to 1.5, and then pass JNI_VERSION_1_4 into JNI_CreateJavaVM as the vm_args.version. To get a specific Java 1.5 JVM, say Java 1.5.0, set the environment variable JAVA_JVM_VERSION to 1.5.0. For Java 1.6 it will be the same in that applications will need to set the environment variable JAVA_JVM_VERSION to 1.6 to specify the current preferred 1.6 Java VM, and to get a specific Java 1.6 JVM, say Java 1.6.1, set the environment variable JAVA_JVM_VERSION to 1.6.1.

To make this sample bring up the current preferred 1.5 JVM, set the environment variable JAVA_JVM_VERSION to 1.5 before calling JNI_CreateJavaVM as shown below. Applications must currently check for availability of JDK 1.5 before requesting it. If your application requires JDK 1.5 and it is not found, it is your responsibility to report an error to the user. To verify if a JVM is installed, check to see if the symlink, or directory exists for the JVM in /System/Library/Frameworks/JavaVM.framework/Versions/ before setting the environment variable JAVA_JVM_VERSION.

If the environment variable JAVA_JVM_VERSION is not set, and JNI_VERSION_1_4 is passed into JNI_CreateJavaVM as the vm_args.version, JNI_CreateJavaVM will return the current preferred JDK. Java 1.4.2 is the preferred JDK as of the release of this sample and the release of Mac OS X 10.4.

Useful option strings:

"-verbose:jni"	show debug output on the console
"-Xms256M"	initial memory
"-Xmx512M"	maximum memory

This method raises UnsupportedOperationException with error about missing CreateJavaVM function if there is no Java found. Either because it is not installed or the bit number (32 vs. 64) does not match.

Since version 16.5 the plugin will no longer raise exception if an existing JavaVM was found. In that case we use that JavaVM and return normally. Lasterror will be set to -5 which indicates this. In that case your options and paths are not passed to VM.

If you get error 126 on Windows, maybe MSVCR100.DLL is missing. So install Visual Studio 2010 runtime libraries. You can download them from Microsoft website. Do not download them from other websites spreading malware!

See also:

• Constructor(path as folderitem)
• Constructor(path as string)
• Constructor(version as Integer, options() as string, path as folderitem, ignoreUnrecognizedOptions as boolean)
• Constructor(version as Integer, options() as string, path as string, ignoreUnrecognizedOptions as boolean)

JavaVMMBS.Constructor(version as Integer, options() as string, path as folderitem, ignoreUnrecognizedOptions as boolean)

dim JarPath as folderitem = specialfolder.desktop.child("test.jar")
dim options() as string

options.append "-Xms256M"
options.append "-Xmx512M"

dim v as new JavaVMMBS( JavaVMMBS.JNI_VERSION_1_4, options, JarPath, false)

This is a convenience function which initializes the java engine with adding the given path to the options.

Only one VM can run at a time with this plugin.
You can specify whatever command line options you need in the options array.
Version must be one of the JNI_VERSION_1_x constants.
The path can be a folderitem pointing to a jar file or a folder with class files.

Useful option strings:

"-verbose:jni"	show debug output on the console
"-Xms256M"	initial memory
"-Xmx512M"	maximum memory

This method raises UnsupportedOperationException with error about missing CreateJavaVM function if there is no Java found. Either because it is not installed or the bit number (32 vs. 64) does not match.

Since version 16.5 the plugin will no longer raise exception if an existing JavaVM was found. In that case we use that JavaVM and return normally. Lasterror will be set to -5 which indicates this. In that case your options and paths are not passed to VM.

See also:

• Constructor(path as folderitem)
• Constructor(path as string)
• Constructor(version as Integer, options() as string, ignoreUnrecognizedOptions as boolean)
• Constructor(version as Integer, options() as string, path as string, ignoreUnrecognizedOptions as boolean)

JavaVMMBS.Constructor(version as Integer, options() as string, path as string, ignoreUnrecognizedOptions as boolean)

This is a convenience function which initializes the java engine with adding the given path to the options.

Only one VM can run at a time with this plugin.
You can specify whatever command line options you need in the options array.
Version must be one of the JNI_VERSION_1_x constants.
The path can be a path pointing to a jar file or a folder with class files. If you use more than one path, you need to separate them with ";". Seems like on Mac OS X and Linux the separator is ":".

Useful option strings:

"-verbose:jni"	show debug output on the console
"-Xms256M"	initial memory
"-Xmx512M"	maximum memory

This method raises UnsupportedOperationException with error about missing CreateJavaVM function if there is no Java found. Either because it is not installed or the bit number (32 vs. 64) does not match.

Since version 16.5 the plugin will no longer raise exception if an existing JavaVM was found. In that case we use that JavaVM and return normally. Lasterror will be set to -5 which indicates this. In that case your options and paths are not passed to VM.

See also:

• Constructor(path as folderitem)
• Constructor(path as string)
• Constructor(version as Integer, options() as string, ignoreUnrecognizedOptions as boolean)
• Constructor(version as Integer, options() as string, path as folderitem, ignoreUnrecognizedOptions as boolean)

JavaVMMBS.DefineClass(name as string, Data as MemoryBlock) as JavaClassMBS

Returns nil in case of error or valid class object on success.
You may want to load a class file and pass it here as String or MemoryBlock.
To read jar file, you can use our archive classes to expand zip archives.

See also:

• DefineClass(name as string, Data as String) as JavaClassMBS

JavaVMMBS.DefineClass(name as string, Data as String) as JavaClassMBS

Returns nil in case of error or valid class object on success.
You may want to load a class file and pass it here as String or MemoryBlock.
To read jar file, you can use our archive classes to expand zip archives.

See also:

• DefineClass(name as string, Data as MemoryBlock) as JavaClassMBS

JavaVMMBS.FindClass(name as string) as JavaClassMBS

dim e as JavaVMMBS // global
dim c as JavaClassMBS
c=e.FindClass("java/lang/String")

This function loads a locally defined class. It searches the directories and zip files specified by the CLASSPATH environment variable for the class with the specified name.

name: a fully qualified class name (that is, a package name, delimited by "/", followed by the class name). If the name begins with "[" (the array signature character), it returns an array class.

Returns nil on any error.

If your class is not found, it may be possible that it can't be loaded as the jar archive has dependencies to other jar archives.

Some examples using this method:

• /Java/Java Get System Property
• /Java/Java Set System Property
• /Java/JavaDatabase/JavaDatabase SQLite blob
• /Java/JavaTest/Java

JavaVMMBS.FreeCurrentThread

dim w as JavaVMMBS // your vm object
w.FreeCurrentThread

The plugin is written to detect if you use it in a thread. But when the thread ends you need to deregister it with the Java runtime.

Some examples using this method:

• /Java/JavaDatabase/java Database Thread Tests
• /Java/JavaDatabase/JavaDatabase MySQL test with Threading

JavaVMMBS.FromReflectedField(field as JavaObjectMBS) as JavaFieldMBS

JavaVMMBS.FromReflectedMethod(method as JavaObjectMBS) as JavaMethodMBS

JavaVMMBS.IsAssignableFrom(TheSubClass as JavaClassMBS, TheSuperClass as JavaClassMBS) as boolean

That means that the sub class is somewhere down the class tree from the super class.

JavaVMMBS.MonitorEnter(obj as JavaObjectMBS) as Integer

Returns zero on success; otherwise, returns a negative value on failure.

Each Java objects has a monitor associated with it. If the current thread already owns the monitor associated with ref, it increments a counter in the monitor indicating the number of times this thread has entered the monitor. If the monitor associated with ref is not owned by any thread, the current thread becomes the owner of the monitor, setting the entry count of this monitor to 1. If another thread already owns the monitor associated with ref, the current thread waits until the monitor is released, then tries again to gain ownership.

JavaVMMBS.MonitorExit(obj as JavaObjectMBS) as Integer

The current thread must be the owner of the monitor associated with the underlying Java object referred to by ref. The thread decrements the counter indicating the number of times it has entered this monitor. If as a result the value of the counter becomes zero, the current thread releases the montior.

Returns zero on success; otherwise, returns a negative value on failure.

JavaVMMBS.NewBooleanArray(ref as JavaObjectMBS) as JavaBooleanArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewBooleanArray(size as Integer) as JavaBooleanArrayMBS
• NewBooleanArray(values() as Boolean) as JavaBooleanArrayMBS

JavaVMMBS.NewBooleanArray(size as Integer) as JavaBooleanArrayMBS

Returns nil on any error.

See also:

• NewBooleanArray(ref as JavaObjectMBS) as JavaBooleanArrayMBS
• NewBooleanArray(values() as Boolean) as JavaBooleanArrayMBS

JavaVMMBS.NewBooleanArray(values() as Boolean) as JavaBooleanArrayMBS

See also:

• NewBooleanArray(ref as JavaObjectMBS) as JavaBooleanArrayMBS
• NewBooleanArray(size as Integer) as JavaBooleanArrayMBS

JavaVMMBS.NewByteArray(ref as JavaObjectMBS) as JavaByteArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewByteArray(size as Integer) as JavaByteArrayMBS
• NewByteArray(values() as UInt8) as JavaBooleanArrayMBS

Some examples using this method:

• /Java/JavaDatabase/JavaDatabase MySQL with JavaInputStreamMBS
• /Java/JavaDatabase/JavaDatabase SQLite blob

JavaVMMBS.NewByteArray(size as Integer) as JavaByteArrayMBS

Returns nil on any error.

See also:

• NewByteArray(ref as JavaObjectMBS) as JavaByteArrayMBS
• NewByteArray(values() as UInt8) as JavaBooleanArrayMBS

JavaVMMBS.NewByteArray(values() as UInt8) as JavaBooleanArrayMBS

See also:

• NewByteArray(ref as JavaObjectMBS) as JavaByteArrayMBS
• NewByteArray(size as Integer) as JavaByteArrayMBS

JavaVMMBS.NewCharArray(ref as JavaObjectMBS) as JavaCharArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewCharArray(size as Integer) as JavaCharArrayMBS
• NewCharArray(values() as UInt16) as JavaCharArrayMBS

JavaVMMBS.NewCharArray(size as Integer) as JavaCharArrayMBS

Returns nil on any error.

See also:

• NewCharArray(ref as JavaObjectMBS) as JavaCharArrayMBS
• NewCharArray(values() as UInt16) as JavaCharArrayMBS

JavaVMMBS.NewCharArray(values() as UInt16) as JavaCharArrayMBS

See also:

• NewCharArray(ref as JavaObjectMBS) as JavaCharArrayMBS
• NewCharArray(size as Integer) as JavaCharArrayMBS

JavaVMMBS.NewDirectByteBuffer(address as Integer, size as Integer) as JavaObjectMBS

See also:

• NewDirectByteBuffer(mem as memoryblock) as JavaObjectMBS

JavaVMMBS.NewDirectByteBuffer(mem as memoryblock) as JavaObjectMBS

Keep the memoryblock until this object is destroyed.

See also:

• NewDirectByteBuffer(address as Integer, size as Integer) as JavaObjectMBS

JavaVMMBS.NewDoubleArray(ref as JavaObjectMBS) as JavaDoubleArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewDoubleArray(size as Integer) as JavaDoubleArrayMBS
• NewDoubleArray(values() as Double) as JavaDoubleArrayMBS

JavaVMMBS.NewDoubleArray(size as Integer) as JavaDoubleArrayMBS

Returns nil on any error.

See also:

• NewDoubleArray(ref as JavaObjectMBS) as JavaDoubleArrayMBS
• NewDoubleArray(values() as Double) as JavaDoubleArrayMBS

JavaVMMBS.NewDoubleArray(values() as Double) as JavaDoubleArrayMBS

See also:

• NewDoubleArray(ref as JavaObjectMBS) as JavaDoubleArrayMBS
• NewDoubleArray(size as Integer) as JavaDoubleArrayMBS

JavaVMMBS.NewFloatArray(ref as JavaObjectMBS) as JavaFloatArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewFloatArray(size as Integer) as JavaFloatArrayMBS
• NewFloatArray(values() as Single) as JavaFloatArrayMBS

JavaVMMBS.NewFloatArray(size as Integer) as JavaFloatArrayMBS

Returns nil on any error.

See also:

• NewFloatArray(ref as JavaObjectMBS) as JavaFloatArrayMBS
• NewFloatArray(values() as Single) as JavaFloatArrayMBS

JavaVMMBS.NewFloatArray(values() as Single) as JavaFloatArrayMBS

See also:

• NewFloatArray(ref as JavaObjectMBS) as JavaFloatArrayMBS
• NewFloatArray(size as Integer) as JavaFloatArrayMBS

JavaVMMBS.NewIntArray(ref as JavaObjectMBS) as JavaIntArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewIntArray(size as Integer) as JavaIntArrayMBS
• NewIntArray(values() as Int32) as JavaIntArrayMBS

JavaVMMBS.NewIntArray(size as Integer) as JavaIntArrayMBS

Returns nil on any error.

See also:

• NewIntArray(ref as JavaObjectMBS) as JavaIntArrayMBS
• NewIntArray(values() as Int32) as JavaIntArrayMBS

JavaVMMBS.NewIntArray(values() as Int32) as JavaIntArrayMBS

See also:

• NewIntArray(ref as JavaObjectMBS) as JavaIntArrayMBS
• NewIntArray(size as Integer) as JavaIntArrayMBS

JavaVMMBS.NewLongArray(ref as JavaObjectMBS) as JavaLongArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewLongArray(size as Integer) as JavaLongArrayMBS
• NewLongArray(values() as Int64) as JavaLongArrayMBS

JavaVMMBS.NewLongArray(size as Integer) as JavaLongArrayMBS

Returns nil on any error.

See also:

• NewLongArray(ref as JavaObjectMBS) as JavaLongArrayMBS
• NewLongArray(values() as Int64) as JavaLongArrayMBS

JavaVMMBS.NewLongArray(values() as Int64) as JavaLongArrayMBS

See also:

• NewLongArray(ref as JavaObjectMBS) as JavaLongArrayMBS
• NewLongArray(size as Integer) as JavaLongArrayMBS

JavaVMMBS.NewObjectArray(ref as JavaObjectMBS) as JavaObjectArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewObjectArray(size as Integer, TheClass as JavaClassMBS, InitialValue as JavaObjectMBS = nil) as JavaObjectArrayMBS
• NewObjectArray(values() as JavaObjectMBS) as JavaObjectArrayMBS

Some examples using this method:

• /Java/JavaTest/Java

JavaVMMBS.NewObjectArray(size as Integer, TheClass as JavaClassMBS, InitialValue as JavaObjectMBS = nil) as JavaObjectArrayMBS

All elements are initially set to initialElement.
Returns nil on any error.

See also:

• NewObjectArray(ref as JavaObjectMBS) as JavaObjectArrayMBS
• NewObjectArray(values() as JavaObjectMBS) as JavaObjectArrayMBS

JavaVMMBS.NewObjectArray(values() as JavaObjectMBS) as JavaObjectArrayMBS

See also:

• NewObjectArray(ref as JavaObjectMBS) as JavaObjectArrayMBS
• NewObjectArray(size as Integer, TheClass as JavaClassMBS, InitialValue as JavaObjectMBS = nil) as JavaObjectArrayMBS

JavaVMMBS.NewShortArray(ref as JavaObjectMBS) as JavaShortArrayMBS

This function is a convenience function to convert a java object array reference to a java array object in Xojo. It can crash if the java object used is not the array of the requested type.

See also:

• NewShortArray(size as Integer) as JavaShortArrayMBS
• NewShortArray(values() as Int16) as JavaShortArrayMBS

JavaVMMBS.NewShortArray(size as Integer) as JavaShortArrayMBS

Returns nil on any error.

See also:

• NewShortArray(ref as JavaObjectMBS) as JavaShortArrayMBS
• NewShortArray(values() as Int16) as JavaShortArrayMBS

JavaVMMBS.NewShortArray(values() as Int16) as JavaShortArrayMBS

See also:

• NewShortArray(ref as JavaObjectMBS) as JavaShortArrayMBS
• NewShortArray(size as Integer) as JavaShortArrayMBS

JavaVMMBS.NewStringArray(size as integer, InitialValue as JavaStringMBS = nil) as JavaObjectArrayMBS

See also:

• NewStringArray(values() as String) as JavaObjectArrayMBS

JavaVMMBS.NewStringArray(values() as String) as JavaObjectArrayMBS

See also:

• NewStringArray(size as integer, InitialValue as JavaStringMBS = nil) as JavaObjectArrayMBS

JavaVMMBS.NewStringUnicode(s as string) as JavaStringMBS

Preferres an Unicode encoded string.

JavaVMMBS.NewStringUTF8(s as string) as JavaStringMBS

// init Java
dim options() as string
dim javaVm as new JavaVMMBS(JavaVMMBS.JNI_VERSION_1_4, options, true)

// Get system class
Dim system As JavaClassMBS = javaVm.FindClass("java/lang/System")

If system <> Nil Then
  
  // query method
  dim transfomerGetPropertyId as JavaMethodMBS = system.GetStaticMethod("getProperty", "(Ljava/lang/String;)Ljava/lang/String;")
  If transfomerGetPropertyId <> Nil Then
    
    // make parameters
    Dim keyString As JavaStringMBS = javaVm.NewStringUTF8("os.version")
    dim m as New MemoryBlock(8)
    m.Int64Value(0)=keyString.Handle
    
    // run it
    dim r as JavaObjectMBS = system.CallStaticObjectMethod(transfomerGetPropertyId, m)
    
    if r<>Nil then
      // show result
      dim s as JavaStringMBS = JavaStringMBS(r)
      MsgBox s.CopyStringUTF
    end if
    
  End If
End If

Preferres an UTF8 encoded string.

Some examples using this method:

• /Java/Java Get System Property
• /Java/Java Set System Property
• /Java/JavaTest/Java

JavaVMMBS.Runtime as JavaRuntimeMBS

Some examples using this method:

• /Java/JavaDatabase/JavaDatabase MySQL test
• /Java/JavaDatabase/JavaDatabase MySQL test with Threading