Provides Octave's Java interface. More...

#include <algorithm>
#include <array>
#include <fstream>
#include <map>
#include <string>
#include <vector>
#include <clocale>
#include "Cell.h"
#include "builtin-defun-decls.h"
#include "cmd-edit.h"
#include "defaults.h"
#include "defun.h"
#include "error.h"
#include "errwarn.h"
#include "file-ops.h"
#include "file-stat.h"
#include "fpucw-wrappers.h"
#include "interpreter.h"
#include "interpreter-private.h"
#include "load-path.h"
#include "lo-sysdep.h"
#include "oct-env.h"
#include "oct-process.h"
#include "oct-shlib.h"
#include "ov-java.h"
#include "variables.h"
#include <jni.h>

Macros
#define	BOX_PRIMITIVE_ARRAY(JAVA_TYPE, JAVA_ID, JAVA_TYPE_CAP, OCTAVE_ID)

#define	LIBJVM_FILE_NAME "libjvm.so"

#define	TO_JAVA(obj) dynamic_cast<octave_java *> ((obj).internal_rep ())

#define	TO_JCLASS(obj) reinterpret_cast<jclass> (obj)

#define	TO_JNIENV(env) reinterpret_cast<JNIEnv *> (env)

#define	TO_JOBJECT(obj) reinterpret_cast<jobject> (obj)

#define	UNBOX_PRIMITIVE_ARRAY(METHOD_T, OCTAVE_T, JAVA_T, JAVA_T_CAP)

#define	UNBOX_PRIMITIVE_SCALAR(OCTAVE_T, METHOD_T, JAVA_T, JAVA_CON)

Typedefs
typedef java_local_ref< jbyteArray >	jbyteArray_ref

typedef java_local_ref< jclass >	jclass_ref

typedef java_local_ref< jdoubleArray >	jdoubleArray_ref

typedef java_local_ref< jintArray >	jintArray_ref

typedef jint(JNICALL *	JNI_CreateJavaVM_t) (JavaVM pvm, JNIEnv penv, void *args)

typedef jint(JNICALL *	JNI_GetCreatedJavaVMs_t) (JavaVM *pvm, jsize bufLen, jsize nVMs)

typedef java_local_ref< jobject >	jobject_ref

typedef java_local_ref< jobjectArray >	jobjectArray_ref

typedef java_local_ref< jstring >	jstring_ref

typedef java_local_ref< jthrowable >	jthrowable_ref

Functions
octave_value_list	F__java2mat__ (const octave_value_list &args, int)

octave_value_list	F__java_exit__ (const octave_value_list &, int)

octave_value_list	F__java_get__ (const octave_value_list &args, int)

octave_value_list	F__java_init__ (const octave_value_list &, int)

octave_value_list	F__java_set__ (const octave_value_list &args, int)

octave_value_list	Fdebug_java (const octave_value_list &args, int nargout)

octave_value_list	Fisjava (const octave_value_list &args, int)

octave_value_list	Fjava_matrix_autoconversion (const octave_value_list &args, int nargout)

octave_value_list	Fjava_unsigned_autoconversion (const octave_value_list &args, int nargout)

octave_value_list	FjavaMethod (const octave_value_list &args, int)

octave_value_list	FjavaObject (const octave_value_list &args, int)

JNIEXPORT jboolean JNICALL	Java_org_octave_Octave_call (JNIEnv *, jclass, jstring, jobjectArray, jobjectArray)

JNIEXPORT void JNICALL	Java_org_octave_Octave_doEvalString (JNIEnv *, jclass, jstring)

JNIEXPORT void JNICALL	Java_org_octave_Octave_doInvoke (JNIEnv *, jclass, jint, jobjectArray)

JNIEXPORT jboolean JNICALL	Java_org_octave_Octave_needThreadedInvokation (JNIEnv *, jclass)

JNIEXPORT void JNICALL	Java_org_octave_OctaveReference_doFinalize (JNIEnv *, jclass, jint)

Variables
bool	Vdebug_java = false

