SQLite Android Bindings
Hex Artifact Content
Not logged in

Artifact 2c59ab56141689068c5ecd9ea3a3bb7a62059a7f:


0000: 0a 41 6c 6c 20 74 68 65 20 66 69 6c 65 73 20 69  .All the files i
0010: 6e 20 74 68 69 73 20 64 69 72 65 63 74 6f 72 79  n this directory
0020: 20 61 72 65 20 63 6f 70 69 65 64 20 66 72 6f 6d   are copied from
0030: 20 73 74 6f 63 6b 20 61 6e 64 72 6f 69 64 2e 20   stock android. 
0040: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 66 69  The following.fi
0050: 6c 65 73 3a 0a 0a 4a 6e 69 43 6f 6e 73 74 61 6e  les:..JniConstan
0060: 74 73 2e 63 70 70 0a 4a 4e 49 48 65 6c 70 2e 63  ts.cpp.JNIHelp.c
0070: 70 70 0a 41 4c 6f 67 2d 70 72 69 76 2e 68 0a 0a  pp.ALog-priv.h..
0080: 61 72 65 20 63 6f 70 69 65 64 20 69 6e 20 66 72  are copied in fr
0090: 6f 6d 20 41 6e 64 72 6f 69 64 27 73 20 6c 69 62  om Android's lib
00a0: 6e 61 74 69 76 65 68 65 6c 70 65 72 20 6d 6f 64  nativehelper mod
00b0: 75 6c 65 20 28 61 6c 74 6f 67 65 74 68 65 72 20  ule (altogether 
00c0: 6c 65 73 73 20 74 68 61 6e 20 31 30 30 30 0a 6c  less than 1000.l
00d0: 69 6e 65 73 20 6f 66 20 63 6f 64 65 29 2e 20 54  ines of code). T
00e0: 68 65 20 72 65 6d 61 69 6e 64 65 72 20 61 72 65  he remainder are
00f0: 20 66 72 6f 6d 20 74 68 65 20 63 6f 72 65 20 66   from the core f
0100: 72 61 6d 65 77 6f 72 6b 20 28 64 69 72 65 63 74  ramework (direct
0110: 6f 72 79 0a 2f 66 72 61 6d 65 77 6f 72 6b 73 2f  ory./frameworks/
0120: 62 61 73 65 2f 63 6f 72 65 2f 6a 6e 69 29 2e 0a  base/core/jni)..
0130: 0a 4e 6f 74 65 73 20 6f 6e 20 63 68 61 6e 67 65  .Notes on change
0140: 73 3a 0a 0a 54 68 65 20 61 73 68 6d 65 6d 5f 58  s:..The ashmem_X
0150: 58 58 28 29 20 69 6e 74 65 72 66 61 63 65 73 20  XX() interfaces 
0160: 61 72 65 20 75 73 65 64 20 66 6f 72 20 74 68 65  are used for the
0170: 20 76 61 72 69 6f 75 73 20 22 78 78 78 46 6f 72   various "xxxFor
0180: 42 6c 6f 62 44 65 73 63 72 69 70 74 6f 72 28 29  BlobDescriptor()
0190: 22 0a 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 2e  ".API functions.
01a0: 20 54 68 65 20 63 6f 64 65 20 69 6e 20 6c 69 62   The code in lib
01b0: 63 75 74 69 6c 73 20 66 6f 72 20 74 68 69 73 20  cutils for this 
01c0: 73 65 65 6d 73 20 74 6f 20 62 65 20 70 6c 61 74  seems to be plat
01d0: 66 6f 72 6d 0a 64 65 70 65 6e 64 65 6e 74 20 2d  form.dependent -
01e0: 20 73 6f 6d 65 20 70 6c 61 74 66 6f 72 6d 73 20   some platforms 
01f0: 68 61 76 65 20 6b 65 72 6e 65 6c 20 73 75 70 70  have kernel supp
0200: 6f 72 74 2c 20 6f 74 68 65 72 73 20 68 61 76 65  ort, others have
0210: 20 61 20 75 73 65 72 20 73 70 61 63 65 0a 69 6d   a user space.im
0220: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 53 6f  plementation. So
0230: 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73   these functions
0240: 20 61 72 65 20 6e 6f 74 20 73 75 70 70 6f 72 74   are not support
0250: 65 64 20 66 6f 72 20 6e 6f 77 2e 0a 0a 54 68 65  ed for now...The
0260: 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 69 74 65   original SQLite
0270: 43 6f 6e 6e 65 63 74 69 6f 6e 2e 63 70 70 20 75  Connection.cpp u
0280: 73 65 73 20 41 6e 64 72 6f 69 64 52 75 6e 74 69  ses AndroidRunti
0290: 6d 65 3a 3a 67 65 6e 4a 4e 49 45 6e 76 28 29 20  me::genJNIEnv() 
02a0: 74 6f 20 6f 62 74 61 69 6e 20 61 0a 70 6f 69 6e  to obtain a.poin
02b0: 74 65 72 20 74 6f 20 74 68 65 20 63 75 72 72 65  ter to the curre
02c0: 6e 74 20 74 68 72 65 61 64 73 20 65 6e 76 69 72  nt threads envir
02d0: 6f 6e 6d 65 6e 74 2e 20 43 68 61 6e 67 65 64 20  onment. Changed 
02e0: 74 6f 20 73 74 6f 72 65 20 61 20 70 6f 69 6e 74  to store a point
02f0: 65 72 20 74 6f 20 74 68 65 0a 70 72 6f 63 65 73  er to the.proces
0300: 73 20 4a 61 76 61 56 4d 20 28 41 6e 64 72 6f 69  s JavaVM (Androi
0310: 64 20 61 6c 6c 6f 77 73 20 6f 6e 6c 79 20 6f 6e  d allows only on
0320: 65 29 20 61 73 20 61 20 67 6c 6f 62 61 6c 20 76  e) as a global v
0330: 61 72 69 61 62 6c 65 2e 20 54 68 65 6e 20 72 65  ariable. Then re
0340: 74 72 69 65 76 65 0a 74 68 65 20 4a 4e 49 45 6e  trieve.the JNIEn
0350: 76 20 61 73 20 6e 65 65 64 65 64 20 75 73 69 6e  v as needed usin
0360: 67 20 47 65 74 45 6e 76 28 29 2e 0a 0a 52 65 70  g GetEnv()...Rep
0370: 6c 61 63 65 64 20 75 73 65 73 20 6f 66 20 63 6c  laced uses of cl
0380: 61 73 73 20 53 74 72 69 6e 67 38 20 77 69 74 68  ass String8 with
0390: 20 73 74 64 3a 3a 73 74 72 69 6e 67 20 69 6e 20   std::string in 
03a0: 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e  SQLiteConnection
03b0: 2e 63 70 70 20 61 6e 64 20 61 0a 66 65 77 20 6f  .cpp and a.few o
03c0: 74 68 65 72 20 70 6c 61 63 65 73 2e 0a 0a 54 68  ther places...Th
03d0: 65 20 73 74 6f 63 6b 20 41 6e 64 72 6f 69 64 20  e stock Android 
03e0: 63 6f 64 65 20 74 6f 20 70 6f 70 75 6c 61 74 65  code to populate
03f0: 20 43 75 72 73 6f 72 57 69 6e 64 6f 77 20 63 6f   CursorWindow co
0400: 6e 74 61 69 6e 65 72 73 20 77 69 74 68 20 74 68  ntainers with th
0410: 65 20 72 65 73 75 6c 74 73 20 6f 66 0a 61 20 53  e results of.a S
0420: 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20  ELECT statement 
0430: 75 73 65 73 20 61 20 43 2b 2b 20 69 6e 74 65 72  uses a C++ inter
0440: 66 61 63 65 20 74 68 61 74 20 69 73 20 6e 6f 74  face that is not
0450: 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 4e 44   available to ND
0460: 4b 20 62 75 69 6c 64 73 2e 20 53 6f 0a 74 68 69  K builds. So.thi
0470: 73 20 63 6f 64 65 20 69 73 20 72 65 77 72 69 74  s code is rewrit
0480: 74 65 6e 20 74 6f 20 63 61 6c 6c 20 74 68 65 20  ten to call the 
0490: 43 75 72 73 6f 72 57 69 6e 64 6f 77 20 6a 61 76  CursorWindow jav
04a0: 61 20 69 6e 74 65 72 66 61 63 65 20 76 69 61 20  a interface via 
04b0: 4a 4e 49 20 6d 65 74 68 6f 64 73 2e 0a 54 68 69  JNI methods..Thi
04c0: 73 20 69 73 20 74 68 65 20 6c 61 72 67 65 73 74  s is the largest
04d0: 20 73 6f 75 72 63 65 20 63 6f 64 65 20 63 68 61   source code cha
04e0: 6e 67 65 2e 20 53 65 65 20 66 75 6e 63 74 69 6f  nge. See functio
04f0: 6e 20 0a 6e 61 74 69 76 65 45 78 65 63 75 74 65  n .nativeExecute
0500: 46 6f 72 43 75 72 73 6f 72 57 69 6e 64 6f 77 28  ForCursorWindow(
0510: 29 20 69 6e 20 66 69 6c 65 20 61 6e 64 72 6f 69  ) in file androi
0520: 64 5f 64 61 74 61 62 61 73 65 5f 53 51 4c 69 74  d_database_SQLit
0530: 65 43 6f 6e 6e 65 63 74 69 6f 6e 2e 63 70 70 0a  eConnection.cpp.
0540: 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 0a 54 68  for details...Th
0550: 65 20 22 4c 4f 43 41 4c 49 5a 45 44 22 20 63 6f  e "LOCALIZED" co
0560: 6c 6c 61 74 69 6f 6e 20 61 6e 64 20 73 6f 6d 65  llation and some
0570: 20 6d 69 73 63 65 6c 6c 61 6e 65 6f 75 73 20 75   miscellaneous u
0580: 73 65 72 2d 66 75 6e 63 74 69 6f 6e 73 20 61 64  ser-functions ad
0590: 64 65 64 20 62 79 20 74 68 65 0a 73 71 6c 69 74  ded by the.sqlit
05a0: 65 33 5f 61 6e 64 72 6f 69 64 2e 63 70 70 20 6d  e3_android.cpp m
05b0: 6f 64 75 6c 65 20 61 72 65 20 6e 6f 74 20 69 6e  odule are not in
05c0: 63 6c 75 64 65 64 2e 20 41 20 63 6f 6c 6c 61 74  cluded. A collat
05d0: 69 6f 6e 20 63 61 6c 6c 65 64 20 4c 4f 43 41 4c  ion called LOCAL
05e0: 49 5a 45 44 0a 74 68 61 74 20 69 73 20 65 71 75  IZED.that is equ
05f0: 69 76 61 6c 65 6e 74 20 74 6f 20 42 49 4e 41 52  ivalent to BINAR
0600: 59 20 69 73 20 61 64 64 65 64 20 69 6e 73 74 65  Y is added inste
0610: 61 64 20 74 6f 20 6b 65 65 70 20 76 61 72 69 6f  ad to keep vario
0620: 75 73 20 74 68 69 6e 67 73 20 77 6f 72 6b 69 6e  us things workin
0630: 67 2e 0a 54 68 69 73 20 73 68 6f 75 6c 64 20 6e  g..This should n
0640: 6f 74 20 63 61 75 73 65 20 73 65 72 69 6f 75 73  ot cause serious
0650: 20 70 72 6f 62 6c 65 6d 73 20 2d 20 63 6c 61 73   problems - clas
0660: 73 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69  s SQLiteConnecti
0670: 6f 6e 20 61 6c 77 61 79 73 0a 72 75 6e 73 20 22  on always.runs "
0680: 52 45 49 4e 44 45 58 20 4c 4f 43 41 4c 49 5a 45  REINDEX LOCALIZE
0690: 44 22 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 61  D" immediately a
06a0: 66 74 65 72 20 6f 70 65 6e 69 6e 67 20 61 20 63  fter opening a c
06b0: 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 0a              onnection...