java_util.h
上传用户:tsgydb
上传日期:2007-04-14
资源大小:10674k
文件大小:14k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /*-
  2.  * See the file LICENSE for redistribution information.
  3.  *
  4.  * Copyright (c) 1997, 1998, 1999, 2000
  5.  * Sleepycat Software.  All rights reserved.
  6.  *
  7.  * $Id: java_util.h,v 11.22 2001/01/11 18:19:53 bostic Exp $
  8.  */
  9. #ifndef _JAVA_UTIL_H_
  10. #define _JAVA_UTIL_H_
  11. #ifdef _MSC_VER
  12. /* These are level 4 warnings that are explicitly disabled.
  13.  * With Visual C++, by default you do not see above level 3 unless
  14.  * you use /W4.  But we like to compile with the highest level
  15.  * warnings to catch other errors.
  16.  *
  17.  * 4201: nameless struct/union
  18.  *       triggered by standard include file <winnt.h>
  19.  *
  20.  * 4244: '=' : convert from '__int64' to 'unsigned int', possible loss of data
  21.  *       results from making size_t data members correspond to jlongs
  22.  *
  23.  * 4514: unreferenced inline function has been removed
  24.  *       jni.h defines methods that are not called
  25.  *
  26.  * 4127: conditional expression is constant
  27.  *       occurs because of arg in JAVADB_RW_ACCESS_STRING macro
  28.  */
  29. #pragma warning(disable: 4244 4201 4514 4127)
  30. #endif
  31. #include "db_config.h"
  32. #include "db.h"
  33. #include "java_info.h"
  34. #include "java_locked.h"
  35. #include <jni.h>
  36. #include <string.h>             /* needed for memset */
  37. #define DB_PACKAGE_NAME "com/sleepycat/db/"
  38. /* Union to convert longs to pointers (see {get,set}_private_dbobj).
  39.  */
  40. typedef union {
  41.     jlong java_long;
  42.     void *ptr;
  43. } long_to_ptr;
  44. /****************************************************************
  45.  *
  46.  * Utility functions and definitions used by "glue" functions.
  47.  *
  48.  */
  49. #define NOT_IMPLEMENTED(str) 
  50. report_exception(jnienv, str /*concatenate*/ ": not implemented", 0)
  51. /* Get, delete a global reference.
  52.  * Making this operation a function call allows for
  53.  * easier tracking for debugging.  Global references
  54.  * are mostly grabbed at 'open' and 'close' points,
  55.  * so there shouldn't be a big performance hit.
  56.  *
  57.  * Macro-izing this makes it easier to add debugging code
  58.  * to track unreleased references.
  59.  */
  60. #ifdef DBJAVA_DEBUG
  61. #include <unistd.h>
  62. static void wrdebug(const char *str)
  63. {
  64. write(2, str, strlen(str));
  65. write(2, "n", 1);
  66. }
  67. static jobject debug_new_global_ref(JNIEnv *jnienv, jobject obj, const char *s)
  68. {
  69. wrdebug(s);
  70. return (*jnienv)->NewGlobalRef(jnienv, obj);
  71. }
  72. static void debug_delete_global_ref(JNIEnv *jnienv, jobject obj, const char *s)
  73. {
  74. wrdebug(s);
  75. (*jnienv)->DeleteGlobalRef(jnienv, obj);
  76. }
  77. #define NEW_GLOBAL_REF(jnienv, obj)  
  78. debug_new_global_ref(jnienv, obj, "+Ref: " #obj)
  79. #define DELETE_GLOBAL_REF(jnienv, obj) 
  80. debug_delete_global_ref(jnienv, obj, "-Ref: " #obj)
  81. #else
  82. #define NEW_GLOBAL_REF(jnienv, obj)     (*jnienv)->NewGlobalRef(jnienv, obj)
  83. #define DELETE_GLOBAL_REF(jnienv, obj)  (*jnienv)->DeleteGlobalRef(jnienv, obj)
  84. #define wrdebug(x)
  85. #endif
  86. /* Get the private data from a Db* object that points back to a C DB_* object.
  87.  * The private data is stored in the object as a Java long (64 bits),
  88.  * which is long enough to store a pointer on current architectures.
  89.  */
  90. void *get_private_dbobj(JNIEnv *jnienv, const char *classname,
  91.        jobject obj);
  92. /* Set the private data in a Db* object that points back to a C DB_* object.
  93.  * The private data is stored in the object as a Java long (64 bits),
  94.  * which is long enough to store a pointer on current architectures.
  95.  */
  96. void set_private_dbobj(JNIEnv *jnienv, const char *classname,
  97.       jobject obj, void *value);
  98. /* Get the private data in a Db/DbEnv object that holds additional 'side data'.
  99.  * The private data is stored in the object as a Java long (64 bits),
  100.  * which is long enough to store a pointer on current architectures.
  101.  */
  102. void *get_private_info(JNIEnv *jnienv, const char *classname,
  103.        jobject obj);
  104. /* Set the private data in a Db/DbEnv object that holds additional 'side data'.
  105.  * The private data is stored in the object as a Java long (64 bits),
  106.  * which is long enough to store a pointer on current architectures.
  107.  */
  108. void set_private_info(JNIEnv *jnienv, const char *classname,
  109.       jobject obj, void *value);
  110. /*
  111.  * Given a non-qualified name (e.g. "foo"), get the class handl
  112.  * for the fully qualified name (e.g. "com.sleepycat.db.foo")
  113.  */
  114. jclass get_class(JNIEnv *jnienv, const char *classname);
  115. /* Set an individual field in a Db* object.
  116.  * The field must be a DB object type.
  117.  */
  118. void set_object_field(JNIEnv *jnienv, jclass class_of_this,
  119.       jobject jthis, const char *object_classname,
  120.       const char *name_of_field, jobject obj);
  121. /* Set an individual field in a Db* object.
  122.  * The field must be an integer type.
  123.  */
  124. void set_int_field(JNIEnv *jnienv, jclass class_of_this,
  125.    jobject jthis, const char *name_of_field, jint value);
  126. /* Set an individual field in a Db* object.
  127.  * The field must be an integer type.
  128.  */
  129. void set_long_field(JNIEnv *jnienv, jclass class_of_this,
  130. jobject jthis, const char *name_of_field, jlong value);
  131. /* Set an individual field in a Db* object.
  132.  * The field must be an DbLsn type.
  133.  */
  134. void set_lsn_field(JNIEnv *jnienv, jclass class_of_this,
  135.    jobject jthis, const char *name_of_field, DB_LSN value);
  136. /* Values of expect_mask
  137.  */
  138. static const int EXCEPTION_FILE_NOT_FOUND = 0x0001;
  139. /* Report an exception back to the java side.
  140.  */
  141. void report_exception(JNIEnv *jnienv, const char *text, int err,
  142.       unsigned long expect_mask);
  143. /* Report an error via the errcall mechanism.
  144.  */
  145. void report_errcall(JNIEnv *jnienv, jobject errcall,
  146.     jstring prefix, const char *message);
  147. /* If the object is null, report an exception and return false (0),
  148.  * otherwise return true (1).
  149.  */
  150. int verify_non_null(JNIEnv *jnienv, void *obj);
  151. /* If the error code is non-zero, report an exception and return false (0),
  152.  * otherwise return true (1).
  153.  */
  154. int verify_return(JNIEnv *jnienv, int err, unsigned long expect_mask);
  155. /* Create an object of the given class, calling its default constructor.
  156.  */
  157. jobject create_default_object(JNIEnv *jnienv, const char *class_name);
  158. /* Convert an DB object to a Java encapsulation of that object.
  159.  * Note: This implementation creates a new Java object on each call,
  160.  * so it is generally useful when a new DB object has just been created.
  161.  */
  162. jobject convert_object(JNIEnv *jnienv, const char *class_name, void *dbobj);
  163. /* Create a copy of the string
  164.  */
  165. char *dup_string(const char *str);
  166. /* Create a malloc'ed copy of the java string.
  167.  * Caller must free it.
  168.  */
  169. char *get_c_string(JNIEnv *jnienv, jstring jstr);
  170. /* Create a java string from the given string
  171.  */
  172. jstring get_java_string(JNIEnv *jnienv, const char* string);
  173. /* Convert a java object to the various C pointers they represent.
  174.  */
  175. DB             *get_DB            (JNIEnv *jnienv, jobject obj);
  176. DB_BTREE_STAT  *get_DB_BTREE_STAT (JNIEnv *jnienv, jobject obj);
  177. DBC            *get_DBC           (JNIEnv *jnienv, jobject obj);
  178. DB_ENV         *get_DB_ENV        (JNIEnv *jnienv, jobject obj);
  179. DB_ENV_JAVAINFO *get_DB_ENV_JAVAINFO (JNIEnv *jnienv, jobject obj);
  180. DB_HASH_STAT   *get_DB_HASH_STAT  (JNIEnv *jnienv, jobject obj);
  181. DB_JAVAINFO    *get_DB_JAVAINFO   (JNIEnv *jnienv, jobject obj);
  182. DB_LOCK        *get_DB_LOCK       (JNIEnv *jnienv, jobject obj);
  183. DB_LOG_STAT    *get_DB_LOG_STAT   (JNIEnv *jnienv, jobject obj);
  184. DB_LSN         *get_DB_LSN        (JNIEnv *jnienv, jobject obj);
  185. DB_MPOOL_FSTAT *get_DB_MPOOL_FSTAT(JNIEnv *jnienv, jobject obj);
  186. DB_MPOOL_STAT  *get_DB_MPOOL_STAT (JNIEnv *jnienv, jobject obj);
  187. DB_QUEUE_STAT  *get_DB_QUEUE_STAT (JNIEnv *jnienv, jobject obj);
  188. DB_TXN         *get_DB_TXN        (JNIEnv *jnienv, jobject obj);
  189. DB_TXN_STAT    *get_DB_TXN_STAT   (JNIEnv *jnienv, jobject obj);
  190. DBT            *get_DBT           (JNIEnv *jnienv, jobject obj);
  191. DBT_JAVAINFO   *get_DBT_JAVAINFO  (JNIEnv *jnienv, jobject obj);
  192. /* From a C object, create a Java object.
  193.  */
  194. jobject get_DbBtreeStat  (JNIEnv *jnienv, DB_BTREE_STAT *dbobj);
  195. jobject get_Dbc          (JNIEnv *jnienv, DBC *dbobj);
  196. jobject get_DbHashStat   (JNIEnv *jnienv, DB_HASH_STAT *dbobj);
  197. jobject get_DbLogStat    (JNIEnv *jnienv, DB_LOG_STAT *dbobj);
  198. jobject get_DbLsn        (JNIEnv *jnienv, DB_LSN dbobj);
  199. jobject get_DbMpoolStat  (JNIEnv *jnienv, DB_MPOOL_STAT *dbobj);
  200. jobject get_DbMpoolFStat (JNIEnv *jnienv, DB_MPOOL_FSTAT *dbobj);
  201. jobject get_DbQueueStat  (JNIEnv *jnienv, DB_QUEUE_STAT *dbobj);
  202. jobject get_Dbt          (JNIEnv *jnienv, DBT *dbt);
  203. jobject get_DbTxn        (JNIEnv *jnienv, DB_TXN *dbobj);
  204. jobject get_DbTxnStat    (JNIEnv *jnienv, DB_TXN_STAT *dbobj);
  205. /* The java names of DB classes */
  206. extern const char * const name_DB;
  207. extern const char * const name_DB_BTREE_STAT;
  208. extern const char * const name_DBC;
  209. extern const char * const name_DB_DEADLOCK_EX;
  210. extern const char * const name_DB_ENV;
  211. extern const char * const name_DB_EXCEPTION;
  212. extern const char * const name_DB_HASH_STAT;
  213. extern const char * const name_DB_LOCK;
  214. extern const char * const name_DB_LOCK_STAT;
  215. extern const char * const name_DB_LOG_STAT;
  216. extern const char * const name_DB_LSN;
  217. extern const char * const name_DB_MEMORY_EX;
  218. extern const char * const name_DB_MPOOL_FSTAT;
  219. extern const char * const name_DB_MPOOL_STAT;
  220. extern const char * const name_DB_QUEUE_STAT;
  221. extern const char * const name_DB_RUNRECOVERY_EX;
  222. extern const char * const name_DBT;
  223. extern const char * const name_DB_TXN;
  224. extern const char * const name_DB_TXN_STAT;
  225. extern const char * const name_DB_TXN_STAT_ACTIVE;
  226. extern const char * const name_DbAppendRecno;
  227. extern const char * const name_DbBtreeCompare;
  228. extern const char * const name_DbBtreePrefix;
  229. extern const char * const name_DbDupCompare;
  230. extern const char * const name_DbEnvFeedback;
  231. extern const char * const name_DbErrcall;
  232. extern const char * const name_DbFeedback;
  233. extern const char * const name_DbHash;
  234. extern const char * const name_DbRecoveryInit;
  235. extern const char * const name_DbTxnRecover;
  236. extern const char * const string_signature;
  237. #define JAVADB_RO_ACCESS(j_class, j_fieldtype, j_field, c_type, c_field)    
  238. JNIEXPORT j_fieldtype JNICALL                                               
  239.   Java_com_sleepycat_db_##j_class##_get_1##j_field                          
  240.   (JNIEnv *jnienv, jobject jthis)                                           
  241. {                                                                           
  242. c_type *db_this = get_##c_type(jnienv, jthis);                      
  243.     
  244. if (verify_non_null(jnienv, db_this)) {                             
  245. return db_this->c_field;                                    
  246. }                                                                   
  247. return 0;                                                           
  248. }
  249. #define JAVADB_WO_ACCESS(j_class, j_fieldtype, j_field, c_type, c_field)    
  250. JNIEXPORT void JNICALL                                                      
  251.   Java_com_sleepycat_db_##j_class##_set_1##j_field                          
  252.   (JNIEnv *jnienv, jobject jthis, j_fieldtype value)                        
  253. {                                                                           
  254. c_type *db_this = get_##c_type(jnienv, jthis);                      
  255.     
  256. if (verify_non_null(jnienv, db_this)) {                             
  257. db_this->c_field = value;                                   
  258. }                                                                   
  259. }
  260. /* This is a variant of the JAVADB_WO_ACCESS macro to define a simple set_
  261.  * method using a C "method" call.  These should be used with set_
  262.  * methods that cannot invoke java 'callbacks' (no set_ method currently
  263.  * does that).  That assumption allows us to optimize (and simplify)
  264.  * by not calling API_BEGIN/END macros.
  265.  */
  266. #define JAVADB_WO_ACCESS_METHOD(j_class, j_fieldtype,                       
  267. j_field, c_type, c_field)     
  268. JNIEXPORT void JNICALL                                                      
  269.   Java_com_sleepycat_db_##j_class##_set_1##j_field                          
  270.   (JNIEnv *jnienv, jobject jthis, j_fieldtype value)                        
  271. {                                                                           
  272. c_type *db_this;                                                    
  273. int err;                                                            
  274.     
  275. db_this = get_##c_type(jnienv, jthis);                              
  276. if (verify_non_null(jnienv, db_this)) {                             
  277. err = db_this->set_##c_field(db_this, value);               
  278. verify_return(jnienv, err, 0);                              
  279. }                                                                   
  280. }
  281. #define JAVADB_RW_ACCESS(j_class, j_fieldtype, j_field, c_type, c_field)    
  282. JAVADB_RO_ACCESS(j_class, j_fieldtype, j_field, c_type, c_field)    
  283. JAVADB_WO_ACCESS(j_class, j_fieldtype, j_field, c_type, c_field)
  284. #define JAVADB_WO_ACCESS_STRING(j_class, j_field, c_type, c_field)          
  285. JNIEXPORT void JNICALL                                                      
  286.   Java_com_sleepycat_db_##j_class##_set_1##j_field                          
  287.   (JNIEnv *jnienv, jobject jthis, jstring value)                            
  288. {                                                                           
  289. c_type *db_this;                                                    
  290. int err;                                                            
  291.     
  292. db_this = get_##c_type(jnienv, jthis);                              
  293. if (verify_non_null(jnienv, db_this)) {                             
  294. err = db_this->set_##c_field(db_this,                       
  295.   (*jnienv)->GetStringUTFChars(jnienv, value, NULL)); 
  296. verify_return(jnienv, err, 0);                              
  297. }                                                                   
  298. }
  299. #define JAVADB_API_BEGIN(db, jthis) 
  300. if ((db) != NULL) 
  301.   ((DB_JAVAINFO*)(db)->cj_internal)->jdbref_ = 
  302.   ((DB_ENV_JAVAINFO*)((db)->dbenv->cj_internal))->jdbref_ = (jthis)
  303. #define JAVADB_API_END(db) 
  304. if ((db) != NULL) 
  305.   ((DB_JAVAINFO*)(db)->cj_internal)->jdbref_ = 
  306.   ((DB_ENV_JAVAINFO*)((db)->dbenv->cj_internal))->jdbref_ = 0
  307. #define JAVADB_ENV_API_BEGIN(dbenv, jthis) 
  308. if ((dbenv) != NULL) 
  309.   ((DB_ENV_JAVAINFO*)((dbenv)->cj_internal))->jenvref_ = (jthis)
  310. #define JAVADB_ENV_API_END(dbenv) 
  311. if ((dbenv) != NULL) 
  312.   ((DB_ENV_JAVAINFO*)((dbenv)->cj_internal))->jenvref_ = 0
  313. #endif /* !_JAVA_UTIL_H_ */