bool	Vjava_matrix_autoconversion = false

bool	Vjava_unsigned_autoconversion = true

Detailed Description

Provides Octave's Java interface.

Definition in file ov-java.cc.

Macro Definition Documentation

◆ BOX_PRIMITIVE_ARRAY

#define BOX_PRIMITIVE_ARRAY	(	JAVA_TYPE,
		JAVA_ID,
		JAVA_TYPE_CAP,
		OCTAVE_ID
	)

Value:

      cls = jni_env->FindClass (JAVA_ID); \
      if (jni_env->IsInstanceOf (jobj, cls)) \
        { \
          const JAVA_TYPE ## Array jarr = reinterpret_cast<JAVA_TYPE ## Array> (jobj); \
          const jsize len = jni_env->GetArrayLength (jarr); \
          OCTAVE_ID ## NDArray d (dim_vector (len, 1)); \
          JAVA_TYPE *buffer = reinterpret_cast<JAVA_TYPE *> (d.rwdata ()); \
          jni_env->Get ## JAVA_TYPE_CAP ## ArrayRegion (jarr, 0, len, buffer); \
          retval = d; \
          break; \
        }

◆ LIBJVM_FILE_NAME

#define LIBJVM_FILE_NAME "libjvm.so"

Definition at line 82 of file ov-java.cc.

◆ TO_JAVA

#define TO_JAVA ( obj ) dynamic_cast<octave_java *> ((obj).internal_rep ())

Definition at line 1339 of file ov-java.cc.

◆ TO_JCLASS

#define TO_JCLASS ( obj ) reinterpret_cast<jclass> (obj)

Definition at line 86 of file ov-java.cc.

◆ TO_JNIENV

#define TO_JNIENV ( env ) reinterpret_cast<JNIEnv *> (env)

Definition at line 88 of file ov-java.cc.

◆ TO_JOBJECT

#define TO_JOBJECT ( obj ) reinterpret_cast<jobject> (obj)

Definition at line 85 of file ov-java.cc.

◆ UNBOX_PRIMITIVE_ARRAY

#define UNBOX_PRIMITIVE_ARRAY	(	METHOD_T,
		OCTAVE_T,
		JAVA_T,
		JAVA_T_CAP
	)

Value:

  do \
    { \
      const OCTAVE_T ## NDArray v = val.METHOD_T ## array_value (); \
      JAVA_T ## Array jarr = jni_env->New ## JAVA_T_CAP ## Array (v.numel ()); \
      const JAVA_T *jv = reinterpret_cast<const JAVA_T *> (v.data ()); \
      jni_env->Set ## JAVA_T_CAP ## ArrayRegion (jarr, 0, v.numel (), jv); \
      jobj = reinterpret_cast<jobject> (jarr); \
      jcls = jni_env->GetObjectClass (jobj); \
    } \
  while (0)

◆ UNBOX_PRIMITIVE_SCALAR

#define UNBOX_PRIMITIVE_SCALAR	(	OCTAVE_T,
		METHOD_T,
		JAVA_T,
		JAVA_CON
	)

Value:

  do \
    { \
      const OCTAVE_T ov = val.METHOD_T ## _value (); \
      jclass_ref dcls (jni_env, jni_env->FindClass (JAVA_T)); \
      const jfieldID fid = jni_env->GetStaticFieldID (dcls, "TYPE", "Ljava/lang/Class;"); \
      const jmethodID mid = jni_env->GetMethodID (dcls, "<init>", JAVA_CON); \
      jcls = reinterpret_cast<jclass> (jni_env->GetStaticObjectField (dcls, fid)); \
      jobj = jni_env->NewObject (dcls, mid, ov); \
     } \
   while (0)

Typedef Documentation

◆ jbyteArray_ref

typedef java_local_ref<jbyteArray> jbyteArray_ref

Definition at line 151 of file ov-java.cc.

◆ jclass_ref

typedef java_local_ref<jclass> jclass_ref

Definition at line 147 of file ov-java.cc.

