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

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. #include "db_config.h"
  8. #ifndef lint
  9. static const char revid[] = "$Id: cxx_app.cpp,v 11.38 2000/12/21 20:30:18 dda Exp $";
  10. #endif /* not lint */
  11. #include <errno.h>
  12. #include <stdio.h>              // needed for set_error_stream
  13. #include <string.h>
  14. #include "db_cxx.h"
  15. #include "cxx_int.h"
  16. #include "db_int.h"
  17. #include "common_ext.h"
  18. // The reason for a static variable is that some structures
  19. // (like Dbts) have no connection to any Db or DbEnv, so when
  20. // errors occur in their methods, we must have some reasonable
  21. // way to determine whether to throw or return errors.
  22. //
  23. // This variable is taken from flags whenever a DbEnv is constructed.
  24. // Normally there is only one DbEnv per program, and even if not,
  25. // there is typically a single policy of throwing or returning.
  26. //
  27. static int last_known_error_policy = ON_ERROR_UNKNOWN;
  28. ////////////////////////////////////////////////////////////////////////
  29. //                                                                    //
  30. //                            DbEnv                                   //
  31. //                                                                    //
  32. ////////////////////////////////////////////////////////////////////////
  33. ostream *DbEnv::error_stream_ = 0;
  34. // _destroy_check is called when there is a user error in a
  35. // destructor, specifically when close has not been called for an
  36. // object (even if it was never opened).  If the DbEnv is being
  37. // destroyed we cannot always use DbEnv::error_stream_, so we'll
  38. // use cerr in that case.
  39. //
  40. void DbEnv::_destroy_check(const char *str, int isDbEnv)
  41. {
  42. ostream *out;
  43. out = error_stream_;
  44. if (out == NULL || isDbEnv == 1)
  45. out = &cerr;
  46. (*out) << "DbEnv::_destroy_check: open " << str << " object destroyedn";
  47. }
  48. // A truism for the DbEnv object is that there is a valid
  49. // DB_ENV handle from the constructor until close().
  50. // After the close, the DB_ENV handle is invalid and
  51. // no operations are permitted on the DbEnv (other than
  52. // destructor).  Leaving the DbEnv handle open and not
  53. // doing a close is generally considered an error.
  54. //
  55. // We used to allow DbEnv objects to be closed and reopened.
  56. // This implied always keeping a valid DB_ENV object, and
  57. // coordinating the open objects between Db/DbEnv turned
  58. // out to be overly complicated.  Now we do not allow this.
  59. DbEnv::DbEnv(u_int32_t flags)
  60. : imp_(0)
  61. , construct_error_(0)
  62. , construct_flags_(flags)
  63. , tx_recover_callback_(0)
  64. , paniccall_callback_(0)
  65. {
  66. int err;
  67. COMPQUIET(err, 0);
  68. if ((err = initialize(0)) != 0)
  69. DB_ERROR("DbEnv::DbEnv", err, error_policy());
  70. }
  71. DbEnv::DbEnv(DB_ENV *env, u_int32_t flags)
  72. : imp_(0)
  73. , construct_error_(0)
  74. , construct_flags_(flags)
  75. , tx_recover_callback_(0)
  76. , paniccall_callback_(0)
  77. {
  78. int err;
  79. COMPQUIET(err, 0);
  80. if ((err = initialize(env)) != 0)
  81. DB_ERROR("DbEnv::DbEnv", err, error_policy());
  82. }
  83. // Note: if the user has not closed, we call _destroy_check
  84. // to warn against this non-safe programming practice,
  85. // and call close anyway.
  86. //
  87. DbEnv::~DbEnv()
  88. {
  89. DB_ENV *env = unwrap(this);
  90. if (env != NULL) {
  91. _destroy_check("DbEnv", 1);
  92. (void)env->close(env, 0);
  93. // extra safety
  94. cleanup();
  95. }
  96. }
  97. // called by Db destructor when the DbEnv is owned by DB.
  98. void DbEnv::cleanup()
  99. {
  100. DB_ENV *env = unwrap(this);
  101. if (env != NULL) {
  102. env->cj_internal = 0;
  103. imp_ = 0;
  104. }
  105. }
  106. int DbEnv::close(u_int32_t flags)
  107. {
  108. DB_ENV *env = unwrap(this);
  109. int err, init_err;
  110. COMPQUIET(init_err, 0);
  111. // after a close (no matter if success or failure),
  112. // the underlying DB_ENV object must not be accessed,
  113. // so we clean up in advance.
  114. //
  115. cleanup();
  116. // It's safe to throw an error after the close,
  117. // since our error mechanism does not peer into
  118. // the DB* structures.
  119. //
  120. if ((err = env->close(env, flags)) != 0) {
  121. DB_ERROR("DbEnv::close", err, error_policy());
  122. }
  123. return (err);
  124. }
  125. void DbEnv::err(int error, const char *format, ...)
  126. {
  127. va_list args;
  128. DB_ENV *env = unwrap(this);
  129. va_start(args, format);
  130. __db_real_err(env, error, 1, 1, format, args);
  131. va_end(args);
  132. }
  133. void DbEnv::errx(const char *format, ...)
  134. {
  135. va_list args;
  136. DB_ENV *env = unwrap(this);
  137. va_start(args, format);
  138. __db_real_err(env, 0, 0, 1, format, args);
  139. va_end(args);
  140. }
  141. // used internally during constructor
  142. // to associate an existing DB_ENV with this DbEnv,
  143. // or create a new one.  If there is an error,
  144. // construct_error_ is set; this is examined during open.
  145. //
  146. int DbEnv::initialize(DB_ENV *env)
  147. {
  148. int err;
  149. last_known_error_policy = error_policy();
  150. if (env == 0) {
  151. // Create a new DB_ENV environment.
  152. if ((err = ::db_env_create(&env,
  153. construct_flags_ & ~DB_CXX_NO_EXCEPTIONS)) != 0) {
  154. construct_error_ = err;
  155. return (err);
  156. }
  157. }
  158. imp_ = wrap(env);
  159. env->cj_internal = this;    // for DB_ENV* to DbEnv* conversion
  160. return (0);
  161. }
  162. // Return a tristate value corresponding to whether we should
  163. // throw exceptions on errors:
  164. //   ON_ERROR_RETURN
  165. //   ON_ERROR_THROW
  166. //   ON_ERROR_UNKNOWN
  167. //
  168. int DbEnv::error_policy()
  169. {
  170. if ((construct_flags_ & DB_CXX_NO_EXCEPTIONS) != 0) {
  171. return (ON_ERROR_RETURN);
  172. }
  173. else {
  174. return (ON_ERROR_THROW);
  175. }
  176. }
  177. // If an error occurred during the constructor, report it now.
  178. // Otherwise, call the underlying DB->open method.
  179. //
  180. int DbEnv::open(const char *db_home, u_int32_t flags, int mode)
  181. {
  182. DB_ENV *env = unwrap(this);
  183. int err;
  184. if ((err = construct_error_) != 0)
  185. DB_ERROR("Db::open", err, error_policy());
  186. else if ((err = env->open(env, db_home, flags, mode)) != 0)
  187. DB_ERROR("DbEnv::open", err, error_policy());
  188. return (err);
  189. }
  190. int DbEnv::remove(const char *db_home, u_int32_t flags)
  191. {
  192. DB_ENV *env;
  193. int ret;
  194. env = unwrap(this);
  195. // after a remove (no matter if success or failure),
  196. // the underlying DB_ENV object must not be accessed,
  197. // so we clean up in advance.
  198. //
  199. cleanup();
  200. if ((ret = env->remove(env, db_home, flags)) != 0)
  201. DB_ERROR("DbEnv::remove", ret, error_policy());
  202. return (ret);
  203. }
  204. // Report an error associated with the DbEnv.
  205. // error_policy is one of:
  206. //   ON_ERROR_THROW     throw an error
  207. //   ON_ERROR_RETURN    do nothing here, the caller will return an error
  208. //   ON_ERROR_UNKNOWN   defer the policy to policy saved in DbEnv::DbEnv
  209. //
  210. void DbEnv::runtime_error(const char *caller, int error, int error_policy)
  211. {
  212. if (error_policy == ON_ERROR_UNKNOWN)
  213. error_policy = last_known_error_policy;
  214. if (error_policy == ON_ERROR_THROW) {
  215. // Creating and throwing the object in two separate
  216. // statements seems to be necessary for HP compilers.
  217. DbException except(caller, error);
  218. throw except;
  219. }
  220. }
  221. // static method
  222. char *DbEnv::strerror(int error)
  223. {
  224. return (db_strerror(error));
  225. }
  226. // This is a 'glue' function declared as extern "C" so it will
  227. // be compatible with picky compilers that do not allow mixing
  228. // of function pointers to 'C' functions with function pointers
  229. // to C++ functions.
  230. //
  231. extern "C"
  232. void _stream_error_function_c(const char *prefix, char *message)
  233. {
  234. DbEnv::_stream_error_function(prefix, message);
  235. }
  236. void DbEnv::_stream_error_function(const char *prefix, char *message)
  237. {
  238. // HP compilers need the extra casts, we don't know why.
  239. if (error_stream_) {
  240. if (prefix) {
  241. (*error_stream_) << prefix << (const char *)": ";
  242. }
  243. if (message) {
  244. (*error_stream_) << (const char *)message;
  245. }
  246. (*error_stream_) << (const char *)"n";
  247. }
  248. }
  249. // Note: This actually behaves a bit like a static function,
  250. // since DB_ENV.db_errcall has no information about which
  251. // db_env triggered the call.  A user that has multiple DB_ENVs
  252. // will simply not be able to have different streams for each one.
  253. //
  254. void DbEnv::set_error_stream(ostream *stream)
  255. {
  256. DB_ENV *dbenv = unwrap(this);
  257. error_stream_ = stream;
  258. dbenv->set_errcall(dbenv, (stream == 0) ? 0 :
  259.    _stream_error_function_c);
  260. }
  261. // static method
  262. char *DbEnv::version(int *major, int *minor, int *patch)
  263. {
  264. return (db_version(major, minor, patch));
  265. }
  266. // This is a variant of the DB_WO_ACCESS macro to define a simple set_
  267. // method calling the underlying C method, but unlike a simple
  268. // set method, it may return an error or raise an exception.
  269. // Note this macro expects that input _argspec is an argument
  270. // list element (e.g. "char *arg") defined in terms of "arg".
  271. //
  272. #define DB_DBENV_ACCESS(_name, _argspec)                       
  273.        
  274. int DbEnv::set_##_name(_argspec)                               
  275. {                                                              
  276. int ret;                                               
  277. DB_ENV *dbenv = unwrap(this);                          
  278.        
  279. if ((ret = (*(dbenv->set_##_name))(dbenv, arg)) != 0) {
  280. DB_ERROR("DbEnv::set_" # _name, ret, error_policy()); 
  281. }                                                      
  282. return (ret);                                          
  283. }
  284. #define DB_DBENV_ACCESS_NORET(_name, _argspec)                 
  285.        
  286. void DbEnv::set_##_name(_argspec)                              
  287. {                                                              
  288. DB_ENV *dbenv = unwrap(this);                          
  289.        
  290. (*(dbenv->set_##_name))(dbenv, arg);                   
  291. return;                                                
  292. }
  293. DB_DBENV_ACCESS_NORET(errfile, FILE *arg)
  294. DB_DBENV_ACCESS_NORET(errpfx, const char *arg)
  295. // We keep these alphabetical by field name,
  296. // for comparison with Java's list.
  297. //
  298. DB_DBENV_ACCESS(data_dir, const char *arg)
  299. DB_DBENV_ACCESS(lg_bsize, u_int32_t arg)
  300. DB_DBENV_ACCESS(lg_dir, const char *arg)
  301. DB_DBENV_ACCESS(lg_max, u_int32_t arg)
  302. DB_DBENV_ACCESS(lk_detect, u_int32_t arg)
  303. DB_DBENV_ACCESS(lk_max, u_int32_t arg)
  304. DB_DBENV_ACCESS(lk_max_lockers, u_int32_t arg)
  305. DB_DBENV_ACCESS(lk_max_locks, u_int32_t arg)
  306. DB_DBENV_ACCESS(lk_max_objects, u_int32_t arg)
  307. DB_DBENV_ACCESS(mp_mmapsize, size_t arg)
  308. DB_DBENV_ACCESS(mutexlocks, int arg)
  309. DB_DBENV_ACCESS(tmp_dir, const char *arg)
  310. DB_DBENV_ACCESS(tx_max, u_int32_t arg)
  311. // Here are the set methods that don't fit the above mold.
  312. //
  313. extern "C" {
  314. typedef void (*db_errcall_fcn_type)
  315. (const char *, char *);
  316. };
  317. void DbEnv::set_errcall(void (*arg)(const char *, char *))
  318. {
  319. DB_ENV *dbenv = unwrap(this);
  320. // XXX
  321. // We are casting from a function ptr declared with C++
  322. // linkage to one (same arg types) declared with C
  323. // linkage.  It's hard to imagine a pair of C/C++
  324. // compilers from the same vendor for which this
  325. // won't work.  Unfortunately, we can't use a
  326. // intercept function like the others since the
  327. // function does not have a (DbEnv*) as one of
  328. // the args.  If this causes trouble, we can pull
  329. // the same trick we use in Java, namely stuffing
  330. // a (DbEnv*) pointer into the prefix.  We're
  331. // avoiding this for the moment because it obfuscates.
  332. //
  333. (*(dbenv->set_errcall))(dbenv, (db_errcall_fcn_type)arg);
  334. }
  335. int DbEnv::set_cachesize(u_int32_t gbytes, u_int32_t bytes, int ncache)
  336. {
  337. int ret;
  338. DB_ENV *dbenv = unwrap(this);
  339. if ((ret =
  340.     (*(dbenv->set_cachesize))(dbenv, gbytes, bytes, ncache)) != 0)
  341. DB_ERROR("DbEnv::set_cachesize", ret, error_policy());
  342. return (ret);
  343. }
  344. int DbEnv::set_flags(u_int32_t flags, int onoff)
  345. {
  346. int ret;
  347. DB_ENV *dbenv = unwrap(this);
  348. if ((ret = (dbenv->set_flags)(dbenv, flags, onoff)) != 0)
  349. DB_ERROR("DbEnv::set_flags", ret, error_policy());
  350. return (ret);
  351. }
  352. int DbEnv::set_lk_conflicts(u_int8_t *lk_conflicts, int lk_max)
  353. {
  354. int ret;
  355. DB_ENV *dbenv = unwrap(this);
  356. if ((ret = (*(dbenv->set_lk_conflicts))
  357.      (dbenv, lk_conflicts, lk_max)) != 0)
  358. DB_ERROR("DbEnv::set_lk_conflicts", ret, error_policy());
  359. return (ret);
  360. }
  361. // static method
  362. int DbEnv::set_pageyield(int arg)
  363. {
  364. int ret;
  365. if ((ret = db_env_set_pageyield(arg)) != 0)
  366. DB_ERROR("DbEnv::set_pageyield", ret, last_known_error_policy);
  367. return (ret);
  368. }
  369. // static method
  370. int DbEnv::set_panicstate(int arg)
  371. {
  372. int ret;
  373. if ((ret = db_env_set_panicstate(arg)) != 0)
  374. DB_ERROR("DbEnv::set_panicstate", ret, last_known_error_policy);
  375. return (ret);
  376. }
  377. // static method
  378. int DbEnv::set_region_init(int arg)
  379. {
  380. int ret;
  381. if ((ret = db_env_set_region_init(arg)) != 0)
  382. DB_ERROR("DbEnv::set_region_init", ret, last_known_error_policy);
  383. return (ret);
  384. }
  385. int DbEnv::set_server(char *host, long tsec, long ssec, u_int32_t flags)
  386. {
  387. int ret;
  388. DB_ENV *dbenv = unwrap(this);
  389. if ((ret = dbenv->set_server(dbenv, host, tsec, ssec, flags)) != 0)
  390. DB_ERROR("DbEnv::set_server", ret, error_policy());
  391. return (ret);
  392. }
  393. int DbEnv::set_shm_key(long shm_key)
  394. {
  395. int ret;
  396. DB_ENV *dbenv = unwrap(this);
  397. if ((ret = dbenv->set_shm_key(dbenv, shm_key)) != 0)
  398. DB_ERROR("DbEnv::set_shm_key", ret, error_policy());
  399. return (ret);
  400. }
  401. // static method
  402. int DbEnv::set_tas_spins(u_int32_t arg)
  403. {
  404. int ret;
  405. if ((ret = db_env_set_tas_spins(arg)) != 0)
  406. DB_ERROR("DbEnv::set_tas_spins", ret, last_known_error_policy);
  407. return (ret);
  408. }
  409. int DbEnv::set_verbose(u_int32_t which, int onoff)
  410. {
  411. int ret;
  412. DB_ENV *dbenv = unwrap(this);
  413. if ((ret = (*(dbenv->set_verbose))(dbenv, which, onoff)) != 0)
  414. DB_ERROR("DbEnv::set_verbose", ret, error_policy());
  415. return (ret);
  416. }
  417. // This is a 'glue' function declared as extern "C" so it will
  418. // be compatible with picky compilers that do not allow mixing
  419. // of function pointers to 'C' functions with function pointers
  420. // to C++ functions.
  421. //
  422. extern "C"
  423. int _tx_recover_intercept_c(DB_ENV *env, DBT *dbt,
  424.     DB_LSN *lsn, db_recops op)
  425. {
  426. return (DbEnv::_tx_recover_intercept(env, dbt, lsn, op));
  427. }
  428. int DbEnv::_tx_recover_intercept(DB_ENV *env, DBT *dbt,
  429. DB_LSN *lsn, db_recops op)
  430. {
  431. if (env == 0) {
  432. DB_ERROR("DbEnv::tx_recover_callback", EINVAL, ON_ERROR_UNKNOWN);
  433. return (EINVAL);
  434. }
  435. DbEnv *cxxenv = (DbEnv *)env->cj_internal;
  436. if (cxxenv == 0) {
  437. DB_ERROR("DbEnv::tx_recover_callback", EINVAL, ON_ERROR_UNKNOWN);
  438. return (EINVAL);
  439. }
  440. if (cxxenv->tx_recover_callback_ == 0) {
  441. DB_ERROR("DbEnv::tx_recover_callback", EINVAL, cxxenv->error_policy());
  442. return (EINVAL);
  443. }
  444. Dbt *cxxdbt = (Dbt *)dbt;
  445. DbLsn *cxxlsn = (DbLsn *)lsn;
  446. return ((*cxxenv->tx_recover_callback_)(cxxenv, cxxdbt, cxxlsn, op));
  447. }
  448. int DbEnv::set_tx_recover
  449.     (int (*arg)(DbEnv *, Dbt *, DbLsn *, db_recops))
  450. {
  451. int ret;
  452. DB_ENV *dbenv = unwrap(this);
  453. tx_recover_callback_ = arg;
  454. if ((ret =
  455.     (*(dbenv->set_tx_recover))(dbenv, _tx_recover_intercept_c)) != 0)
  456. DB_ERROR("DbEnv::set_tx_recover", ret, error_policy());
  457. return (ret);
  458. }
  459. int DbEnv::set_tx_timestamp(time_t *timestamp)
  460. {
  461. int ret;
  462. DB_ENV *dbenv = unwrap(this);
  463. if ((ret = dbenv->set_tx_timestamp(dbenv, timestamp)) != 0)
  464. DB_ERROR("DbEnv::set_tx_timestamp", ret, error_policy());
  465. return (ret);
  466. }
  467. // This is a 'glue' function declared as extern "C" so it will
  468. // be compatible with picky compilers that do not allow mixing
  469. // of function pointers to 'C' functions with function pointers
  470. // to C++ functions.
  471. //
  472. extern "C"
  473. void _paniccall_intercept_c(DB_ENV *env, int errval)
  474. {
  475. DbEnv::_paniccall_intercept(env, errval);
  476. }
  477. void DbEnv::_paniccall_intercept(DB_ENV *env, int errval)
  478. {
  479. if (env == 0) {
  480. DB_ERROR("DbEnv::paniccall_callback", EINVAL, ON_ERROR_UNKNOWN);
  481. }
  482. DbEnv *cxxenv = (DbEnv *)env->cj_internal;
  483. if (cxxenv == 0) {
  484. DB_ERROR("DbEnv::paniccall_callback", EINVAL, ON_ERROR_UNKNOWN);
  485. }
  486. if (cxxenv->paniccall_callback_ == 0) {
  487. DB_ERROR("DbEnv::paniccall_callback", EINVAL, cxxenv->error_policy());
  488. }
  489. (*cxxenv->paniccall_callback_)(cxxenv, errval);
  490. }
  491. int DbEnv::set_paniccall(void (*arg)(DbEnv *, int))
  492. {
  493. DB_ENV *dbenv = unwrap(this);
  494. paniccall_callback_ = arg;
  495. return ((*(dbenv->set_paniccall))(dbenv, _paniccall_intercept_c));
  496. }
  497. // This is a 'glue' function declared as extern "C" so it will
  498. // be compatible with picky compilers that do not allow mixing
  499. // of function pointers to 'C' functions with function pointers
  500. // to C++ functions.
  501. //
  502. extern "C"
  503. int _recovery_init_intercept_c(DB_ENV *env)
  504. {
  505. return (DbEnv::_recovery_init_intercept(env));
  506. }
  507. int DbEnv::_recovery_init_intercept(DB_ENV *env)
  508. {
  509. if (env == 0) {
  510. DB_ERROR("DbEnv::recovery_init_callback", EINVAL,
  511.  ON_ERROR_UNKNOWN);
  512. }
  513. DbEnv *cxxenv = (DbEnv *)env->cj_internal;
  514. if (cxxenv == 0) {
  515. DB_ERROR("DbEnv::recovery_init_callback", EINVAL,
  516.  ON_ERROR_UNKNOWN);
  517. }
  518. if (cxxenv->recovery_init_callback_ == 0) {
  519. DB_ERROR("DbEnv::recovery_init_callback", EINVAL,
  520.  cxxenv->error_policy());
  521. }
  522. return ((*cxxenv->recovery_init_callback_)(cxxenv));
  523. }
  524. int DbEnv::set_recovery_init(int (*arg)(DbEnv *))
  525. {
  526. DB_ENV *dbenv = unwrap(this);
  527. recovery_init_callback_ = arg;
  528. return ((*(dbenv->set_recovery_init))(dbenv, _recovery_init_intercept_c));
  529. }
  530. // This is a 'glue' function declared as extern "C" so it will
  531. // be compatible with picky compilers that do not allow mixing
  532. // of function pointers to 'C' functions with function pointers
  533. // to C++ functions.
  534. //
  535. extern "C"
  536. void _feedback_intercept_c(DB_ENV *env, int opcode, int pct)
  537. {
  538. DbEnv::_feedback_intercept(env, opcode, pct);
  539. }
  540. void DbEnv::_feedback_intercept(DB_ENV *env, int opcode, int pct)
  541. {
  542. if (env == 0) {
  543. DB_ERROR("DbEnv::feedback_callback", EINVAL, ON_ERROR_UNKNOWN);
  544. return;
  545. }
  546. DbEnv *cxxenv = (DbEnv *)env->cj_internal;
  547. if (cxxenv == 0) {
  548. DB_ERROR("DbEnv::feedback_callback", EINVAL, ON_ERROR_UNKNOWN);
  549. return;
  550. }
  551. if (cxxenv->feedback_callback_ == 0) {
  552. DB_ERROR("DbEnv::feedback_callback", EINVAL,
  553.  cxxenv->error_policy());
  554. return;
  555. }
  556. (*cxxenv->feedback_callback_)(cxxenv, opcode, pct);
  557. }
  558. int DbEnv::set_feedback(void (*arg)(DbEnv *, int, int))
  559. {
  560. DB_ENV *dbenv = unwrap(this);
  561. feedback_callback_ = arg;
  562. return ((*(dbenv->set_feedback))(dbenv, _feedback_intercept_c));
  563. }