SQLite Android Bindings
Hex Artifact Content
Not logged in

Artifact f4ad893d9bbd02fccee9f74ddd1f36fe8928e182:


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 70 61 63 6b 61 67 65 20 6f 72 67 2e 73 71 6c  .package org.sql
02e0: 69 74 65 2e 64 61 74 61 62 61 73 65 2e 73 71 6c  ite.database.sql
02f0: 69 74 65 3b 0a 0a 69 6d 70 6f 72 74 20 61 6e 64  ite;..import and
0300: 72 6f 69 64 2e 63 6f 6e 74 65 6e 74 2e 72 65 73  roid.content.res
0310: 2e 52 65 73 6f 75 72 63 65 73 3b 0a 69 6d 70 6f  .Resources;.impo
0320: 72 74 20 61 6e 64 72 6f 69 64 2e 6f 73 2e 53 74  rt android.os.St
0330: 61 74 46 73 3b 0a 2f 2a 20 69 6d 70 6f 72 74 20  atFs;./* import 
0340: 61 6e 64 72 6f 69 64 2e 6f 73 2e 53 79 73 74 65  android.os.Syste
0350: 6d 50 72 6f 70 65 72 74 69 65 73 3b 20 2a 2f 0a  mProperties; */.
0360: 0a 2f 2a 2a 0a 20 2a 20 50 72 6f 76 69 64 65 73  ./**. * Provides
0370: 20 61 63 63 65 73 73 20 74 6f 20 53 51 4c 69 74   access to SQLit
0380: 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74  e functions that
0390: 20 61 66 66 65 63 74 20 61 6c 6c 20 64 61 74 61   affect all data
03a0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c  base connection,
03b0: 0a 20 2a 20 73 75 63 68 20 61 73 20 6d 65 6d 6f  . * such as memo
03c0: 72 79 20 6d 61 6e 61 67 65 6d 65 6e 74 2e 0a 20  ry management.. 
03d0: 2a 0a 20 2a 20 54 68 65 20 6e 61 74 69 76 65 20  *. * The native 
03e0: 63 6f 64 65 20 61 73 73 6f 63 69 61 74 65 64 20  code associated 
03f0: 77 69 74 68 20 53 51 4c 69 74 65 47 6c 6f 62 61  with SQLiteGloba
0400: 6c 20 69 73 20 61 6c 73 6f 20 73 65 74 73 20 67  l is also sets g
0410: 6c 6f 62 61 6c 20 63 6f 6e 66 69 67 75 72 61 74  lobal configurat
0420: 69 6f 6e 20 6f 70 74 69 6f 6e 73 0a 20 2a 20 75  ion options. * u
0430: 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 63 6f 6e  sing sqlite3_con
0440: 66 69 67 28 29 20 74 68 65 6e 20 63 61 6c 6c 73  fig() then calls
0450: 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c   sqlite3_initial
0460: 69 7a 65 28 29 20 74 6f 20 65 6e 73 75 72 65 20  ize() to ensure 
0470: 74 68 61 74 20 74 68 65 20 53 51 4c 69 74 65 0a  that the SQLite.
0480: 20 2a 20 6c 69 62 72 61 72 79 20 69 73 20 70 72   * library is pr
0490: 6f 70 65 72 6c 79 20 69 6e 69 74 69 61 6c 69 7a  operly initializ
04a0: 65 64 20 65 78 61 63 74 6c 79 20 6f 6e 63 65 20  ed exactly once 
04b0: 62 65 66 6f 72 65 20 61 6e 79 20 6f 74 68 65 72  before any other
04c0: 20 66 72 61 6d 65 77 6f 72 6b 20 6f 72 20 61 70   framework or ap
04d0: 70 6c 69 63 61 74 69 6f 6e 0a 20 2a 20 63 6f 64  plication. * cod
04e0: 65 20 68 61 73 20 61 20 63 68 61 6e 63 65 20 74  e has a chance t
04f0: 6f 20 72 75 6e 2e 0a 20 2a 0a 20 2a 20 56 65 72  o run.. *. * Ver
0500: 62 6f 73 65 20 53 51 4c 69 74 65 20 6c 6f 67 67  bose SQLite logg
0510: 69 6e 67 20 69 73 20 65 6e 61 62 6c 65 64 20 69  ing is enabled i
0520: 66 20 74 68 65 20 22 6c 6f 67 2e 74 61 67 2e 53  f the "log.tag.S
0530: 51 4c 69 74 65 4c 6f 67 22 20 70 72 6f 70 65 72  QLiteLog" proper
0540: 74 79 20 69 73 20 73 65 74 20 74 6f 20 22 56 22  ty is set to "V"
0550: 2e 0a 20 2a 20 28 70 65 72 20 7b 40 6c 69 6e 6b  .. * (per {@link
0560: 20 53 51 4c 69 74 65 44 65 62 75 67 23 44 45 42   SQLiteDebug#DEB
0570: 55 47 5f 53 51 4c 5f 4c 4f 47 7d 29 2e 0a 20 2a  UG_SQL_LOG}).. *
0580: 0a 20 2a 20 40 68 69 64 65 0a 20 2a 2f 0a 70 75  . * @hide. */.pu
0590: 62 6c 69 63 20 66 69 6e 61 6c 20 63 6c 61 73 73  blic final class
05a0: 20 53 51 4c 69 74 65 47 6c 6f 62 61 6c 20 7b 0a   SQLiteGlobal {.
05b0: 20 20 20 20 70 72 69 76 61 74 65 20 73 74 61 74      private stat
05c0: 69 63 20 66 69 6e 61 6c 20 53 74 72 69 6e 67 20  ic final String 
05d0: 54 41 47 20 3d 20 22 53 51 4c 69 74 65 47 6c 6f  TAG = "SQLiteGlo
05e0: 62 61 6c 22 3b 0a 0a 20 20 20 20 70 72 69 76 61  bal";..    priva
05f0: 74 65 20 73 74 61 74 69 63 20 66 69 6e 61 6c 20  te static final 
0600: 4f 62 6a 65 63 74 20 73 4c 6f 63 6b 20 3d 20 6e  Object sLock = n
0610: 65 77 20 4f 62 6a 65 63 74 28 29 3b 0a 20 20 20  ew Object();.   
0620: 20 70 72 69 76 61 74 65 20 73 74 61 74 69 63 20   private static 
0630: 69 6e 74 20 73 44 65 66 61 75 6c 74 50 61 67 65  int sDefaultPage
0640: 53 69 7a 65 3b 0a 0a 20 20 20 20 70 72 69 76 61  Size;..    priva
0650: 74 65 20 73 74 61 74 69 63 20 6e 61 74 69 76 65  te static native
0660: 20 69 6e 74 20 6e 61 74 69 76 65 52 65 6c 65 61   int nativeRelea
0670: 73 65 4d 65 6d 6f 72 79 28 29 3b 0a 0a 20 20 20  seMemory();..   
0680: 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 47   private SQLiteG
0690: 6c 6f 62 61 6c 28 29 20 7b 0a 20 20 20 20 7d 0a  lobal() {.    }.
06a0: 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20  .    /**.     * 
06b0: 41 74 74 65 6d 70 74 73 20 74 6f 20 72 65 6c 65  Attempts to rele
06c0: 61 73 65 20 6d 65 6d 6f 72 79 20 62 79 20 70 72  ase memory by pr
06d0: 75 6e 69 6e 67 20 74 68 65 20 53 51 4c 69 74 65  uning the SQLite
06e0: 20 70 61 67 65 20 63 61 63 68 65 20 61 6e 64 20   page cache and 
06f0: 6f 74 68 65 72 0a 20 20 20 20 20 2a 20 69 6e 74  other.     * int
0700: 65 72 6e 61 6c 20 64 61 74 61 20 73 74 72 75 63  ernal data struc
0710: 74 75 72 65 73 2e 0a 20 20 20 20 20 2a 0a 20 20  tures..     *.  
0720: 20 20 20 2a 20 40 72 65 74 75 72 6e 20 54 68 65     * @return The
0730: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
0740: 20 74 68 61 74 20 77 65 72 65 20 66 72 65 65 64   that were freed
0750: 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75  ..     */.    pu
0760: 62 6c 69 63 20 73 74 61 74 69 63 20 69 6e 74 20  blic static int 
0770: 72 65 6c 65 61 73 65 4d 65 6d 6f 72 79 28 29 20  releaseMemory() 
0780: 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  {.        return
0790: 20 6e 61 74 69 76 65 52 65 6c 65 61 73 65 4d 65   nativeReleaseMe
07a0: 6d 6f 72 79 28 29 3b 0a 20 20 20 20 7d 0a 0a 20  mory();.    }.. 
07b0: 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 47 65     /**.     * Ge
07c0: 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 70  ts the default p
07d0: 61 67 65 20 73 69 7a 65 20 74 6f 20 75 73 65 20  age size to use 
07e0: 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 61 20  when creating a 
07f0: 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 2a  database..     *
0800: 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 73 74 61  /.    public sta
0810: 74 69 63 20 69 6e 74 20 67 65 74 44 65 66 61 75  tic int getDefau
0820: 6c 74 50 61 67 65 53 69 7a 65 28 29 20 7b 0a 20  ltPageSize() {. 
0830: 20 20 20 20 20 20 20 73 79 6e 63 68 72 6f 6e 69         synchroni
0840: 7a 65 64 20 28 73 4c 6f 63 6b 29 20 7b 0a 20 20  zed (sLock) {.  
0850: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 73 44            if (sD
0860: 65 66 61 75 6c 74 50 61 67 65 53 69 7a 65 20 3d  efaultPageSize =
0870: 3d 20 30 29 20 7b 0a 20 20 20 20 20 20 20 20 20  = 0) {.         
0880: 20 20 20 20 20 20 20 73 44 65 66 61 75 6c 74 50         sDefaultP
0890: 61 67 65 53 69 7a 65 20 3d 20 6e 65 77 20 53 74  ageSize = new St
08a0: 61 74 46 73 28 22 2f 64 61 74 61 22 29 2e 67 65  atFs("/data").ge
08b0: 74 42 6c 6f 63 6b 53 69 7a 65 28 29 3b 0a 20 20  tBlockSize();.  
08c0: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
08d0: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 31          return 1
08e0: 30 32 34 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  024;.        }. 
08f0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20     }..    /**.  
0900: 20 20 20 2a 20 47 65 74 73 20 74 68 65 20 64 65     * Gets the de
0910: 66 61 75 6c 74 20 6a 6f 75 72 6e 61 6c 20 6d 6f  fault journal mo
0920: 64 65 20 77 68 65 6e 20 57 41 4c 20 69 73 20 6e  de when WAL is n
0930: 6f 74 20 69 6e 20 75 73 65 2e 0a 20 20 20 20 20  ot in use..     
0940: 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 73 74  */.    public st
0950: 61 74 69 63 20 53 74 72 69 6e 67 20 67 65 74 44  atic String getD
0960: 65 66 61 75 6c 74 4a 6f 75 72 6e 61 6c 4d 6f 64  efaultJournalMod
0970: 65 28 29 20 7b 0a 20 20 20 20 20 20 20 20 72 65  e() {.        re
0980: 74 75 72 6e 20 22 64 65 6c 65 74 65 22 3b 0a 20  turn "delete";. 
0990: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20     }..    /**.  
09a0: 20 20 20 2a 20 47 65 74 73 20 74 68 65 20 6a 6f     * Gets the jo
09b0: 75 72 6e 61 6c 20 73 69 7a 65 20 6c 69 6d 69 74  urnal size limit
09c0: 20 69 6e 20 62 79 74 65 73 2e 0a 20 20 20 20 20   in bytes..     
09d0: 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 73 74  */.    public st
09e0: 61 74 69 63 20 69 6e 74 20 67 65 74 4a 6f 75 72  atic int getJour
09f0: 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 28 29 20 7b  nalSizeLimit() {
0a00: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
0a10: 31 30 30 30 30 3b 0a 20 20 20 20 7d 0a 0a 20 20  10000;.    }..  
0a20: 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 47 65 74    /**.     * Get
0a30: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 64 61  s the default da
0a40: 74 61 62 61 73 65 20 73 79 6e 63 68 72 6f 6e 69  tabase synchroni
0a50: 7a 61 74 69 6f 6e 20 6d 6f 64 65 20 77 68 65 6e  zation mode when
0a60: 20 57 41 4c 20 69 73 20 6e 6f 74 20 69 6e 20 75   WAL is not in u
0a70: 73 65 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20  se..     */.    
0a80: 70 75 62 6c 69 63 20 73 74 61 74 69 63 20 53 74  public static St
0a90: 72 69 6e 67 20 67 65 74 44 65 66 61 75 6c 74 53  ring getDefaultS
0aa0: 79 6e 63 4d 6f 64 65 28 29 20 7b 0a 20 20 20 20  yncMode() {.    
0ab0: 20 20 20 20 72 65 74 75 72 6e 20 22 6e 6f 72 6d      return "norm
0ac0: 61 6c 22 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  al";.    }..    
0ad0: 2f 2a 2a 0a 20 20 20 20 20 2a 20 47 65 74 73 20  /**.     * Gets 
0ae0: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 79 6e  the database syn
0af0: 63 68 72 6f 6e 69 7a 61 74 69 6f 6e 20 6d 6f 64  chronization mod
0b00: 65 20 77 68 65 6e 20 69 6e 20 57 41 4c 20 6d 6f  e when in WAL mo
0b10: 64 65 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20  de..     */.    
0b20: 70 75 62 6c 69 63 20 73 74 61 74 69 63 20 53 74  public static St
0b30: 72 69 6e 67 20 67 65 74 57 41 4c 53 79 6e 63 4d  ring getWALSyncM
0b40: 6f 64 65 28 29 20 7b 0a 20 20 20 20 20 20 20 20  ode() {.        
0b50: 72 65 74 75 72 6e 20 22 6e 6f 72 6d 61 6c 22 3b  return "normal";
0b60: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a  .    }..    /**.
0b70: 20 20 20 20 20 2a 20 47 65 74 73 20 74 68 65 20       * Gets the 
0b80: 57 41 4c 20 61 75 74 6f 2d 63 68 65 63 6b 70 6f  WAL auto-checkpo
0b90: 69 6e 74 20 69 6e 74 65 67 65 72 20 69 6e 20 64  int integer in d
0ba0: 61 74 61 62 61 73 65 20 70 61 67 65 73 2e 0a 20  atabase pages.. 
0bb0: 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69      */.    publi
0bc0: 63 20 73 74 61 74 69 63 20 69 6e 74 20 67 65 74  c static int get
0bd0: 57 41 4c 41 75 74 6f 43 68 65 63 6b 70 6f 69 6e  WALAutoCheckpoin
0be0: 74 28 29 20 7b 0a 20 20 20 20 20 20 20 20 69 6e  t() {.        in
0bf0: 74 20 76 61 6c 75 65 20 3d 20 31 30 30 30 3b 0a  t value = 1000;.
0c00: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d          return M
0c10: 61 74 68 2e 6d 61 78 28 31 2c 20 76 61 6c 75 65  ath.max(1, value
0c20: 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a  );.    }..    /*
0c30: 2a 0a 20 20 20 20 20 2a 20 47 65 74 73 20 74 68  *.     * Gets th
0c40: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 6f  e connection poo
0c50: 6c 20 73 69 7a 65 20 77 68 65 6e 20 69 6e 20 57  l size when in W
0c60: 41 4c 20 6d 6f 64 65 2e 0a 20 20 20 20 20 2a 2f  AL mode..     */
0c70: 0a 20 20 20 20 70 75 62 6c 69 63 20 73 74 61 74  .    public stat
0c80: 69 63 20 69 6e 74 20 67 65 74 57 41 4c 43 6f 6e  ic int getWALCon
0c90: 6e 65 63 74 69 6f 6e 50 6f 6f 6c 53 69 7a 65 28  nectionPoolSize(
0ca0: 29 20 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20  ) {.        int 
0cb0: 76 61 6c 75 65 20 3d 20 31 30 3b 0a 20 20 20 20  value = 10;.    
0cc0: 20 20 20 20 72 65 74 75 72 6e 20 4d 61 74 68 2e      return Math.
0cd0: 6d 61 78 28 32 2c 20 76 61 6c 75 65 29 3b 0a 20  max(2, value);. 
0ce0: 20 20 20 7d 0a 7d 0a                                }.}.