◆ jdoubleArray_ref

typedef java_local_ref<jdoubleArray> jdoubleArray_ref

Definition at line 152 of file ov-java.cc.

◆ jintArray_ref

typedef java_local_ref<jintArray> jintArray_ref

Definition at line 150 of file ov-java.cc.

◆ JNI_CreateJavaVM_t

typedef jint(JNICALL * JNI_CreateJavaVM_t) (JavaVM **pvm, JNIEnv **penv, void *args)

Definition at line 90 of file ov-java.cc.

◆ JNI_GetCreatedJavaVMs_t

typedef jint(JNICALL * JNI_GetCreatedJavaVMs_t) (JavaVM **pvm, jsize bufLen, jsize *nVMs)

Definition at line 93 of file ov-java.cc.

◆ jobject_ref

typedef java_local_ref<jobject> jobject_ref

Definition at line 146 of file ov-java.cc.

◆ jobjectArray_ref

typedef java_local_ref<jobjectArray> jobjectArray_ref

Definition at line 149 of file ov-java.cc.

◆ jstring_ref

typedef java_local_ref<jstring> jstring_ref

Definition at line 148 of file ov-java.cc.

◆ jthrowable_ref

typedef java_local_ref<jthrowable> jthrowable_ref

Definition at line 153 of file ov-java.cc.

Function Documentation

◆ Fjava2mat()

octave_value_list F__java2mat__	(	const octave_value_list &	args,
		int
	)

Definition at line 3360 of file ov-java.cc.

References err_disabled_feature(), octave_value_list::length(), ovl(), print_usage(), octave_java::to_java(), and TO_JAVA.

◆ F__java_exit__()

octave_value_list F__java_exit__	(	const octave_value_list &	,
		int
	)

Definition at line 3088 of file ov-java.cc.

References err_disabled_feature(), and ovl().

◆ F__java_get__()

octave_value_list F__java_get__	(	const octave_value_list &	args,
		int
	)

Definition at line 3257 of file ov-java.cc.

References octave_java::do_java_get(), err_disabled_feature(), error(), octave_value_list::length(), print_usage(), and TO_JAVA.

◆ F__java_init__()

octave_value_list F__java_init__	(	const octave_value_list &	,
		int
	)

Definition at line 3063 of file ov-java.cc.

References err_disabled_feature().

◆ F__java_set__()

octave_value_list F__java_set__	(	const octave_value_list &	args,
		int
	)

Definition at line 3317 of file ov-java.cc.

References octave_java::do_java_set(), err_disabled_feature(), error(), octave_value_list::length(), print_usage(), and TO_JAVA.

◆ Fdebug_java()

octave_value_list Fdebug_java	(	const octave_value_list &	args,
		int	nargout
	)

Definition at line 3468 of file ov-java.cc.

References err_disabled_feature(), set_internal_variable(), and Vdebug_java.

◆ Fisjava()

octave_value_list Fisjava	(	const octave_value_list &	args,
		int
	)

Definition at line 3493 of file ov-java.cc.

References octave_value_list::length(), ovl(), and print_usage().

◆ Fjava_matrix_autoconversion()

octave_value_list Fjava_matrix_autoconversion	(	const octave_value_list &	args,
		int	nargout
	)

Definition at line 3406 of file ov-java.cc.

References err_disabled_feature(), set_internal_variable(), and Vjava_matrix_autoconversion.

◆ Fjava_unsigned_autoconversion()

octave_value_list Fjava_unsigned_autoconversion	(	const octave_value_list &	args,
		int	nargout
	)

Definition at line 3438 of file ov-java.cc.

References err_disabled_feature(), set_internal_variable(), and Vjava_unsigned_autoconversion.

◆ FjavaMethod()

octave_value_list FjavaMethod	(	const octave_value_list &	args,
		int
	)

Definition at line 3182 of file ov-java.cc.

References octave_java::do_javaMethod(), err_disabled_feature(), error(), octave_value_list::length(), print_usage(), and TO_JAVA.

◆ FjavaObject()

