SQLite Android Bindings
Hex Artifact Content
Not logged in

Artifact c53984a8b12af821952df2e33a8f205b3af16b60:


0000: 2f 2a 0a 20 2a 20 43 6f 70 79 72 69 67 68 74 20  /*. * Copyright 
0010: 28 43 29 20 32 30 31 31 20 54 68 65 20 41 6e 64  (C) 2011 The And
0020: 72 6f 69 64 20 4f 70 65 6e 20 53 6f 75 72 63 65  roid Open Source
0030: 20 50 72 6f 6a 65 63 74 0a 20 2a 0a 20 2a 20 4c   Project. *. * L
0040: 69 63 65 6e 73 65 64 20 75 6e 64 65 72 20 74 68  icensed under th
0050: 65 20 41 70 61 63 68 65 20 4c 69 63 65 6e 73 65  e Apache License
0060: 2c 20 56 65 72 73 69 6f 6e 20 32 2e 30 20 28 74  , Version 2.0 (t
0070: 68 65 20 22 4c 69 63 65 6e 73 65 22 29 3b 0a 20  he "License");. 
0080: 2a 20 79 6f 75 20 6d 61 79 20 6e 6f 74 20 75 73  * you may not us
0090: 65 20 74 68 69 73 20 66 69 6c 65 20 65 78 63 65  e this file exce
00a0: 70 74 20 69 6e 20 63 6f 6d 70 6c 69 61 6e 63 65  pt in compliance
00b0: 20 77 69 74 68 20 74 68 65 20 4c 69 63 65 6e 73   with the Licens
00c0: 65 2e 0a 20 2a 20 59 6f 75 20 6d 61 79 20 6f 62  e.. * You may ob
00d0: 74 61 69 6e 20 61 20 63 6f 70 79 20 6f 66 20 74  tain a copy of t
00e0: 68 65 20 4c 69 63 65 6e 73 65 20 61 74 0a 20 2a  he License at. *
00f0: 0a 20 2a 20 20 20 20 20 20 68 74 74 70 3a 2f 2f  . *      http://
0100: 77 77 77 2e 61 70 61 63 68 65 2e 6f 72 67 2f 6c  www.apache.org/l
0110: 69 63 65 6e 73 65 73 2f 4c 49 43 45 4e 53 45 2d  icenses/LICENSE-
0120: 32 2e 30 0a 20 2a 0a 20 2a 20 55 6e 6c 65 73 73  2.0. *. * Unless
0130: 20 72 65 71 75 69 72 65 64 20 62 79 20 61 70 70   required by app
0140: 6c 69 63 61 62 6c 65 20 6c 61 77 20 6f 72 20 61  licable law or a
0150: 67 72 65 65 64 20 74 6f 20 69 6e 20 77 72 69 74  greed to in writ
0160: 69 6e 67 2c 20 73 6f 66 74 77 61 72 65 0a 20 2a  ing, software. *
0170: 20 64 69 73 74 72 69 62 75 74 65 64 20 75 6e 64   distributed und
0180: 65 72 20 74 68 65 20 4c 69 63 65 6e 73 65 20 69  er the License i
0190: 73 20 64 69 73 74 72 69 62 75 74 65 64 20 6f 6e  s distributed on
01a0: 20 61 6e 20 22 41 53 20 49 53 22 20 42 41 53 49   an "AS IS" BASI
01b0: 53 2c 0a 20 2a 20 57 49 54 48 4f 55 54 20 57 41  S,. * WITHOUT WA
01c0: 52 52 41 4e 54 49 45 53 20 4f 52 20 43 4f 4e 44  RRANTIES OR COND
01d0: 49 54 49 4f 4e 53 20 4f 46 20 41 4e 59 20 4b 49  ITIONS OF ANY KI
01e0: 4e 44 2c 20 65 69 74 68 65 72 20 65 78 70 72 65  ND, either expre
01f0: 73 73 20 6f 72 20 69 6d 70 6c 69 65 64 2e 0a 20  ss or implied.. 
0200: 2a 20 53 65 65 20 74 68 65 20 4c 69 63 65 6e 73  * See the Licens
0210: 65 20 66 6f 72 20 74 68 65 20 73 70 65 63 69 66  e for the specif
0220: 69 63 20 6c 61 6e 67 75 61 67 65 20 67 6f 76 65  ic language gove
0230: 72 6e 69 6e 67 20 70 65 72 6d 69 73 73 69 6f 6e  rning permission
0240: 73 20 61 6e 64 0a 20 2a 20 6c 69 6d 69 74 61 74  s and. * limitat
0250: 69 6f 6e 73 20 75 6e 64 65 72 20 74 68 65 20 4c  ions under the L
0260: 69 63 65 6e 73 65 2e 0a 20 2a 2f 0a 2f 2a 0a 2a  icense.. */./*.*
0270: 2a 20 4d 6f 64 69 66 69 65 64 20 74 6f 20 73 75  * Modified to su
0280: 70 70 6f 72 74 20 53 51 4c 69 74 65 20 65 78 74  pport SQLite ext
0290: 65 6e 73 69 6f 6e 73 20 62 79 20 74 68 65 20 53  ensions by the S
02a0: 51 4c 69 74 65 20 64 65 76 65 6c 6f 70 65 72 73  QLite developers
02b0: 3a 20 0a 2a 2a 20 73 71 6c 69 74 65 2d 64 65 76  : .** sqlite-dev
02c0: 40 73 71 6c 69 74 65 2e 6f 72 67 2e 0a 2a 2f 0a  @sqlite.org..*/.
02d0: 0a 23 64 65 66 69 6e 65 20 4c 4f 47 5f 54 41 47  .#define LOG_TAG
02e0: 20 22 53 51 4c 69 74 65 47 6c 6f 62 61 6c 22 0a   "SQLiteGlobal".
02f0: 0a 23 69 6e 63 6c 75 64 65 20 3c 6a 6e 69 2e 68  .#include <jni.h
0300: 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 4a 4e 49 48  >.#include <JNIH
0310: 65 6c 70 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20  elp.h>.#include 
0320: 22 41 4c 6f 67 2d 70 72 69 76 2e 68 22 0a 0a 0a  "ALog-priv.h"...
0330: 23 69 6e 63 6c 75 64 65 20 3c 73 71 6c 69 74 65  #include <sqlite
0340: 33 2e 68 3e 0a 23 69 66 20 30 0a 23 69 6e 63 6c  3.h>.#if 0.#incl
0350: 75 64 65 20 3c 73 71 6c 69 74 65 33 5f 61 6e 64  ude <sqlite3_and
0360: 72 6f 69 64 2e 68 3e 0a 23 65 6e 64 69 66 0a 0a  roid.h>.#endif..
0370: 0a 23 69 6e 63 6c 75 64 65 20 22 61 6e 64 72 6f  .#include "andro
0380: 69 64 5f 64 61 74 61 62 61 73 65 5f 53 51 4c 69  id_database_SQLi
0390: 74 65 43 6f 6d 6d 6f 6e 2e 68 22 0a 0a 6e 61 6d  teCommon.h"..nam
03a0: 65 73 70 61 63 65 20 61 6e 64 72 6f 69 64 20 7b  espace android {
03b0: 0a 0a 2f 2f 20 4c 69 6d 69 74 20 68 65 61 70 20  ..// Limit heap 
03c0: 74 6f 20 38 4d 42 20 66 6f 72 20 6e 6f 77 2e 20  to 8MB for now. 
03d0: 20 54 68 69 73 20 69 73 20 34 20 74 69 6d 65 73   This is 4 times
03e0: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 63 75 72   the maximum cur
03f0: 73 6f 72 20 77 69 6e 64 6f 77 0a 2f 2f 20 73 69  sor window.// si
0400: 7a 65 2c 20 61 73 20 68 61 73 20 62 65 65 6e 20  ze, as has been 
0410: 75 73 65 64 20 62 79 20 74 68 65 20 6f 72 69 67  used by the orig
0420: 69 6e 61 6c 20 63 6f 64 65 20 69 6e 20 53 51 4c  inal code in SQL
0430: 69 74 65 44 61 74 61 62 61 73 65 20 66 6f 72 0a  iteDatabase for.
0440: 2f 2f 20 61 20 6c 6f 6e 67 20 74 69 6d 65 2e 0a  // a long time..
0450: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 69 6e 74  static const int
0460: 20 53 4f 46 54 5f 48 45 41 50 5f 4c 49 4d 49 54   SOFT_HEAP_LIMIT
0470: 20 3d 20 38 20 2a 20 31 30 32 34 20 2a 20 31 30   = 8 * 1024 * 10
0480: 32 34 3b 0a 0a 0a 2f 2f 20 43 61 6c 6c 65 64 20  24;...// Called 
0490: 65 61 63 68 20 74 69 6d 65 20 61 20 6d 65 73 73  each time a mess
04a0: 61 67 65 20 69 73 20 6c 6f 67 67 65 64 2e 0a 73  age is logged..s
04b0: 74 61 74 69 63 20 76 6f 69 64 20 73 71 6c 69 74  tatic void sqlit
04c0: 65 4c 6f 67 43 61 6c 6c 62 61 63 6b 28 76 6f 69  eLogCallback(voi
04d0: 64 2a 20 64 61 74 61 2c 20 69 6e 74 20 69 45 72  d* data, int iEr
04e0: 72 43 6f 64 65 2c 20 63 6f 6e 73 74 20 63 68 61  rCode, const cha
04f0: 72 2a 20 7a 4d 73 67 29 20 7b 0a 20 20 20 20 62  r* zMsg) {.    b
0500: 6f 6f 6c 20 76 65 72 62 6f 73 65 4c 6f 67 20 3d  ool verboseLog =
0510: 20 21 21 64 61 74 61 3b 0a 20 20 20 20 69 66 20   !!data;.    if 
0520: 28 69 45 72 72 43 6f 64 65 20 3d 3d 20 30 20 7c  (iErrCode == 0 |
0530: 7c 20 69 45 72 72 43 6f 64 65 20 3d 3d 20 53 51  | iErrCode == SQ
0540: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20  LITE_CONSTRAINT 
0550: 7c 7c 20 69 45 72 72 43 6f 64 65 20 3d 3d 20 53  || iErrCode == S
0560: 51 4c 49 54 45 5f 53 43 48 45 4d 41 29 20 7b 0a  QLITE_SCHEMA) {.
0570: 20 20 20 20 20 20 20 20 69 66 20 28 76 65 72 62          if (verb
0580: 6f 73 65 4c 6f 67 29 20 7b 0a 20 20 20 20 20 20  oseLog) {.      
0590: 20 20 20 20 20 20 41 4c 4f 47 28 4c 4f 47 5f 56        ALOG(LOG_V
05a0: 45 52 42 4f 53 45 2c 20 53 51 4c 49 54 45 5f 4c  ERBOSE, SQLITE_L
05b0: 4f 47 5f 54 41 47 2c 20 22 28 25 64 29 20 25 73  OG_TAG, "(%d) %s
05c0: 5c 6e 22 2c 20 69 45 72 72 43 6f 64 65 2c 20 7a  \n", iErrCode, z
05d0: 4d 73 67 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a  Msg);.        }.
05e0: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20      } else {.   
05f0: 20 20 20 20 20 41 4c 4f 47 28 4c 4f 47 5f 45 52       ALOG(LOG_ER
0600: 52 4f 52 2c 20 53 51 4c 49 54 45 5f 4c 4f 47 5f  ROR, SQLITE_LOG_
0610: 54 41 47 2c 20 22 28 25 64 29 20 25 73 5c 6e 22  TAG, "(%d) %s\n"
0620: 2c 20 69 45 72 72 43 6f 64 65 2c 20 7a 4d 73 67  , iErrCode, zMsg
0630: 29 3b 0a 20 20 20 20 7d 0a 7d 0a 0a 2f 2f 20 53  );.    }.}..// S
0640: 65 74 73 20 74 68 65 20 67 6c 6f 62 61 6c 20 53  ets the global S
0650: 51 4c 69 74 65 20 63 6f 6e 66 69 67 75 72 61 74  QLite configurat
0660: 69 6f 6e 2e 0a 2f 2f 20 54 68 69 73 20 6d 75 73  ion..// This mus
0670: 74 20 62 65 20 63 61 6c 6c 65 64 20 62 65 66 6f  t be called befo
0680: 72 65 20 61 6e 79 20 6f 74 68 65 72 20 53 51 4c  re any other SQL
0690: 69 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72  ite functions ar
06a0: 65 20 63 61 6c 6c 65 64 2e 0a 73 74 61 74 69 63  e called..static
06b0: 20 76 6f 69 64 20 73 71 6c 69 74 65 49 6e 69 74   void sqliteInit
06c0: 69 61 6c 69 7a 65 28 29 20 7b 0a 20 20 20 20 2f  ialize() {.    /
06d0: 2f 20 45 6e 61 62 6c 65 20 6d 75 6c 74 69 2d 74  / Enable multi-t
06e0: 68 72 65 61 64 65 64 20 6d 6f 64 65 2e 20 20 49  hreaded mode.  I
06f0: 6e 20 74 68 69 73 20 6d 6f 64 65 2c 20 53 51 4c  n this mode, SQL
0700: 69 74 65 20 69 73 20 73 61 66 65 20 74 6f 20 75  ite is safe to u
0710: 73 65 20 62 79 20 6d 75 6c 74 69 70 6c 65 0a 20  se by multiple. 
0720: 20 20 20 2f 2f 20 74 68 72 65 61 64 73 20 61 73     // threads as
0730: 20 6c 6f 6e 67 20 61 73 20 6e 6f 20 74 77 6f 20   long as no two 
0740: 74 68 72 65 61 64 73 20 75 73 65 20 74 68 65 20  threads use the 
0750: 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 63 6f  same database co
0760: 6e 6e 65 63 74 69 6f 6e 20 61 74 20 74 68 65 20  nnection at the 
0770: 73 61 6d 65 0a 20 20 20 20 2f 2f 20 74 69 6d 65  same.    // time
0780: 20 28 77 68 69 63 68 20 77 65 20 67 75 61 72 61   (which we guara
0790: 6e 74 65 65 20 69 6e 20 74 68 65 20 53 51 4c 69  ntee in the SQLi
07a0: 74 65 20 64 61 74 61 62 61 73 65 20 77 72 61 70  te database wrap
07b0: 70 65 72 73 29 2e 0a 20 20 20 20 73 71 6c 69 74  pers)..    sqlit
07c0: 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45  e3_config(SQLITE
07d0: 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 54 48 52  _CONFIG_MULTITHR
07e0: 45 41 44 29 3b 0a 0a 20 20 20 20 2f 2f 20 52 65  EAD);..    // Re
07f0: 64 69 72 65 63 74 20 53 51 4c 69 74 65 20 6c 6f  direct SQLite lo
0800: 67 20 6d 65 73 73 61 67 65 73 20 74 6f 20 74 68  g messages to th
0810: 65 20 41 6e 64 72 6f 69 64 20 6c 6f 67 2e 0a 23  e Android log..#
0820: 69 66 20 30 0a 20 20 20 20 62 6f 6f 6c 20 76 65  if 0.    bool ve
0830: 72 62 6f 73 65 4c 6f 67 20 3d 20 61 6e 64 72 6f  rboseLog = andro
0840: 69 64 5f 75 74 69 6c 5f 4c 6f 67 5f 69 73 56 65  id_util_Log_isVe
0850: 72 62 6f 73 65 4c 6f 67 45 6e 61 62 6c 65 64 28  rboseLogEnabled(
0860: 53 51 4c 49 54 45 5f 4c 4f 47 5f 54 41 47 29 3b  SQLITE_LOG_TAG);
0870: 0a 23 65 6e 64 69 66 0a 20 20 20 20 62 6f 6f 6c  .#endif.    bool
0880: 20 76 65 72 62 6f 73 65 4c 6f 67 20 3d 20 66 61   verboseLog = fa
0890: 6c 73 65 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  lse;.    sqlite3
08a0: 5f 63 6f 6e 66 69 67 28 53 51 4c 49 54 45 5f 43  _config(SQLITE_C
08b0: 4f 4e 46 49 47 5f 4c 4f 47 2c 20 26 73 71 6c 69  ONFIG_LOG, &sqli
08c0: 74 65 4c 6f 67 43 61 6c 6c 62 61 63 6b 2c 20 76  teLogCallback, v
08d0: 65 72 62 6f 73 65 4c 6f 67 20 3f 20 28 76 6f 69  erboseLog ? (voi
08e0: 64 2a 29 31 20 3a 20 4e 55 4c 4c 29 3b 0a 0a 20  d*)1 : NULL);.. 
08f0: 20 20 20 2f 2f 20 54 68 65 20 73 6f 66 74 20 68     // The soft h
0900: 65 61 70 20 6c 69 6d 69 74 20 70 72 65 76 65 6e  eap limit preven
0910: 74 73 20 74 68 65 20 70 61 67 65 20 63 61 63 68  ts the page cach
0920: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 66 72  e allocations fr
0930: 6f 6d 20 67 72 6f 77 69 6e 67 0a 20 20 20 20 2f  om growing.    /
0940: 2f 20 62 65 79 6f 6e 64 20 74 68 65 20 67 69 76  / beyond the giv
0950: 65 6e 20 6c 69 6d 69 74 2c 20 6e 6f 20 6d 61 74  en limit, no mat
0960: 74 65 72 20 77 68 61 74 20 74 68 65 20 6d 61 78  ter what the max
0970: 20 70 61 67 65 20 63 61 63 68 65 20 73 69 7a 65   page cache size
0980: 73 20 61 72 65 0a 20 20 20 20 2f 2f 20 73 65 74  s are.    // set
0990: 20 74 6f 2e 20 54 68 65 20 6c 69 6d 69 74 20 64   to. The limit d
09a0: 6f 65 73 20 6e 6f 74 2c 20 61 73 20 6f 66 20 33  oes not, as of 3
09b0: 2e 35 2e 30 2c 20 61 66 66 65 63 74 20 61 6e 79  .5.0, affect any
09c0: 20 6f 74 68 65 72 20 61 6c 6c 6f 63 61 74 69 6f   other allocatio
09d0: 6e 73 2e 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  ns..    sqlite3_
09e0: 73 6f 66 74 5f 68 65 61 70 5f 6c 69 6d 69 74 28  soft_heap_limit(
09f0: 53 4f 46 54 5f 48 45 41 50 5f 4c 49 4d 49 54 29  SOFT_HEAP_LIMIT)
0a00: 3b 0a 0a 20 20 20 20 2f 2f 20 49 6e 69 74 69 61  ;..    // Initia
0a10: 6c 69 7a 65 20 53 51 4c 69 74 65 2e 0a 20 20 20  lize SQLite..   
0a20: 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c   sqlite3_initial
0a30: 69 7a 65 28 29 3b 0a 7d 0a 0a 73 74 61 74 69 63  ize();.}..static
0a40: 20 6a 69 6e 74 20 6e 61 74 69 76 65 52 65 6c 65   jint nativeRele
0a50: 61 73 65 4d 65 6d 6f 72 79 28 4a 4e 49 45 6e 76  aseMemory(JNIEnv
0a60: 2a 20 65 6e 76 2c 20 6a 63 6c 61 73 73 20 63 6c  * env, jclass cl
0a70: 61 7a 7a 29 20 7b 0a 20 20 20 20 72 65 74 75 72  azz) {.    retur
0a80: 6e 20 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73  n sqlite3_releas
0a90: 65 5f 6d 65 6d 6f 72 79 28 53 4f 46 54 5f 48 45  e_memory(SOFT_HE
0aa0: 41 50 5f 4c 49 4d 49 54 29 3b 0a 7d 0a 0a 73 74  AP_LIMIT);.}..st
0ab0: 61 74 69 63 20 4a 4e 49 4e 61 74 69 76 65 4d 65  atic JNINativeMe
0ac0: 74 68 6f 64 20 73 4d 65 74 68 6f 64 73 5b 5d 20  thod sMethods[] 
0ad0: 3d 0a 7b 0a 20 20 20 20 2f 2a 20 6e 61 6d 65 2c  =.{.    /* name,
0ae0: 20 73 69 67 6e 61 74 75 72 65 2c 20 66 75 6e 63   signature, func
0af0: 50 74 72 20 2a 2f 0a 20 20 20 20 7b 20 22 6e 61  Ptr */.    { "na
0b00: 74 69 76 65 52 65 6c 65 61 73 65 4d 65 6d 6f 72  tiveReleaseMemor
0b10: 79 22 2c 20 22 28 29 49 22 2c 0a 20 20 20 20 20  y", "()I",.     
0b20: 20 20 20 20 20 20 20 28 76 6f 69 64 2a 29 6e 61         (void*)na
0b30: 74 69 76 65 52 65 6c 65 61 73 65 4d 65 6d 6f 72  tiveReleaseMemor
0b40: 79 20 7d 2c 0a 7d 3b 0a 0a 69 6e 74 20 72 65 67  y },.};..int reg
0b50: 69 73 74 65 72 5f 61 6e 64 72 6f 69 64 5f 64 61  ister_android_da
0b60: 74 61 62 61 73 65 5f 53 51 4c 69 74 65 47 6c 6f  tabase_SQLiteGlo
0b70: 62 61 6c 28 4a 4e 49 45 6e 76 20 2a 65 6e 76 29  bal(JNIEnv *env)
0b80: 0a 7b 0a 20 20 20 20 73 71 6c 69 74 65 49 6e 69  .{.    sqliteIni
0b90: 74 69 61 6c 69 7a 65 28 29 3b 0a 0a 20 20 20 20  tialize();..    
0ba0: 72 65 74 75 72 6e 20 6a 6e 69 52 65 67 69 73 74  return jniRegist
0bb0: 65 72 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 28  erNativeMethods(
0bc0: 65 6e 76 2c 20 22 6f 72 67 2f 73 71 6c 69 74 65  env, "org/sqlite
0bd0: 2f 64 61 74 61 62 61 73 65 2f 73 71 6c 69 74 65  /database/sqlite
0be0: 2f 53 51 4c 69 74 65 47 6c 6f 62 61 6c 22 2c 0a  /SQLiteGlobal",.
0bf0: 20 20 20 20 20 20 20 20 20 20 20 20 73 4d 65 74              sMet
0c00: 68 6f 64 73 2c 20 4e 45 4c 45 4d 28 73 4d 65 74  hods, NELEM(sMet
0c10: 68 6f 64 73 29 29 3b 0a 7d 0a 0a 7d 20 2f 2f 20  hods));.}..} // 
0c20: 6e 61 6d 65 73 70 61 63 65 20 61 6e 64 72 6f 69  namespace androi
0c30: 64 0a                                            d.