SQLite Android Bindings
Hex Artifact Content
Not logged in

Artifact 827ea944e74db4d4add93c94393f6f92c95c89b1:


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 0a 23 69 6e 63 6c 75 64 65  elp.h>..#include
0320: 20 3c 73 71 6c 69 74 65 33 2e 68 3e 0a 0a 23 69   <sqlite3.h>..#i
0330: 6e 63 6c 75 64 65 20 22 61 6e 64 72 6f 69 64 5f  nclude "android_
0340: 64 61 74 61 62 61 73 65 5f 53 51 4c 69 74 65 43  database_SQLiteC
0350: 6f 6d 6d 6f 6e 2e 68 22 0a 23 69 6e 63 6c 75 64  ommon.h".#includ
0360: 65 20 22 41 4c 6f 67 2d 70 72 69 76 2e 68 22 0a  e "ALog-priv.h".
0370: 0a 6e 61 6d 65 73 70 61 63 65 20 61 6e 64 72 6f  .namespace andro
0380: 69 64 20 7b 0a 0a 2f 2f 20 4c 69 6d 69 74 20 68  id {..// Limit h
0390: 65 61 70 20 74 6f 20 38 4d 42 20 66 6f 72 20 6e  eap to 8MB for n
03a0: 6f 77 2e 20 20 54 68 69 73 20 69 73 20 34 20 74  ow.  This is 4 t
03b0: 69 6d 65 73 20 74 68 65 20 6d 61 78 69 6d 75 6d  imes the maximum
03c0: 20 63 75 72 73 6f 72 20 77 69 6e 64 6f 77 0a 2f   cursor window./
03d0: 2f 20 73 69 7a 65 2c 20 61 73 20 68 61 73 20 62  / size, as has b
03e0: 65 65 6e 20 75 73 65 64 20 62 79 20 74 68 65 20  een used by the 
03f0: 6f 72 69 67 69 6e 61 6c 20 63 6f 64 65 20 69 6e  original code in
0400: 20 53 51 4c 69 74 65 44 61 74 61 62 61 73 65 20   SQLiteDatabase 
0410: 66 6f 72 0a 2f 2f 20 61 20 6c 6f 6e 67 20 74 69  for.// a long ti
0420: 6d 65 2e 0a 73 74 61 74 69 63 20 63 6f 6e 73 74  me..static const
0430: 20 69 6e 74 20 53 4f 46 54 5f 48 45 41 50 5f 4c   int SOFT_HEAP_L
0440: 49 4d 49 54 20 3d 20 38 20 2a 20 31 30 32 34 20  IMIT = 8 * 1024 
0450: 2a 20 31 30 32 34 3b 0a 0a 0a 2f 2f 20 43 61 6c  * 1024;...// Cal
0460: 6c 65 64 20 65 61 63 68 20 74 69 6d 65 20 61 20  led each time a 
0470: 6d 65 73 73 61 67 65 20 69 73 20 6c 6f 67 67 65  message is logge
0480: 64 2e 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73  d..static void s
0490: 71 6c 69 74 65 4c 6f 67 43 61 6c 6c 62 61 63 6b  qliteLogCallback
04a0: 28 76 6f 69 64 2a 20 64 61 74 61 2c 20 69 6e 74  (void* data, int
04b0: 20 65 72 72 2c 20 63 6f 6e 73 74 20 63 68 61 72   err, const char
04c0: 2a 20 6d 73 67 29 20 7b 0a 20 20 20 20 62 6f 6f  * msg) {.    boo
04d0: 6c 20 76 65 72 62 6f 73 65 4c 6f 67 20 3d 20 21  l verboseLog = !
04e0: 21 64 61 74 61 3b 0a 20 20 20 20 69 6e 74 20 65  !data;.    int e
04f0: 72 72 54 79 70 65 20 3d 20 65 72 72 20 26 20 32  rrType = err & 2
0500: 35 35 3b 0a 20 20 20 20 69 66 20 28 65 72 72 54  55;.    if (errT
0510: 79 70 65 20 3d 3d 20 30 20 7c 7c 20 65 72 72 54  ype == 0 || errT
0520: 79 70 65 20 3d 3d 20 53 51 4c 49 54 45 5f 43 4f  ype == SQLITE_CO
0530: 4e 53 54 52 41 49 4e 54 20 7c 7c 20 65 72 72 54  NSTRAINT || errT
0540: 79 70 65 20 3d 3d 20 53 51 4c 49 54 45 5f 53 43  ype == SQLITE_SC
0550: 48 45 4d 41 0a 20 20 20 20 20 20 20 20 20 20 20  HEMA.           
0560: 20 7c 7c 20 65 72 72 54 79 70 65 20 3d 3d 20 53   || errType == S
0570: 51 4c 49 54 45 5f 4e 4f 54 49 43 45 20 7c 7c 20  QLITE_NOTICE || 
0580: 65 72 72 20 3d 3d 20 53 51 4c 49 54 45 5f 57 41  err == SQLITE_WA
0590: 52 4e 49 4e 47 5f 41 55 54 4f 49 4e 44 45 58 29  RNING_AUTOINDEX)
05a0: 20 7b 0a 20 20 20 20 20 20 20 20 69 66 20 28 76   {.        if (v
05b0: 65 72 62 6f 73 65 4c 6f 67 29 20 7b 0a 20 20 20  erboseLog) {.   
05c0: 20 20 20 20 20 20 20 20 20 41 4c 4f 47 28 4c 4f           ALOG(LO
05d0: 47 5f 56 45 52 42 4f 53 45 2c 20 53 51 4c 49 54  G_VERBOSE, SQLIT
05e0: 45 5f 4c 4f 47 5f 54 41 47 2c 20 22 28 25 64 29  E_LOG_TAG, "(%d)
05f0: 20 25 73 5c 6e 22 2c 20 65 72 72 2c 20 6d 73 67   %s\n", err, msg
0600: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
0610: 20 7d 20 65 6c 73 65 20 69 66 20 28 65 72 72 54   } else if (errT
0620: 79 70 65 20 3d 3d 20 53 51 4c 49 54 45 5f 57 41  ype == SQLITE_WA
0630: 52 4e 49 4e 47 29 20 7b 0a 20 20 20 20 20 20 20  RNING) {.       
0640: 20 41 4c 4f 47 28 4c 4f 47 5f 57 41 52 4e 2c 20   ALOG(LOG_WARN, 
0650: 53 51 4c 49 54 45 5f 4c 4f 47 5f 54 41 47 2c 20  SQLITE_LOG_TAG, 
0660: 22 28 25 64 29 20 25 73 5c 6e 22 2c 20 65 72 72  "(%d) %s\n", err
0670: 2c 20 6d 73 67 29 3b 0a 20 20 20 20 7d 20 65 6c  , msg);.    } el
0680: 73 65 20 7b 0a 20 20 20 20 20 20 20 20 41 4c 4f  se {.        ALO
0690: 47 28 4c 4f 47 5f 45 52 52 4f 52 2c 20 53 51 4c  G(LOG_ERROR, SQL
06a0: 49 54 45 5f 4c 4f 47 5f 54 41 47 2c 20 22 28 25  ITE_LOG_TAG, "(%
06b0: 64 29 20 25 73 5c 6e 22 2c 20 65 72 72 2c 20 6d  d) %s\n", err, m
06c0: 73 67 29 3b 0a 20 20 20 20 7d 0a 7d 0a 0a 2f 2f  sg);.    }.}..//
06d0: 20 53 65 74 73 20 74 68 65 20 67 6c 6f 62 61 6c   Sets the global
06e0: 20 53 51 4c 69 74 65 20 63 6f 6e 66 69 67 75 72   SQLite configur
06f0: 61 74 69 6f 6e 2e 0a 2f 2f 20 54 68 69 73 20 6d  ation..// This m
0700: 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 62 65  ust be called be
0710: 66 6f 72 65 20 61 6e 79 20 6f 74 68 65 72 20 53  fore any other S
0720: 51 4c 69 74 65 20 66 75 6e 63 74 69 6f 6e 73 20  QLite functions 
0730: 61 72 65 20 63 61 6c 6c 65 64 2e 0a 73 74 61 74  are called..stat
0740: 69 63 20 76 6f 69 64 20 73 71 6c 69 74 65 49 6e  ic void sqliteIn
0750: 69 74 69 61 6c 69 7a 65 28 29 20 7b 0a 20 20 20  itialize() {.   
0760: 20 2f 2f 20 45 6e 61 62 6c 65 20 6d 75 6c 74 69   // Enable multi
0770: 2d 74 68 72 65 61 64 65 64 20 6d 6f 64 65 2e 20  -threaded mode. 
0780: 20 49 6e 20 74 68 69 73 20 6d 6f 64 65 2c 20 53   In this mode, S
0790: 51 4c 69 74 65 20 69 73 20 73 61 66 65 20 74 6f  QLite is safe to
07a0: 20 75 73 65 20 62 79 20 6d 75 6c 74 69 70 6c 65   use by multiple
07b0: 0a 20 20 20 20 2f 2f 20 74 68 72 65 61 64 73 20  .    // threads 
07c0: 61 73 20 6c 6f 6e 67 20 61 73 20 6e 6f 20 74 77  as long as no tw
07d0: 6f 20 74 68 72 65 61 64 73 20 75 73 65 20 74 68  o threads use th
07e0: 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 20  e same database 
07f0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 74 20 74 68  connection at th
0800: 65 20 73 61 6d 65 0a 20 20 20 20 2f 2f 20 74 69  e same.    // ti
0810: 6d 65 20 28 77 68 69 63 68 20 77 65 20 67 75 61  me (which we gua
0820: 72 61 6e 74 65 65 20 69 6e 20 74 68 65 20 53 51  rantee in the SQ
0830: 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 77 72  Lite database wr
0840: 61 70 70 65 72 73 29 2e 0a 20 20 20 20 73 71 6c  appers)..    sql
0850: 69 74 65 33 5f 63 6f 6e 66 69 67 28 53 51 4c 49  ite3_config(SQLI
0860: 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 54  TE_CONFIG_MULTIT
0870: 48 52 45 41 44 29 3b 0a 0a 20 20 20 20 2f 2f 20  HREAD);..    // 
0880: 52 65 64 69 72 65 63 74 20 53 51 4c 69 74 65 20  Redirect SQLite 
0890: 6c 6f 67 20 6d 65 73 73 61 67 65 73 20 74 6f 20  log messages to 
08a0: 74 68 65 20 41 6e 64 72 6f 69 64 20 6c 6f 67 2e  the Android log.
08b0: 0a 20 20 20 20 62 6f 6f 6c 20 76 65 72 62 6f 73  .    bool verbos
08c0: 65 4c 6f 67 20 3d 20 66 61 6c 73 65 3b 0a 20 20  eLog = false;.  
08d0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67    sqlite3_config
08e0: 28 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c  (SQLITE_CONFIG_L
08f0: 4f 47 2c 20 26 73 71 6c 69 74 65 4c 6f 67 43 61  OG, &sqliteLogCa
0900: 6c 6c 62 61 63 6b 2c 20 76 65 72 62 6f 73 65 4c  llback, verboseL
0910: 6f 67 20 3f 20 28 76 6f 69 64 2a 29 31 20 3a 20  og ? (void*)1 : 
0920: 4e 55 4c 4c 29 3b 0a 0a 20 20 20 20 2f 2f 20 54  NULL);..    // T
0930: 68 65 20 73 6f 66 74 20 68 65 61 70 20 6c 69 6d  he soft heap lim
0940: 69 74 20 70 72 65 76 65 6e 74 73 20 74 68 65 20  it prevents the 
0950: 70 61 67 65 20 63 61 63 68 65 20 61 6c 6c 6f 63  page cache alloc
0960: 61 74 69 6f 6e 73 20 66 72 6f 6d 20 67 72 6f 77  ations from grow
0970: 69 6e 67 0a 20 20 20 20 2f 2f 20 62 65 79 6f 6e  ing.    // beyon
0980: 64 20 74 68 65 20 67 69 76 65 6e 20 6c 69 6d 69  d the given limi
0990: 74 2c 20 6e 6f 20 6d 61 74 74 65 72 20 77 68 61  t, no matter wha
09a0: 74 20 74 68 65 20 6d 61 78 20 70 61 67 65 20 63  t the max page c
09b0: 61 63 68 65 20 73 69 7a 65 73 20 61 72 65 0a 20  ache sizes are. 
09c0: 20 20 20 2f 2f 20 73 65 74 20 74 6f 2e 20 54 68     // set to. Th
09d0: 65 20 6c 69 6d 69 74 20 64 6f 65 73 20 6e 6f 74  e limit does not
09e0: 2c 20 61 73 20 6f 66 20 33 2e 35 2e 30 2c 20 61  , as of 3.5.0, a
09f0: 66 66 65 63 74 20 61 6e 79 20 6f 74 68 65 72 20  ffect any other 
0a00: 61 6c 6c 6f 63 61 74 69 6f 6e 73 2e 0a 20 20 20  allocations..   
0a10: 20 73 71 6c 69 74 65 33 5f 73 6f 66 74 5f 68 65   sqlite3_soft_he
0a20: 61 70 5f 6c 69 6d 69 74 28 53 4f 46 54 5f 48 45  ap_limit(SOFT_HE
0a30: 41 50 5f 4c 49 4d 49 54 29 3b 0a 0a 20 20 20 20  AP_LIMIT);..    
0a40: 2f 2f 20 49 6e 69 74 69 61 6c 69 7a 65 20 53 51  // Initialize SQ
0a50: 4c 69 74 65 2e 0a 20 20 20 20 73 71 6c 69 74 65  Lite..    sqlite
0a60: 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a  3_initialize();.
0a70: 7d 0a 0a 73 74 61 74 69 63 20 6a 69 6e 74 20 6e  }..static jint n
0a80: 61 74 69 76 65 52 65 6c 65 61 73 65 4d 65 6d 6f  ativeReleaseMemo
0a90: 72 79 28 4a 4e 49 45 6e 76 2a 20 65 6e 76 2c 20  ry(JNIEnv* env, 
0aa0: 6a 63 6c 61 73 73 20 63 6c 61 7a 7a 29 20 7b 0a  jclass clazz) {.
0ab0: 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74      return sqlit
0ac0: 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d 6f 72  e3_release_memor
0ad0: 79 28 53 4f 46 54 5f 48 45 41 50 5f 4c 49 4d 49  y(SOFT_HEAP_LIMI
0ae0: 54 29 3b 0a 7d 0a 0a 73 74 61 74 69 63 20 63 6f  T);.}..static co
0af0: 6e 73 74 20 4a 4e 49 4e 61 74 69 76 65 4d 65 74  nst JNINativeMet
0b00: 68 6f 64 20 73 4d 65 74 68 6f 64 73 5b 5d 20 3d  hod sMethods[] =
0b10: 0a 7b 0a 20 20 20 20 2f 2a 20 6e 61 6d 65 2c 20  .{.    /* name, 
0b20: 73 69 67 6e 61 74 75 72 65 2c 20 66 75 6e 63 50  signature, funcP
0b30: 74 72 20 2a 2f 0a 20 20 20 20 7b 20 22 6e 61 74  tr */.    { "nat
0b40: 69 76 65 52 65 6c 65 61 73 65 4d 65 6d 6f 72 79  iveReleaseMemory
0b50: 22 2c 20 22 28 29 49 22 2c 20 28 76 6f 69 64 2a  ", "()I", (void*
0b60: 29 6e 61 74 69 76 65 52 65 6c 65 61 73 65 4d 65  )nativeReleaseMe
0b70: 6d 6f 72 79 20 7d 2c 0a 7d 3b 0a 0a 69 6e 74 20  mory },.};..int 
0b80: 72 65 67 69 73 74 65 72 5f 61 6e 64 72 6f 69 64  register_android
0b90: 5f 64 61 74 61 62 61 73 65 5f 53 51 4c 69 74 65  _database_SQLite
0ba0: 47 6c 6f 62 61 6c 28 4a 4e 49 45 6e 76 20 2a 65  Global(JNIEnv *e
0bb0: 6e 76 29 0a 7b 0a 20 20 20 20 73 71 6c 69 74 65  nv).{.    sqlite
0bc0: 49 6e 69 74 69 61 6c 69 7a 65 28 29 3b 0a 0a 20  Initialize();.. 
0bd0: 20 20 20 72 65 74 75 72 6e 20 6a 6e 69 52 65 67     return jniReg
0be0: 69 73 74 65 72 4e 61 74 69 76 65 4d 65 74 68 6f  isterNativeMetho
0bf0: 64 73 28 65 6e 76 2c 20 22 6f 72 67 2f 73 71 6c  ds(env, "org/sql
0c00: 69 74 65 2f 64 61 74 61 62 61 73 65 2f 73 71 6c  ite/database/sql
0c10: 69 74 65 2f 53 51 4c 69 74 65 47 6c 6f 62 61 6c  ite/SQLiteGlobal
0c20: 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 73  ",.            s
0c30: 4d 65 74 68 6f 64 73 2c 20 4e 45 4c 45 4d 28 73  Methods, NELEM(s
0c40: 4d 65 74 68 6f 64 73 29 29 3b 0a 7d 0a 0a 7d 20  Methods));.}..} 
0c50: 2f 2f 20 6e 61 6d 65 73 70 61 63 65 20 61 6e 64  // namespace and
0c60: 72 6f 69 64 0a                                   roid.