octave_value_list FjavaObject	(	const octave_value_list &	args,
		int
	)

Definition at line 3121 of file ov-java.cc.

References octave_java::do_javaObject(), err_disabled_feature(), octave_value_list::length(), ovl(), and print_usage().

◆ Java_org_octave_Octave_call()

JNIEXPORT jboolean JNICALL Java_org_octave_Octave_call	(	JNIEnv *	env,
		jclass	,
		jstring	fcnName,
		jobjectArray	argin,
		jobjectArray	argout
	)

Definition at line 2042 of file ov-java.cc.

◆ Java_org_octave_Octave_doEvalString()

JNIEXPORT void JNICALL Java_org_octave_Octave_doEvalString	(	JNIEnv *	env,
		jclass	,
		jstring	cmd
	)

Definition at line 2113 of file ov-java.cc.

◆ Java_org_octave_Octave_doInvoke()

JNIEXPORT void JNICALL Java_org_octave_Octave_doInvoke	(	JNIEnv *	env,
		jclass	,
		jint	ID,
		jobjectArray	args
	)

Definition at line 2071 of file ov-java.cc.

References octave_value::cell_value(), octave_value::columns(), error(), octave_value::function_value(), octave_value::is_function_handle(), octave_value::iscell(), len, octave_value::length(), Array< T, Alloc >::numel(), and octave_value::rows().

◆ Java_org_octave_Octave_needThreadedInvokation()

JNIEXPORT jboolean JNICALL Java_org_octave_Octave_needThreadedInvokation	(	JNIEnv *	env,
		jclass
	)

Definition at line 2123 of file ov-java.cc.

◆ Java_org_octave_OctaveReference_doFinalize()

JNIEXPORT void JNICALL Java_org_octave_OctaveReference_doFinalize	(	JNIEnv *	,
		jclass	,
		jint	ID
	)

Definition at line 2065 of file ov-java.cc.

Variable Documentation

◆ Vdebug_java

bool Vdebug_java = false

Definition at line 224 of file ov-java.cc.

Referenced by Fdebug_java().

◆ Vjava_matrix_autoconversion

bool Vjava_matrix_autoconversion = false

Definition at line 222 of file ov-java.cc.

Referenced by Fjava_matrix_autoconversion().

◆ Vjava_unsigned_autoconversion

bool Vjava_unsigned_autoconversion = true

Definition at line 223 of file ov-java.cc.

Referenced by Fjava_unsigned_autoconversion().

Macros

Typedefs

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ BOX_PRIMITIVE_ARRAY

◆ LIBJVM_FILE_NAME

◆ TO_JAVA

◆ TO_JCLASS

◆ TO_JNIENV

◆ TO_JOBJECT

◆ UNBOX_PRIMITIVE_ARRAY

◆ UNBOX_PRIMITIVE_SCALAR

Typedef Documentation

◆ jbyteArray_ref

◆ jclass_ref

◆ jdoubleArray_ref

◆ jintArray_ref

◆ JNI_CreateJavaVM_t

◆ JNI_GetCreatedJavaVMs_t

◆ jobject_ref

◆ jobjectArray_ref

◆ jstring_ref

◆ jthrowable_ref

Function Documentation

◆ F__java2mat__()

◆ F__java_exit__()

◆ F__java_get__()

◆ F__java_init__()

◆ F__java_set__()

◆ Fdebug_java()

◆ Fisjava()

◆ Fjava_matrix_autoconversion()

◆ Fjava_unsigned_autoconversion()

◆ FjavaMethod()

◆ FjavaObject()

◆ Java_org_octave_Octave_call()

◆ Java_org_octave_Octave_doEvalString()

◆ Java_org_octave_Octave_doInvoke()

◆ Java_org_octave_Octave_needThreadedInvokation()

◆ Java_org_octave_OctaveReference_doFinalize()

Variable Documentation

◆ Vdebug_java

◆ Vjava_matrix_autoconversion

◆ Vjava_unsigned_autoconversion

◆ Fjava2mat()