SQLite Android Bindings
Hex Artifact Content
Not logged in

Artifact 9132482a4a08de6ffefb4a707083de22bf4ddbf6:


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 30 37 20 54 68 65 20 41 6e 64  (C) 2007 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 6a 61 76  ite;..import jav
0300: 61 2e 69 6f 2e 43 6c 6f 73 65 61 62 6c 65 3b 0a  a.io.Closeable;.
0310: 0a 2f 2a 2a 0a 20 2a 20 41 6e 20 6f 62 6a 65 63  ./**. * An objec
0320: 74 20 63 72 65 61 74 65 64 20 66 72 6f 6d 20 61  t created from a
0330: 20 53 51 4c 69 74 65 44 61 74 61 62 61 73 65 20   SQLiteDatabase 
0340: 74 68 61 74 20 63 61 6e 20 62 65 20 63 6c 6f 73  that can be clos
0350: 65 64 2e 0a 20 2a 0a 20 2a 20 54 68 69 73 20 63  ed.. *. * This c
0360: 6c 61 73 73 20 69 6d 70 6c 65 6d 65 6e 74 73 20  lass implements 
0370: 61 20 70 72 69 6d 69 74 69 76 65 20 72 65 66 65  a primitive refe
0380: 72 65 6e 63 65 20 63 6f 75 6e 74 69 6e 67 20 73  rence counting s
0390: 63 68 65 6d 65 20 66 6f 72 20 64 61 74 61 62 61  cheme for databa
03a0: 73 65 20 6f 62 6a 65 63 74 73 2e 0a 20 2a 2f 0a  se objects.. */.
03b0: 70 75 62 6c 69 63 20 61 62 73 74 72 61 63 74 20  public abstract 
03c0: 63 6c 61 73 73 20 53 51 4c 69 74 65 43 6c 6f 73  class SQLiteClos
03d0: 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20  able implements 
03e0: 43 6c 6f 73 65 61 62 6c 65 20 7b 0a 20 20 20 20  Closeable {.    
03f0: 70 72 69 76 61 74 65 20 69 6e 74 20 6d 52 65 66  private int mRef
0400: 65 72 65 6e 63 65 43 6f 75 6e 74 20 3d 20 31 3b  erenceCount = 1;
0410: 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a  ..    /**.     *
0420: 20 43 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65   Called when the
0430: 20 6c 61 73 74 20 72 65 66 65 72 65 6e 63 65 20   last reference 
0440: 74 6f 20 74 68 65 20 6f 62 6a 65 63 74 20 77 61  to the object wa
0450: 73 20 72 65 6c 65 61 73 65 64 20 62 79 0a 20 20  s released by.  
0460: 20 20 20 2a 20 61 20 63 61 6c 6c 20 74 6f 20 7b     * a call to {
0470: 40 6c 69 6e 6b 20 23 72 65 6c 65 61 73 65 52 65  @link #releaseRe
0480: 66 65 72 65 6e 63 65 28 29 7d 20 6f 72 20 7b 40  ference()} or {@
0490: 6c 69 6e 6b 20 23 63 6c 6f 73 65 28 29 7d 2e 0a  link #close()}..
04a0: 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 72 6f 74       */.    prot
04b0: 65 63 74 65 64 20 61 62 73 74 72 61 63 74 20 76  ected abstract v
04c0: 6f 69 64 20 6f 6e 41 6c 6c 52 65 66 65 72 65 6e  oid onAllReferen
04d0: 63 65 73 52 65 6c 65 61 73 65 64 28 29 3b 0a 0a  cesReleased();..
04e0: 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 43      /**.     * C
04f0: 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 20 6c  alled when the l
0500: 61 73 74 20 72 65 66 65 72 65 6e 63 65 20 74 6f  ast reference to
0510: 20 74 68 65 20 6f 62 6a 65 63 74 20 77 61 73 20   the object was 
0520: 72 65 6c 65 61 73 65 64 20 62 79 0a 20 20 20 20  released by.    
0530: 20 2a 20 61 20 63 61 6c 6c 20 74 6f 20 7b 40 6c   * a call to {@l
0540: 69 6e 6b 20 23 72 65 6c 65 61 73 65 52 65 66 65  ink #releaseRefe
0550: 72 65 6e 63 65 46 72 6f 6d 43 6f 6e 74 61 69 6e  renceFromContain
0560: 65 72 28 29 7d 2e 0a 20 20 20 20 20 2a 0a 20 20  er()}..     *.  
0570: 20 20 20 2a 20 40 64 65 70 72 65 63 61 74 65 64     * @deprecated
0580: 20 44 6f 20 6e 6f 74 20 75 73 65 2e 0a 20 20 20   Do not use..   
0590: 20 20 2a 2f 0a 20 20 20 20 40 44 65 70 72 65 63    */.    @Deprec
05a0: 61 74 65 64 0a 20 20 20 20 70 72 6f 74 65 63 74  ated.    protect
05b0: 65 64 20 76 6f 69 64 20 6f 6e 41 6c 6c 52 65 66  ed void onAllRef
05c0: 65 72 65 6e 63 65 73 52 65 6c 65 61 73 65 64 46  erencesReleasedF
05d0: 72 6f 6d 43 6f 6e 74 61 69 6e 65 72 28 29 20 7b  romContainer() {
05e0: 0a 20 20 20 20 20 20 20 20 6f 6e 41 6c 6c 52 65  .        onAllRe
05f0: 66 65 72 65 6e 63 65 73 52 65 6c 65 61 73 65 64  ferencesReleased
0600: 28 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f  ();.    }..    /
0610: 2a 2a 0a 20 20 20 20 20 2a 20 41 63 71 75 69 72  **.     * Acquir
0620: 65 73 20 61 20 72 65 66 65 72 65 6e 63 65 20 74  es a reference t
0630: 6f 20 74 68 65 20 6f 62 6a 65 63 74 2e 0a 20 20  o the object..  
0640: 20 20 20 2a 0a 20 20 20 20 20 2a 20 40 74 68 72     *.     * @thr
0650: 6f 77 73 20 49 6c 6c 65 67 61 6c 53 74 61 74 65  ows IllegalState
0660: 45 78 63 65 70 74 69 6f 6e 20 69 66 20 74 68 65  Exception if the
0670: 20 6c 61 73 74 20 72 65 66 65 72 65 6e 63 65 20   last reference 
0680: 74 6f 20 74 68 65 20 6f 62 6a 65 63 74 20 68 61  to the object ha
0690: 73 20 61 6c 72 65 61 64 79 0a 20 20 20 20 20 2a  s already.     *
06a0: 20 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2e 0a   been released..
06b0: 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62 6c       */.    publ
06c0: 69 63 20 76 6f 69 64 20 61 63 71 75 69 72 65 52  ic void acquireR
06d0: 65 66 65 72 65 6e 63 65 28 29 20 7b 0a 20 20 20  eference() {.   
06e0: 20 20 20 20 20 73 79 6e 63 68 72 6f 6e 69 7a 65       synchronize
06f0: 64 28 74 68 69 73 29 20 7b 0a 20 20 20 20 20 20  d(this) {.      
0700: 20 20 20 20 20 20 69 66 20 28 6d 52 65 66 65 72        if (mRefer
0710: 65 6e 63 65 43 6f 75 6e 74 20 3c 3d 20 30 29 20  enceCount <= 0) 
0720: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  {.              
0730: 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6c 6c 65    throw new Ille
0740: 67 61 6c 53 74 61 74 65 45 78 63 65 70 74 69 6f  galStateExceptio
0750: 6e 28 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  n(.             
0760: 20 20 20 20 20 20 20 20 20 20 20 22 61 74 74 65             "atte
0770: 6d 70 74 20 74 6f 20 72 65 2d 6f 70 65 6e 20 61  mpt to re-open a
0780: 6e 20 61 6c 72 65 61 64 79 2d 63 6c 6f 73 65 64  n already-closed
0790: 20 6f 62 6a 65 63 74 3a 20 22 20 2b 20 74 68 69   object: " + thi
07a0: 73 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  s);.            
07b0: 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 52  }.            mR
07c0: 65 66 65 72 65 6e 63 65 43 6f 75 6e 74 2b 2b 3b  eferenceCount++;
07d0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  .        }.    }
07e0: 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a  ..    /**.     *
07f0: 20 52 65 6c 65 61 73 65 73 20 61 20 72 65 66 65   Releases a refe
0800: 72 65 6e 63 65 20 74 6f 20 74 68 65 20 6f 62 6a  rence to the obj
0810: 65 63 74 2c 20 63 6c 6f 73 69 6e 67 20 74 68 65  ect, closing the
0820: 20 6f 62 6a 65 63 74 20 69 66 20 74 68 65 20 6c   object if the l
0830: 61 73 74 20 72 65 66 65 72 65 6e 63 65 0a 20 20  ast reference.  
0840: 20 20 20 2a 20 77 61 73 20 72 65 6c 65 61 73 65     * was release
0850: 64 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a  d..     *.     *
0860: 20 40 73 65 65 20 23 6f 6e 41 6c 6c 52 65 66 65   @see #onAllRefe
0870: 72 65 6e 63 65 73 52 65 6c 65 61 73 65 64 28 29  rencesReleased()
0880: 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62  .     */.    pub
0890: 6c 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65  lic void release
08a0: 52 65 66 65 72 65 6e 63 65 28 29 20 7b 0a 20 20  Reference() {.  
08b0: 20 20 20 20 20 20 62 6f 6f 6c 65 61 6e 20 72 65        boolean re
08c0: 66 43 6f 75 6e 74 49 73 5a 65 72 6f 20 3d 20 66  fCountIsZero = f
08d0: 61 6c 73 65 3b 0a 20 20 20 20 20 20 20 20 73 79  alse;.        sy
08e0: 6e 63 68 72 6f 6e 69 7a 65 64 28 74 68 69 73 29  nchronized(this)
08f0: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72   {.            r
0900: 65 66 43 6f 75 6e 74 49 73 5a 65 72 6f 20 3d 20  efCountIsZero = 
0910: 2d 2d 6d 52 65 66 65 72 65 6e 63 65 43 6f 75 6e  --mReferenceCoun
0920: 74 20 3d 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  t == 0;.        
0930: 7d 0a 20 20 20 20 20 20 20 20 69 66 20 28 72 65  }.        if (re
0940: 66 43 6f 75 6e 74 49 73 5a 65 72 6f 29 20 7b 0a  fCountIsZero) {.
0950: 20 20 20 20 20 20 20 20 20 20 20 20 6f 6e 41 6c              onAl
0960: 6c 52 65 66 65 72 65 6e 63 65 73 52 65 6c 65 61  lReferencesRelea
0970: 73 65 64 28 29 3b 0a 20 20 20 20 20 20 20 20 7d  sed();.        }
0980: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a  .    }..    /**.
0990: 20 20 20 20 20 2a 20 52 65 6c 65 61 73 65 73 20       * Releases 
09a0: 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74  a reference to t
09b0: 68 65 20 6f 62 6a 65 63 74 20 74 68 61 74 20 77  he object that w
09c0: 61 73 20 6f 77 6e 65 64 20 62 79 20 74 68 65 20  as owned by the 
09d0: 63 6f 6e 74 61 69 6e 65 72 20 6f 66 20 74 68 65  container of the
09e0: 20 6f 62 6a 65 63 74 2c 0a 20 20 20 20 20 2a 20   object,.     * 
09f0: 63 6c 6f 73 69 6e 67 20 74 68 65 20 6f 62 6a 65  closing the obje
0a00: 63 74 20 69 66 20 74 68 65 20 6c 61 73 74 20 72  ct if the last r
0a10: 65 66 65 72 65 6e 63 65 20 77 61 73 20 72 65 6c  eference was rel
0a20: 65 61 73 65 64 2e 0a 20 20 20 20 20 2a 0a 20 20  eased..     *.  
0a30: 20 20 20 2a 20 40 73 65 65 20 23 6f 6e 41 6c 6c     * @see #onAll
0a40: 52 65 66 65 72 65 6e 63 65 73 52 65 6c 65 61 73  ReferencesReleas
0a50: 65 64 46 72 6f 6d 43 6f 6e 74 61 69 6e 65 72 28  edFromContainer(
0a60: 29 0a 20 20 20 20 20 2a 20 40 64 65 70 72 65 63  ).     * @deprec
0a70: 61 74 65 64 20 44 6f 20 6e 6f 74 20 75 73 65 2e  ated Do not use.
0a80: 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 40 44 65  .     */.    @De
0a90: 70 72 65 63 61 74 65 64 0a 20 20 20 20 70 75 62  precated.    pub
0aa0: 6c 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65  lic void release
0ab0: 52 65 66 65 72 65 6e 63 65 46 72 6f 6d 43 6f 6e  ReferenceFromCon
0ac0: 74 61 69 6e 65 72 28 29 20 7b 0a 20 20 20 20 20  tainer() {.     
0ad0: 20 20 20 62 6f 6f 6c 65 61 6e 20 72 65 66 43 6f     boolean refCo
0ae0: 75 6e 74 49 73 5a 65 72 6f 20 3d 20 66 61 6c 73  untIsZero = fals
0af0: 65 3b 0a 20 20 20 20 20 20 20 20 73 79 6e 63 68  e;.        synch
0b00: 72 6f 6e 69 7a 65 64 28 74 68 69 73 29 20 7b 0a  ronized(this) {.
0b10: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 66 43              refC
0b20: 6f 75 6e 74 49 73 5a 65 72 6f 20 3d 20 2d 2d 6d  ountIsZero = --m
0b30: 52 65 66 65 72 65 6e 63 65 43 6f 75 6e 74 20 3d  ReferenceCount =
0b40: 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  = 0;.        }. 
0b50: 20 20 20 20 20 20 20 69 66 20 28 72 65 66 43 6f         if (refCo
0b60: 75 6e 74 49 73 5a 65 72 6f 29 20 7b 0a 20 20 20  untIsZero) {.   
0b70: 20 20 20 20 20 20 20 20 20 6f 6e 41 6c 6c 52 65           onAllRe
0b80: 66 65 72 65 6e 63 65 73 52 65 6c 65 61 73 65 64  ferencesReleased
0b90: 46 72 6f 6d 43 6f 6e 74 61 69 6e 65 72 28 29 3b  FromContainer();
0ba0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  .        }.    }
0bb0: 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a  ..    /**.     *
0bc0: 20 52 65 6c 65 61 73 65 73 20 61 20 72 65 66 65   Releases a refe
0bd0: 72 65 6e 63 65 20 74 6f 20 74 68 65 20 6f 62 6a  rence to the obj
0be0: 65 63 74 2c 20 63 6c 6f 73 69 6e 67 20 74 68 65  ect, closing the
0bf0: 20 6f 62 6a 65 63 74 20 69 66 20 74 68 65 20 6c   object if the l
0c00: 61 73 74 20 72 65 66 65 72 65 6e 63 65 0a 20 20  ast reference.  
0c10: 20 20 20 2a 20 77 61 73 20 72 65 6c 65 61 73 65     * was release
0c20: 64 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a  d..     *.     *
0c30: 20 43 61 6c 6c 69 6e 67 20 74 68 69 73 20 6d 65   Calling this me
0c40: 74 68 6f 64 20 69 73 20 65 71 75 69 76 61 6c 65  thod is equivale
0c50: 6e 74 20 74 6f 20 63 61 6c 6c 69 6e 67 20 7b 40  nt to calling {@
0c60: 6c 69 6e 6b 20 23 72 65 6c 65 61 73 65 52 65 66  link #releaseRef
0c70: 65 72 65 6e 63 65 7d 2e 0a 20 20 20 20 20 2a 0a  erence}..     *.
0c80: 20 20 20 20 20 2a 20 40 73 65 65 20 23 72 65 6c       * @see #rel
0c90: 65 61 73 65 52 65 66 65 72 65 6e 63 65 28 29 0a  easeReference().
0ca0: 20 20 20 20 20 2a 20 40 73 65 65 20 23 6f 6e 41       * @see #onA
0cb0: 6c 6c 52 65 66 65 72 65 6e 63 65 73 52 65 6c 65  llReferencesRele
0cc0: 61 73 65 64 28 29 0a 20 20 20 20 20 2a 2f 0a 20  ased().     */. 
0cd0: 20 20 20 70 75 62 6c 69 63 20 76 6f 69 64 20 63     public void c
0ce0: 6c 6f 73 65 28 29 20 7b 0a 20 20 20 20 20 20 20  lose() {.       
0cf0: 20 72 65 6c 65 61 73 65 52 65 66 65 72 65 6e 63   releaseReferenc
0d00: 65 28 29 3b 0a 20 20 20 20 7d 0a 7d 0a           e();.    }.}.