mirror of
https://github.com/MariaDB/server.git
synced 2025-01-19 13:32:33 +01:00
441 lines
15 KiB
C
441 lines
15 KiB
C
/*-
|
|
* See the file LICENSE for redistribution information.
|
|
*
|
|
* Copyright (c) 1997-2002
|
|
* Sleepycat Software. All rights reserved.
|
|
*
|
|
* $Id: java_util.h,v 11.44 2002/08/29 14:22:24 margo Exp $
|
|
*/
|
|
|
|
#ifndef _JAVA_UTIL_H_
|
|
#define _JAVA_UTIL_H_
|
|
|
|
#ifdef _MSC_VER
|
|
|
|
/*
|
|
* These are level 4 warnings that are explicitly disabled.
|
|
* With Visual C++, by default you do not see above level 3 unless
|
|
* you use /W4. But we like to compile with the highest level
|
|
* warnings to catch other errors.
|
|
*
|
|
* 4201: nameless struct/union
|
|
* triggered by standard include file <winnt.h>
|
|
*
|
|
* 4244: '=' : convert from '__int64' to 'unsigned int', possible loss of data
|
|
* results from making size_t data members correspond to jlongs
|
|
*
|
|
* 4514: unreferenced inline function has been removed
|
|
* jni.h defines methods that are not called
|
|
*
|
|
* 4127: conditional expression is constant
|
|
* occurs because of arg in JAVADB_RW_ACCESS_STRING macro
|
|
*/
|
|
#pragma warning(disable: 4244 4201 4514 4127)
|
|
|
|
#endif
|
|
|
|
#include "db_config.h"
|
|
#include "db.h"
|
|
#include "db_int.h"
|
|
#include <jni.h>
|
|
#include "java_info.h"
|
|
#include "java_locked.h"
|
|
#include <string.h> /* needed for memset */
|
|
|
|
#define DB_PACKAGE_NAME "com/sleepycat/db/"
|
|
|
|
/* Union to convert longs to pointers (see {get,set}_private_dbobj). */
|
|
typedef union {
|
|
jlong java_long;
|
|
void *ptr;
|
|
} long_to_ptr;
|
|
|
|
/****************************************************************
|
|
*
|
|
* Utility functions and definitions used by "glue" functions.
|
|
*/
|
|
|
|
#define NOT_IMPLEMENTED(str) \
|
|
report_exception(jnienv, str /*concatenate*/ ": not implemented", 0)
|
|
|
|
/*
|
|
* Get, delete a global reference.
|
|
* Making this operation a function call allows for
|
|
* easier tracking for debugging. Global references
|
|
* are mostly grabbed at 'open' and 'close' points,
|
|
* so there shouldn't be a big performance hit.
|
|
*
|
|
* Macro-izing this makes it easier to add debugging code
|
|
* to track unreleased references.
|
|
*/
|
|
#ifdef DBJAVA_DEBUG
|
|
#include <unistd.h>
|
|
static void wrdebug(const char *str)
|
|
{
|
|
write(2, str, strlen(str));
|
|
write(2, "\n", 1);
|
|
}
|
|
|
|
static jobject debug_new_global_ref(JNIEnv *jnienv, jobject obj, const char *s)
|
|
{
|
|
wrdebug(s);
|
|
return ((*jnienv)->NewGlobalRef(jnienv, obj));
|
|
}
|
|
|
|
static void debug_delete_global_ref(JNIEnv *jnienv, jobject obj, const char *s)
|
|
{
|
|
wrdebug(s);
|
|
(*jnienv)->DeleteGlobalRef(jnienv, obj);
|
|
}
|
|
|
|
#define NEW_GLOBAL_REF(jnienv, obj) \
|
|
debug_new_global_ref(jnienv, obj, "+Ref: " #obj)
|
|
#define DELETE_GLOBAL_REF(jnienv, obj) \
|
|
debug_delete_global_ref(jnienv, obj, "-Ref: " #obj)
|
|
#else
|
|
#define NEW_GLOBAL_REF(jnienv, obj) (*jnienv)->NewGlobalRef(jnienv, obj)
|
|
#define DELETE_GLOBAL_REF(jnienv, obj) (*jnienv)->DeleteGlobalRef(jnienv, obj)
|
|
#define wrdebug(x)
|
|
#endif
|
|
|
|
/*
|
|
* Do any one time initialization, especially initializing any
|
|
* unchanging methodIds, fieldIds, etc.
|
|
*/
|
|
void one_time_init(JNIEnv *jnienv);
|
|
|
|
/*
|
|
* Get the current JNIEnv from the java VM.
|
|
* If the jvm argument is null, uses the default
|
|
* jvm stored during the first invocation.
|
|
*/
|
|
JNIEnv *get_jnienv(JavaVM *jvm);
|
|
|
|
/*
|
|
* Get the private data from a Db* object that points back to a C DB_* object.
|
|
* The private data is stored in the object as a Java long (64 bits),
|
|
* which is long enough to store a pointer on current architectures.
|
|
*/
|
|
void *get_private_dbobj(JNIEnv *jnienv, const char *classname,
|
|
jobject obj);
|
|
|
|
/*
|
|
* Set the private data in a Db* object that points back to a C DB_* object.
|
|
* The private data is stored in the object as a Java long (64 bits),
|
|
* which is long enough to store a pointer on current architectures.
|
|
*/
|
|
void set_private_dbobj(JNIEnv *jnienv, const char *classname,
|
|
jobject obj, void *value);
|
|
|
|
/*
|
|
* Get the private data in a Db/DbEnv object that holds additional 'side data'.
|
|
* The private data is stored in the object as a Java long (64 bits),
|
|
* which is long enough to store a pointer on current architectures.
|
|
*/
|
|
void *get_private_info(JNIEnv *jnienv, const char *classname,
|
|
jobject obj);
|
|
|
|
/*
|
|
* Set the private data in a Db/DbEnv object that holds additional 'side data'.
|
|
* The private data is stored in the object as a Java long (64 bits),
|
|
* which is long enough to store a pointer on current architectures.
|
|
*/
|
|
void set_private_info(JNIEnv *jnienv, const char *classname,
|
|
jobject obj, void *value);
|
|
|
|
/*
|
|
* Given a non-qualified name (e.g. "foo"), get the class handle
|
|
* for the fully qualified name (e.g. "com.sleepycat.db.foo")
|
|
*/
|
|
jclass get_class(JNIEnv *jnienv, const char *classname);
|
|
|
|
/*
|
|
* Set an individual field in a Db* object.
|
|
* The field must be a DB object type.
|
|
*/
|
|
void set_object_field(JNIEnv *jnienv, jclass class_of_this,
|
|
jobject jthis, const char *object_classname,
|
|
const char *name_of_field, jobject obj);
|
|
|
|
/*
|
|
* Set an individual field in a Db* object.
|
|
* The field must be an integer type.
|
|
*/
|
|
void set_int_field(JNIEnv *jnienv, jclass class_of_this,
|
|
jobject jthis, const char *name_of_field, jint value);
|
|
|
|
/*
|
|
* Set an individual field in a Db* object.
|
|
* The field must be an integer type.
|
|
*/
|
|
void set_long_field(JNIEnv *jnienv, jclass class_of_this,
|
|
jobject jthis, const char *name_of_field, jlong value);
|
|
|
|
/*
|
|
* Set an individual field in a Db* object.
|
|
* The field must be an DbLsn type.
|
|
*/
|
|
void set_lsn_field(JNIEnv *jnienv, jclass class_of_this,
|
|
jobject jthis, const char *name_of_field, DB_LSN value);
|
|
|
|
/*
|
|
* Values of flags for verify_return() and report_exception().
|
|
* These indicate what sort of exceptions the method may throw
|
|
* (in addition to DbException).
|
|
*/
|
|
static const u_int32_t EXCEPTION_FILE_NOT_FOUND = 0x0001; /*FileNotFound*/
|
|
|
|
/*
|
|
* Report an exception back to the java side.
|
|
*/
|
|
void report_exception(JNIEnv *jnienv, const char *text,
|
|
int err, unsigned long expect_mask);
|
|
|
|
/*
|
|
* Report an exception back to the java side, for the specific
|
|
* case of DB_LOCK_NOTGRANTED, as more things are added to the
|
|
* constructor of this type of exception.
|
|
*/
|
|
void report_notgranted_exception(JNIEnv *jnienv, const char *text,
|
|
db_lockop_t op, db_lockmode_t mode,
|
|
jobject jdbt, jobject jlock, int index);
|
|
|
|
/*
|
|
* Create an exception object and return it.
|
|
* The given class must have a constructor that has a
|
|
* constructor with args (java.lang.String text, int errno);
|
|
* DbException and its subclasses fit this bill.
|
|
*/
|
|
jobject create_exception(JNIEnv *jnienv, jstring text,
|
|
int err, jclass dbexcept);
|
|
|
|
/*
|
|
* Report an error via the errcall mechanism.
|
|
*/
|
|
void report_errcall(JNIEnv *jnienv, jobject errcall,
|
|
jstring prefix, const char *message);
|
|
|
|
/*
|
|
* If the object is null, report an exception and return false (0),
|
|
* otherwise return true (1).
|
|
*/
|
|
int verify_non_null(JNIEnv *jnienv, void *obj);
|
|
|
|
/*
|
|
* If the error code is non-zero, report an exception and return false (0),
|
|
* otherwise return true (1).
|
|
*/
|
|
int verify_return(JNIEnv *jnienv, int err, unsigned long flags);
|
|
|
|
/*
|
|
* Verify that there was no memory error due to undersized Dbt.
|
|
* If there is report a DbMemoryException, with the Dbt attached
|
|
* and return false (0), otherwise return true (1).
|
|
*/
|
|
int verify_dbt(JNIEnv *jnienv, int err, LOCKED_DBT *locked_dbt);
|
|
|
|
/*
|
|
* Create an object of the given class, calling its default constructor.
|
|
*/
|
|
jobject create_default_object(JNIEnv *jnienv, const char *class_name);
|
|
|
|
/*
|
|
* Create a Dbt object, , calling its default constructor.
|
|
*/
|
|
jobject create_dbt(JNIEnv *jnienv, const char *class_name);
|
|
|
|
/*
|
|
* Convert an DB object to a Java encapsulation of that object.
|
|
* Note: This implementation creates a new Java object on each call,
|
|
* so it is generally useful when a new DB object has just been created.
|
|
*/
|
|
jobject convert_object(JNIEnv *jnienv, const char *class_name, void *dbobj);
|
|
|
|
/*
|
|
* Create a copy of the java string using __os_malloc.
|
|
* Caller must free it.
|
|
*/
|
|
char *get_c_string(JNIEnv *jnienv, jstring jstr);
|
|
|
|
/*
|
|
* Create a java string from the given string
|
|
*/
|
|
jstring get_java_string(JNIEnv *jnienv, const char* string);
|
|
|
|
/*
|
|
* Convert a java object to the various C pointers they represent.
|
|
*/
|
|
DB *get_DB (JNIEnv *jnienv, jobject obj);
|
|
DB_BTREE_STAT *get_DB_BTREE_STAT (JNIEnv *jnienv, jobject obj);
|
|
DBC *get_DBC (JNIEnv *jnienv, jobject obj);
|
|
DB_ENV *get_DB_ENV (JNIEnv *jnienv, jobject obj);
|
|
DB_ENV_JAVAINFO *get_DB_ENV_JAVAINFO (JNIEnv *jnienv, jobject obj);
|
|
DB_HASH_STAT *get_DB_HASH_STAT (JNIEnv *jnienv, jobject obj);
|
|
DB_JAVAINFO *get_DB_JAVAINFO (JNIEnv *jnienv, jobject obj);
|
|
DB_LOCK *get_DB_LOCK (JNIEnv *jnienv, jobject obj);
|
|
DB_LOGC *get_DB_LOGC (JNIEnv *jnienv, jobject obj);
|
|
DB_LOG_STAT *get_DB_LOG_STAT (JNIEnv *jnienv, jobject obj);
|
|
DB_LSN *get_DB_LSN (JNIEnv *jnienv, jobject obj);
|
|
DB_MPOOL_FSTAT *get_DB_MPOOL_FSTAT(JNIEnv *jnienv, jobject obj);
|
|
DB_MPOOL_STAT *get_DB_MPOOL_STAT (JNIEnv *jnienv, jobject obj);
|
|
DB_QUEUE_STAT *get_DB_QUEUE_STAT (JNIEnv *jnienv, jobject obj);
|
|
DB_TXN *get_DB_TXN (JNIEnv *jnienv, jobject obj);
|
|
DB_TXN_STAT *get_DB_TXN_STAT (JNIEnv *jnienv, jobject obj);
|
|
DBT *get_DBT (JNIEnv *jnienv, jobject obj);
|
|
DBT_JAVAINFO *get_DBT_JAVAINFO (JNIEnv *jnienv, jobject obj);
|
|
|
|
/*
|
|
* From a C object, create a Java object.
|
|
*/
|
|
jobject get_DbBtreeStat (JNIEnv *jnienv, DB_BTREE_STAT *dbobj);
|
|
jobject get_Dbc (JNIEnv *jnienv, DBC *dbobj);
|
|
jobject get_DbHashStat (JNIEnv *jnienv, DB_HASH_STAT *dbobj);
|
|
jobject get_DbLogc (JNIEnv *jnienv, DB_LOGC *dbobj);
|
|
jobject get_DbLogStat (JNIEnv *jnienv, DB_LOG_STAT *dbobj);
|
|
jobject get_DbLsn (JNIEnv *jnienv, DB_LSN dbobj);
|
|
jobject get_DbMpoolStat (JNIEnv *jnienv, DB_MPOOL_STAT *dbobj);
|
|
jobject get_DbMpoolFStat (JNIEnv *jnienv, DB_MPOOL_FSTAT *dbobj);
|
|
jobject get_DbQueueStat (JNIEnv *jnienv, DB_QUEUE_STAT *dbobj);
|
|
jobject get_const_Dbt (JNIEnv *jnienv, const DBT *dbt, DBT_JAVAINFO **retp);
|
|
jobject get_Dbt (JNIEnv *jnienv, DBT *dbt, DBT_JAVAINFO **retp);
|
|
jobject get_DbTxn (JNIEnv *jnienv, DB_TXN *dbobj);
|
|
jobject get_DbTxnStat (JNIEnv *jnienv, DB_TXN_STAT *dbobj);
|
|
|
|
/* The java names of DB classes */
|
|
extern const char * const name_DB;
|
|
extern const char * const name_DB_BTREE_STAT;
|
|
extern const char * const name_DBC;
|
|
extern const char * const name_DB_DEADLOCK_EX;
|
|
extern const char * const name_DB_ENV;
|
|
extern const char * const name_DB_EXCEPTION;
|
|
extern const char * const name_DB_HASH_STAT;
|
|
extern const char * const name_DB_LOCK;
|
|
extern const char * const name_DB_LOCK_STAT;
|
|
extern const char * const name_DB_LOGC;
|
|
extern const char * const name_DB_LOG_STAT;
|
|
extern const char * const name_DB_LSN;
|
|
extern const char * const name_DB_MEMORY_EX;
|
|
extern const char * const name_DB_MPOOL_FSTAT;
|
|
extern const char * const name_DB_MPOOL_STAT;
|
|
extern const char * const name_DB_LOCKNOTGRANTED_EX;
|
|
extern const char * const name_DB_PREPLIST;
|
|
extern const char * const name_DB_QUEUE_STAT;
|
|
extern const char * const name_DB_REP_STAT;
|
|
extern const char * const name_DB_RUNRECOVERY_EX;
|
|
extern const char * const name_DBT;
|
|
extern const char * const name_DB_TXN;
|
|
extern const char * const name_DB_TXN_STAT;
|
|
extern const char * const name_DB_TXN_STAT_ACTIVE;
|
|
extern const char * const name_DB_UTIL;
|
|
extern const char * const name_DbAppendRecno;
|
|
extern const char * const name_DbBtreeCompare;
|
|
extern const char * const name_DbBtreePrefix;
|
|
extern const char * const name_DbDupCompare;
|
|
extern const char * const name_DbEnvFeedback;
|
|
extern const char * const name_DbErrcall;
|
|
extern const char * const name_DbFeedback;
|
|
extern const char * const name_DbHash;
|
|
extern const char * const name_DbRecoveryInit;
|
|
extern const char * const name_DbRepTransport;
|
|
extern const char * const name_DbSecondaryKeyCreate;
|
|
extern const char * const name_DbTxnRecover;
|
|
extern const char * const name_RepElectResult;
|
|
extern const char * const name_RepProcessMessage;
|
|
|
|
extern const char * const string_signature;
|
|
|
|
extern jfieldID fid_Dbt_data;
|
|
extern jfieldID fid_Dbt_offset;
|
|
extern jfieldID fid_Dbt_size;
|
|
extern jfieldID fid_Dbt_ulen;
|
|
extern jfieldID fid_Dbt_dlen;
|
|
extern jfieldID fid_Dbt_doff;
|
|
extern jfieldID fid_Dbt_flags;
|
|
extern jfieldID fid_Dbt_must_create_data;
|
|
extern jfieldID fid_DbLockRequest_op;
|
|
extern jfieldID fid_DbLockRequest_mode;
|
|
extern jfieldID fid_DbLockRequest_timeout;
|
|
extern jfieldID fid_DbLockRequest_obj;
|
|
extern jfieldID fid_DbLockRequest_lock;
|
|
extern jfieldID fid_RepProcessMessage_envid;
|
|
|
|
#define JAVADB_ARGS JNIEnv *jnienv, jobject jthis
|
|
|
|
#define JAVADB_GET_FLD(j_class, j_fieldtype, j_field, c_type, c_field) \
|
|
JNIEXPORT j_fieldtype JNICALL \
|
|
Java_com_sleepycat_db_##j_class##_get_1##j_field \
|
|
(JAVADB_ARGS) \
|
|
{ \
|
|
c_type *db= get_##c_type(jnienv, jthis); \
|
|
\
|
|
if (verify_non_null(jnienv, db)) \
|
|
return (db->c_field); \
|
|
return (0); \
|
|
}
|
|
|
|
#define JAVADB_SET_FLD(j_class, j_fieldtype, j_field, c_type, c_field) \
|
|
JNIEXPORT void JNICALL \
|
|
Java_com_sleepycat_db_##j_class##_set_1##j_field \
|
|
(JAVADB_ARGS, j_fieldtype value) \
|
|
{ \
|
|
c_type *db= get_##c_type(jnienv, jthis); \
|
|
\
|
|
if (verify_non_null(jnienv, db)) \
|
|
db->c_field = value; \
|
|
}
|
|
|
|
#define JAVADB_METHOD(_meth, _argspec, c_type, c_meth, _args) \
|
|
JNIEXPORT void JNICALL Java_com_sleepycat_db_##_meth _argspec \
|
|
{ \
|
|
c_type *c_this = get_##c_type(jnienv, jthis); \
|
|
int ret; \
|
|
\
|
|
if (!verify_non_null(jnienv, c_this)) \
|
|
return; \
|
|
ret = c_this->c_meth _args; \
|
|
if (!DB_RETOK_STD(ret)) \
|
|
report_exception(jnienv, db_strerror(ret), ret, 0); \
|
|
}
|
|
|
|
#define JAVADB_METHOD_INT(_meth, _argspec, c_type, c_meth, _args, _retok) \
|
|
JNIEXPORT jint JNICALL Java_com_sleepycat_db_##_meth _argspec \
|
|
{ \
|
|
c_type *c_this = get_##c_type(jnienv, jthis); \
|
|
int ret; \
|
|
\
|
|
if (!verify_non_null(jnienv, c_this)) \
|
|
return (0); \
|
|
ret = c_this->c_meth _args; \
|
|
if (!_retok(ret)) \
|
|
report_exception(jnienv, db_strerror(ret), ret, 0); \
|
|
return ((jint)ret); \
|
|
}
|
|
|
|
#define JAVADB_SET_METH(j_class, j_type, j_fld, c_type, c_field) \
|
|
JAVADB_METHOD(j_class##_set_1##j_fld, (JAVADB_ARGS, j_type val), c_type, \
|
|
set_##c_field, (c_this, val))
|
|
|
|
#define JAVADB_SET_METH_STR(j_class, j_fld, c_type, c_field) \
|
|
JAVADB_METHOD(j_class##_set_1##j_fld, (JAVADB_ARGS, jstring val), c_type, \
|
|
set_##c_field, (c_this, (*jnienv)->GetStringUTFChars(jnienv, val, NULL)))
|
|
|
|
|
|
/*
|
|
* These macros are used by code generated by the s_java script.
|
|
*/
|
|
#define JAVADB_STAT_INT(env, cl, jobj, statp, name) \
|
|
set_int_field(jnienv, cl, jobj, #name, statp->name)
|
|
|
|
#define JAVADB_STAT_LSN(env, cl, jobj, statp, name) \
|
|
set_lsn_field(jnienv, cl, jobj, #name, statp->name)
|
|
|
|
#define JAVADB_STAT_LONG(env, cl, jobj, statp, name) \
|
|
set_long_field(jnienv, cl, jobj, #name, statp->name)
|
|
|
|
/*
|
|
* We build the active list separately.
|
|
*/
|
|
#define JAVADB_STAT_ACTIVE(env, cl, jobj, statp, name) \
|
|
do {} while(0)
|
|
|
|
#endif /* !_JAVA_UTIL_H_ */
|