SQLite Android Bindings
Hex Artifact Content
Not logged in

Artifact 9d87514bc55365e9a63a1f90b814ac921671b0a2:


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 64 61 74 61 62 61 73 65 2e 43 75  roid.database.Cu
0310: 72 73 6f 72 57 69 6e 64 6f 77 3b 0a 69 6d 70 6f  rsorWindow;.impo
0320: 72 74 20 61 6e 64 72 6f 69 64 2e 64 61 74 61 62  rt android.datab
0330: 61 73 65 2e 44 61 74 61 62 61 73 65 55 74 69 6c  ase.DatabaseUtil
0340: 73 3b 0a 69 6d 70 6f 72 74 20 61 6e 64 72 6f 69  s;.import androi
0350: 64 2e 6f 73 2e 43 61 6e 63 65 6c 6c 61 74 69 6f  d.os.Cancellatio
0360: 6e 53 69 67 6e 61 6c 3b 0a 69 6d 70 6f 72 74 20  nSignal;.import 
0370: 61 6e 64 72 6f 69 64 2e 6f 73 2e 4f 70 65 72 61  android.os.Opera
0380: 74 69 6f 6e 43 61 6e 63 65 6c 65 64 45 78 63 65  tionCanceledExce
0390: 70 74 69 6f 6e 3b 0a 69 6d 70 6f 72 74 20 61 6e  ption;.import an
03a0: 64 72 6f 69 64 2e 6f 73 2e 50 61 72 63 65 6c 46  droid.os.ParcelF
03b0: 69 6c 65 44 65 73 63 72 69 70 74 6f 72 3b 0a 0a  ileDescriptor;..
03c0: 2f 2a 2a 0a 20 2a 20 50 72 6f 76 69 64 65 73 20  /**. * Provides 
03d0: 61 20 73 69 6e 67 6c 65 20 63 6c 69 65 6e 74 20  a single client 
03e0: 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 75  the ability to u
03f0: 73 65 20 61 20 64 61 74 61 62 61 73 65 2e 0a 20  se a database.. 
0400: 2a 0a 20 2a 20 3c 68 32 3e 41 62 6f 75 74 20 64  *. * <h2>About d
0410: 61 74 61 62 61 73 65 20 73 65 73 73 69 6f 6e 73  atabase sessions
0420: 3c 2f 68 32 3e 0a 20 2a 20 3c 70 3e 0a 20 2a 20  </h2>. * <p>. * 
0430: 44 61 74 61 62 61 73 65 20 61 63 63 65 73 73 20  Database access 
0440: 69 73 20 61 6c 77 61 79 73 20 70 65 72 66 6f 72  is always perfor
0450: 6d 65 64 20 75 73 69 6e 67 20 61 20 73 65 73 73  med using a sess
0460: 69 6f 6e 2e 20 20 54 68 65 20 73 65 73 73 69 6f  ion.  The sessio
0470: 6e 0a 20 2a 20 6d 61 6e 61 67 65 73 20 74 68 65  n. * manages the
0480: 20 6c 69 66 65 63 79 63 6c 65 20 6f 66 20 74 72   lifecycle of tr
0490: 61 6e 73 61 63 74 69 6f 6e 73 20 61 6e 64 20 64  ansactions and d
04a0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
04b0: 6f 6e 73 2e 0a 20 2a 20 3c 2f 70 3e 3c 70 3e 0a  ons.. * </p><p>.
04c0: 20 2a 20 53 65 73 73 69 6f 6e 73 20 63 61 6e 20   * Sessions can 
04d0: 62 65 20 75 73 65 64 20 74 6f 20 70 65 72 66 6f  be used to perfo
04e0: 72 6d 20 62 6f 74 68 20 72 65 61 64 2d 6f 6e 6c  rm both read-onl
04f0: 79 20 61 6e 64 20 72 65 61 64 2d 77 72 69 74 65  y and read-write
0500: 20 6f 70 65 72 61 74 69 6f 6e 73 2e 0a 20 2a 20   operations.. * 
0510: 54 68 65 72 65 20 69 73 20 73 6f 6d 65 20 61 64  There is some ad
0520: 76 61 6e 74 61 67 65 20 74 6f 20 6b 6e 6f 77 69  vantage to knowi
0530: 6e 67 20 77 68 65 6e 20 61 20 73 65 73 73 69 6f  ng when a sessio
0540: 6e 20 69 73 20 62 65 69 6e 67 20 75 73 65 64 20  n is being used 
0550: 66 6f 72 0a 20 2a 20 72 65 61 64 2d 6f 6e 6c 79  for. * read-only
0560: 20 70 75 72 70 6f 73 65 73 20 62 65 63 61 75 73   purposes becaus
0570: 65 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  e the connection
0580: 20 70 6f 6f 6c 20 63 61 6e 20 6f 70 74 69 6d 69   pool can optimi
0590: 7a 65 20 74 68 65 20 75 73 65 0a 20 2a 20 6f 66  ze the use. * of
05a0: 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 63   the available c
05b0: 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 6f 20 70 65  onnections to pe
05c0: 72 6d 69 74 20 6d 75 6c 74 69 70 6c 65 20 72 65  rmit multiple re
05d0: 61 64 2d 6f 6e 6c 79 20 6f 70 65 72 61 74 69 6f  ad-only operatio
05e0: 6e 73 0a 20 2a 20 74 6f 20 65 78 65 63 75 74 65  ns. * to execute
05f0: 20 69 6e 20 70 61 72 61 6c 6c 65 6c 20 77 68 65   in parallel whe
0600: 72 65 61 73 20 72 65 61 64 2d 77 72 69 74 65 20  reas read-write 
0610: 6f 70 65 72 61 74 69 6f 6e 73 20 6d 61 79 20 6e  operations may n
0620: 65 65 64 20 74 6f 20 62 65 20 73 65 72 69 61 6c  eed to be serial
0630: 69 7a 65 64 2e 0a 20 2a 20 3c 2f 70 3e 3c 70 3e  ized.. * </p><p>
0640: 0a 20 2a 20 57 68 65 6e 20 3c 65 6d 3e 57 72 69  . * When <em>Wri
0650: 74 65 20 41 68 65 61 64 20 4c 6f 67 67 69 6e 67  te Ahead Logging
0660: 20 28 57 41 4c 29 3c 2f 65 6d 3e 20 69 73 20 65   (WAL)</em> is e
0670: 6e 61 62 6c 65 64 2c 20 74 68 65 20 64 61 74 61  nabled, the data
0680: 62 61 73 65 20 63 61 6e 0a 20 2a 20 65 78 65 63  base can. * exec
0690: 75 74 65 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73  ute simultaneous
06a0: 20 72 65 61 64 2d 6f 6e 6c 79 20 61 6e 64 20 72   read-only and r
06b0: 65 61 64 2d 77 72 69 74 65 20 74 72 61 6e 73 61  ead-write transa
06c0: 63 74 69 6f 6e 73 2c 20 70 72 6f 76 69 64 65 64  ctions, provided
06d0: 20 74 68 61 74 0a 20 2a 20 61 74 20 6d 6f 73 74   that. * at most
06e0: 20 6f 6e 65 20 72 65 61 64 2d 77 72 69 74 65 20   one read-write 
06f0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 70  transaction is p
0700: 65 72 66 6f 72 6d 65 64 20 61 74 20 61 20 74 69  erformed at a ti
0710: 6d 65 2e 20 20 57 68 65 6e 20 57 41 4c 20 69 73  me.  When WAL is
0720: 20 6e 6f 74 0a 20 2a 20 65 6e 61 62 6c 65 64 2c   not. * enabled,
0730: 20 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e 73   read-only trans
0740: 61 63 74 69 6f 6e 73 20 63 61 6e 20 65 78 65 63  actions can exec
0750: 75 74 65 20 69 6e 20 70 61 72 61 6c 6c 65 6c 20  ute in parallel 
0760: 62 75 74 20 72 65 61 64 2d 77 72 69 74 65 0a 20  but read-write. 
0770: 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61  * transactions a
0780: 72 65 20 6d 75 74 75 61 6c 6c 79 20 65 78 63 6c  re mutually excl
0790: 75 73 69 76 65 2e 0a 20 2a 20 3c 2f 70 3e 0a 20  usive.. * </p>. 
07a0: 2a 0a 20 2a 20 3c 68 32 3e 4f 77 6e 65 72 73 68  *. * <h2>Ownersh
07b0: 69 70 20 61 6e 64 20 63 6f 6e 63 75 72 72 65 6e  ip and concurren
07c0: 63 79 20 67 75 61 72 61 6e 74 65 65 73 3c 2f 68  cy guarantees</h
07d0: 32 3e 0a 20 2a 20 3c 70 3e 0a 20 2a 20 53 65 73  2>. * <p>. * Ses
07e0: 73 69 6f 6e 20 6f 62 6a 65 63 74 73 20 61 72 65  sion objects are
07f0: 20 6e 6f 74 20 74 68 72 65 61 64 2d 73 61 66 65   not thread-safe
0800: 2e 20 20 49 6e 20 66 61 63 74 2c 20 73 65 73 73  .  In fact, sess
0810: 69 6f 6e 20 6f 62 6a 65 63 74 73 20 61 72 65 20  ion objects are 
0820: 74 68 72 65 61 64 2d 62 6f 75 6e 64 2e 0a 20 2a  thread-bound.. *
0830: 20 54 68 65 20 7b 40 6c 69 6e 6b 20 53 51 4c 69   The {@link SQLi
0840: 74 65 44 61 74 61 62 61 73 65 7d 20 75 73 65 73  teDatabase} uses
0850: 20 61 20 74 68 72 65 61 64 2d 6c 6f 63 61 6c 20   a thread-local 
0860: 76 61 72 69 61 62 6c 65 20 74 6f 20 61 73 73 6f  variable to asso
0870: 63 69 61 74 65 20 61 20 73 65 73 73 69 6f 6e 0a  ciate a session.
0880: 20 2a 20 77 69 74 68 20 65 61 63 68 20 74 68 72   * with each thr
0890: 65 61 64 20 66 6f 72 20 74 68 65 20 75 73 65 20  ead for the use 
08a0: 6f 66 20 74 68 61 74 20 74 68 72 65 61 64 20 61  of that thread a
08b0: 6c 6f 6e 65 2e 20 20 43 6f 6e 73 65 71 75 65 6e  lone.  Consequen
08c0: 74 6c 79 2c 20 65 61 63 68 20 74 68 72 65 61 64  tly, each thread
08d0: 0a 20 2a 20 68 61 73 20 69 74 73 20 6f 77 6e 20  . * has its own 
08e0: 73 65 73 73 69 6f 6e 20 6f 62 6a 65 63 74 20 61  session object a
08f0: 6e 64 20 74 68 65 72 65 66 6f 72 65 20 69 74 73  nd therefore its
0900: 20 6f 77 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e   own transaction
0910: 20 73 74 61 74 65 20 69 6e 64 65 70 65 6e 64 65   state independe
0920: 6e 74 0a 20 2a 20 6f 66 20 6f 74 68 65 72 20 74  nt. * of other t
0930: 68 72 65 61 64 73 2e 0a 20 2a 20 3c 2f 70 3e 3c  hreads.. * </p><
0940: 70 3e 0a 20 2a 20 41 20 74 68 72 65 61 64 20 68  p>. * A thread h
0950: 61 73 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 73  as at most one s
0960: 65 73 73 69 6f 6e 20 70 65 72 20 64 61 74 61 62  ession per datab
0970: 61 73 65 2e 20 20 54 68 69 73 20 63 6f 6e 73 74  ase.  This const
0980: 72 61 69 6e 74 20 65 6e 73 75 72 65 73 20 74 68  raint ensures th
0990: 61 74 0a 20 2a 20 61 20 74 68 72 65 61 64 20 63  at. * a thread c
09a0: 61 6e 20 6e 65 76 65 72 20 75 73 65 20 6d 6f 72  an never use mor
09b0: 65 20 74 68 61 6e 20 6f 6e 65 20 64 61 74 61 62  e than one datab
09c0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61  ase connection a
09d0: 74 20 61 20 74 69 6d 65 20 66 6f 72 20 61 0a 20  t a time for a. 
09e0: 2a 20 67 69 76 65 6e 20 64 61 74 61 62 61 73 65  * given database
09f0: 2e 20 20 41 73 20 74 68 65 20 6e 75 6d 62 65 72  .  As the number
0a00: 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 64 61   of available da
0a10: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
0a20: 6e 73 20 69 73 20 6c 69 6d 69 74 65 64 2c 0a 20  ns is limited,. 
0a30: 2a 20 69 66 20 61 20 73 69 6e 67 6c 65 20 74 68  * if a single th
0a40: 72 65 61 64 20 74 72 69 65 64 20 74 6f 20 61 63  read tried to ac
0a50: 71 75 69 72 65 20 6d 75 6c 74 69 70 6c 65 20 63  quire multiple c
0a60: 6f 6e 6e 65 63 74 69 6f 6e 73 20 66 6f 72 20 74  onnections for t
0a70: 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65  he same database
0a80: 0a 20 2a 20 61 74 20 74 68 65 20 73 61 6d 65 20  . * at the same 
0a90: 74 69 6d 65 2c 20 69 74 20 6d 69 67 68 74 20 64  time, it might d
0aa0: 65 61 64 6c 6f 63 6b 2e 20 20 54 68 65 72 65 66  eadlock.  Theref
0ab0: 6f 72 65 20 77 65 20 61 6c 6c 6f 77 20 74 68 65  ore we allow the
0ac0: 72 65 20 74 6f 20 62 65 20 6f 6e 6c 79 0a 20 2a  re to be only. *
0ad0: 20 6f 6e 65 20 73 65 73 73 69 6f 6e 20 28 73 6f   one session (so
0ae0: 2c 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 63 6f  , at most one co
0af0: 6e 6e 65 63 74 69 6f 6e 29 20 70 65 72 20 74 68  nnection) per th
0b00: 72 65 61 64 20 70 65 72 20 64 61 74 61 62 61 73  read per databas
0b10: 65 2e 0a 20 2a 20 3c 2f 70 3e 0a 20 2a 0a 20 2a  e.. * </p>. *. *
0b20: 20 3c 68 32 3e 54 72 61 6e 73 61 63 74 69 6f 6e   <h2>Transaction
0b30: 73 3c 2f 68 32 3e 0a 20 2a 20 3c 70 3e 0a 20 2a  s</h2>. * <p>. *
0b40: 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 6b   There are two k
0b50: 69 6e 64 73 20 6f 66 20 74 72 61 6e 73 61 63 74  inds of transact
0b60: 69 6f 6e 3a 20 69 6d 70 6c 69 63 69 74 20 74 72  ion: implicit tr
0b70: 61 6e 73 61 63 74 69 6f 6e 73 20 61 6e 64 20 65  ansactions and e
0b80: 78 70 6c 69 63 69 74 0a 20 2a 20 74 72 61 6e 73  xplicit. * trans
0b90: 61 63 74 69 6f 6e 73 2e 0a 20 2a 20 3c 2f 70 3e  actions.. * </p>
0ba0: 3c 70 3e 0a 20 2a 20 41 6e 20 69 6d 70 6c 69 63  <p>. * An implic
0bb0: 69 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69  it transaction i
0bc0: 73 20 63 72 65 61 74 65 64 20 77 68 65 6e 65 76  s created whenev
0bd0: 65 72 20 61 20 64 61 74 61 62 61 73 65 20 6f 70  er a database op
0be0: 65 72 61 74 69 6f 6e 20 69 73 20 72 65 71 75 65  eration is reque
0bf0: 73 74 65 64 0a 20 2a 20 61 6e 64 20 74 68 65 72  sted. * and ther
0c00: 65 20 69 73 20 6e 6f 20 65 78 70 6c 69 63 69 74  e is no explicit
0c10: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 75 72   transaction cur
0c20: 72 65 6e 74 6c 79 20 69 6e 20 70 72 6f 67 72 65  rently in progre
0c30: 73 73 2e 20 20 41 6e 20 69 6d 70 6c 69 63 69 74  ss.  An implicit
0c40: 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 2a 20   transaction. * 
0c50: 6f 6e 6c 79 20 6c 61 73 74 73 20 66 6f 72 20 74  only lasts for t
0c60: 68 65 20 64 75 72 61 74 69 6f 6e 20 6f 66 20 74  he duration of t
0c70: 68 65 20 64 61 74 61 62 61 73 65 20 6f 70 65 72  he database oper
0c80: 61 74 69 6f 6e 20 69 6e 20 71 75 65 73 74 69 6f  ation in questio
0c90: 6e 20 61 6e 64 20 74 68 65 6e 20 69 74 0a 20 2a  n and then it. *
0ca0: 20 69 73 20 65 6e 64 65 64 2e 20 20 49 66 20 74   is ended.  If t
0cb0: 68 65 20 64 61 74 61 62 61 73 65 20 6f 70 65 72  he database oper
0cc0: 61 74 69 6f 6e 20 77 61 73 20 73 75 63 63 65 73  ation was succes
0cd0: 73 66 75 6c 2c 20 74 68 65 6e 20 69 74 73 20 63  sful, then its c
0ce0: 68 61 6e 67 65 73 20 61 72 65 20 63 6f 6d 6d 69  hanges are commi
0cf0: 74 74 65 64 2e 0a 20 2a 20 3c 2f 70 3e 3c 70 3e  tted.. * </p><p>
0d00: 0a 20 2a 20 41 6e 20 65 78 70 6c 69 63 69 74 20  . * An explicit 
0d10: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 73  transaction is s
0d20: 74 61 72 74 65 64 20 62 79 20 63 61 6c 6c 69 6e  tarted by callin
0d30: 67 20 7b 40 6c 69 6e 6b 20 23 62 65 67 69 6e 54  g {@link #beginT
0d40: 72 61 6e 73 61 63 74 69 6f 6e 7d 20 61 6e 64 0a  ransaction} and.
0d50: 20 2a 20 73 70 65 63 69 66 79 69 6e 67 20 74 68   * specifying th
0d60: 65 20 64 65 73 69 72 65 64 20 74 72 61 6e 73 61  e desired transa
0d70: 63 74 69 6f 6e 20 6d 6f 64 65 2e 20 20 4f 6e 63  ction mode.  Onc
0d80: 65 20 61 6e 20 65 78 70 6c 69 63 69 74 20 74 72  e an explicit tr
0d90: 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 62 65  ansaction has be
0da0: 67 75 6e 2c 0a 20 2a 20 61 6c 6c 20 73 75 62 73  gun,. * all subs
0db0: 65 71 75 65 6e 74 20 64 61 74 61 62 61 73 65 20  equent database 
0dc0: 6f 70 65 72 61 74 69 6f 6e 73 20 77 69 6c 6c 20  operations will 
0dd0: 62 65 20 70 65 72 66 6f 72 6d 65 64 20 61 73 20  be performed as 
0de0: 70 61 72 74 20 6f 66 20 74 68 61 74 20 74 72 61  part of that tra
0df0: 6e 73 61 63 74 69 6f 6e 2e 0a 20 2a 20 54 6f 20  nsaction.. * To 
0e00: 65 6e 64 20 61 6e 20 65 78 70 6c 69 63 69 74 20  end an explicit 
0e10: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 66 69 72  transaction, fir
0e20: 73 74 20 63 61 6c 6c 20 7b 40 6c 69 6e 6b 20 23  st call {@link #
0e30: 73 65 74 54 72 61 6e 73 61 63 74 69 6f 6e 53 75  setTransactionSu
0e40: 63 63 65 73 73 66 75 6c 7d 20 69 66 20 74 68 65  ccessful} if the
0e50: 0a 20 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  . * transaction 
0e60: 77 61 73 20 73 75 63 63 65 73 73 66 75 6c 2c 20  was successful, 
0e70: 74 68 65 6e 20 63 61 6c 6c 20 7b 40 6c 69 6e 6b  then call {@link
0e80: 20 23 65 6e 64 7d 2e 20 20 49 66 20 74 68 65 20   #end}.  If the 
0e90: 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 0a  transaction was.
0ea0: 20 2a 20 6d 61 72 6b 65 64 20 73 75 63 63 65 73   * marked succes
0eb0: 73 66 75 6c 2c 20 69 74 73 20 63 68 61 6e 67 65  sful, its change
0ec0: 73 20 77 69 6c 6c 20 62 65 20 63 6f 6d 6d 69 74  s will be commit
0ed0: 74 65 64 2c 20 6f 74 68 65 72 77 69 73 65 20 74  ted, otherwise t
0ee0: 68 65 79 20 77 69 6c 6c 20 62 65 20 72 6f 6c 6c  hey will be roll
0ef0: 65 64 20 62 61 63 6b 2e 0a 20 2a 20 3c 2f 70 3e  ed back.. * </p>
0f00: 3c 70 3e 0a 20 2a 20 45 78 70 6c 69 63 69 74 20  <p>. * Explicit 
0f10: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 63 61 6e  transactions can
0f20: 20 61 6c 73 6f 20 62 65 20 6e 65 73 74 65 64 2e   also be nested.
0f30: 20 20 41 20 6e 65 73 74 65 64 20 65 78 70 6c 69    A nested expli
0f40: 63 69 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  cit transaction 
0f50: 69 73 0a 20 2a 20 73 74 61 72 74 65 64 20 77 69  is. * started wi
0f60: 74 68 20 7b 40 6c 69 6e 6b 20 23 62 65 67 69 6e  th {@link #begin
0f70: 54 72 61 6e 73 61 63 74 69 6f 6e 7d 2c 20 6d 61  Transaction}, ma
0f80: 72 6b 65 64 20 73 75 63 63 65 73 73 66 75 6c 20  rked successful 
0f90: 77 69 74 68 0a 20 2a 20 7b 40 6c 69 6e 6b 20 23  with. * {@link #
0fa0: 73 65 74 54 72 61 6e 73 61 63 74 69 6f 6e 53 75  setTransactionSu
0fb0: 63 63 65 73 73 66 75 6c 7d 61 6e 64 20 65 6e 64  ccessful}and end
0fc0: 65 64 20 77 69 74 68 20 7b 40 6c 69 6e 6b 20 23  ed with {@link #
0fd0: 65 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 7d 2e  endTransaction}.
0fe0: 0a 20 2a 20 49 66 20 61 6e 79 20 6e 65 73 74 65  . * If any neste
0ff0: 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73  d transaction is
1000: 20 6e 6f 74 20 6d 61 72 6b 65 64 20 73 75 63 63   not marked succ
1010: 65 73 73 66 75 6c 2c 20 74 68 65 6e 20 74 68 65  essful, then the
1020: 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61 63 74   entire transact
1030: 69 6f 6e 0a 20 2a 20 69 6e 63 6c 75 64 69 6e 67  ion. * including
1040: 20 61 6c 6c 20 6f 66 20 69 74 73 20 6e 65 73 74   all of its nest
1050: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20  ed transactions 
1060: 77 69 6c 6c 20 62 65 20 72 6f 6c 6c 65 64 20 62  will be rolled b
1070: 61 63 6b 0a 20 2a 20 77 68 65 6e 20 74 68 65 20  ack. * when the 
1080: 6f 75 74 65 72 6d 6f 73 74 20 74 72 61 6e 73 61  outermost transa
1090: 63 74 69 6f 6e 20 69 73 20 65 6e 64 65 64 2e 0a  ction is ended..
10a0: 20 2a 20 3c 2f 70 3e 3c 70 3e 0a 20 2a 20 54 6f   * </p><p>. * To
10b0: 20 69 6d 70 72 6f 76 65 20 63 6f 6e 63 75 72 72   improve concurr
10c0: 65 6e 63 79 2c 20 61 6e 20 65 78 70 6c 69 63 69  ency, an explici
10d0: 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 61  t transaction ca
10e0: 6e 20 62 65 20 79 69 65 6c 64 65 64 20 62 79 20  n be yielded by 
10f0: 63 61 6c 6c 69 6e 67 0a 20 2a 20 7b 40 6c 69 6e  calling. * {@lin
1100: 6b 20 23 79 69 65 6c 64 54 72 61 6e 73 61 63 74  k #yieldTransact
1110: 69 6f 6e 7d 2e 20 20 49 66 20 74 68 65 72 65 20  ion}.  If there 
1120: 69 73 20 63 6f 6e 74 65 6e 74 69 6f 6e 20 66 6f  is contention fo
1130: 72 20 75 73 65 20 6f 66 20 74 68 65 20 64 61 74  r use of the dat
1140: 61 62 61 73 65 2c 0a 20 2a 20 74 68 65 6e 20 79  abase,. * then y
1150: 69 65 6c 64 69 6e 67 20 65 6e 64 73 20 74 68 65  ielding ends the
1160: 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63   current transac
1170: 74 69 6f 6e 2c 20 63 6f 6d 6d 69 74 73 20 69 74  tion, commits it
1180: 73 20 63 68 61 6e 67 65 73 2c 20 72 65 6c 65 61  s changes, relea
1190: 73 65 73 20 74 68 65 0a 20 2a 20 64 61 74 61 62  ses the. * datab
11a0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 66  ase connection f
11b0: 6f 72 20 75 73 65 20 62 79 20 61 6e 6f 74 68 65  or use by anothe
11c0: 72 20 73 65 73 73 69 6f 6e 20 66 6f 72 20 61 20  r session for a 
11d0: 6c 69 74 74 6c 65 20 77 68 69 6c 65 2c 20 61 6e  little while, an
11e0: 64 20 73 74 61 72 74 73 20 61 0a 20 2a 20 6e 65  d starts a. * ne
11f0: 77 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 69  w transaction wi
1200: 74 68 20 74 68 65 20 73 61 6d 65 20 70 72 6f 70  th the same prop
1210: 65 72 74 69 65 73 20 61 73 20 74 68 65 20 6f 72  erties as the or
1220: 69 67 69 6e 61 6c 20 6f 6e 65 2e 0a 20 2a 20 43  iginal one.. * C
1230: 68 61 6e 67 65 73 20 63 6f 6d 6d 69 74 74 65 64  hanges committed
1240: 20 62 79 20 7b 40 6c 69 6e 6b 20 23 79 69 65 6c   by {@link #yiel
1250: 64 54 72 61 6e 73 61 63 74 69 6f 6e 7d 20 63 61  dTransaction} ca
1260: 6e 6e 6f 74 20 62 65 20 72 6f 6c 6c 65 64 20 62  nnot be rolled b
1270: 61 63 6b 2e 0a 20 2a 20 3c 2f 70 3e 3c 70 3e 0a  ack.. * </p><p>.
1280: 20 2a 20 57 68 65 6e 20 61 20 74 72 61 6e 73 61   * When a transa
1290: 63 74 69 6f 6e 20 69 73 20 73 74 61 72 74 65 64  ction is started
12a0: 2c 20 74 68 65 20 63 6c 69 65 6e 74 20 63 61 6e  , the client can
12b0: 20 70 72 6f 76 69 64 65 20 61 20 7b 40 6c 69 6e   provide a {@lin
12c0: 6b 20 53 51 4c 69 74 65 54 72 61 6e 73 61 63 74  k SQLiteTransact
12d0: 69 6f 6e 4c 69 73 74 65 6e 65 72 7d 0a 20 2a 20  ionListener}. * 
12e0: 74 6f 20 6c 69 73 74 65 6e 20 66 6f 72 20 6e 6f  to listen for no
12f0: 74 69 66 69 63 61 74 69 6f 6e 73 20 6f 66 20 74  tifications of t
1300: 72 61 6e 73 61 63 74 69 6f 6e 2d 72 65 6c 61 74  ransaction-relat
1310: 65 64 20 65 76 65 6e 74 73 2e 0a 20 2a 20 3c 2f  ed events.. * </
1320: 70 3e 3c 70 3e 0a 20 2a 20 52 65 63 6f 6d 6d 65  p><p>. * Recomme
1330: 6e 64 65 64 20 75 73 61 67 65 3a 0a 20 2a 20 3c  nded usage:. * <
1340: 63 6f 64 65 3e 3c 70 72 65 3e 0a 20 2a 20 2f 2f  code><pre>. * //
1350: 20 46 69 72 73 74 2c 20 62 65 67 69 6e 20 74 68   First, begin th
1360: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20  e transaction.. 
1370: 2a 20 73 65 73 73 69 6f 6e 2e 62 65 67 69 6e 54  * session.beginT
1380: 72 61 6e 73 61 63 74 69 6f 6e 28 53 51 4c 69 74  ransaction(SQLit
1390: 65 53 65 73 73 69 6f 6e 2e 54 52 41 4e 53 41 43  eSession.TRANSAC
13a0: 54 49 4f 4e 5f 4d 4f 44 45 5f 44 45 46 45 52 52  TION_MODE_DEFERR
13b0: 45 44 2c 20 30 29 3b 0a 20 2a 20 74 72 79 20 7b  ED, 0);. * try {
13c0: 0a 20 2a 20 20 20 20 20 2f 2f 20 54 68 65 6e 20  . *     // Then 
13d0: 64 6f 20 73 74 75 66 66 2e 2e 2e 0a 20 2a 20 20  do stuff.... *  
13e0: 20 20 20 73 65 73 73 69 6f 6e 2e 65 78 65 63 75     session.execu
13f0: 74 65 28 22 49 4e 53 45 52 54 20 49 4e 54 4f 20  te("INSERT INTO 
1400: 2e 2e 2e 22 2c 20 6e 75 6c 6c 2c 20 30 29 3b 0a  ...", null, 0);.
1410: 20 2a 0a 20 2a 20 20 20 20 20 2f 2f 20 41 73 20   *. *     // As 
1420: 74 68 65 20 76 65 72 79 20 6c 61 73 74 20 73 74  the very last st
1430: 65 70 20 62 65 66 6f 72 65 20 65 6e 64 69 6e 67  ep before ending
1440: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
1450: 2c 20 6d 61 72 6b 20 69 74 20 73 75 63 63 65 73  , mark it succes
1460: 73 66 75 6c 2e 0a 20 2a 20 20 20 20 20 73 65 73  sful.. *     ses
1470: 73 69 6f 6e 2e 73 65 74 54 72 61 6e 73 61 63 74  sion.setTransact
1480: 69 6f 6e 53 75 63 63 65 73 73 66 75 6c 28 29 3b  ionSuccessful();
1490: 0a 20 2a 20 7d 20 66 69 6e 61 6c 6c 79 20 7b 0a  . * } finally {.
14a0: 20 2a 20 20 20 20 20 2f 2f 20 46 69 6e 61 6c 6c   *     // Finall
14b0: 79 2c 20 65 6e 64 20 74 68 65 20 74 72 61 6e 73  y, end the trans
14c0: 61 63 74 69 6f 6e 2e 0a 20 2a 20 20 20 20 20 2f  action.. *     /
14d0: 2f 20 54 68 69 73 20 73 74 61 74 65 6d 65 6e 74  / This statement
14e0: 20 77 69 6c 6c 20 63 6f 6d 6d 69 74 20 74 68 65   will commit the
14f0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 66 20   transaction if 
1500: 69 74 20 77 61 73 20 6d 61 72 6b 65 64 20 73 75  it was marked su
1510: 63 63 65 73 73 66 75 6c 20 6f 72 0a 20 2a 20 20  ccessful or. *  
1520: 20 20 20 2f 2f 20 72 6f 6c 6c 20 69 74 20 62 61     // roll it ba
1530: 63 6b 20 6f 74 68 65 72 77 69 73 65 2e 0a 20 2a  ck otherwise.. *
1540: 20 20 20 20 20 73 65 73 73 69 6f 6e 2e 65 6e 64       session.end
1550: 54 72 61 6e 73 61 63 74 69 6f 6e 28 29 3b 0a 20  Transaction();. 
1560: 2a 20 7d 0a 20 2a 20 3c 2f 70 72 65 3e 3c 2f 63  * }. * </pre></c
1570: 6f 64 65 3e 0a 20 2a 20 3c 2f 70 3e 0a 20 2a 0a  ode>. * </p>. *.
1580: 20 2a 20 3c 68 32 3e 44 61 74 61 62 61 73 65 20   * <h2>Database 
1590: 63 6f 6e 6e 65 63 74 69 6f 6e 73 3c 2f 68 32 3e  connections</h2>
15a0: 0a 20 2a 20 3c 70 3e 0a 20 2a 20 41 20 7b 40 6c  . * <p>. * A {@l
15b0: 69 6e 6b 20 53 51 4c 69 74 65 44 61 74 61 62 61  ink SQLiteDataba
15c0: 73 65 7d 20 63 61 6e 20 68 61 76 65 20 6d 75 6c  se} can have mul
15d0: 74 69 70 6c 65 20 61 63 74 69 76 65 20 73 65 73  tiple active ses
15e0: 73 69 6f 6e 73 20 61 74 20 74 68 65 20 73 61 6d  sions at the sam
15f0: 65 0a 20 2a 20 74 69 6d 65 2e 20 20 45 61 63 68  e. * time.  Each
1600: 20 73 65 73 73 69 6f 6e 20 61 63 71 75 69 72 65   session acquire
1610: 73 20 61 6e 64 20 72 65 6c 65 61 73 65 73 20 63  s and releases c
1620: 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 6f 20 74 68  onnections to th
1630: 65 20 64 61 74 61 62 61 73 65 0a 20 2a 20 61 73  e database. * as
1640: 20 6e 65 65 64 65 64 20 74 6f 20 70 65 72 66 6f   needed to perfo
1650: 72 6d 20 65 61 63 68 20 72 65 71 75 65 73 74 65  rm each requeste
1660: 64 20 64 61 74 61 62 61 73 65 20 74 72 61 6e 73  d database trans
1670: 61 63 74 69 6f 6e 2e 20 20 49 66 20 61 6c 6c 20  action.  If all 
1680: 63 6f 6e 6e 65 63 74 69 6f 6e 73 0a 20 2a 20 61  connections. * a
1690: 72 65 20 69 6e 20 75 73 65 2c 20 74 68 65 6e 20  re in use, then 
16a0: 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63  database transac
16b0: 74 69 6f 6e 73 20 6f 6e 20 73 6f 6d 65 20 73 65  tions on some se
16c0: 73 73 69 6f 6e 73 20 77 69 6c 6c 20 62 6c 6f 63  ssions will bloc
16d0: 6b 20 75 6e 74 69 6c 20 61 0a 20 2a 20 63 6f 6e  k until a. * con
16e0: 6e 65 63 74 69 6f 6e 20 62 65 63 6f 6d 65 73 20  nection becomes 
16f0: 61 76 61 69 6c 61 62 6c 65 2e 0a 20 2a 20 3c 2f  available.. * </
1700: 70 3e 3c 70 3e 0a 20 2a 20 54 68 65 20 73 65 73  p><p>. * The ses
1710: 73 69 6f 6e 20 61 63 71 75 69 72 65 73 20 61 20  sion acquires a 
1720: 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65 20  single database 
1730: 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 6e 6c 79 20  connection only 
1740: 66 6f 72 20 74 68 65 20 64 75 72 61 74 69 6f 6e  for the duration
1750: 0a 20 2a 20 6f 66 20 61 20 73 69 6e 67 6c 65 20  . * of a single 
1760: 28 69 6d 70 6c 69 63 69 74 20 6f 72 20 65 78 70  (implicit or exp
1770: 6c 69 63 69 74 29 20 64 61 74 61 62 61 73 65 20  licit) database 
1780: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65  transaction, the
1790: 6e 20 72 65 6c 65 61 73 65 73 20 69 74 2e 0a 20  n releases it.. 
17a0: 2a 20 54 68 69 73 20 63 68 61 72 61 63 74 65 72  * This character
17b0: 69 73 74 69 63 20 61 6c 6c 6f 77 73 20 61 20 73  istic allows a s
17c0: 6d 61 6c 6c 20 70 6f 6f 6c 20 6f 66 20 64 61 74  mall pool of dat
17d0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
17e0: 73 20 74 6f 20 62 65 20 73 68 61 72 65 64 0a 20  s to be shared. 
17f0: 2a 20 65 66 66 69 63 69 65 6e 74 6c 79 20 62 79  * efficiently by
1800: 20 6d 75 6c 74 69 70 6c 65 20 73 65 73 73 69 6f   multiple sessio
1810: 6e 73 20 61 73 20 6c 6f 6e 67 20 61 73 20 74 68  ns as long as th
1820: 65 79 20 61 72 65 20 6e 6f 74 20 61 6c 6c 20 74  ey are not all t
1830: 72 79 69 6e 67 20 74 6f 20 70 65 72 66 6f 72 6d  rying to perform
1840: 0a 20 2a 20 64 61 74 61 62 61 73 65 20 74 72 61  . * database tra
1850: 6e 73 61 63 74 69 6f 6e 73 20 61 74 20 74 68 65  nsactions at the
1860: 20 73 61 6d 65 20 74 69 6d 65 2e 0a 20 2a 20 3c   same time.. * <
1870: 2f 70 3e 0a 20 2a 0a 20 2a 20 3c 68 32 3e 52 65  /p>. *. * <h2>Re
1880: 73 70 6f 6e 73 69 76 65 6e 65 73 73 3c 2f 68 32  sponsiveness</h2
1890: 3e 0a 20 2a 20 3c 70 3e 0a 20 2a 20 42 65 63 61  >. * <p>. * Beca
18a0: 75 73 65 20 74 68 65 72 65 20 61 72 65 20 61 20  use there are a 
18b0: 6c 69 6d 69 74 65 64 20 6e 75 6d 62 65 72 20 6f  limited number o
18c0: 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  f database conne
18d0: 63 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 20 73  ctions and the s
18e0: 65 73 73 69 6f 6e 20 68 6f 6c 64 73 0a 20 2a 20  ession holds. * 
18f0: 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  a database conne
1900: 63 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 65 6e  ction for the en
1910: 74 69 72 65 20 64 75 72 61 74 69 6f 6e 20 6f 66  tire duration of
1920: 20 61 20 64 61 74 61 62 61 73 65 20 74 72 61 6e   a database tran
1930: 73 61 63 74 69 6f 6e 2c 0a 20 2a 20 69 74 20 69  saction,. * it i
1940: 73 20 69 6d 70 6f 72 74 61 6e 74 20 74 6f 20 6b  s important to k
1950: 65 65 70 20 74 72 61 6e 73 61 63 74 69 6f 6e 73  eep transactions
1960: 20 73 68 6f 72 74 2e 20 20 54 68 69 73 20 69 73   short.  This is
1970: 20 65 73 70 65 63 69 61 6c 6c 79 20 69 6d 70 6f   especially impo
1980: 72 74 61 6e 74 0a 20 2a 20 66 6f 72 20 72 65 61  rtant. * for rea
1990: 64 2d 77 72 69 74 65 20 74 72 61 6e 73 61 63 74  d-write transact
19a0: 69 6f 6e 73 20 73 69 6e 63 65 20 74 68 65 79 20  ions since they 
19b0: 6d 61 79 20 62 6c 6f 63 6b 20 6f 74 68 65 72 20  may block other 
19c0: 74 72 61 6e 73 61 63 74 69 6f 6e 73 0a 20 2a 20  transactions. * 
19d0: 66 72 6f 6d 20 65 78 65 63 75 74 69 6e 67 2e 20  from executing. 
19e0: 20 43 6f 6e 73 69 64 65 72 20 63 61 6c 6c 69 6e   Consider callin
19f0: 67 20 7b 40 6c 69 6e 6b 20 23 79 69 65 6c 64 54  g {@link #yieldT
1a00: 72 61 6e 73 61 63 74 69 6f 6e 7d 20 70 65 72 69  ransaction} peri
1a10: 6f 64 69 63 61 6c 6c 79 0a 20 2a 20 64 75 72 69  odically. * duri
1a20: 6e 67 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20  ng long-running 
1a30: 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e 0a 20 2a  transactions.. *
1a40: 20 3c 2f 70 3e 3c 70 3e 0a 20 2a 20 41 6e 6f 74   </p><p>. * Anot
1a50: 68 65 72 20 69 6d 70 6f 72 74 61 6e 74 20 63 6f  her important co
1a60: 6e 73 69 64 65 72 61 74 69 6f 6e 20 69 73 20 74  nsideration is t
1a70: 68 61 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 73  hat transactions
1a80: 20 74 68 61 74 20 74 61 6b 65 20 74 6f 6f 20 6c   that take too l
1a90: 6f 6e 67 20 74 6f 0a 20 2a 20 72 75 6e 20 6d 61  ong to. * run ma
1aa0: 79 20 63 61 75 73 65 20 74 68 65 20 61 70 70 6c  y cause the appl
1ab0: 69 63 61 74 69 6f 6e 20 55 49 20 74 6f 20 62 65  ication UI to be
1ac0: 63 6f 6d 65 20 75 6e 72 65 73 70 6f 6e 73 69 76  come unresponsiv
1ad0: 65 2e 20 20 45 76 65 6e 20 69 66 20 74 68 65 20  e.  Even if the 
1ae0: 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 2a 20 69  transaction. * i
1af0: 73 20 65 78 65 63 75 74 65 64 20 69 6e 20 61 20  s executed in a 
1b00: 62 61 63 6b 67 72 6f 75 6e 64 20 74 68 72 65 61  background threa
1b10: 64 2c 20 74 68 65 20 75 73 65 72 20 77 69 6c 6c  d, the user will
1b20: 20 67 65 74 20 62 6f 72 65 64 20 61 6e 64 0a 20   get bored and. 
1b30: 2a 20 66 72 75 73 74 72 61 74 65 64 20 69 66 20  * frustrated if 
1b40: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20  the application 
1b50: 73 68 6f 77 73 20 6e 6f 20 64 61 74 61 20 66 6f  shows no data fo
1b60: 72 20 73 65 76 65 72 61 6c 20 73 65 63 6f 6e 64  r several second
1b70: 73 20 77 68 69 6c 65 0a 20 2a 20 61 20 74 72 61  s while. * a tra
1b80: 6e 73 61 63 74 69 6f 6e 20 72 75 6e 73 2e 0a 20  nsaction runs.. 
1b90: 2a 20 3c 2f 70 3e 3c 70 3e 0a 20 2a 20 47 75 69  * </p><p>. * Gui
1ba0: 64 65 6c 69 6e 65 73 3a 0a 20 2a 20 3c 75 6c 3e  delines:. * <ul>
1bb0: 0a 20 2a 20 3c 6c 69 3e 44 6f 20 6e 6f 74 20 70  . * <li>Do not p
1bc0: 65 72 66 6f 72 6d 20 64 61 74 61 62 61 73 65 20  erform database 
1bd0: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f 6e 20  transactions on 
1be0: 74 68 65 20 55 49 20 74 68 72 65 61 64 2e 3c 2f  the UI thread.</
1bf0: 6c 69 3e 0a 20 2a 20 3c 6c 69 3e 4b 65 65 70 20  li>. * <li>Keep 
1c00: 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63  database transac
1c10: 74 69 6f 6e 73 20 61 73 20 73 68 6f 72 74 20 61  tions as short a
1c20: 73 20 70 6f 73 73 69 62 6c 65 2e 3c 2f 6c 69 3e  s possible.</li>
1c30: 0a 20 2a 20 3c 6c 69 3e 53 69 6d 70 6c 65 20 71  . * <li>Simple q
1c40: 75 65 72 69 65 73 20 6f 66 74 65 6e 20 72 75 6e  ueries often run
1c50: 20 66 61 73 74 65 72 20 74 68 61 6e 20 63 6f 6d   faster than com
1c60: 70 6c 65 78 20 71 75 65 72 69 65 73 2e 3c 2f 6c  plex queries.</l
1c70: 69 3e 0a 20 2a 20 3c 6c 69 3e 4d 65 61 73 75 72  i>. * <li>Measur
1c80: 65 20 74 68 65 20 70 65 72 66 6f 72 6d 61 6e 63  e the performanc
1c90: 65 20 6f 66 20 79 6f 75 72 20 64 61 74 61 62 61  e of your databa
1ca0: 73 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e  se transactions.
1cb0: 3c 2f 6c 69 3e 0a 20 2a 20 3c 6c 69 3e 43 6f 6e  </li>. * <li>Con
1cc0: 73 69 64 65 72 20 77 68 61 74 20 77 69 6c 6c 20  sider what will 
1cd0: 68 61 70 70 65 6e 20 77 68 65 6e 20 74 68 65 20  happen when the 
1ce0: 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61  size of the data
1cf0: 20 73 65 74 20 67 72 6f 77 73 2e 0a 20 2a 20 41   set grows.. * A
1d00: 20 71 75 65 72 79 20 74 68 61 74 20 77 6f 72 6b   query that work
1d10: 73 20 77 65 6c 6c 20 6f 6e 20 31 30 30 20 72 6f  s well on 100 ro
1d20: 77 73 20 6d 61 79 20 73 74 72 75 67 67 6c 65 20  ws may struggle 
1d30: 77 69 74 68 20 31 30 2c 30 30 30 2e 3c 2f 6c 69  with 10,000.</li
1d40: 3e 0a 20 2a 20 3c 2f 75 6c 3e 0a 20 2a 0a 20 2a  >. * </ul>. *. *
1d50: 20 3c 68 32 3e 52 65 65 6e 74 72 61 6e 63 65 3c   <h2>Reentrance<
1d60: 2f 68 32 3e 0a 20 2a 20 3c 70 3e 0a 20 2a 20 54  /h2>. * <p>. * T
1d70: 68 69 73 20 63 6c 61 73 73 20 6d 75 73 74 20 74  his class must t
1d80: 6f 6c 65 72 61 74 65 20 72 65 65 6e 74 72 61 6e  olerate reentran
1d90: 74 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 53  t execution of S
1da0: 51 4c 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 73  QLite operations
1db0: 20 62 65 63 61 75 73 65 0a 20 2a 20 74 72 69 67   because. * trig
1dc0: 67 65 72 73 20 6d 61 79 20 63 61 6c 6c 20 63 75  gers may call cu
1dd0: 73 74 6f 6d 20 53 51 4c 69 74 65 20 66 75 6e 63  stom SQLite func
1de0: 74 69 6f 6e 73 20 74 68 61 74 20 70 65 72 66 6f  tions that perfo
1df0: 72 6d 20 61 64 64 69 74 69 6f 6e 61 6c 20 71 75  rm additional qu
1e00: 65 72 69 65 73 2e 0a 20 2a 20 3c 2f 70 3e 0a 20  eries.. * </p>. 
1e10: 2a 0a 20 2a 20 40 68 69 64 65 0a 20 2a 2f 0a 70  *. * @hide. */.p
1e20: 75 62 6c 69 63 20 66 69 6e 61 6c 20 63 6c 61 73  ublic final clas
1e30: 73 20 53 51 4c 69 74 65 53 65 73 73 69 6f 6e 20  s SQLiteSession 
1e40: 7b 0a 20 20 20 20 70 72 69 76 61 74 65 20 66 69  {.    private fi
1e50: 6e 61 6c 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63  nal SQLiteConnec
1e60: 74 69 6f 6e 50 6f 6f 6c 20 6d 43 6f 6e 6e 65 63  tionPool mConnec
1e70: 74 69 6f 6e 50 6f 6f 6c 3b 0a 0a 20 20 20 20 70  tionPool;..    p
1e80: 72 69 76 61 74 65 20 53 51 4c 69 74 65 43 6f 6e  rivate SQLiteCon
1e90: 6e 65 63 74 69 6f 6e 20 6d 43 6f 6e 6e 65 63 74  nection mConnect
1ea0: 69 6f 6e 3b 0a 20 20 20 20 70 72 69 76 61 74 65  ion;.    private
1eb0: 20 69 6e 74 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e   int mConnection
1ec0: 46 6c 61 67 73 3b 0a 20 20 20 20 70 72 69 76 61  Flags;.    priva
1ed0: 74 65 20 69 6e 74 20 6d 43 6f 6e 6e 65 63 74 69  te int mConnecti
1ee0: 6f 6e 55 73 65 43 6f 75 6e 74 3b 0a 20 20 20 20  onUseCount;.    
1ef0: 70 72 69 76 61 74 65 20 54 72 61 6e 73 61 63 74  private Transact
1f00: 69 6f 6e 20 6d 54 72 61 6e 73 61 63 74 69 6f 6e  ion mTransaction
1f10: 50 6f 6f 6c 3b 0a 20 20 20 20 70 72 69 76 61 74  Pool;.    privat
1f20: 65 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 6d 54  e Transaction mT
1f30: 72 61 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b 3b  ransactionStack;
1f40: 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a  ..    /**.     *
1f50: 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64   Transaction mod
1f60: 65 3a 20 44 65 66 65 72 72 65 64 2e 0a 20 20 20  e: Deferred..   
1f70: 20 20 2a 20 3c 70 3e 0a 20 20 20 20 20 2a 20 49    * <p>.     * I
1f80: 6e 20 61 20 64 65 66 65 72 72 65 64 20 74 72 61  n a deferred tra
1f90: 6e 73 61 63 74 69 6f 6e 2c 20 6e 6f 20 6c 6f 63  nsaction, no loc
1fa0: 6b 73 20 61 72 65 20 61 63 71 75 69 72 65 64 20  ks are acquired 
1fb0: 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  on the database.
1fc0: 20 20 20 20 20 2a 20 75 6e 74 69 6c 20 74 68 65       * until the
1fd0: 20 66 69 72 73 74 20 6f 70 65 72 61 74 69 6f 6e   first operation
1fe0: 20 69 73 20 70 65 72 66 6f 72 6d 65 64 2e 20 20   is performed.  
1ff0: 49 66 20 74 68 65 20 66 69 72 73 74 20 6f 70 65  If the first ope
2000: 72 61 74 69 6f 6e 20 69 73 0a 20 20 20 20 20 2a  ration is.     *
2010: 20 72 65 61 64 2d 6f 6e 6c 79 2c 20 74 68 65 6e   read-only, then
2020: 20 61 20 3c 63 6f 64 65 3e 53 48 41 52 45 44 3c   a <code>SHARED<
2030: 2f 63 6f 64 65 3e 20 6c 6f 63 6b 20 69 73 20 61  /code> lock is a
2040: 63 71 75 69 72 65 64 2c 20 6f 74 68 65 72 77 69  cquired, otherwi
2050: 73 65 0a 20 20 20 20 20 2a 20 61 20 3c 63 6f 64  se.     * a <cod
2060: 65 3e 52 45 53 45 52 56 45 44 3c 2f 63 6f 64 65  e>RESERVED</code
2070: 3e 20 6c 6f 63 6b 20 69 73 20 61 63 71 75 69 72  > lock is acquir
2080: 65 64 2e 0a 20 20 20 20 20 2a 20 3c 2f 70 3e 3c  ed..     * </p><
2090: 70 3e 0a 20 20 20 20 20 2a 20 57 68 69 6c 65 20  p>.     * While 
20a0: 68 6f 6c 64 69 6e 67 20 61 20 3c 63 6f 64 65 3e  holding a <code>
20b0: 53 48 41 52 45 44 3c 2f 63 6f 64 65 3e 20 6c 6f  SHARED</code> lo
20c0: 63 6b 2c 20 74 68 69 73 20 73 65 73 73 69 6f 6e  ck, this session
20d0: 20 69 73 20 6f 6e 6c 79 20 61 6c 6c 6f 77 65 64   is only allowed
20e0: 20 74 6f 0a 20 20 20 20 20 2a 20 72 65 61 64 20   to.     * read 
20f0: 62 75 74 20 6f 74 68 65 72 20 73 65 73 73 69 6f  but other sessio
2100: 6e 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 74  ns are allowed t
2110: 6f 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 2e  o read or write.
2120: 0a 20 20 20 20 20 2a 20 57 68 69 6c 65 20 68 6f  .     * While ho
2130: 6c 64 69 6e 67 20 61 20 3c 63 6f 64 65 3e 52 45  lding a <code>RE
2140: 53 45 52 56 45 44 3c 2f 63 6f 64 65 3e 20 6c 6f  SERVED</code> lo
2150: 63 6b 2c 20 74 68 69 73 20 73 65 73 73 69 6f 6e  ck, this session
2160: 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 72   is allowed to r
2170: 65 61 64 0a 20 20 20 20 20 2a 20 6f 72 20 77 72  ead.     * or wr
2180: 69 74 65 20 62 75 74 20 6f 74 68 65 72 20 73 65  ite but other se
2190: 73 73 69 6f 6e 73 20 61 72 65 20 6f 6e 6c 79 20  ssions are only 
21a0: 61 6c 6c 6f 77 65 64 20 74 6f 20 72 65 61 64 2e  allowed to read.
21b0: 0a 20 20 20 20 20 2a 20 3c 2f 70 3e 3c 70 3e 0a  .     * </p><p>.
21c0: 20 20 20 20 20 2a 20 42 65 63 61 75 73 65 20 74       * Because t
21d0: 68 65 20 6c 6f 63 6b 20 69 73 20 6f 6e 6c 79 20  he lock is only 
21e0: 61 63 71 75 69 72 65 64 20 77 68 65 6e 20 6e 65  acquired when ne
21f0: 65 64 65 64 20 69 6e 20 61 20 64 65 66 65 72 72  eded in a deferr
2200: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 0a  ed transaction,.
2210: 20 20 20 20 20 2a 20 69 74 20 69 73 20 70 6f 73       * it is pos
2220: 73 69 62 6c 65 20 66 6f 72 20 61 6e 6f 74 68 65  sible for anothe
2230: 72 20 73 65 73 73 69 6f 6e 20 74 6f 20 77 72 69  r session to wri
2240: 74 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  te to the databa
2250: 73 65 20 66 69 72 73 74 20 62 65 66 6f 72 65 0a  se first before.
2260: 20 20 20 20 20 2a 20 74 68 69 73 20 73 65 73 73       * this sess
2270: 69 6f 6e 20 68 61 73 20 61 20 63 68 61 6e 63 65  ion has a chance
2280: 20 74 6f 20 64 6f 20 61 6e 79 74 68 69 6e 67 2e   to do anything.
2290: 0a 20 20 20 20 20 2a 20 3c 2f 70 3e 3c 70 3e 0a  .     * </p><p>.
22a0: 20 20 20 20 20 2a 20 43 6f 72 72 65 73 70 6f 6e       * Correspon
22b0: 64 73 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65  ds to the SQLite
22c0: 20 3c 63 6f 64 65 3e 42 45 47 49 4e 20 44 45 46   <code>BEGIN DEF
22d0: 45 52 52 45 44 3c 2f 63 6f 64 65 3e 20 74 72 61  ERRED</code> tra
22e0: 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 65 2e 0a 20  nsaction mode.. 
22f0: 20 20 20 20 2a 20 3c 2f 70 3e 0a 20 20 20 20 20      * </p>.     
2300: 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 73 74  */.    public st
2310: 61 74 69 63 20 66 69 6e 61 6c 20 69 6e 74 20 54  atic final int T
2320: 52 41 4e 53 41 43 54 49 4f 4e 5f 4d 4f 44 45 5f  RANSACTION_MODE_
2330: 44 45 46 45 52 52 45 44 20 3d 20 30 3b 0a 0a 20  DEFERRED = 0;.. 
2340: 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 54 72     /**.     * Tr
2350: 61 6e 73 61 63 74 69 6f 6e 20 6d 6f 64 65 3a 20  ansaction mode: 
2360: 49 6d 6d 65 64 69 61 74 65 2e 0a 20 20 20 20 20  Immediate..     
2370: 2a 20 3c 70 3e 0a 20 20 20 20 20 2a 20 57 68 65  * <p>.     * Whe
2380: 6e 20 61 6e 20 69 6d 6d 65 64 69 61 74 65 20 74  n an immediate t
2390: 72 61 6e 73 61 63 74 69 6f 6e 20 62 65 67 69 6e  ransaction begin
23a0: 73 2c 20 74 68 65 20 73 65 73 73 69 6f 6e 20 61  s, the session a
23b0: 63 71 75 69 72 65 73 20 61 0a 20 20 20 20 20 2a  cquires a.     *
23c0: 20 3c 63 6f 64 65 3e 52 45 53 45 52 56 45 44 3c   <code>RESERVED<
23d0: 2f 63 6f 64 65 3e 20 6c 6f 63 6b 2e 0a 20 20 20  /code> lock..   
23e0: 20 20 2a 20 3c 2f 70 3e 3c 70 3e 0a 20 20 20 20    * </p><p>.    
23f0: 20 2a 20 57 68 69 6c 65 20 68 6f 6c 64 69 6e 67   * While holding
2400: 20 61 20 3c 63 6f 64 65 3e 52 45 53 45 52 56 45   a <code>RESERVE
2410: 44 3c 2f 63 6f 64 65 3e 20 6c 6f 63 6b 2c 20 74  D</code> lock, t
2420: 68 69 73 20 73 65 73 73 69 6f 6e 20 69 73 20 61  his session is a
2430: 6c 6c 6f 77 65 64 20 74 6f 20 72 65 61 64 0a 20  llowed to read. 
2440: 20 20 20 20 2a 20 6f 72 20 77 72 69 74 65 20 62      * or write b
2450: 75 74 20 6f 74 68 65 72 20 73 65 73 73 69 6f 6e  ut other session
2460: 73 20 61 72 65 20 6f 6e 6c 79 20 61 6c 6c 6f 77  s are only allow
2470: 65 64 20 74 6f 20 72 65 61 64 2e 0a 20 20 20 20  ed to read..    
2480: 20 2a 20 3c 2f 70 3e 3c 70 3e 0a 20 20 20 20 20   * </p><p>.     
2490: 2a 20 43 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f  * Corresponds to
24a0: 20 74 68 65 20 53 51 4c 69 74 65 20 3c 63 6f 64   the SQLite <cod
24b0: 65 3e 42 45 47 49 4e 20 49 4d 4d 45 44 49 41 54  e>BEGIN IMMEDIAT
24c0: 45 3c 2f 63 6f 64 65 3e 20 74 72 61 6e 73 61 63  E</code> transac
24d0: 74 69 6f 6e 20 6d 6f 64 65 2e 0a 20 20 20 20 20  tion mode..     
24e0: 2a 20 3c 2f 70 3e 0a 20 20 20 20 20 2a 2f 0a 20  * </p>.     */. 
24f0: 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 63     public static
2500: 20 66 69 6e 61 6c 20 69 6e 74 20 54 52 41 4e 53   final int TRANS
2510: 41 43 54 49 4f 4e 5f 4d 4f 44 45 5f 49 4d 4d 45  ACTION_MODE_IMME
2520: 44 49 41 54 45 20 3d 20 31 3b 0a 0a 20 20 20 20  DIATE = 1;..    
2530: 2f 2a 2a 0a 20 20 20 20 20 2a 20 54 72 61 6e 73  /**.     * Trans
2540: 61 63 74 69 6f 6e 20 6d 6f 64 65 3a 20 45 78 63  action mode: Exc
2550: 6c 75 73 69 76 65 2e 0a 20 20 20 20 20 2a 20 3c  lusive..     * <
2560: 70 3e 0a 20 20 20 20 20 2a 20 57 68 65 6e 20 61  p>.     * When a
2570: 6e 20 65 78 63 6c 75 73 69 76 65 20 74 72 61 6e  n exclusive tran
2580: 73 61 63 74 69 6f 6e 20 62 65 67 69 6e 73 2c 20  saction begins, 
2590: 74 68 65 20 73 65 73 73 69 6f 6e 20 61 63 71 75  the session acqu
25a0: 69 72 65 73 20 61 6e 0a 20 20 20 20 20 2a 20 3c  ires an.     * <
25b0: 63 6f 64 65 3e 45 58 43 4c 55 53 49 56 45 3c 2f  code>EXCLUSIVE</
25c0: 63 6f 64 65 3e 20 6c 6f 63 6b 2e 0a 20 20 20 20  code> lock..    
25d0: 20 2a 20 3c 2f 70 3e 3c 70 3e 0a 20 20 20 20 20   * </p><p>.     
25e0: 2a 20 57 68 69 6c 65 20 68 6f 6c 64 69 6e 67 20  * While holding 
25f0: 61 6e 20 3c 63 6f 64 65 3e 45 58 43 4c 55 53 49  an <code>EXCLUSI
2600: 56 45 3c 2f 63 6f 64 65 3e 20 6c 6f 63 6b 2c 20  VE</code> lock, 
2610: 74 68 69 73 20 73 65 73 73 69 6f 6e 20 69 73 20  this session is 
2620: 61 6c 6c 6f 77 65 64 20 74 6f 20 72 65 61 64 0a  allowed to read.
2630: 20 20 20 20 20 2a 20 6f 72 20 77 72 69 74 65 20       * or write 
2640: 62 75 74 20 6e 6f 20 6f 74 68 65 72 20 73 65 73  but no other ses
2650: 73 69 6f 6e 73 20 61 72 65 20 61 6c 6c 6f 77 65  sions are allowe
2660: 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20  d to access the 
2670: 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 2a  database..     *
2680: 20 3c 2f 70 3e 3c 70 3e 0a 20 20 20 20 20 2a 20   </p><p>.     * 
2690: 43 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74  Corresponds to t
26a0: 68 65 20 53 51 4c 69 74 65 20 3c 63 6f 64 65 3e  he SQLite <code>
26b0: 42 45 47 49 4e 20 45 58 43 4c 55 53 49 56 45 3c  BEGIN EXCLUSIVE<
26c0: 2f 63 6f 64 65 3e 20 74 72 61 6e 73 61 63 74 69  /code> transacti
26d0: 6f 6e 20 6d 6f 64 65 2e 0a 20 20 20 20 20 2a 20  on mode..     * 
26e0: 3c 2f 70 3e 0a 20 20 20 20 20 2a 2f 0a 20 20 20  </p>.     */.   
26f0: 20 70 75 62 6c 69 63 20 73 74 61 74 69 63 20 66   public static f
2700: 69 6e 61 6c 20 69 6e 74 20 54 52 41 4e 53 41 43  inal int TRANSAC
2710: 54 49 4f 4e 5f 4d 4f 44 45 5f 45 58 43 4c 55 53  TION_MODE_EXCLUS
2720: 49 56 45 20 3d 20 32 3b 0a 0a 20 20 20 20 2f 2a  IVE = 2;..    /*
2730: 2a 0a 20 20 20 20 20 2a 20 43 72 65 61 74 65 73  *.     * Creates
2740: 20 61 20 73 65 73 73 69 6f 6e 20 62 6f 75 6e 64   a session bound
2750: 20 74 6f 20 74 68 65 20 73 70 65 63 69 66 69 65   to the specifie
2760: 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 6f  d connection poo
2770: 6c 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a  l..     *.     *
2780: 20 40 70 61 72 61 6d 20 63 6f 6e 6e 65 63 74 69   @param connecti
2790: 6f 6e 50 6f 6f 6c 20 54 68 65 20 63 6f 6e 6e 65  onPool The conne
27a0: 63 74 69 6f 6e 20 70 6f 6f 6c 2e 0a 20 20 20 20  ction pool..    
27b0: 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 53   */.    public S
27c0: 51 4c 69 74 65 53 65 73 73 69 6f 6e 28 53 51 4c  QLiteSession(SQL
27d0: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f  iteConnectionPoo
27e0: 6c 20 63 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c  l connectionPool
27f0: 29 20 7b 0a 20 20 20 20 20 20 20 20 69 66 20 28  ) {.        if (
2800: 63 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 20 3d  connectionPool =
2810: 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20  = null) {.      
2820: 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20        throw new 
2830: 49 6c 6c 65 67 61 6c 41 72 67 75 6d 65 6e 74 45  IllegalArgumentE
2840: 78 63 65 70 74 69 6f 6e 28 22 63 6f 6e 6e 65 63  xception("connec
2850: 74 69 6f 6e 50 6f 6f 6c 20 6d 75 73 74 20 6e 6f  tionPool must no
2860: 74 20 62 65 20 6e 75 6c 6c 22 29 3b 0a 20 20 20  t be null");.   
2870: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20       }..        
2880: 6d 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 20  mConnectionPool 
2890: 3d 20 63 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c  = connectionPool
28a0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a  ;.    }..    /**
28b0: 0a 20 20 20 20 20 2a 20 52 65 74 75 72 6e 73 20  .     * Returns 
28c0: 74 72 75 65 20 69 66 20 74 68 65 20 73 65 73 73  true if the sess
28d0: 69 6f 6e 20 68 61 73 20 61 20 74 72 61 6e 73 61  ion has a transa
28e0: 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73  ction in progres
28f0: 73 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a  s..     *.     *
2900: 20 40 72 65 74 75 72 6e 20 54 72 75 65 20 69 66   @return True if
2910: 20 74 68 65 20 73 65 73 73 69 6f 6e 20 68 61 73   the session has
2920: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
2930: 6e 20 70 72 6f 67 72 65 73 73 2e 0a 20 20 20 20  n progress..    
2940: 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 62   */.    public b
2950: 6f 6f 6c 65 61 6e 20 68 61 73 54 72 61 6e 73 61  oolean hasTransa
2960: 63 74 69 6f 6e 28 29 20 7b 0a 20 20 20 20 20 20  ction() {.      
2970: 20 20 72 65 74 75 72 6e 20 6d 54 72 61 6e 73 61    return mTransa
2980: 63 74 69 6f 6e 53 74 61 63 6b 20 21 3d 20 6e 75  ctionStack != nu
2990: 6c 6c 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f  ll;.    }..    /
29a0: 2a 2a 0a 20 20 20 20 20 2a 20 52 65 74 75 72 6e  **.     * Return
29b0: 73 20 74 72 75 65 20 69 66 20 74 68 65 20 73 65  s true if the se
29c0: 73 73 69 6f 6e 20 68 61 73 20 61 20 6e 65 73 74  ssion has a nest
29d0: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69  ed transaction i
29e0: 6e 20 70 72 6f 67 72 65 73 73 2e 0a 20 20 20 20  n progress..    
29f0: 20 2a 0a 20 20 20 20 20 2a 20 40 72 65 74 75 72   *.     * @retur
2a00: 6e 20 54 72 75 65 20 69 66 20 74 68 65 20 73 65  n True if the se
2a10: 73 73 69 6f 6e 20 68 61 73 20 61 20 6e 65 73 74  ssion has a nest
2a20: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69  ed transaction i
2a30: 6e 20 70 72 6f 67 72 65 73 73 2e 0a 20 20 20 20  n progress..    
2a40: 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 62   */.    public b
2a50: 6f 6f 6c 65 61 6e 20 68 61 73 4e 65 73 74 65 64  oolean hasNested
2a60: 54 72 61 6e 73 61 63 74 69 6f 6e 28 29 20 7b 0a  Transaction() {.
2a70: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d          return m
2a80: 54 72 61 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b  TransactionStack
2a90: 20 21 3d 20 6e 75 6c 6c 20 26 26 20 6d 54 72 61   != null && mTra
2aa0: 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b 2e 6d 50  nsactionStack.mP
2ab0: 61 72 65 6e 74 20 21 3d 20 6e 75 6c 6c 3b 0a 20  arent != null;. 
2ac0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20     }..    /**.  
2ad0: 20 20 20 2a 20 52 65 74 75 72 6e 73 20 74 72 75     * Returns tru
2ae0: 65 20 69 66 20 74 68 65 20 73 65 73 73 69 6f 6e  e if the session
2af0: 20 68 61 73 20 61 6e 20 61 63 74 69 76 65 20 64   has an active d
2b00: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
2b10: 6f 6e 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20  on..     *.     
2b20: 2a 20 40 72 65 74 75 72 6e 20 54 72 75 65 20 69  * @return True i
2b30: 66 20 74 68 65 20 73 65 73 73 69 6f 6e 20 68 61  f the session ha
2b40: 73 20 61 6e 20 61 63 74 69 76 65 20 64 61 74 61  s an active data
2b50: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e  base connection.
2b60: 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62  .     */.    pub
2b70: 6c 69 63 20 62 6f 6f 6c 65 61 6e 20 68 61 73 43  lic boolean hasC
2b80: 6f 6e 6e 65 63 74 69 6f 6e 28 29 20 7b 0a 20 20  onnection() {.  
2b90: 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 43 6f        return mCo
2ba0: 6e 6e 65 63 74 69 6f 6e 20 21 3d 20 6e 75 6c 6c  nnection != null
2bb0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a  ;.    }..    /**
2bc0: 0a 20 20 20 20 20 2a 20 42 65 67 69 6e 73 20 61  .     * Begins a
2bd0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20   transaction..  
2be0: 20 20 20 2a 20 3c 70 3e 0a 20 20 20 20 20 2a 20     * <p>.     * 
2bf0: 54 72 61 6e 73 61 63 74 69 6f 6e 73 20 6d 61 79  Transactions may
2c00: 20 6e 65 73 74 2e 20 20 49 66 20 74 68 65 20 74   nest.  If the t
2c10: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 6f  ransaction is no
2c20: 74 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 0a 20  t in progress,. 
2c30: 20 20 20 20 2a 20 74 68 65 6e 20 61 20 64 61 74      * then a dat
2c40: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
2c50: 20 69 73 20 6f 62 74 61 69 6e 65 64 20 61 6e 64   is obtained and
2c60: 20 61 20 6e 65 77 20 74 72 61 6e 73 61 63 74 69   a new transacti
2c70: 6f 6e 20 69 73 20 73 74 61 72 74 65 64 2e 0a 20  on is started.. 
2c80: 20 20 20 20 2a 20 4f 74 68 65 72 77 69 73 65 2c      * Otherwise,
2c90: 20 61 20 6e 65 73 74 65 64 20 74 72 61 6e 73 61   a nested transa
2ca0: 63 74 69 6f 6e 20 69 73 20 73 74 61 72 74 65 64  ction is started
2cb0: 2e 0a 20 20 20 20 20 2a 20 3c 2f 70 3e 3c 70 3e  ..     * </p><p>
2cc0: 0a 20 20 20 20 20 2a 20 45 61 63 68 20 63 61 6c  .     * Each cal
2cd0: 6c 20 74 6f 20 7b 40 6c 69 6e 6b 20 23 62 65 67  l to {@link #beg
2ce0: 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 7d 20 6d  inTransaction} m
2cf0: 75 73 74 20 62 65 20 6d 61 74 63 68 65 64 20 65  ust be matched e
2d00: 78 61 63 74 6c 79 20 62 79 20 61 20 63 61 6c 6c  xactly by a call
2d10: 0a 20 20 20 20 20 2a 20 74 6f 20 7b 40 6c 69 6e  .     * to {@lin
2d20: 6b 20 23 65 6e 64 54 72 61 6e 73 61 63 74 69 6f  k #endTransactio
2d30: 6e 7d 2e 20 20 54 6f 20 6d 61 72 6b 20 61 20 74  n}.  To mark a t
2d40: 72 61 6e 73 61 63 74 69 6f 6e 20 61 73 20 73 75  ransaction as su
2d50: 63 63 65 73 73 66 75 6c 2c 0a 20 20 20 20 20 2a  ccessful,.     *
2d60: 20 63 61 6c 6c 20 7b 40 6c 69 6e 6b 20 23 73 65   call {@link #se
2d70: 74 54 72 61 6e 73 61 63 74 69 6f 6e 53 75 63 63  tTransactionSucc
2d80: 65 73 73 66 75 6c 7d 20 62 65 66 6f 72 65 20 63  essful} before c
2d90: 61 6c 6c 69 6e 67 20 7b 40 6c 69 6e 6b 20 23 65  alling {@link #e
2da0: 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 7d 2e 0a  ndTransaction}..
2db0: 20 20 20 20 20 2a 20 49 66 20 74 68 65 20 74 72       * If the tr
2dc0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 6f 74  ansaction is not
2dd0: 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20   successful, or 
2de0: 69 66 20 61 6e 79 20 6f 66 20 69 74 73 20 6e 65  if any of its ne
2df0: 73 74 65 64 0a 20 20 20 20 20 2a 20 74 72 61 6e  sted.     * tran
2e00: 73 61 63 74 69 6f 6e 73 20 77 65 72 65 20 6e 6f  sactions were no
2e10: 74 20 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68  t successful, th
2e20: 65 6e 20 74 68 65 20 65 6e 74 69 72 65 20 74 72  en the entire tr
2e30: 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 0a 20  ansaction will. 
2e40: 20 20 20 20 2a 20 62 65 20 72 6f 6c 6c 65 64 20      * be rolled 
2e50: 62 61 63 6b 20 77 68 65 6e 20 74 68 65 20 6f 75  back when the ou
2e60: 74 65 72 6d 6f 73 74 20 74 72 61 6e 73 61 63 74  termost transact
2e70: 69 6f 6e 20 69 73 20 65 6e 64 65 64 2e 0a 20 20  ion is ended..  
2e80: 20 20 20 2a 20 3c 2f 70 3e 0a 20 20 20 20 20 2a     * </p>.     *
2e90: 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 74  .     * @param t
2ea0: 72 61 6e 73 61 63 74 69 6f 6e 4d 6f 64 65 20 54  ransactionMode T
2eb0: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d  he transaction m
2ec0: 6f 64 65 2e 20 20 4f 6e 65 20 6f 66 3a 20 7b 40  ode.  One of: {@
2ed0: 6c 69 6e 6b 20 23 54 52 41 4e 53 41 43 54 49 4f  link #TRANSACTIO
2ee0: 4e 5f 4d 4f 44 45 5f 44 45 46 45 52 52 45 44 7d  N_MODE_DEFERRED}
2ef0: 2c 0a 20 20 20 20 20 2a 20 7b 40 6c 69 6e 6b 20  ,.     * {@link 
2f00: 23 54 52 41 4e 53 41 43 54 49 4f 4e 5f 4d 4f 44  #TRANSACTION_MOD
2f10: 45 5f 49 4d 4d 45 44 49 41 54 45 7d 2c 20 6f 72  E_IMMEDIATE}, or
2f20: 20 7b 40 6c 69 6e 6b 20 23 54 52 41 4e 53 41 43   {@link #TRANSAC
2f30: 54 49 4f 4e 5f 4d 4f 44 45 5f 45 58 43 4c 55 53  TION_MODE_EXCLUS
2f40: 49 56 45 7d 2e 0a 20 20 20 20 20 2a 20 49 67 6e  IVE}..     * Ign
2f50: 6f 72 65 64 20 77 68 65 6e 20 63 72 65 61 74 69  ored when creati
2f60: 6e 67 20 61 20 6e 65 73 74 65 64 20 74 72 61 6e  ng a nested tran
2f70: 73 61 63 74 69 6f 6e 2e 0a 20 20 20 20 20 2a 20  saction..     * 
2f80: 40 70 61 72 61 6d 20 74 72 61 6e 73 61 63 74 69  @param transacti
2f90: 6f 6e 4c 69 73 74 65 6e 65 72 20 54 68 65 20 74  onListener The t
2fa0: 72 61 6e 73 61 63 74 69 6f 6e 20 6c 69 73 74 65  ransaction liste
2fb0: 6e 65 72 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20  ner, or null if 
2fc0: 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a 20 40 70 61  none..     * @pa
2fd0: 72 61 6d 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c  ram connectionFl
2fe0: 61 67 73 20 54 68 65 20 63 6f 6e 6e 65 63 74 69  ags The connecti
2ff0: 6f 6e 20 66 6c 61 67 73 20 74 6f 20 75 73 65 20  on flags to use 
3000: 69 66 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20  if a connection 
3010: 6d 75 73 74 20 62 65 0a 20 20 20 20 20 2a 20 61  must be.     * a
3020: 63 71 75 69 72 65 64 20 62 79 20 74 68 69 73 20  cquired by this 
3030: 6f 70 65 72 61 74 69 6f 6e 2e 20 20 52 65 66 65  operation.  Refe
3040: 72 20 74 6f 20 7b 40 6c 69 6e 6b 20 53 51 4c 69  r to {@link SQLi
3050: 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c  teConnectionPool
3060: 7d 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d  }..     * @param
3070: 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67   cancellationSig
3080: 6e 61 6c 20 41 20 73 69 67 6e 61 6c 20 74 6f 20  nal A signal to 
3090: 63 61 6e 63 65 6c 20 74 68 65 20 6f 70 65 72 61  cancel the opera
30a0: 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73  tion in progress
30b0: 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e  , or null if non
30c0: 65 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a  e..     *.     *
30d0: 20 40 74 68 72 6f 77 73 20 49 6c 6c 65 67 61 6c   @throws Illegal
30e0: 53 74 61 74 65 45 78 63 65 70 74 69 6f 6e 20 69  StateException i
30f0: 66 20 7b 40 6c 69 6e 6b 20 23 73 65 74 54 72 61  f {@link #setTra
3100: 6e 73 61 63 74 69 6f 6e 53 75 63 63 65 73 73 66  nsactionSuccessf
3110: 75 6c 7d 20 68 61 73 20 61 6c 72 65 61 64 79 20  ul} has already 
3120: 62 65 65 6e 0a 20 20 20 20 20 2a 20 63 61 6c 6c  been.     * call
3130: 65 64 20 66 6f 72 20 74 68 65 20 63 75 72 72 65  ed for the curre
3140: 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a  nt transaction..
3150: 20 20 20 20 20 2a 20 40 74 68 72 6f 77 73 20 53       * @throws S
3160: 51 4c 69 74 65 45 78 63 65 70 74 69 6f 6e 20 69  QLiteException i
3170: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  f an error occur
3180: 73 2e 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77  s..     * @throw
3190: 73 20 4f 70 65 72 61 74 69 6f 6e 43 61 6e 63 65  s OperationCance
31a0: 6c 65 64 45 78 63 65 70 74 69 6f 6e 20 69 66 20  ledException if 
31b0: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 77 61  the operation wa
31c0: 73 20 63 61 6e 63 65 6c 65 64 2e 0a 20 20 20 20  s canceled..    
31d0: 20 2a 0a 20 20 20 20 20 2a 20 40 73 65 65 20 23   *.     * @see #
31e0: 73 65 74 54 72 61 6e 73 61 63 74 69 6f 6e 53 75  setTransactionSu
31f0: 63 63 65 73 73 66 75 6c 0a 20 20 20 20 20 2a 20  ccessful.     * 
3200: 40 73 65 65 20 23 79 69 65 6c 64 54 72 61 6e 73  @see #yieldTrans
3210: 61 63 74 69 6f 6e 0a 20 20 20 20 20 2a 20 40 73  action.     * @s
3220: 65 65 20 23 65 6e 64 54 72 61 6e 73 61 63 74 69  ee #endTransacti
3230: 6f 6e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70  on.     */.    p
3240: 75 62 6c 69 63 20 76 6f 69 64 20 62 65 67 69 6e  ublic void begin
3250: 54 72 61 6e 73 61 63 74 69 6f 6e 28 69 6e 74 20  Transaction(int 
3260: 74 72 61 6e 73 61 63 74 69 6f 6e 4d 6f 64 65 2c  transactionMode,
3270: 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c  .            SQL
3280: 69 74 65 54 72 61 6e 73 61 63 74 69 6f 6e 4c 69  iteTransactionLi
3290: 73 74 65 6e 65 72 20 74 72 61 6e 73 61 63 74 69  stener transacti
32a0: 6f 6e 4c 69 73 74 65 6e 65 72 2c 20 69 6e 74 20  onListener, int 
32b0: 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c  connectionFlags,
32c0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 43 61 6e  .            Can
32d0: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 20  cellationSignal 
32e0: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
32f0: 61 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 74 68  al) {.        th
3300: 72 6f 77 49 66 54 72 61 6e 73 61 63 74 69 6f 6e  rowIfTransaction
3310: 4d 61 72 6b 65 64 53 75 63 63 65 73 73 66 75 6c  MarkedSuccessful
3320: 28 29 3b 0a 20 20 20 20 20 20 20 20 62 65 67 69  ();.        begi
3330: 6e 54 72 61 6e 73 61 63 74 69 6f 6e 55 6e 63 68  nTransactionUnch
3340: 65 63 6b 65 64 28 74 72 61 6e 73 61 63 74 69 6f  ecked(transactio
3350: 6e 4d 6f 64 65 2c 20 74 72 61 6e 73 61 63 74 69  nMode, transacti
3360: 6f 6e 4c 69 73 74 65 6e 65 72 2c 20 63 6f 6e 6e  onListener, conn
3370: 65 63 74 69 6f 6e 46 6c 61 67 73 2c 0a 20 20 20  ectionFlags,.   
3380: 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e               can
3390: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29  cellationSignal)
33a0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 69  ;.    }..    pri
33b0: 76 61 74 65 20 76 6f 69 64 20 62 65 67 69 6e 54  vate void beginT
33c0: 72 61 6e 73 61 63 74 69 6f 6e 55 6e 63 68 65 63  ransactionUnchec
33d0: 6b 65 64 28 69 6e 74 20 74 72 61 6e 73 61 63 74  ked(int transact
33e0: 69 6f 6e 4d 6f 64 65 2c 0a 20 20 20 20 20 20 20  ionMode,.       
33f0: 20 20 20 20 20 53 51 4c 69 74 65 54 72 61 6e 73       SQLiteTrans
3400: 61 63 74 69 6f 6e 4c 69 73 74 65 6e 65 72 20 74  actionListener t
3410: 72 61 6e 73 61 63 74 69 6f 6e 4c 69 73 74 65 6e  ransactionListen
3420: 65 72 2c 20 69 6e 74 20 63 6f 6e 6e 65 63 74 69  er, int connecti
3430: 6f 6e 46 6c 61 67 73 2c 0a 20 20 20 20 20 20 20  onFlags,.       
3440: 20 20 20 20 20 43 61 6e 63 65 6c 6c 61 74 69 6f       Cancellatio
3450: 6e 53 69 67 6e 61 6c 20 63 61 6e 63 65 6c 6c 61  nSignal cancella
3460: 74 69 6f 6e 53 69 67 6e 61 6c 29 20 7b 0a 20 20  tionSignal) {.  
3470: 20 20 20 20 20 20 69 66 20 28 63 61 6e 63 65 6c        if (cancel
3480: 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 20 21 3d 20  lationSignal != 
3490: 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20 20 20  null) {.        
34a0: 20 20 20 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e      cancellation
34b0: 53 69 67 6e 61 6c 2e 74 68 72 6f 77 49 66 43 61  Signal.throwIfCa
34c0: 6e 63 65 6c 65 64 28 29 3b 0a 20 20 20 20 20 20  nceled();.      
34d0: 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 66 20    }..        if 
34e0: 28 6d 54 72 61 6e 73 61 63 74 69 6f 6e 53 74 61  (mTransactionSta
34f0: 63 6b 20 3d 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20  ck == null) {.  
3500: 20 20 20 20 20 20 20 20 20 20 61 63 71 75 69 72            acquir
3510: 65 43 6f 6e 6e 65 63 74 69 6f 6e 28 6e 75 6c 6c  eConnection(null
3520: 2c 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  , connectionFlag
3530: 73 2c 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53  s, cancellationS
3540: 69 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74  ignal); // might
3550: 20 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20 7d   throw.        }
3560: 0a 20 20 20 20 20 20 20 20 74 72 79 20 7b 0a 20  .        try {. 
3570: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 53 65             // Se
3580: 74 20 75 70 20 74 68 65 20 74 72 61 6e 73 61 63  t up the transac
3590: 74 69 6f 6e 20 73 75 63 68 20 74 68 61 74 20 77  tion such that w
35a0: 65 20 63 61 6e 20 62 61 63 6b 20 6f 75 74 20 73  e can back out s
35b0: 61 66 65 6c 79 0a 20 20 20 20 20 20 20 20 20 20  afely.          
35c0: 20 20 2f 2f 20 69 6e 20 63 61 73 65 20 77 65 20    // in case we 
35d0: 66 61 69 6c 20 70 61 72 74 20 77 61 79 2e 0a 20  fail part way.. 
35e0: 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 6d             if (m
35f0: 54 72 61 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b  TransactionStack
3600: 20 3d 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20   == null) {.    
3610: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 45              // E
3620: 78 65 63 75 74 65 20 53 51 4c 20 6d 69 67 68 74  xecute SQL might
3630: 20 74 68 72 6f 77 20 61 20 72 75 6e 74 69 6d 65   throw a runtime
3640: 20 65 78 63 65 70 74 69 6f 6e 2e 0a 20 20 20 20   exception..    
3650: 20 20 20 20 20 20 20 20 20 20 20 20 73 77 69 74              swit
3660: 63 68 20 28 74 72 61 6e 73 61 63 74 69 6f 6e 4d  ch (transactionM
3670: 6f 64 65 29 20 7b 0a 20 20 20 20 20 20 20 20 20  ode) {.         
3680: 20 20 20 20 20 20 20 20 20 20 20 63 61 73 65 20             case 
3690: 54 52 41 4e 53 41 43 54 49 4f 4e 5f 4d 4f 44 45  TRANSACTION_MODE
36a0: 5f 49 4d 4d 45 44 49 41 54 45 3a 0a 20 20 20 20  _IMMEDIATE:.    
36b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
36c0: 20 20 20 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e 2e      mConnection.
36d0: 65 78 65 63 75 74 65 28 22 42 45 47 49 4e 20 49  execute("BEGIN I
36e0: 4d 4d 45 44 49 41 54 45 3b 22 2c 20 6e 75 6c 6c  MMEDIATE;", null
36f0: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
3700: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3710: 20 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69    cancellationSi
3720: 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20  gnal); // might 
3730: 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20 20 20  throw.          
3740: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72                br
3750: 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20  eak;.           
3760: 20 20 20 20 20 20 20 20 20 63 61 73 65 20 54 52           case TR
3770: 41 4e 53 41 43 54 49 4f 4e 5f 4d 4f 44 45 5f 45  ANSACTION_MODE_E
3780: 58 43 4c 55 53 49 56 45 3a 0a 20 20 20 20 20 20  XCLUSIVE:.      
3790: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
37a0: 20 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e 2e 65 78    mConnection.ex
37b0: 65 63 75 74 65 28 22 42 45 47 49 4e 20 45 58 43  ecute("BEGIN EXC
37c0: 4c 55 53 49 56 45 3b 22 2c 20 6e 75 6c 6c 2c 0a  LUSIVE;", null,.
37d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
37e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
37f0: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
3800: 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68  al); // might th
3810: 72 6f 77 0a 20 20 20 20 20 20 20 20 20 20 20 20  row.            
3820: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61              brea
3830: 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  k;.             
3840: 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a 0a         default:.
3850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3860: 20 20 20 20 20 20 20 20 6d 43 6f 6e 6e 65 63 74          mConnect
3870: 69 6f 6e 2e 65 78 65 63 75 74 65 28 22 42 45 47  ion.execute("BEG
3880: 49 4e 3b 22 2c 20 6e 75 6c 6c 2c 20 63 61 6e 63  IN;", null, canc
3890: 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 3b  ellationSignal);
38a0: 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a   // might throw.
38b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
38c0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
38d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d                 }
38e0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 0a  .            }..
38f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 4c              // L
3900: 69 73 74 65 6e 65 72 20 6d 69 67 68 74 20 74 68  istener might th
3910: 72 6f 77 20 61 20 72 75 6e 74 69 6d 65 20 65 78  row a runtime ex
3920: 63 65 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20  ception..       
3930: 20 20 20 20 20 69 66 20 28 74 72 61 6e 73 61 63       if (transac
3940: 74 69 6f 6e 4c 69 73 74 65 6e 65 72 20 21 3d 20  tionListener != 
3950: 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20 20 20  null) {.        
3960: 20 20 20 20 20 20 20 20 74 72 79 20 7b 0a 20 20          try {.  
3970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3980: 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 4c 69 73    transactionLis
3990: 74 65 6e 65 72 2e 6f 6e 42 65 67 69 6e 28 29 3b  tener.onBegin();
39a0: 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a   // might throw.
39b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
39c0: 7d 20 63 61 74 63 68 20 28 52 75 6e 74 69 6d 65  } catch (Runtime
39d0: 45 78 63 65 70 74 69 6f 6e 20 65 78 29 20 7b 0a  Exception ex) {.
39e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
39f0: 20 20 20 20 69 66 20 28 6d 54 72 61 6e 73 61 63      if (mTransac
3a00: 74 69 6f 6e 53 74 61 63 6b 20 3d 3d 20 6e 75 6c  tionStack == nul
3a10: 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20  l) {.           
3a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 43 6f               mCo
3a30: 6e 6e 65 63 74 69 6f 6e 2e 65 78 65 63 75 74 65  nnection.execute
3a40: 28 22 52 4f 4c 4c 42 41 43 4b 3b 22 2c 20 6e 75  ("ROLLBACK;", nu
3a50: 6c 6c 2c 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e  ll, cancellation
3a60: 53 69 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68  Signal); // migh
3a70: 74 20 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20  t throw.        
3a80: 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20              }.  
3a90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3aa0: 20 20 74 68 72 6f 77 20 65 78 3b 0a 20 20 20 20    throw ex;.    
3ab0: 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20              }.  
3ac0: 20 20 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20            }..   
3ad0: 20 20 20 20 20 20 20 20 20 2f 2f 20 42 6f 6f 6b           // Book
3ae0: 6b 65 65 70 69 6e 67 20 63 61 6e 27 74 20 74 68  keeping can't th
3af0: 72 6f 77 2c 20 65 78 63 65 70 74 20 61 6e 20 4f  row, except an O
3b00: 4f 4d 2c 20 77 68 69 63 68 20 69 73 20 6a 75 73  OM, which is jus
3b10: 74 20 74 6f 6f 20 62 61 64 2e 2e 2e 0a 20 20 20  t too bad....   
3b20: 20 20 20 20 20 20 20 20 20 54 72 61 6e 73 61 63           Transac
3b30: 74 69 6f 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e  tion transaction
3b40: 20 3d 20 6f 62 74 61 69 6e 54 72 61 6e 73 61 63   = obtainTransac
3b50: 74 69 6f 6e 28 74 72 61 6e 73 61 63 74 69 6f 6e  tion(transaction
3b60: 4d 6f 64 65 2c 20 74 72 61 6e 73 61 63 74 69 6f  Mode, transactio
3b70: 6e 4c 69 73 74 65 6e 65 72 29 3b 0a 20 20 20 20  nListener);.    
3b80: 20 20 20 20 20 20 20 20 74 72 61 6e 73 61 63 74          transact
3b90: 69 6f 6e 2e 6d 50 61 72 65 6e 74 20 3d 20 6d 54  ion.mParent = mT
3ba0: 72 61 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b 3b  ransactionStack;
3bb0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 54 72  .            mTr
3bc0: 61 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b 20 3d  ansactionStack =
3bd0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 3b 0a 20 20   transaction;.  
3be0: 20 20 20 20 20 20 7d 20 66 69 6e 61 6c 6c 79 20        } finally 
3bf0: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66  {.            if
3c00: 20 28 6d 54 72 61 6e 73 61 63 74 69 6f 6e 53 74   (mTransactionSt
3c10: 61 63 6b 20 3d 3d 20 6e 75 6c 6c 29 20 7b 0a 20  ack == null) {. 
3c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72                 r
3c30: 65 6c 65 61 73 65 43 6f 6e 6e 65 63 74 69 6f 6e  eleaseConnection
3c40: 28 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68 72  (); // might thr
3c50: 6f 77 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d  ow.            }
3c60: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  .        }.    }
3c70: 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a  ..    /**.     *
3c80: 20 4d 61 72 6b 73 20 74 68 65 20 63 75 72 72 65   Marks the curre
3c90: 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61  nt transaction a
3ca0: 73 20 68 61 76 69 6e 67 20 63 6f 6d 70 6c 65 74  s having complet
3cb0: 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2e  ed successfully.
3cc0: 0a 20 20 20 20 20 2a 20 3c 70 3e 0a 20 20 20 20  .     * <p>.    
3cd0: 20 2a 20 54 68 69 73 20 6d 65 74 68 6f 64 20 63   * This method c
3ce0: 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 61 74 20  an be called at 
3cf0: 6d 6f 73 74 20 6f 6e 63 65 20 62 65 74 77 65 65  most once betwee
3d00: 6e 20 7b 40 6c 69 6e 6b 20 23 62 65 67 69 6e 54  n {@link #beginT
3d10: 72 61 6e 73 61 63 74 69 6f 6e 7d 20 61 6e 64 0a  ransaction} and.
3d20: 20 20 20 20 20 2a 20 7b 40 6c 69 6e 6b 20 23 65       * {@link #e
3d30: 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 7d 20 74  ndTransaction} t
3d40: 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 20  o indicate that 
3d50: 74 68 65 20 63 68 61 6e 67 65 73 20 6d 61 64 65  the changes made
3d60: 20 62 79 20 74 68 65 20 74 72 61 6e 73 61 63 74   by the transact
3d70: 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 0a 20 20  ion should be.  
3d80: 20 20 20 2a 20 63 6f 6d 6d 69 74 74 65 64 2e 20     * committed. 
3d90: 20 49 66 20 74 68 69 73 20 6d 65 74 68 6f 64 20   If this method 
3da0: 69 73 20 6e 6f 74 20 63 61 6c 6c 65 64 2c 20 74  is not called, t
3db0: 68 65 20 63 68 61 6e 67 65 73 20 77 69 6c 6c 20  he changes will 
3dc0: 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 0a 20  be rolled back. 
3dd0: 20 20 20 20 2a 20 77 68 65 6e 20 74 68 65 20 74      * when the t
3de0: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 65 6e  ransaction is en
3df0: 64 65 64 2e 0a 20 20 20 20 20 2a 20 3c 2f 70 3e  ded..     * </p>
3e00: 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a 20 40  .     *.     * @
3e10: 74 68 72 6f 77 73 20 49 6c 6c 65 67 61 6c 53 74  throws IllegalSt
3e20: 61 74 65 45 78 63 65 70 74 69 6f 6e 20 69 66 20  ateException if 
3e30: 74 68 65 72 65 20 69 73 20 6e 6f 20 63 75 72 72  there is no curr
3e40: 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c  ent transaction,
3e50: 20 6f 72 20 69 66 0a 20 20 20 20 20 2a 20 7b 40   or if.     * {@
3e60: 6c 69 6e 6b 20 23 73 65 74 54 72 61 6e 73 61 63  link #setTransac
3e70: 74 69 6f 6e 53 75 63 63 65 73 73 66 75 6c 7d 20  tionSuccessful} 
3e80: 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e  has already been
3e90: 20 63 61 6c 6c 65 64 20 66 6f 72 20 74 68 65 20   called for the 
3ea0: 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74  current transact
3eb0: 69 6f 6e 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20  ion..     *.    
3ec0: 20 2a 20 40 73 65 65 20 23 62 65 67 69 6e 54 72   * @see #beginTr
3ed0: 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 2a  ansaction.     *
3ee0: 20 40 73 65 65 20 23 65 6e 64 54 72 61 6e 73 61   @see #endTransa
3ef0: 63 74 69 6f 6e 0a 20 20 20 20 20 2a 2f 0a 20 20  ction.     */.  
3f00: 20 20 70 75 62 6c 69 63 20 76 6f 69 64 20 73 65    public void se
3f10: 74 54 72 61 6e 73 61 63 74 69 6f 6e 53 75 63 63  tTransactionSucc
3f20: 65 73 73 66 75 6c 28 29 20 7b 0a 20 20 20 20 20  essful() {.     
3f30: 20 20 20 74 68 72 6f 77 49 66 4e 6f 54 72 61 6e     throwIfNoTran
3f40: 73 61 63 74 69 6f 6e 28 29 3b 0a 20 20 20 20 20  saction();.     
3f50: 20 20 20 74 68 72 6f 77 49 66 54 72 61 6e 73 61     throwIfTransa
3f60: 63 74 69 6f 6e 4d 61 72 6b 65 64 53 75 63 63 65  ctionMarkedSucce
3f70: 73 73 66 75 6c 28 29 3b 0a 0a 20 20 20 20 20 20  ssful();..      
3f80: 20 20 6d 54 72 61 6e 73 61 63 74 69 6f 6e 53 74    mTransactionSt
3f90: 61 63 6b 2e 6d 4d 61 72 6b 65 64 53 75 63 63 65  ack.mMarkedSucce
3fa0: 73 73 66 75 6c 20 3d 20 74 72 75 65 3b 0a 20 20  ssful = true;.  
3fb0: 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20    }..    /**.   
3fc0: 20 20 2a 20 45 6e 64 73 20 74 68 65 20 63 75 72    * Ends the cur
3fd0: 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e  rent transaction
3fe0: 20 61 6e 64 20 63 6f 6d 6d 69 74 73 20 6f 72 20   and commits or 
3ff0: 72 6f 6c 6c 73 20 62 61 63 6b 20 63 68 61 6e 67  rolls back chang
4000: 65 73 2e 0a 20 20 20 20 20 2a 20 3c 70 3e 0a 20  es..     * <p>. 
4010: 20 20 20 20 2a 20 49 66 20 74 68 69 73 20 69 73      * If this is
4020: 20 74 68 65 20 6f 75 74 65 72 6d 6f 73 74 20 74   the outermost t
4030: 72 61 6e 73 61 63 74 69 6f 6e 20 28 6e 6f 74 20  ransaction (not 
4040: 6e 65 73 74 65 64 20 77 69 74 68 69 6e 20 61 6e  nested within an
4050: 79 20 6f 74 68 65 72 0a 20 20 20 20 20 2a 20 74  y other.     * t
4060: 72 61 6e 73 61 63 74 69 6f 6e 29 2c 20 74 68 65  ransaction), the
4070: 6e 20 74 68 65 20 63 68 61 6e 67 65 73 20 61 72  n the changes ar
4080: 65 20 63 6f 6d 6d 69 74 74 65 64 20 69 66 20 7b  e committed if {
4090: 40 6c 69 6e 6b 20 23 73 65 74 54 72 61 6e 73 61  @link #setTransa
40a0: 63 74 69 6f 6e 53 75 63 63 65 73 73 66 75 6c 7d  ctionSuccessful}
40b0: 0a 20 20 20 20 20 2a 20 77 61 73 20 63 61 6c 6c  .     * was call
40c0: 65 64 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63  ed or rolled bac
40d0: 6b 20 6f 74 68 65 72 77 69 73 65 2e 0a 20 20 20  k otherwise..   
40e0: 20 20 2a 20 3c 2f 70 3e 3c 70 3e 0a 20 20 20 20    * </p><p>.    
40f0: 20 2a 20 54 68 69 73 20 6d 65 74 68 6f 64 20 6d   * This method m
4100: 75 73 74 20 62 65 20 63 61 6c 6c 65 64 20 65 78  ust be called ex
4110: 61 63 74 6c 79 20 6f 6e 63 65 20 66 6f 72 20 65  actly once for e
4120: 61 63 68 20 63 61 6c 6c 20 74 6f 20 7b 40 6c 69  ach call to {@li
4130: 6e 6b 20 23 62 65 67 69 6e 54 72 61 6e 73 61 63  nk #beginTransac
4140: 74 69 6f 6e 7d 2e 0a 20 20 20 20 20 2a 20 3c 2f  tion}..     * </
4150: 70 3e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a  p>.     *.     *
4160: 20 40 70 61 72 61 6d 20 63 61 6e 63 65 6c 6c 61   @param cancella
4170: 74 69 6f 6e 53 69 67 6e 61 6c 20 41 20 73 69 67  tionSignal A sig
4180: 6e 61 6c 20 74 6f 20 63 61 6e 63 65 6c 20 74 68  nal to cancel th
4190: 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70  e operation in p
41a0: 72 6f 67 72 65 73 73 2c 20 6f 72 20 6e 75 6c 6c  rogress, or null
41b0: 20 69 66 20 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a   if none..     *
41c0: 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77 73 20  .     * @throws 
41d0: 49 6c 6c 65 67 61 6c 53 74 61 74 65 45 78 63 65  IllegalStateExce
41e0: 70 74 69 6f 6e 20 69 66 20 74 68 65 72 65 20 69  ption if there i
41f0: 73 20 6e 6f 20 63 75 72 72 65 6e 74 20 74 72 61  s no current tra
4200: 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 20 20 20 2a  nsaction..     *
4210: 20 40 74 68 72 6f 77 73 20 53 51 4c 69 74 65 45   @throws SQLiteE
4220: 78 63 65 70 74 69 6f 6e 20 69 66 20 61 6e 20 65  xception if an e
4230: 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 20 20 20  rror occurs..   
4240: 20 20 2a 20 40 74 68 72 6f 77 73 20 4f 70 65 72    * @throws Oper
4250: 61 74 69 6f 6e 43 61 6e 63 65 6c 65 64 45 78 63  ationCanceledExc
4260: 65 70 74 69 6f 6e 20 69 66 20 74 68 65 20 6f 70  eption if the op
4270: 65 72 61 74 69 6f 6e 20 77 61 73 20 63 61 6e 63  eration was canc
4280: 65 6c 65 64 2e 0a 20 20 20 20 20 2a 0a 20 20 20  eled..     *.   
4290: 20 20 2a 20 40 73 65 65 20 23 62 65 67 69 6e 54    * @see #beginT
42a0: 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20  ransaction.     
42b0: 2a 20 40 73 65 65 20 23 73 65 74 54 72 61 6e 73  * @see #setTrans
42c0: 61 63 74 69 6f 6e 53 75 63 63 65 73 73 66 75 6c  actionSuccessful
42d0: 0a 20 20 20 20 20 2a 20 40 73 65 65 20 23 79 69  .     * @see #yi
42e0: 65 6c 64 54 72 61 6e 73 61 63 74 69 6f 6e 0a 20  eldTransaction. 
42f0: 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69      */.    publi
4300: 63 20 76 6f 69 64 20 65 6e 64 54 72 61 6e 73 61  c void endTransa
4310: 63 74 69 6f 6e 28 43 61 6e 63 65 6c 6c 61 74 69  ction(Cancellati
4320: 6f 6e 53 69 67 6e 61 6c 20 63 61 6e 63 65 6c 6c  onSignal cancell
4330: 61 74 69 6f 6e 53 69 67 6e 61 6c 29 20 7b 0a 20  ationSignal) {. 
4340: 20 20 20 20 20 20 20 74 68 72 6f 77 49 66 4e 6f         throwIfNo
4350: 54 72 61 6e 73 61 63 74 69 6f 6e 28 29 3b 0a 20  Transaction();. 
4360: 20 20 20 20 20 20 20 61 73 73 65 72 74 20 6d 43         assert mC
4370: 6f 6e 6e 65 63 74 69 6f 6e 20 21 3d 20 6e 75 6c  onnection != nul
4380: 6c 3b 0a 0a 20 20 20 20 20 20 20 20 65 6e 64 54  l;..        endT
4390: 72 61 6e 73 61 63 74 69 6f 6e 55 6e 63 68 65 63  ransactionUnchec
43a0: 6b 65 64 28 63 61 6e 63 65 6c 6c 61 74 69 6f 6e  ked(cancellation
43b0: 53 69 67 6e 61 6c 2c 20 66 61 6c 73 65 29 3b 0a  Signal, false);.
43c0: 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 69 76 61      }..    priva
43d0: 74 65 20 76 6f 69 64 20 65 6e 64 54 72 61 6e 73  te void endTrans
43e0: 61 63 74 69 6f 6e 55 6e 63 68 65 63 6b 65 64 28  actionUnchecked(
43f0: 43 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  CancellationSign
4400: 61 6c 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53  al cancellationS
4410: 69 67 6e 61 6c 2c 20 62 6f 6f 6c 65 61 6e 20 79  ignal, boolean y
4420: 69 65 6c 64 69 6e 67 29 20 7b 0a 20 20 20 20 20  ielding) {.     
4430: 20 20 20 69 66 20 28 63 61 6e 63 65 6c 6c 61 74     if (cancellat
4440: 69 6f 6e 53 69 67 6e 61 6c 20 21 3d 20 6e 75 6c  ionSignal != nul
4450: 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20  l) {.           
4460: 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67   cancellationSig
4470: 6e 61 6c 2e 74 68 72 6f 77 49 66 43 61 6e 63 65  nal.throwIfCance
4480: 6c 65 64 28 29 3b 0a 20 20 20 20 20 20 20 20 7d  led();.        }
4490: 0a 0a 20 20 20 20 20 20 20 20 66 69 6e 61 6c 20  ..        final 
44a0: 54 72 61 6e 73 61 63 74 69 6f 6e 20 74 6f 70 20  Transaction top 
44b0: 3d 20 6d 54 72 61 6e 73 61 63 74 69 6f 6e 53 74  = mTransactionSt
44c0: 61 63 6b 3b 0a 20 20 20 20 20 20 20 20 62 6f 6f  ack;.        boo
44d0: 6c 65 61 6e 20 73 75 63 63 65 73 73 66 75 6c 20  lean successful 
44e0: 3d 20 28 74 6f 70 2e 6d 4d 61 72 6b 65 64 53 75  = (top.mMarkedSu
44f0: 63 63 65 73 73 66 75 6c 20 7c 7c 20 79 69 65 6c  ccessful || yiel
4500: 64 69 6e 67 29 20 26 26 20 21 74 6f 70 2e 6d 43  ding) && !top.mC
4510: 68 69 6c 64 46 61 69 6c 65 64 3b 0a 0a 20 20 20  hildFailed;..   
4520: 20 20 20 20 20 52 75 6e 74 69 6d 65 45 78 63 65       RuntimeExce
4530: 70 74 69 6f 6e 20 6c 69 73 74 65 6e 65 72 45 78  ption listenerEx
4540: 63 65 70 74 69 6f 6e 20 3d 20 6e 75 6c 6c 3b 0a  ception = null;.
4550: 20 20 20 20 20 20 20 20 66 69 6e 61 6c 20 53 51          final SQ
4560: 4c 69 74 65 54 72 61 6e 73 61 63 74 69 6f 6e 4c  LiteTransactionL
4570: 69 73 74 65 6e 65 72 20 6c 69 73 74 65 6e 65 72  istener listener
4580: 20 3d 20 74 6f 70 2e 6d 4c 69 73 74 65 6e 65 72   = top.mListener
4590: 3b 0a 20 20 20 20 20 20 20 20 69 66 20 28 6c 69  ;.        if (li
45a0: 73 74 65 6e 65 72 20 21 3d 20 6e 75 6c 6c 29 20  stener != null) 
45b0: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 72  {.            tr
45c0: 79 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20  y {.            
45d0: 20 20 20 20 69 66 20 28 73 75 63 63 65 73 73 66      if (successf
45e0: 75 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20  ul) {.          
45f0: 20 20 20 20 20 20 20 20 20 20 6c 69 73 74 65 6e            listen
4600: 65 72 2e 6f 6e 43 6f 6d 6d 69 74 28 29 3b 20 2f  er.onCommit(); /
4610: 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20  / might throw.  
4620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 20                } 
4630: 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 20 20 20  else {.         
4640: 20 20 20 20 20 20 20 20 20 20 20 6c 69 73 74 65             liste
4650: 6e 65 72 2e 6f 6e 52 6f 6c 6c 62 61 63 6b 28 29  ner.onRollback()
4660: 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f 77  ; // might throw
4670: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
4680: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d   }.            }
4690: 20 63 61 74 63 68 20 28 52 75 6e 74 69 6d 65 45   catch (RuntimeE
46a0: 78 63 65 70 74 69 6f 6e 20 65 78 29 20 7b 0a 20  xception ex) {. 
46b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c                 l
46c0: 69 73 74 65 6e 65 72 45 78 63 65 70 74 69 6f 6e  istenerException
46d0: 20 3d 20 65 78 3b 0a 20 20 20 20 20 20 20 20 20   = ex;.         
46e0: 20 20 20 20 20 20 20 73 75 63 63 65 73 73 66 75         successfu
46f0: 6c 20 3d 20 66 61 6c 73 65 3b 0a 20 20 20 20 20  l = false;.     
4700: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
4710: 20 7d 0a 0a 20 20 20 20 20 20 20 20 6d 54 72 61   }..        mTra
4720: 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b 20 3d 20  nsactionStack = 
4730: 74 6f 70 2e 6d 50 61 72 65 6e 74 3b 0a 20 20 20  top.mParent;.   
4740: 20 20 20 20 20 72 65 63 79 63 6c 65 54 72 61 6e       recycleTran
4750: 73 61 63 74 69 6f 6e 28 74 6f 70 29 3b 0a 0a 20  saction(top);.. 
4760: 20 20 20 20 20 20 20 69 66 20 28 6d 54 72 61 6e         if (mTran
4770: 73 61 63 74 69 6f 6e 53 74 61 63 6b 20 21 3d 20  sactionStack != 
4780: 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20 20 20  null) {.        
4790: 20 20 20 20 69 66 20 28 21 73 75 63 63 65 73 73      if (!success
47a0: 66 75 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 20  ful) {.         
47b0: 20 20 20 20 20 20 20 6d 54 72 61 6e 73 61 63 74         mTransact
47c0: 69 6f 6e 53 74 61 63 6b 2e 6d 43 68 69 6c 64 46  ionStack.mChildF
47d0: 61 69 6c 65 64 20 3d 20 74 72 75 65 3b 0a 20 20  ailed = true;.  
47e0: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
47f0: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20      } else {.   
4800: 20 20 20 20 20 20 20 20 20 74 72 79 20 7b 0a 20           try {. 
4810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69                 i
4820: 66 20 28 73 75 63 63 65 73 73 66 75 6c 29 20 7b  f (successful) {
4830: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
4840: 20 20 20 20 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e       mConnection
4850: 2e 65 78 65 63 75 74 65 28 22 43 4f 4d 4d 49 54  .execute("COMMIT
4860: 3b 22 2c 20 6e 75 6c 6c 2c 20 63 61 6e 63 65 6c  ;", null, cancel
4870: 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f  lationSignal); /
4880: 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20  / might throw.  
4890: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 20                } 
48a0: 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 20 20 20  else {.         
48b0: 20 20 20 20 20 20 20 20 20 20 20 6d 43 6f 6e 6e             mConn
48c0: 65 63 74 69 6f 6e 2e 65 78 65 63 75 74 65 28 22  ection.execute("
48d0: 52 4f 4c 4c 42 41 43 4b 3b 22 2c 20 6e 75 6c 6c  ROLLBACK;", null
48e0: 2c 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69  , cancellationSi
48f0: 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20  gnal); // might 
4900: 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20 20 20  throw.          
4910: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
4920: 20 20 20 20 7d 20 66 69 6e 61 6c 6c 79 20 7b 0a      } finally {.
4930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4940: 72 65 6c 65 61 73 65 43 6f 6e 6e 65 63 74 69 6f  releaseConnectio
4950: 6e 28 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68  n(); // might th
4960: 72 6f 77 0a 20 20 20 20 20 20 20 20 20 20 20 20  row.            
4970: 7d 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20  }.        }..   
4980: 20 20 20 20 20 69 66 20 28 6c 69 73 74 65 6e 65       if (listene
4990: 72 45 78 63 65 70 74 69 6f 6e 20 21 3d 20 6e 75  rException != nu
49a0: 6c 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20  ll) {.          
49b0: 20 20 74 68 72 6f 77 20 6c 69 73 74 65 6e 65 72    throw listener
49c0: 45 78 63 65 70 74 69 6f 6e 3b 0a 20 20 20 20 20  Exception;.     
49d0: 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20     }.    }..    
49e0: 2f 2a 2a 0a 20 20 20 20 20 2a 20 54 65 6d 70 6f  /**.     * Tempo
49f0: 72 61 72 69 6c 79 20 65 6e 64 73 20 61 20 74 72  rarily ends a tr
4a00: 61 6e 73 61 63 74 69 6f 6e 20 74 6f 20 6c 65 74  ansaction to let
4a10: 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 20 68   other threads h
4a20: 61 76 65 20 75 73 65 20 6f 66 0a 20 20 20 20 20  ave use of.     
4a30: 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20  * the database. 
4a40: 20 42 65 67 69 6e 73 20 61 20 6e 65 77 20 74 72   Begins a new tr
4a50: 61 6e 73 61 63 74 69 6f 6e 20 61 66 74 65 72 20  ansaction after 
4a60: 61 20 73 70 65 63 69 66 69 65 64 20 64 65 6c 61  a specified dela
4a70: 79 2e 0a 20 20 20 20 20 2a 20 3c 70 3e 0a 20 20  y..     * <p>.  
4a80: 20 20 20 2a 20 49 66 20 74 68 65 72 65 20 61 72     * If there ar
4a90: 65 20 6f 74 68 65 72 20 74 68 72 65 61 64 73 20  e other threads 
4aa0: 77 61 69 74 69 6e 67 20 74 6f 20 61 63 71 75 69  waiting to acqui
4ab0: 72 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2c 0a  re connections,.
4ac0: 20 20 20 20 20 2a 20 74 68 65 6e 20 74 68 65 20       * then the 
4ad0: 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74  current transact
4ae0: 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 64  ion is committed
4af0: 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 61 73   and the databas
4b00: 65 0a 20 20 20 20 20 2a 20 63 6f 6e 6e 65 63 74  e.     * connect
4b10: 69 6f 6e 20 69 73 20 72 65 6c 65 61 73 65 64 2e  ion is released.
4b20: 20 20 41 66 74 65 72 20 61 20 73 68 6f 72 74 20    After a short 
4b30: 64 65 6c 61 79 2c 20 61 20 6e 65 77 20 74 72 61  delay, a new tra
4b40: 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 2a 20  nsaction.     * 
4b50: 69 73 20 73 74 61 72 74 65 64 2e 0a 20 20 20 20  is started..    
4b60: 20 2a 20 3c 2f 70 3e 3c 70 3e 0a 20 20 20 20 20   * </p><p>.     
4b70: 2a 20 54 68 65 20 74 72 61 6e 73 61 63 74 69 6f  * The transactio
4b80: 6e 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20  n is assumed to 
4b90: 62 65 20 73 75 63 63 65 73 73 66 75 6c 20 73 6f  be successful so
4ba0: 20 66 61 72 2e 20 20 44 6f 20 6e 6f 74 20 63 61   far.  Do not ca
4bb0: 6c 6c 0a 20 20 20 20 20 2a 20 7b 40 6c 69 6e 6b  ll.     * {@link
4bc0: 20 23 73 65 74 54 72 61 6e 73 61 63 74 69 6f 6e   #setTransaction
4bd0: 53 75 63 63 65 73 73 66 75 6c 28 29 7d 20 62 65  Successful()} be
4be0: 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 74 68 69  fore calling thi
4bf0: 73 20 6d 65 74 68 6f 64 2e 0a 20 20 20 20 20 2a  s method..     *
4c00: 20 54 68 69 73 20 6d 65 74 68 6f 64 20 77 69 6c   This method wil
4c10: 6c 20 66 61 69 6c 20 69 66 20 74 68 65 20 74 72  l fail if the tr
4c20: 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 61 6c  ansaction has al
4c30: 72 65 61 64 79 20 62 65 65 6e 20 6d 61 72 6b 65  ready been marke
4c40: 64 0a 20 20 20 20 20 2a 20 73 75 63 63 65 73 73  d.     * success
4c50: 66 75 6c 2e 0a 20 20 20 20 20 2a 20 3c 2f 70 3e  ful..     * </p>
4c60: 3c 70 3e 0a 20 20 20 20 20 2a 20 54 68 65 20 63  <p>.     * The c
4c70: 68 61 6e 67 65 73 20 74 68 61 74 20 77 65 72 65  hanges that were
4c80: 20 63 6f 6d 6d 69 74 74 65 64 20 62 79 20 61 20   committed by a 
4c90: 79 69 65 6c 64 20 63 61 6e 6e 6f 74 20 62 65 20  yield cannot be 
4ca0: 72 6f 6c 6c 65 64 20 62 61 63 6b 20 6c 61 74 65  rolled back late
4cb0: 72 2e 0a 20 20 20 20 20 2a 20 3c 2f 70 3e 3c 70  r..     * </p><p
4cc0: 3e 0a 20 20 20 20 20 2a 20 42 65 66 6f 72 65 20  >.     * Before 
4cd0: 74 68 69 73 20 6d 65 74 68 6f 64 20 77 61 73 20  this method was 
4ce0: 63 61 6c 6c 65 64 2c 20 74 68 65 72 65 20 6d 75  called, there mu
4cf0: 73 74 20 61 6c 72 65 61 64 79 20 68 61 76 65 20  st already have 
4d00: 62 65 65 6e 0a 20 20 20 20 20 2a 20 61 20 74 72  been.     * a tr
4d10: 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f  ansaction in pro
4d20: 67 72 65 73 73 2e 20 20 57 68 65 6e 20 74 68 69  gress.  When thi
4d30: 73 20 6d 65 74 68 6f 64 20 72 65 74 75 72 6e 73  s method returns
4d40: 2c 20 74 68 65 72 65 20 77 69 6c 6c 0a 20 20 20  , there will.   
4d50: 20 20 2a 20 73 74 69 6c 6c 20 62 65 20 61 20 74    * still be a t
4d60: 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 70 72  ransaction in pr
4d70: 6f 67 72 65 73 73 2c 20 65 69 74 68 65 72 20 74  ogress, either t
4d80: 68 65 20 73 61 6d 65 20 6f 6e 65 20 61 73 20 62  he same one as b
4d90: 65 66 6f 72 65 0a 20 20 20 20 20 2a 20 6f 72 20  efore.     * or 
4da0: 61 20 6e 65 77 20 6f 6e 65 20 69 66 20 74 68 65  a new one if the
4db0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73   transaction was
4dc0: 20 61 63 74 75 61 6c 6c 79 20 79 69 65 6c 64 65   actually yielde
4dd0: 64 2e 0a 20 20 20 20 20 2a 20 3c 2f 70 3e 3c 70  d..     * </p><p
4de0: 3e 0a 20 20 20 20 20 2a 20 54 68 69 73 20 6d 65  >.     * This me
4df0: 74 68 6f 64 20 73 68 6f 75 6c 64 20 6e 6f 74 20  thod should not 
4e00: 62 65 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 74  be called when t
4e10: 68 65 72 65 20 69 73 20 61 20 6e 65 73 74 65 64  here is a nested
4e20: 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20   transaction.   
4e30: 20 20 2a 20 69 6e 20 70 72 6f 67 72 65 73 73 20    * in progress 
4e40: 62 65 63 61 75 73 65 20 69 74 20 69 73 20 6e 6f  because it is no
4e50: 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 79 69  t possible to yi
4e60: 65 6c 64 20 61 20 6e 65 73 74 65 64 20 74 72 61  eld a nested tra
4e70: 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 20 20 20 2a  nsaction..     *
4e80: 20 49 66 20 3c 63 6f 64 65 3e 74 68 72 6f 77 49   If <code>throwI
4e90: 66 4e 65 73 74 65 64 3c 2f 63 6f 64 65 3e 20 69  fNested</code> i
4ea0: 73 20 74 72 75 65 2c 20 74 68 65 6e 20 61 74 74  s true, then att
4eb0: 65 6d 70 74 69 6e 67 20 74 6f 20 79 69 65 6c 64  empting to yield
4ec0: 0a 20 20 20 20 20 2a 20 61 20 6e 65 73 74 65 64  .     * a nested
4ed0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c   transaction wil
4ee0: 6c 20 74 68 72 6f 77 20 7b 40 6c 69 6e 6b 20 49  l throw {@link I
4ef0: 6c 6c 65 67 61 6c 53 74 61 74 65 45 78 63 65 70  llegalStateExcep
4f00: 74 69 6f 6e 7d 2c 20 6f 74 68 65 72 77 69 73 65  tion}, otherwise
4f10: 0a 20 20 20 20 20 2a 20 74 68 65 20 6d 65 74 68  .     * the meth
4f20: 6f 64 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 3c  od will return <
4f30: 63 6f 64 65 3e 66 61 6c 73 65 3c 2f 63 6f 64 65  code>false</code
4f40: 3e 20 69 6e 20 74 68 61 74 20 63 61 73 65 2e 0a  > in that case..
4f50: 20 20 20 20 20 2a 20 3c 2f 70 3e 3c 70 3e 0a 20       * </p><p>. 
4f60: 20 20 20 20 2a 20 49 66 20 74 68 65 72 65 20 69      * If there i
4f70: 73 20 6e 6f 20 6e 65 73 74 65 64 20 74 72 61 6e  s no nested tran
4f80: 73 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72  saction in progr
4f90: 65 73 73 20 62 75 74 20 61 20 70 72 65 76 69 6f  ess but a previo
4fa0: 75 73 20 6e 65 73 74 65 64 0a 20 20 20 20 20 2a  us nested.     *
4fb0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 66 61 69   transaction fai
4fc0: 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 20 74 72  led, then the tr
4fd0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 6f 74  ansaction is not
4fe0: 20 79 69 65 6c 64 65 64 20 28 62 65 63 61 75 73   yielded (becaus
4ff0: 65 20 69 74 0a 20 20 20 20 20 2a 20 6d 75 73 74  e it.     * must
5000: 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 29   be rolled back)
5010: 20 61 6e 64 20 74 68 69 73 20 6d 65 74 68 6f 64   and this method
5020: 20 72 65 74 75 72 6e 73 20 3c 63 6f 64 65 3e 66   returns <code>f
5030: 61 6c 73 65 3c 2f 63 6f 64 65 3e 2e 0a 20 20 20  alse</code>..   
5040: 20 20 2a 20 3c 2f 70 3e 0a 20 20 20 20 20 2a 0a    * </p>.     *.
5050: 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 73 6c       * @param sl
5060: 65 65 70 41 66 74 65 72 59 69 65 6c 64 44 65 6c  eepAfterYieldDel
5070: 61 79 4d 69 6c 6c 69 73 20 41 20 64 65 6c 61 79  ayMillis A delay
5080: 20 74 69 6d 65 20 74 6f 20 77 61 69 74 20 61 66   time to wait af
5090: 74 65 72 20 79 69 65 6c 64 69 6e 67 0a 20 20 20  ter yielding.   
50a0: 20 20 2a 20 74 68 65 20 64 61 74 61 62 61 73 65    * the database
50b0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61   connection to a
50c0: 6c 6c 6f 77 20 6f 74 68 65 72 20 74 68 72 65 61  llow other threa
50d0: 64 73 20 73 6f 6d 65 20 74 69 6d 65 20 74 6f 20  ds some time to 
50e0: 72 75 6e 2e 0a 20 20 20 20 20 2a 20 49 66 20 74  run..     * If t
50f0: 68 65 20 76 61 6c 75 65 20 69 73 20 6c 65 73 73  he value is less
5100: 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74   than or equal t
5110: 6f 20 7a 65 72 6f 2c 20 74 68 65 72 65 20 77 69  o zero, there wi
5120: 6c 6c 20 62 65 20 6e 6f 20 61 64 64 69 74 69 6f  ll be no additio
5130: 6e 61 6c 0a 20 20 20 20 20 2a 20 64 65 6c 61 79  nal.     * delay
5140: 20 62 65 79 6f 6e 64 20 74 68 65 20 74 69 6d 65   beyond the time
5150: 20 69 74 20 77 69 6c 6c 20 74 61 6b 65 20 74 6f   it will take to
5160: 20 62 65 67 69 6e 20 61 20 6e 65 77 20 74 72 61   begin a new tra
5170: 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 20 20 20 2a  nsaction..     *
5180: 20 40 70 61 72 61 6d 20 74 68 72 6f 77 49 66 55   @param throwIfU
5190: 6e 73 61 66 65 20 49 66 20 74 72 75 65 2c 20 74  nsafe If true, t
51a0: 68 65 6e 20 69 6e 73 74 65 61 64 20 6f 66 20 72  hen instead of r
51b0: 65 74 75 72 6e 69 6e 67 20 66 61 6c 73 65 20 77  eturning false w
51c0: 68 65 6e 20 6e 6f 0a 20 20 20 20 20 2a 20 74 72  hen no.     * tr
51d0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 69 6e 20  ansaction is in 
51e0: 70 72 6f 67 72 65 73 73 2c 20 61 20 6e 65 73 74  progress, a nest
51f0: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69  ed transaction i
5200: 73 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 20 6f  s in progress, o
5210: 72 20 77 68 65 6e 0a 20 20 20 20 20 2a 20 74 68  r when.     * th
5220: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61  e transaction ha
5230: 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 6d  s already been m
5240: 61 72 6b 65 64 20 73 75 63 63 65 73 73 66 75 6c  arked successful
5250: 2c 20 74 68 72 6f 77 73 20 7b 40 6c 69 6e 6b 20  , throws {@link 
5260: 49 6c 6c 65 67 61 6c 53 74 61 74 65 45 78 63 65  IllegalStateExce
5270: 70 74 69 6f 6e 7d 2e 0a 20 20 20 20 20 2a 20 40  ption}..     * @
5280: 70 61 72 61 6d 20 63 61 6e 63 65 6c 6c 61 74 69  param cancellati
5290: 6f 6e 53 69 67 6e 61 6c 20 41 20 73 69 67 6e 61  onSignal A signa
52a0: 6c 20 74 6f 20 63 61 6e 63 65 6c 20 74 68 65 20  l to cancel the 
52b0: 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f  operation in pro
52c0: 67 72 65 73 73 2c 20 6f 72 20 6e 75 6c 6c 20 69  gress, or null i
52d0: 66 20 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a 20 40  f none..     * @
52e0: 72 65 74 75 72 6e 20 54 72 75 65 20 69 66 20 74  return True if t
52f0: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77  he transaction w
5300: 61 73 20 61 63 74 75 61 6c 6c 79 20 79 69 65 6c  as actually yiel
5310: 64 65 64 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20  ded..     *.    
5320: 20 2a 20 40 74 68 72 6f 77 73 20 49 6c 6c 65 67   * @throws Illeg
5330: 61 6c 53 74 61 74 65 45 78 63 65 70 74 69 6f 6e  alStateException
5340: 20 69 66 20 3c 63 6f 64 65 3e 74 68 72 6f 77 49   if <code>throwI
5350: 66 4e 65 73 74 65 64 3c 2f 63 6f 64 65 3e 20 69  fNested</code> i
5360: 73 20 74 72 75 65 20 61 6e 64 0a 20 20 20 20 20  s true and.     
5370: 2a 20 74 68 65 72 65 20 69 73 20 6e 6f 20 63 75  * there is no cu
5380: 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f  rrent transactio
5390: 6e 2c 20 74 68 65 72 65 20 69 73 20 61 20 6e 65  n, there is a ne
53a0: 73 74 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e  sted transaction
53b0: 20 69 6e 20 70 72 6f 67 72 65 73 73 20 6f 72 0a   in progress or.
53c0: 20 20 20 20 20 2a 20 69 66 20 7b 40 6c 69 6e 6b       * if {@link
53d0: 20 23 73 65 74 54 72 61 6e 73 61 63 74 69 6f 6e   #setTransaction
53e0: 53 75 63 63 65 73 73 66 75 6c 7d 20 68 61 73 20  Successful} has 
53f0: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 63 61 6c  already been cal
5400: 6c 65 64 20 66 6f 72 20 74 68 65 20 63 75 72 72  led for the curr
5410: 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e  ent transaction.
5420: 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77 73 20  .     * @throws 
5430: 53 51 4c 69 74 65 45 78 63 65 70 74 69 6f 6e 20  SQLiteException 
5440: 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75  if an error occu
5450: 72 73 2e 0a 20 20 20 20 20 2a 20 40 74 68 72 6f  rs..     * @thro
5460: 77 73 20 4f 70 65 72 61 74 69 6f 6e 43 61 6e 63  ws OperationCanc
5470: 65 6c 65 64 45 78 63 65 70 74 69 6f 6e 20 69 66  eledException if
5480: 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 77   the operation w
5490: 61 73 20 63 61 6e 63 65 6c 65 64 2e 0a 20 20 20  as canceled..   
54a0: 20 20 2a 0a 20 20 20 20 20 2a 20 40 73 65 65 20    *.     * @see 
54b0: 23 62 65 67 69 6e 54 72 61 6e 73 61 63 74 69 6f  #beginTransactio
54c0: 6e 0a 20 20 20 20 20 2a 20 40 73 65 65 20 23 65  n.     * @see #e
54d0: 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20  ndTransaction.  
54e0: 20 20 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63     */.    public
54f0: 20 62 6f 6f 6c 65 61 6e 20 79 69 65 6c 64 54 72   boolean yieldTr
5500: 61 6e 73 61 63 74 69 6f 6e 28 6c 6f 6e 67 20 73  ansaction(long s
5510: 6c 65 65 70 41 66 74 65 72 59 69 65 6c 64 44 65  leepAfterYieldDe
5520: 6c 61 79 4d 69 6c 6c 69 73 2c 20 62 6f 6f 6c 65  layMillis, boole
5530: 61 6e 20 74 68 72 6f 77 49 66 55 6e 73 61 66 65  an throwIfUnsafe
5540: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 43 61  ,.            Ca
5550: 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c  ncellationSignal
5560: 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67   cancellationSig
5570: 6e 61 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 69  nal) {.        i
5580: 66 20 28 74 68 72 6f 77 49 66 55 6e 73 61 66 65  f (throwIfUnsafe
5590: 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ) {.            
55a0: 74 68 72 6f 77 49 66 4e 6f 54 72 61 6e 73 61 63  throwIfNoTransac
55b0: 74 69 6f 6e 28 29 3b 0a 20 20 20 20 20 20 20 20  tion();.        
55c0: 20 20 20 20 74 68 72 6f 77 49 66 54 72 61 6e 73      throwIfTrans
55d0: 61 63 74 69 6f 6e 4d 61 72 6b 65 64 53 75 63 63  actionMarkedSucc
55e0: 65 73 73 66 75 6c 28 29 3b 0a 20 20 20 20 20 20  essful();.      
55f0: 20 20 20 20 20 20 74 68 72 6f 77 49 66 4e 65 73        throwIfNes
5600: 74 65 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 29  tedTransaction()
5610: 3b 0a 20 20 20 20 20 20 20 20 7d 20 65 6c 73 65  ;.        } else
5620: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69   {.            i
5630: 66 20 28 6d 54 72 61 6e 73 61 63 74 69 6f 6e 53  f (mTransactionS
5640: 74 61 63 6b 20 3d 3d 20 6e 75 6c 6c 20 7c 7c 20  tack == null || 
5650: 6d 54 72 61 6e 73 61 63 74 69 6f 6e 53 74 61 63  mTransactionStac
5660: 6b 2e 6d 4d 61 72 6b 65 64 53 75 63 63 65 73 73  k.mMarkedSuccess
5670: 66 75 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20  ful.            
5680: 20 20 20 20 20 20 20 20 7c 7c 20 6d 54 72 61 6e          || mTran
5690: 73 61 63 74 69 6f 6e 53 74 61 63 6b 2e 6d 50 61  sactionStack.mPa
56a0: 72 65 6e 74 20 21 3d 20 6e 75 6c 6c 29 20 7b 0a  rent != null) {.
56b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
56c0: 72 65 74 75 72 6e 20 66 61 6c 73 65 3b 0a 20 20  return false;.  
56d0: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
56e0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73      }.        as
56f0: 73 65 72 74 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e  sert mConnection
5700: 20 21 3d 20 6e 75 6c 6c 3b 0a 0a 20 20 20 20 20   != null;..     
5710: 20 20 20 69 66 20 28 6d 54 72 61 6e 73 61 63 74     if (mTransact
5720: 69 6f 6e 53 74 61 63 6b 2e 6d 43 68 69 6c 64 46  ionStack.mChildF
5730: 61 69 6c 65 64 29 20 7b 0a 20 20 20 20 20 20 20  ailed) {.       
5740: 20 20 20 20 20 72 65 74 75 72 6e 20 66 61 6c 73       return fals
5750: 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20  e;.        }..  
5760: 20 20 20 20 20 20 72 65 74 75 72 6e 20 79 69 65        return yie
5770: 6c 64 54 72 61 6e 73 61 63 74 69 6f 6e 55 6e 63  ldTransactionUnc
5780: 68 65 63 6b 65 64 28 73 6c 65 65 70 41 66 74 65  hecked(sleepAfte
5790: 72 59 69 65 6c 64 44 65 6c 61 79 4d 69 6c 6c 69  rYieldDelayMilli
57a0: 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  s,.             
57b0: 20 20 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53     cancellationS
57c0: 69 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74  ignal); // might
57d0: 20 74 68 72 6f 77 0a 20 20 20 20 7d 0a 0a 20 20   throw.    }..  
57e0: 20 20 70 72 69 76 61 74 65 20 62 6f 6f 6c 65 61    private boolea
57f0: 6e 20 79 69 65 6c 64 54 72 61 6e 73 61 63 74 69  n yieldTransacti
5800: 6f 6e 55 6e 63 68 65 63 6b 65 64 28 6c 6f 6e 67  onUnchecked(long
5810: 20 73 6c 65 65 70 41 66 74 65 72 59 69 65 6c 64   sleepAfterYield
5820: 44 65 6c 61 79 4d 69 6c 6c 69 73 2c 0a 20 20 20  DelayMillis,.   
5830: 20 20 20 20 20 20 20 20 20 43 61 6e 63 65 6c 6c           Cancell
5840: 61 74 69 6f 6e 53 69 67 6e 61 6c 20 63 61 6e 63  ationSignal canc
5850: 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 20  ellationSignal) 
5860: 7b 0a 20 20 20 20 20 20 20 20 69 66 20 28 63 61  {.        if (ca
5870: 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c  ncellationSignal
5880: 20 21 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20   != null) {.    
5890: 20 20 20 20 20 20 20 20 63 61 6e 63 65 6c 6c 61          cancella
58a0: 74 69 6f 6e 53 69 67 6e 61 6c 2e 74 68 72 6f 77  tionSignal.throw
58b0: 49 66 43 61 6e 63 65 6c 65 64 28 29 3b 0a 20 20  IfCanceled();.  
58c0: 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20        }..       
58d0: 20 69 66 20 28 21 6d 43 6f 6e 6e 65 63 74 69 6f   if (!mConnectio
58e0: 6e 50 6f 6f 6c 2e 73 68 6f 75 6c 64 59 69 65 6c  nPool.shouldYiel
58f0: 64 43 6f 6e 6e 65 63 74 69 6f 6e 28 6d 43 6f 6e  dConnection(mCon
5900: 6e 65 63 74 69 6f 6e 2c 20 6d 43 6f 6e 6e 65 63  nection, mConnec
5910: 74 69 6f 6e 46 6c 61 67 73 29 29 20 7b 0a 20 20  tionFlags)) {.  
5920: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e            return
5930: 20 66 61 6c 73 65 3b 0a 20 20 20 20 20 20 20 20   false;.        
5940: 7d 0a 0a 20 20 20 20 20 20 20 20 66 69 6e 61 6c  }..        final
5950: 20 69 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e   int transaction
5960: 4d 6f 64 65 20 3d 20 6d 54 72 61 6e 73 61 63 74  Mode = mTransact
5970: 69 6f 6e 53 74 61 63 6b 2e 6d 4d 6f 64 65 3b 0a  ionStack.mMode;.
5980: 20 20 20 20 20 20 20 20 66 69 6e 61 6c 20 53 51          final SQ
5990: 4c 69 74 65 54 72 61 6e 73 61 63 74 69 6f 6e 4c  LiteTransactionL
59a0: 69 73 74 65 6e 65 72 20 6c 69 73 74 65 6e 65 72  istener listener
59b0: 20 3d 20 6d 54 72 61 6e 73 61 63 74 69 6f 6e 53   = mTransactionS
59c0: 74 61 63 6b 2e 6d 4c 69 73 74 65 6e 65 72 3b 0a  tack.mListener;.
59d0: 20 20 20 20 20 20 20 20 66 69 6e 61 6c 20 69 6e          final in
59e0: 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  t connectionFlag
59f0: 73 20 3d 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e 46  s = mConnectionF
5a00: 6c 61 67 73 3b 0a 20 20 20 20 20 20 20 20 65 6e  lags;.        en
5a10: 64 54 72 61 6e 73 61 63 74 69 6f 6e 55 6e 63 68  dTransactionUnch
5a20: 65 63 6b 65 64 28 63 61 6e 63 65 6c 6c 61 74 69  ecked(cancellati
5a30: 6f 6e 53 69 67 6e 61 6c 2c 20 74 72 75 65 29 3b  onSignal, true);
5a40: 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a   // might throw.
5a50: 0a 20 20 20 20 20 20 20 20 69 66 20 28 73 6c 65  .        if (sle
5a60: 65 70 41 66 74 65 72 59 69 65 6c 64 44 65 6c 61  epAfterYieldDela
5a70: 79 4d 69 6c 6c 69 73 20 3e 20 30 29 20 7b 0a 20  yMillis > 0) {. 
5a80: 20 20 20 20 20 20 20 20 20 20 20 74 72 79 20 7b             try {
5a90: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
5aa0: 20 54 68 72 65 61 64 2e 73 6c 65 65 70 28 73 6c   Thread.sleep(sl
5ab0: 65 65 70 41 66 74 65 72 59 69 65 6c 64 44 65 6c  eepAfterYieldDel
5ac0: 61 79 4d 69 6c 6c 69 73 29 3b 0a 20 20 20 20 20  ayMillis);.     
5ad0: 20 20 20 20 20 20 20 7d 20 63 61 74 63 68 20 28         } catch (
5ae0: 49 6e 74 65 72 72 75 70 74 65 64 45 78 63 65 70  InterruptedExcep
5af0: 74 69 6f 6e 20 65 78 29 20 7b 0a 20 20 20 20 20  tion ex) {.     
5b00: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 77 65             // we
5b10: 20 68 61 76 65 20 62 65 65 6e 20 69 6e 74 65 72   have been inter
5b20: 72 75 70 74 65 64 2c 20 74 68 61 74 27 73 20 61  rupted, that's a
5b30: 6c 6c 20 77 65 20 6e 65 65 64 20 74 6f 20 64 6f  ll we need to do
5b40: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20  .            }. 
5b50: 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20         }..      
5b60: 20 20 62 65 67 69 6e 54 72 61 6e 73 61 63 74 69    beginTransacti
5b70: 6f 6e 55 6e 63 68 65 63 6b 65 64 28 74 72 61 6e  onUnchecked(tran
5b80: 73 61 63 74 69 6f 6e 4d 6f 64 65 2c 20 6c 69 73  sactionMode, lis
5b90: 74 65 6e 65 72 2c 20 63 6f 6e 6e 65 63 74 69 6f  tener, connectio
5ba0: 6e 46 6c 61 67 73 2c 0a 20 20 20 20 20 20 20 20  nFlags,.        
5bb0: 20 20 20 20 20 20 20 20 63 61 6e 63 65 6c 6c 61          cancella
5bc0: 74 69 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f 2f 20  tionSignal); // 
5bd0: 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20  might throw.    
5be0: 20 20 20 20 72 65 74 75 72 6e 20 74 72 75 65 3b      return true;
5bf0: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a  .    }..    /**.
5c00: 20 20 20 20 20 2a 20 50 72 65 70 61 72 65 73 20       * Prepares 
5c10: 61 20 73 74 61 74 65 6d 65 6e 74 20 66 6f 72 20  a statement for 
5c20: 65 78 65 63 75 74 69 6f 6e 20 62 75 74 20 64 6f  execution but do
5c30: 65 73 20 6e 6f 74 20 62 69 6e 64 20 69 74 73 20  es not bind its 
5c40: 70 61 72 61 6d 65 74 65 72 73 20 6f 72 20 65 78  parameters or ex
5c50: 65 63 75 74 65 20 69 74 2e 0a 20 20 20 20 20 2a  ecute it..     *
5c60: 20 3c 70 3e 0a 20 20 20 20 20 2a 20 54 68 69 73   <p>.     * This
5c70: 20 6d 65 74 68 6f 64 20 63 61 6e 20 62 65 20 75   method can be u
5c80: 73 65 64 20 74 6f 20 63 68 65 63 6b 20 66 6f 72  sed to check for
5c90: 20 73 79 6e 74 61 78 20 65 72 72 6f 72 73 20 64   syntax errors d
5ca0: 75 72 69 6e 67 20 63 6f 6d 70 69 6c 61 74 69 6f  uring compilatio
5cb0: 6e 0a 20 20 20 20 20 2a 20 70 72 69 6f 72 20 74  n.     * prior t
5cc0: 6f 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74  o execution of t
5cd0: 68 65 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 49  he statement.  I
5ce0: 66 20 74 68 65 20 7b 40 63 6f 64 65 20 6f 75 74  f the {@code out
5cf0: 53 74 61 74 65 6d 65 6e 74 49 6e 66 6f 7d 20 61  StatementInfo} a
5d00: 72 67 75 6d 65 6e 74 0a 20 20 20 20 20 2a 20 69  rgument.     * i
5d10: 73 20 6e 6f 74 20 6e 75 6c 6c 2c 20 74 68 65 20  s not null, the 
5d20: 70 72 6f 76 69 64 65 64 20 7b 40 6c 69 6e 6b 20  provided {@link 
5d30: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 49  SQLiteStatementI
5d40: 6e 66 6f 7d 20 6f 62 6a 65 63 74 20 69 73 20 70  nfo} object is p
5d50: 6f 70 75 6c 61 74 65 64 0a 20 20 20 20 20 2a 20  opulated.     * 
5d60: 77 69 74 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  with information
5d70: 20 61 62 6f 75 74 20 74 68 65 20 73 74 61 74 65   about the state
5d80: 6d 65 6e 74 2e 0a 20 20 20 20 20 2a 20 3c 2f 70  ment..     * </p
5d90: 3e 3c 70 3e 0a 20 20 20 20 20 2a 20 41 20 70 72  ><p>.     * A pr
5da0: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
5db0: 20 6d 61 6b 65 73 20 6e 6f 20 72 65 66 65 72 65   makes no refere
5dc0: 6e 63 65 20 74 6f 20 74 68 65 20 61 72 67 75 6d  nce to the argum
5dd0: 65 6e 74 73 20 74 68 61 74 20 6d 61 79 20 65 76  ents that may ev
5de0: 65 6e 74 75 61 6c 6c 79 0a 20 20 20 20 20 2a 20  entually.     * 
5df0: 62 65 20 62 6f 75 6e 64 20 74 6f 20 69 74 2c 20  be bound to it, 
5e00: 63 6f 6e 73 65 71 75 65 6e 74 6c 79 20 69 74 20  consequently it 
5e10: 69 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 63  it possible to c
5e20: 61 63 68 65 20 63 65 72 74 61 69 6e 20 70 72 65  ache certain pre
5e30: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73  pared statements
5e40: 0a 20 20 20 20 20 2a 20 73 75 63 68 20 61 73 20  .     * such as 
5e50: 53 45 4c 45 43 54 20 6f 72 20 49 4e 53 45 52 54  SELECT or INSERT
5e60: 2f 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e  /UPDATE statemen
5e70: 74 73 2e 20 20 49 66 20 74 68 65 20 73 74 61 74  ts.  If the stat
5e80: 65 6d 65 6e 74 20 69 73 20 63 61 63 68 65 61 62  ement is cacheab
5e90: 6c 65 2c 0a 20 20 20 20 20 2a 20 74 68 65 6e 20  le,.     * then 
5ea0: 69 74 20 77 69 6c 6c 20 62 65 20 73 74 6f 72 65  it will be store
5eb0: 64 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 66  d in the cache f
5ec0: 6f 72 20 6c 61 74 65 72 20 61 6e 64 20 72 65 75  or later and reu
5ed0: 73 65 64 20 69 66 20 70 6f 73 73 69 62 6c 65 2e  sed if possible.
5ee0: 0a 20 20 20 20 20 2a 20 3c 2f 70 3e 0a 20 20 20  .     * </p>.   
5ef0: 20 20 2a 0a 20 20 20 20 20 2a 20 40 70 61 72 61    *.     * @para
5f00: 6d 20 73 71 6c 20 54 68 65 20 53 51 4c 20 73 74  m sql The SQL st
5f10: 61 74 65 6d 65 6e 74 20 74 6f 20 70 72 65 70 61  atement to prepa
5f20: 72 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61  re..     * @para
5f30: 6d 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  m connectionFlag
5f40: 73 20 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  s The connection
5f50: 20 66 6c 61 67 73 20 74 6f 20 75 73 65 20 69 66   flags to use if
5f60: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75   a connection mu
5f70: 73 74 20 62 65 0a 20 20 20 20 20 2a 20 61 63 71  st be.     * acq
5f80: 75 69 72 65 64 20 62 79 20 74 68 69 73 20 6f 70  uired by this op
5f90: 65 72 61 74 69 6f 6e 2e 20 20 52 65 66 65 72 20  eration.  Refer 
5fa0: 74 6f 20 7b 40 6c 69 6e 6b 20 53 51 4c 69 74 65  to {@link SQLite
5fb0: 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 7d 2e  ConnectionPool}.
5fc0: 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 63  .     * @param c
5fd0: 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61  ancellationSigna
5fe0: 6c 20 41 20 73 69 67 6e 61 6c 20 74 6f 20 63 61  l A signal to ca
5ff0: 6e 63 65 6c 20 74 68 65 20 6f 70 65 72 61 74 69  ncel the operati
6000: 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 20  on in progress, 
6010: 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65 2e  or null if none.
6020: 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 6f  .     * @param o
6030: 75 74 53 74 61 74 65 6d 65 6e 74 49 6e 66 6f 20  utStatementInfo 
6040: 54 68 65 20 7b 40 6c 69 6e 6b 20 53 51 4c 69 74  The {@link SQLit
6050: 65 53 74 61 74 65 6d 65 6e 74 49 6e 66 6f 7d 20  eStatementInfo} 
6060: 6f 62 6a 65 63 74 20 74 6f 20 70 6f 70 75 6c 61  object to popula
6070: 74 65 0a 20 20 20 20 20 2a 20 77 69 74 68 20 69  te.     * with i
6080: 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74  nformation about
6090: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 2c 20   the statement, 
60a0: 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65 2e  or null if none.
60b0: 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a 20 40  .     *.     * @
60c0: 74 68 72 6f 77 73 20 53 51 4c 69 74 65 45 78 63  throws SQLiteExc
60d0: 65 70 74 69 6f 6e 20 69 66 20 61 6e 20 65 72 72  eption if an err
60e0: 6f 72 20 6f 63 63 75 72 73 2c 20 73 75 63 68 20  or occurs, such 
60f0: 61 73 20 61 20 73 79 6e 74 61 78 20 65 72 72 6f  as a syntax erro
6100: 72 2e 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77  r..     * @throw
6110: 73 20 4f 70 65 72 61 74 69 6f 6e 43 61 6e 63 65  s OperationCance
6120: 6c 65 64 45 78 63 65 70 74 69 6f 6e 20 69 66 20  ledException if 
6130: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 77 61  the operation wa
6140: 73 20 63 61 6e 63 65 6c 65 64 2e 0a 20 20 20 20  s canceled..    
6150: 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 76   */.    public v
6160: 6f 69 64 20 70 72 65 70 61 72 65 28 53 74 72 69  oid prepare(Stri
6170: 6e 67 20 73 71 6c 2c 20 69 6e 74 20 63 6f 6e 6e  ng sql, int conn
6180: 65 63 74 69 6f 6e 46 6c 61 67 73 2c 20 43 61 6e  ectionFlags, Can
6190: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 20  cellationSignal 
61a0: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
61b0: 61 6c 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  al,.            
61c0: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 49  SQLiteStatementI
61d0: 6e 66 6f 20 6f 75 74 53 74 61 74 65 6d 65 6e 74  nfo outStatement
61e0: 49 6e 66 6f 29 20 7b 0a 20 20 20 20 20 20 20 20  Info) {.        
61f0: 69 66 20 28 73 71 6c 20 3d 3d 20 6e 75 6c 6c 29  if (sql == null)
6200: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 74   {.            t
6210: 68 72 6f 77 20 6e 65 77 20 49 6c 6c 65 67 61 6c  hrow new Illegal
6220: 41 72 67 75 6d 65 6e 74 45 78 63 65 70 74 69 6f  ArgumentExceptio
6230: 6e 28 22 73 71 6c 20 6d 75 73 74 20 6e 6f 74 20  n("sql must not 
6240: 62 65 20 6e 75 6c 6c 2e 22 29 3b 0a 20 20 20 20  be null.");.    
6250: 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69      }..        i
6260: 66 20 28 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53  f (cancellationS
6270: 69 67 6e 61 6c 20 21 3d 20 6e 75 6c 6c 29 20 7b  ignal != null) {
6280: 0a 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e  .            can
6290: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 2e  cellationSignal.
62a0: 74 68 72 6f 77 49 66 43 61 6e 63 65 6c 65 64 28  throwIfCanceled(
62b0: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20  );.        }..  
62c0: 20 20 20 20 20 20 61 63 71 75 69 72 65 43 6f 6e        acquireCon
62d0: 6e 65 63 74 69 6f 6e 28 73 71 6c 2c 20 63 6f 6e  nection(sql, con
62e0: 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c 20 63 61  nectionFlags, ca
62f0: 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c  ncellationSignal
6300: 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f  ); // might thro
6310: 77 0a 20 20 20 20 20 20 20 20 74 72 79 20 7b 0a  w.        try {.
6320: 20 20 20 20 20 20 20 20 20 20 20 20 6d 43 6f 6e              mCon
6330: 6e 65 63 74 69 6f 6e 2e 70 72 65 70 61 72 65 28  nection.prepare(
6340: 73 71 6c 2c 20 6f 75 74 53 74 61 74 65 6d 65 6e  sql, outStatemen
6350: 74 49 6e 66 6f 29 3b 20 2f 2f 20 6d 69 67 68 74  tInfo); // might
6360: 20 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20 7d   throw.        }
6370: 20 66 69 6e 61 6c 6c 79 20 7b 0a 20 20 20 20 20   finally {.     
6380: 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 43 6f         releaseCo
6390: 6e 6e 65 63 74 69 6f 6e 28 29 3b 20 2f 2f 20 6d  nnection(); // m
63a0: 69 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20 20  ight throw.     
63b0: 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20     }.    }..    
63c0: 2f 2a 2a 0a 20 20 20 20 20 2a 20 45 78 65 63 75  /**.     * Execu
63d0: 74 65 73 20 61 20 73 74 61 74 65 6d 65 6e 74 20  tes a statement 
63e0: 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 72 65  that does not re
63f0: 74 75 72 6e 20 61 20 72 65 73 75 6c 74 2e 0a 20  turn a result.. 
6400: 20 20 20 20 2a 0a 20 20 20 20 20 2a 20 40 70 61      *.     * @pa
6410: 72 61 6d 20 73 71 6c 20 54 68 65 20 53 51 4c 20  ram sql The SQL 
6420: 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 65 78 65  statement to exe
6430: 63 75 74 65 2e 0a 20 20 20 20 20 2a 20 40 70 61  cute..     * @pa
6440: 72 61 6d 20 62 69 6e 64 41 72 67 73 20 54 68 65  ram bindArgs The
6450: 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 62 69   arguments to bi
6460: 6e 64 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e  nd, or null if n
6470: 6f 6e 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72  one..     * @par
6480: 61 6d 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  am connectionFla
6490: 67 73 20 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f  gs The connectio
64a0: 6e 20 66 6c 61 67 73 20 74 6f 20 75 73 65 20 69  n flags to use i
64b0: 66 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d  f a connection m
64c0: 75 73 74 20 62 65 0a 20 20 20 20 20 2a 20 61 63  ust be.     * ac
64d0: 71 75 69 72 65 64 20 62 79 20 74 68 69 73 20 6f  quired by this o
64e0: 70 65 72 61 74 69 6f 6e 2e 20 20 52 65 66 65 72  peration.  Refer
64f0: 20 74 6f 20 7b 40 6c 69 6e 6b 20 53 51 4c 69 74   to {@link SQLit
6500: 65 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 7d  eConnectionPool}
6510: 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20  ..     * @param 
6520: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
6530: 61 6c 20 41 20 73 69 67 6e 61 6c 20 74 6f 20 63  al A signal to c
6540: 61 6e 63 65 6c 20 74 68 65 20 6f 70 65 72 61 74  ancel the operat
6550: 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c  ion in progress,
6560: 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65   or null if none
6570: 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a 20  ..     *.     * 
6580: 40 74 68 72 6f 77 73 20 53 51 4c 69 74 65 45 78  @throws SQLiteEx
6590: 63 65 70 74 69 6f 6e 20 69 66 20 61 6e 20 65 72  ception if an er
65a0: 72 6f 72 20 6f 63 63 75 72 73 2c 20 73 75 63 68  ror occurs, such
65b0: 20 61 73 20 61 20 73 79 6e 74 61 78 20 65 72 72   as a syntax err
65c0: 6f 72 0a 20 20 20 20 20 2a 20 6f 72 20 69 6e 76  or.     * or inv
65d0: 61 6c 69 64 20 6e 75 6d 62 65 72 20 6f 66 20 62  alid number of b
65e0: 69 6e 64 20 61 72 67 75 6d 65 6e 74 73 2e 0a 20  ind arguments.. 
65f0: 20 20 20 20 2a 20 40 74 68 72 6f 77 73 20 4f 70      * @throws Op
6600: 65 72 61 74 69 6f 6e 43 61 6e 63 65 6c 65 64 45  erationCanceledE
6610: 78 63 65 70 74 69 6f 6e 20 69 66 20 74 68 65 20  xception if the 
6620: 6f 70 65 72 61 74 69 6f 6e 20 77 61 73 20 63 61  operation was ca
6630: 6e 63 65 6c 65 64 2e 0a 20 20 20 20 20 2a 2f 0a  nceled..     */.
6640: 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69 64 20      public void 
6650: 65 78 65 63 75 74 65 28 53 74 72 69 6e 67 20 73  execute(String s
6660: 71 6c 2c 20 4f 62 6a 65 63 74 5b 5d 20 62 69 6e  ql, Object[] bin
6670: 64 41 72 67 73 2c 20 69 6e 74 20 63 6f 6e 6e 65  dArgs, int conne
6680: 63 74 69 6f 6e 46 6c 61 67 73 2c 0a 20 20 20 20  ctionFlags,.    
6690: 20 20 20 20 20 20 20 20 43 61 6e 63 65 6c 6c 61          Cancella
66a0: 74 69 6f 6e 53 69 67 6e 61 6c 20 63 61 6e 63 65  tionSignal cance
66b0: 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 20 7b  llationSignal) {
66c0: 0a 20 20 20 20 20 20 20 20 69 66 20 28 73 71 6c  .        if (sql
66d0: 20 3d 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20   == null) {.    
66e0: 20 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65          throw ne
66f0: 77 20 49 6c 6c 65 67 61 6c 41 72 67 75 6d 65 6e  w IllegalArgumen
6700: 74 45 78 63 65 70 74 69 6f 6e 28 22 73 71 6c 20  tException("sql 
6710: 6d 75 73 74 20 6e 6f 74 20 62 65 20 6e 75 6c 6c  must not be null
6720: 2e 22 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a  .");.        }..
6730: 20 20 20 20 20 20 20 20 69 66 20 28 65 78 65 63          if (exec
6740: 75 74 65 53 70 65 63 69 61 6c 28 73 71 6c 2c 20  uteSpecial(sql, 
6750: 62 69 6e 64 41 72 67 73 2c 20 63 6f 6e 6e 65 63  bindArgs, connec
6760: 74 69 6f 6e 46 6c 61 67 73 2c 20 63 61 6e 63 65  tionFlags, cance
6770: 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 29 20  llationSignal)) 
6780: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65  {.            re
6790: 74 75 72 6e 3b 0a 20 20 20 20 20 20 20 20 7d 0a  turn;.        }.
67a0: 0a 20 20 20 20 20 20 20 20 61 63 71 75 69 72 65  .        acquire
67b0: 43 6f 6e 6e 65 63 74 69 6f 6e 28 73 71 6c 2c 20  Connection(sql, 
67c0: 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c  connectionFlags,
67d0: 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67   cancellationSig
67e0: 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74  nal); // might t
67f0: 68 72 6f 77 0a 20 20 20 20 20 20 20 20 74 72 79  hrow.        try
6800: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d   {.            m
6810: 43 6f 6e 6e 65 63 74 69 6f 6e 2e 65 78 65 63 75  Connection.execu
6820: 74 65 28 73 71 6c 2c 20 62 69 6e 64 41 72 67 73  te(sql, bindArgs
6830: 2c 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69  , cancellationSi
6840: 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20  gnal); // might 
6850: 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20 7d 20  throw.        } 
6860: 66 69 6e 61 6c 6c 79 20 7b 0a 20 20 20 20 20 20  finally {.      
6870: 20 20 20 20 20 20 72 65 6c 65 61 73 65 43 6f 6e        releaseCon
6880: 6e 65 63 74 69 6f 6e 28 29 3b 20 2f 2f 20 6d 69  nection(); // mi
6890: 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20 20 20  ght throw.      
68a0: 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f    }.    }..    /
68b0: 2a 2a 0a 20 20 20 20 20 2a 20 45 78 65 63 75 74  **.     * Execut
68c0: 65 73 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74  es a statement t
68d0: 68 61 74 20 72 65 74 75 72 6e 73 20 61 20 73 69  hat returns a si
68e0: 6e 67 6c 65 20 3c 63 6f 64 65 3e 6c 6f 6e 67 3c  ngle <code>long<
68f0: 2f 63 6f 64 65 3e 20 72 65 73 75 6c 74 2e 0a 20  /code> result.. 
6900: 20 20 20 20 2a 0a 20 20 20 20 20 2a 20 40 70 61      *.     * @pa
6910: 72 61 6d 20 73 71 6c 20 54 68 65 20 53 51 4c 20  ram sql The SQL 
6920: 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 65 78 65  statement to exe
6930: 63 75 74 65 2e 0a 20 20 20 20 20 2a 20 40 70 61  cute..     * @pa
6940: 72 61 6d 20 62 69 6e 64 41 72 67 73 20 54 68 65  ram bindArgs The
6950: 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 62 69   arguments to bi
6960: 6e 64 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e  nd, or null if n
6970: 6f 6e 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72  one..     * @par
6980: 61 6d 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  am connectionFla
6990: 67 73 20 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f  gs The connectio
69a0: 6e 20 66 6c 61 67 73 20 74 6f 20 75 73 65 20 69  n flags to use i
69b0: 66 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d  f a connection m
69c0: 75 73 74 20 62 65 0a 20 20 20 20 20 2a 20 61 63  ust be.     * ac
69d0: 71 75 69 72 65 64 20 62 79 20 74 68 69 73 20 6f  quired by this o
69e0: 70 65 72 61 74 69 6f 6e 2e 20 20 52 65 66 65 72  peration.  Refer
69f0: 20 74 6f 20 7b 40 6c 69 6e 6b 20 53 51 4c 69 74   to {@link SQLit
6a00: 65 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 7d  eConnectionPool}
6a10: 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20  ..     * @param 
6a20: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
6a30: 61 6c 20 41 20 73 69 67 6e 61 6c 20 74 6f 20 63  al A signal to c
6a40: 61 6e 63 65 6c 20 74 68 65 20 6f 70 65 72 61 74  ancel the operat
6a50: 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c  ion in progress,
6a60: 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65   or null if none
6a70: 2e 0a 20 20 20 20 20 2a 20 40 72 65 74 75 72 6e  ..     * @return
6a80: 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68   The value of th
6a90: 65 20 66 69 72 73 74 20 63 6f 6c 75 6d 6e 20 69  e first column i
6aa0: 6e 20 74 68 65 20 66 69 72 73 74 20 72 6f 77 20  n the first row 
6ab0: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 73 65  of the result se
6ac0: 74 0a 20 20 20 20 20 2a 20 61 73 20 61 20 3c 63  t.     * as a <c
6ad0: 6f 64 65 3e 6c 6f 6e 67 3c 2f 63 6f 64 65 3e 2c  ode>long</code>,
6ae0: 20 6f 72 20 7a 65 72 6f 20 69 66 20 6e 6f 6e 65   or zero if none
6af0: 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a 20  ..     *.     * 
6b00: 40 74 68 72 6f 77 73 20 53 51 4c 69 74 65 45 78  @throws SQLiteEx
6b10: 63 65 70 74 69 6f 6e 20 69 66 20 61 6e 20 65 72  ception if an er
6b20: 72 6f 72 20 6f 63 63 75 72 73 2c 20 73 75 63 68  ror occurs, such
6b30: 20 61 73 20 61 20 73 79 6e 74 61 78 20 65 72 72   as a syntax err
6b40: 6f 72 0a 20 20 20 20 20 2a 20 6f 72 20 69 6e 76  or.     * or inv
6b50: 61 6c 69 64 20 6e 75 6d 62 65 72 20 6f 66 20 62  alid number of b
6b60: 69 6e 64 20 61 72 67 75 6d 65 6e 74 73 2e 0a 20  ind arguments.. 
6b70: 20 20 20 20 2a 20 40 74 68 72 6f 77 73 20 4f 70      * @throws Op
6b80: 65 72 61 74 69 6f 6e 43 61 6e 63 65 6c 65 64 45  erationCanceledE
6b90: 78 63 65 70 74 69 6f 6e 20 69 66 20 74 68 65 20  xception if the 
6ba0: 6f 70 65 72 61 74 69 6f 6e 20 77 61 73 20 63 61  operation was ca
6bb0: 6e 63 65 6c 65 64 2e 0a 20 20 20 20 20 2a 2f 0a  nceled..     */.
6bc0: 20 20 20 20 70 75 62 6c 69 63 20 6c 6f 6e 67 20      public long 
6bd0: 65 78 65 63 75 74 65 46 6f 72 4c 6f 6e 67 28 53  executeForLong(S
6be0: 74 72 69 6e 67 20 73 71 6c 2c 20 4f 62 6a 65 63  tring sql, Objec
6bf0: 74 5b 5d 20 62 69 6e 64 41 72 67 73 2c 20 69 6e  t[] bindArgs, in
6c00: 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  t connectionFlag
6c10: 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 43  s,.            C
6c20: 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61  ancellationSigna
6c30: 6c 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69  l cancellationSi
6c40: 67 6e 61 6c 29 20 7b 0a 20 20 20 20 20 20 20 20  gnal) {.        
6c50: 69 66 20 28 73 71 6c 20 3d 3d 20 6e 75 6c 6c 29  if (sql == null)
6c60: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 74   {.            t
6c70: 68 72 6f 77 20 6e 65 77 20 49 6c 6c 65 67 61 6c  hrow new Illegal
6c80: 41 72 67 75 6d 65 6e 74 45 78 63 65 70 74 69 6f  ArgumentExceptio
6c90: 6e 28 22 73 71 6c 20 6d 75 73 74 20 6e 6f 74 20  n("sql must not 
6ca0: 62 65 20 6e 75 6c 6c 2e 22 29 3b 0a 20 20 20 20  be null.");.    
6cb0: 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69      }..        i
6cc0: 66 20 28 65 78 65 63 75 74 65 53 70 65 63 69 61  f (executeSpecia
6cd0: 6c 28 73 71 6c 2c 20 62 69 6e 64 41 72 67 73 2c  l(sql, bindArgs,
6ce0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73   connectionFlags
6cf0: 2c 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69  , cancellationSi
6d00: 67 6e 61 6c 29 29 20 7b 0a 20 20 20 20 20 20 20  gnal)) {.       
6d10: 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20       return 0;. 
6d20: 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20         }..      
6d30: 20 20 61 63 71 75 69 72 65 43 6f 6e 6e 65 63 74    acquireConnect
6d40: 69 6f 6e 28 73 71 6c 2c 20 63 6f 6e 6e 65 63 74  ion(sql, connect
6d50: 69 6f 6e 46 6c 61 67 73 2c 20 63 61 6e 63 65 6c  ionFlags, cancel
6d60: 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f  lationSignal); /
6d70: 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20  / might throw.  
6d80: 20 20 20 20 20 20 74 72 79 20 7b 0a 20 20 20 20        try {.    
6d90: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d          return m
6da0: 43 6f 6e 6e 65 63 74 69 6f 6e 2e 65 78 65 63 75  Connection.execu
6db0: 74 65 46 6f 72 4c 6f 6e 67 28 73 71 6c 2c 20 62  teForLong(sql, b
6dc0: 69 6e 64 41 72 67 73 2c 20 63 61 6e 63 65 6c 6c  indArgs, cancell
6dd0: 61 74 69 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f 2f  ationSignal); //
6de0: 20 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20 20   might throw.   
6df0: 20 20 20 20 20 7d 20 66 69 6e 61 6c 6c 79 20 7b       } finally {
6e00: 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c  .            rel
6e10: 65 61 73 65 43 6f 6e 6e 65 63 74 69 6f 6e 28 29  easeConnection()
6e20: 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f 77  ; // might throw
6e30: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  .        }.    }
6e40: 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a  ..    /**.     *
6e50: 20 45 78 65 63 75 74 65 73 20 61 20 73 74 61 74   Executes a stat
6e60: 65 6d 65 6e 74 20 74 68 61 74 20 72 65 74 75 72  ement that retur
6e70: 6e 73 20 61 20 73 69 6e 67 6c 65 20 7b 40 6c 69  ns a single {@li
6e80: 6e 6b 20 53 74 72 69 6e 67 7d 20 72 65 73 75 6c  nk String} resul
6e90: 74 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20 2a  t..     *.     *
6ea0: 20 40 70 61 72 61 6d 20 73 71 6c 20 54 68 65 20   @param sql The 
6eb0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 6f  SQL statement to
6ec0: 20 65 78 65 63 75 74 65 2e 0a 20 20 20 20 20 2a   execute..     *
6ed0: 20 40 70 61 72 61 6d 20 62 69 6e 64 41 72 67 73   @param bindArgs
6ee0: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 74   The arguments t
6ef0: 6f 20 62 69 6e 64 2c 20 6f 72 20 6e 75 6c 6c 20  o bind, or null 
6f00: 69 66 20 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a 20  if none..     * 
6f10: 40 70 61 72 61 6d 20 63 6f 6e 6e 65 63 74 69 6f  @param connectio
6f20: 6e 46 6c 61 67 73 20 54 68 65 20 63 6f 6e 6e 65  nFlags The conne
6f30: 63 74 69 6f 6e 20 66 6c 61 67 73 20 74 6f 20 75  ction flags to u
6f40: 73 65 20 69 66 20 61 20 63 6f 6e 6e 65 63 74 69  se if a connecti
6f50: 6f 6e 20 6d 75 73 74 20 62 65 0a 20 20 20 20 20  on must be.     
6f60: 2a 20 61 63 71 75 69 72 65 64 20 62 79 20 74 68  * acquired by th
6f70: 69 73 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 52  is operation.  R
6f80: 65 66 65 72 20 74 6f 20 7b 40 6c 69 6e 6b 20 53  efer to {@link S
6f90: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 50  QLiteConnectionP
6fa0: 6f 6f 6c 7d 2e 0a 20 20 20 20 20 2a 20 40 70 61  ool}..     * @pa
6fb0: 72 61 6d 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e  ram cancellation
6fc0: 53 69 67 6e 61 6c 20 41 20 73 69 67 6e 61 6c 20  Signal A signal 
6fd0: 74 6f 20 63 61 6e 63 65 6c 20 74 68 65 20 6f 70  to cancel the op
6fe0: 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72  eration in progr
6ff0: 65 73 73 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20  ess, or null if 
7000: 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a 20 40 72 65  none..     * @re
7010: 74 75 72 6e 20 54 68 65 20 76 61 6c 75 65 20 6f  turn The value o
7020: 66 20 74 68 65 20 66 69 72 73 74 20 63 6f 6c 75  f the first colu
7030: 6d 6e 20 69 6e 20 74 68 65 20 66 69 72 73 74 20  mn in the first 
7040: 72 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c  row of the resul
7050: 74 20 73 65 74 0a 20 20 20 20 20 2a 20 61 73 20  t set.     * as 
7060: 61 20 3c 63 6f 64 65 3e 53 74 72 69 6e 67 3c 2f  a <code>String</
7070: 63 6f 64 65 3e 2c 20 6f 72 20 6e 75 6c 6c 20 69  code>, or null i
7080: 66 20 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a 0a 20  f none..     *. 
7090: 20 20 20 20 2a 20 40 74 68 72 6f 77 73 20 53 51      * @throws SQ
70a0: 4c 69 74 65 45 78 63 65 70 74 69 6f 6e 20 69 66  LiteException if
70b0: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
70c0: 2c 20 73 75 63 68 20 61 73 20 61 20 73 79 6e 74  , such as a synt
70d0: 61 78 20 65 72 72 6f 72 0a 20 20 20 20 20 2a 20  ax error.     * 
70e0: 6f 72 20 69 6e 76 61 6c 69 64 20 6e 75 6d 62 65  or invalid numbe
70f0: 72 20 6f 66 20 62 69 6e 64 20 61 72 67 75 6d 65  r of bind argume
7100: 6e 74 73 2e 0a 20 20 20 20 20 2a 20 40 74 68 72  nts..     * @thr
7110: 6f 77 73 20 4f 70 65 72 61 74 69 6f 6e 43 61 6e  ows OperationCan
7120: 63 65 6c 65 64 45 78 63 65 70 74 69 6f 6e 20 69  celedException i
7130: 66 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20  f the operation 
7140: 77 61 73 20 63 61 6e 63 65 6c 65 64 2e 0a 20 20  was canceled..  
7150: 20 20 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63     */.    public
7160: 20 53 74 72 69 6e 67 20 65 78 65 63 75 74 65 46   String executeF
7170: 6f 72 53 74 72 69 6e 67 28 53 74 72 69 6e 67 20  orString(String 
7180: 73 71 6c 2c 20 4f 62 6a 65 63 74 5b 5d 20 62 69  sql, Object[] bi
7190: 6e 64 41 72 67 73 2c 20 69 6e 74 20 63 6f 6e 6e  ndArgs, int conn
71a0: 65 63 74 69 6f 6e 46 6c 61 67 73 2c 0a 20 20 20  ectionFlags,.   
71b0: 20 20 20 20 20 20 20 20 20 43 61 6e 63 65 6c 6c           Cancell
71c0: 61 74 69 6f 6e 53 69 67 6e 61 6c 20 63 61 6e 63  ationSignal canc
71d0: 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 20  ellationSignal) 
71e0: 7b 0a 20 20 20 20 20 20 20 20 69 66 20 28 73 71  {.        if (sq
71f0: 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20  l == null) {.   
7200: 20 20 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e           throw n
7210: 65 77 20 49 6c 6c 65 67 61 6c 41 72 67 75 6d 65  ew IllegalArgume
7220: 6e 74 45 78 63 65 70 74 69 6f 6e 28 22 73 71 6c  ntException("sql
7230: 20 6d 75 73 74 20 6e 6f 74 20 62 65 20 6e 75 6c   must not be nul
7240: 6c 2e 22 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a  l.");.        }.
7250: 0a 20 20 20 20 20 20 20 20 69 66 20 28 65 78 65  .        if (exe
7260: 63 75 74 65 53 70 65 63 69 61 6c 28 73 71 6c 2c  cuteSpecial(sql,
7270: 20 62 69 6e 64 41 72 67 73 2c 20 63 6f 6e 6e 65   bindArgs, conne
7280: 63 74 69 6f 6e 46 6c 61 67 73 2c 20 63 61 6e 63  ctionFlags, canc
7290: 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 29  ellationSignal))
72a0: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72   {.            r
72b0: 65 74 75 72 6e 20 6e 75 6c 6c 3b 0a 20 20 20 20  eturn null;.    
72c0: 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 61      }..        a
72d0: 63 71 75 69 72 65 43 6f 6e 6e 65 63 74 69 6f 6e  cquireConnection
72e0: 28 73 71 6c 2c 20 63 6f 6e 6e 65 63 74 69 6f 6e  (sql, connection
72f0: 46 6c 61 67 73 2c 20 63 61 6e 63 65 6c 6c 61 74  Flags, cancellat
7300: 69 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f 2f 20 6d  ionSignal); // m
7310: 69 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20 20  ight throw.     
7320: 20 20 20 74 72 79 20 7b 0a 20 20 20 20 20 20 20     try {.       
7330: 20 20 20 20 20 72 65 74 75 72 6e 20 6d 43 6f 6e       return mCon
7340: 6e 65 63 74 69 6f 6e 2e 65 78 65 63 75 74 65 46  nection.executeF
7350: 6f 72 53 74 72 69 6e 67 28 73 71 6c 2c 20 62 69  orString(sql, bi
7360: 6e 64 41 72 67 73 2c 20 63 61 6e 63 65 6c 6c 61  ndArgs, cancella
7370: 74 69 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f 2f 20  tionSignal); // 
7380: 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20  might throw.    
7390: 20 20 20 20 7d 20 66 69 6e 61 6c 6c 79 20 7b 0a      } finally {.
73a0: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 65              rele
73b0: 61 73 65 43 6f 6e 6e 65 63 74 69 6f 6e 28 29 3b  aseConnection();
73c0: 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a   // might throw.
73d0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a          }.    }.
73e0: 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20  .    /**.     * 
73f0: 45 78 65 63 75 74 65 73 20 61 20 73 74 61 74 65  Executes a state
7400: 6d 65 6e 74 20 74 68 61 74 20 72 65 74 75 72 6e  ment that return
7410: 73 20 61 20 73 69 6e 67 6c 65 20 42 4c 4f 42 20  s a single BLOB 
7420: 72 65 73 75 6c 74 20 61 73 20 61 0a 20 20 20 20  result as a.    
7430: 20 2a 20 66 69 6c 65 20 64 65 73 63 72 69 70 74   * file descript
7440: 6f 72 20 74 6f 20 61 20 73 68 61 72 65 64 20 6d  or to a shared m
7450: 65 6d 6f 72 79 20 72 65 67 69 6f 6e 2e 0a 20 20  emory region..  
7460: 20 20 20 2a 0a 20 20 20 20 20 2a 20 40 70 61 72     *.     * @par
7470: 61 6d 20 73 71 6c 20 54 68 65 20 53 51 4c 20 73  am sql The SQL s
7480: 74 61 74 65 6d 65 6e 74 20 74 6f 20 65 78 65 63  tatement to exec
7490: 75 74 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72  ute..     * @par
74a0: 61 6d 20 62 69 6e 64 41 72 67 73 20 54 68 65 20  am bindArgs The 
74b0: 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 62 69 6e  arguments to bin
74c0: 64 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f  d, or null if no
74d0: 6e 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61  ne..     * @para
74e0: 6d 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  m connectionFlag
74f0: 73 20 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  s The connection
7500: 20 66 6c 61 67 73 20 74 6f 20 75 73 65 20 69 66   flags to use if
7510: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75   a connection mu
7520: 73 74 20 62 65 0a 20 20 20 20 20 2a 20 61 63 71  st be.     * acq
7530: 75 69 72 65 64 20 62 79 20 74 68 69 73 20 6f 70  uired by this op
7540: 65 72 61 74 69 6f 6e 2e 20 20 52 65 66 65 72 20  eration.  Refer 
7550: 74 6f 20 7b 40 6c 69 6e 6b 20 53 51 4c 69 74 65  to {@link SQLite
7560: 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 7d 2e  ConnectionPool}.
7570: 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 63  .     * @param c
7580: 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61  ancellationSigna
7590: 6c 20 41 20 73 69 67 6e 61 6c 20 74 6f 20 63 61  l A signal to ca
75a0: 6e 63 65 6c 20 74 68 65 20 6f 70 65 72 61 74 69  ncel the operati
75b0: 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 20  on in progress, 
75c0: 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65 2e  or null if none.
75d0: 0a 20 20 20 20 20 2a 20 40 72 65 74 75 72 6e 20  .     * @return 
75e0: 54 68 65 20 66 69 6c 65 20 64 65 73 63 72 69 70  The file descrip
75f0: 74 6f 72 20 66 6f 72 20 61 20 73 68 61 72 65 64  tor for a shared
7600: 20 6d 65 6d 6f 72 79 20 72 65 67 69 6f 6e 20 74   memory region t
7610: 68 61 74 20 63 6f 6e 74 61 69 6e 73 0a 20 20 20  hat contains.   
7620: 20 20 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66    * the value of
7630: 20 74 68 65 20 66 69 72 73 74 20 63 6f 6c 75 6d   the first colum
7640: 6e 20 69 6e 20 74 68 65 20 66 69 72 73 74 20 72  n in the first r
7650: 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74  ow of the result
7660: 20 73 65 74 20 61 73 20 61 20 42 4c 4f 42 2c 0a   set as a BLOB,.
7670: 20 20 20 20 20 2a 20 6f 72 20 6e 75 6c 6c 20 69       * or null i
7680: 66 20 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a 0a 20  f none..     *. 
7690: 20 20 20 20 2a 20 40 74 68 72 6f 77 73 20 53 51      * @throws SQ
76a0: 4c 69 74 65 45 78 63 65 70 74 69 6f 6e 20 69 66  LiteException if
76b0: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
76c0: 2c 20 73 75 63 68 20 61 73 20 61 20 73 79 6e 74  , such as a synt
76d0: 61 78 20 65 72 72 6f 72 0a 20 20 20 20 20 2a 20  ax error.     * 
76e0: 6f 72 20 69 6e 76 61 6c 69 64 20 6e 75 6d 62 65  or invalid numbe
76f0: 72 20 6f 66 20 62 69 6e 64 20 61 72 67 75 6d 65  r of bind argume
7700: 6e 74 73 2e 0a 20 20 20 20 20 2a 20 40 74 68 72  nts..     * @thr
7710: 6f 77 73 20 4f 70 65 72 61 74 69 6f 6e 43 61 6e  ows OperationCan
7720: 63 65 6c 65 64 45 78 63 65 70 74 69 6f 6e 20 69  celedException i
7730: 66 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20  f the operation 
7740: 77 61 73 20 63 61 6e 63 65 6c 65 64 2e 0a 20 20  was canceled..  
7750: 20 20 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63     */.    public
7760: 20 50 61 72 63 65 6c 46 69 6c 65 44 65 73 63 72   ParcelFileDescr
7770: 69 70 74 6f 72 20 65 78 65 63 75 74 65 46 6f 72  iptor executeFor
7780: 42 6c 6f 62 46 69 6c 65 44 65 73 63 72 69 70 74  BlobFileDescript
7790: 6f 72 28 53 74 72 69 6e 67 20 73 71 6c 2c 20 4f  or(String sql, O
77a0: 62 6a 65 63 74 5b 5d 20 62 69 6e 64 41 72 67 73  bject[] bindArgs
77b0: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e  ,.            in
77c0: 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  t connectionFlag
77d0: 73 2c 20 43 61 6e 63 65 6c 6c 61 74 69 6f 6e 53  s, CancellationS
77e0: 69 67 6e 61 6c 20 63 61 6e 63 65 6c 6c 61 74 69  ignal cancellati
77f0: 6f 6e 53 69 67 6e 61 6c 29 20 7b 0a 20 20 20 20  onSignal) {.    
7800: 20 20 20 20 69 66 20 28 73 71 6c 20 3d 3d 20 6e      if (sql == n
7810: 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 20  ull) {.         
7820: 20 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6c 6c     throw new Ill
7830: 65 67 61 6c 41 72 67 75 6d 65 6e 74 45 78 63 65  egalArgumentExce
7840: 70 74 69 6f 6e 28 22 73 71 6c 20 6d 75 73 74 20  ption("sql must 
7850: 6e 6f 74 20 62 65 20 6e 75 6c 6c 2e 22 29 3b 0a  not be null.");.
7860: 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20          }..     
7870: 20 20 20 69 66 20 28 65 78 65 63 75 74 65 53 70     if (executeSp
7880: 65 63 69 61 6c 28 73 71 6c 2c 20 62 69 6e 64 41  ecial(sql, bindA
7890: 72 67 73 2c 20 63 6f 6e 6e 65 63 74 69 6f 6e 46  rgs, connectionF
78a0: 6c 61 67 73 2c 20 63 61 6e 63 65 6c 6c 61 74 69  lags, cancellati
78b0: 6f 6e 53 69 67 6e 61 6c 29 29 20 7b 0a 20 20 20  onSignal)) {.   
78c0: 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20           return 
78d0: 6e 75 6c 6c 3b 0a 20 20 20 20 20 20 20 20 7d 0a  null;.        }.
78e0: 0a 20 20 20 20 20 20 20 20 61 63 71 75 69 72 65  .        acquire
78f0: 43 6f 6e 6e 65 63 74 69 6f 6e 28 73 71 6c 2c 20  Connection(sql, 
7900: 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c  connectionFlags,
7910: 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67   cancellationSig
7920: 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74  nal); // might t
7930: 68 72 6f 77 0a 20 20 20 20 20 20 20 20 74 72 79  hrow.        try
7940: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72   {.            r
7950: 65 74 75 72 6e 20 6d 43 6f 6e 6e 65 63 74 69 6f  eturn mConnectio
7960: 6e 2e 65 78 65 63 75 74 65 46 6f 72 42 6c 6f 62  n.executeForBlob
7970: 46 69 6c 65 44 65 73 63 72 69 70 74 6f 72 28 73  FileDescriptor(s
7980: 71 6c 2c 20 62 69 6e 64 41 72 67 73 2c 0a 20 20  ql, bindArgs,.  
7990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
79a0: 20 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69    cancellationSi
79b0: 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20  gnal); // might 
79c0: 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20 7d 20  throw.        } 
79d0: 66 69 6e 61 6c 6c 79 20 7b 0a 20 20 20 20 20 20  finally {.      
79e0: 20 20 20 20 20 20 72 65 6c 65 61 73 65 43 6f 6e        releaseCon
79f0: 6e 65 63 74 69 6f 6e 28 29 3b 20 2f 2f 20 6d 69  nection(); // mi
7a00: 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20 20 20  ght throw.      
7a10: 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f    }.    }..    /
7a20: 2a 2a 0a 20 20 20 20 20 2a 20 45 78 65 63 75 74  **.     * Execut
7a30: 65 73 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74  es a statement t
7a40: 68 61 74 20 72 65 74 75 72 6e 73 20 61 20 63 6f  hat returns a co
7a50: 75 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d 62 65  unt of the numbe
7a60: 72 20 6f 66 20 72 6f 77 73 0a 20 20 20 20 20 2a  r of rows.     *
7a70: 20 74 68 61 74 20 77 65 72 65 20 63 68 61 6e 67   that were chang
7a80: 65 64 2e 20 20 55 73 65 20 66 6f 72 20 55 50 44  ed.  Use for UPD
7a90: 41 54 45 20 6f 72 20 44 45 4c 45 54 45 20 53 51  ATE or DELETE SQ
7aa0: 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20  L statements..  
7ab0: 20 20 20 2a 0a 20 20 20 20 20 2a 20 40 70 61 72     *.     * @par
7ac0: 61 6d 20 73 71 6c 20 54 68 65 20 53 51 4c 20 73  am sql The SQL s
7ad0: 74 61 74 65 6d 65 6e 74 20 74 6f 20 65 78 65 63  tatement to exec
7ae0: 75 74 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72  ute..     * @par
7af0: 61 6d 20 62 69 6e 64 41 72 67 73 20 54 68 65 20  am bindArgs The 
7b00: 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 62 69 6e  arguments to bin
7b10: 64 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f  d, or null if no
7b20: 6e 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61  ne..     * @para
7b30: 6d 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  m connectionFlag
7b40: 73 20 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  s The connection
7b50: 20 66 6c 61 67 73 20 74 6f 20 75 73 65 20 69 66   flags to use if
7b60: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75   a connection mu
7b70: 73 74 20 62 65 0a 20 20 20 20 20 2a 20 61 63 71  st be.     * acq
7b80: 75 69 72 65 64 20 62 79 20 74 68 69 73 20 6f 70  uired by this op
7b90: 65 72 61 74 69 6f 6e 2e 20 20 52 65 66 65 72 20  eration.  Refer 
7ba0: 74 6f 20 7b 40 6c 69 6e 6b 20 53 51 4c 69 74 65  to {@link SQLite
7bb0: 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 7d 2e  ConnectionPool}.
7bc0: 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 63  .     * @param c
7bd0: 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61  ancellationSigna
7be0: 6c 20 41 20 73 69 67 6e 61 6c 20 74 6f 20 63 61  l A signal to ca
7bf0: 6e 63 65 6c 20 74 68 65 20 6f 70 65 72 61 74 69  ncel the operati
7c00: 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 20  on in progress, 
7c10: 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65 2e  or null if none.
7c20: 0a 20 20 20 20 20 2a 20 40 72 65 74 75 72 6e 20  .     * @return 
7c30: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f  The number of ro
7c40: 77 73 20 74 68 61 74 20 77 65 72 65 20 63 68 61  ws that were cha
7c50: 6e 67 65 64 2e 0a 20 20 20 20 20 2a 0a 20 20 20  nged..     *.   
7c60: 20 20 2a 20 40 74 68 72 6f 77 73 20 53 51 4c 69    * @throws SQLi
7c70: 74 65 45 78 63 65 70 74 69 6f 6e 20 69 66 20 61  teException if a
7c80: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20  n error occurs, 
7c90: 73 75 63 68 20 61 73 20 61 20 73 79 6e 74 61 78  such as a syntax
7ca0: 20 65 72 72 6f 72 0a 20 20 20 20 20 2a 20 6f 72   error.     * or
7cb0: 20 69 6e 76 61 6c 69 64 20 6e 75 6d 62 65 72 20   invalid number 
7cc0: 6f 66 20 62 69 6e 64 20 61 72 67 75 6d 65 6e 74  of bind argument
7cd0: 73 2e 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77  s..     * @throw
7ce0: 73 20 4f 70 65 72 61 74 69 6f 6e 43 61 6e 63 65  s OperationCance
7cf0: 6c 65 64 45 78 63 65 70 74 69 6f 6e 20 69 66 20  ledException if 
7d00: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 77 61  the operation wa
7d10: 73 20 63 61 6e 63 65 6c 65 64 2e 0a 20 20 20 20  s canceled..    
7d20: 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 69   */.    public i
7d30: 6e 74 20 65 78 65 63 75 74 65 46 6f 72 43 68 61  nt executeForCha
7d40: 6e 67 65 64 52 6f 77 43 6f 75 6e 74 28 53 74 72  ngedRowCount(Str
7d50: 69 6e 67 20 73 71 6c 2c 20 4f 62 6a 65 63 74 5b  ing sql, Object[
7d60: 5d 20 62 69 6e 64 41 72 67 73 2c 20 69 6e 74 20  ] bindArgs, int 
7d70: 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c  connectionFlags,
7d80: 0a 20 20 20 20 20 20 20 20 20 20 20 20 43 61 6e  .            Can
7d90: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 20  cellationSignal 
7da0: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
7db0: 61 6c 29 20 7b 0a 20 20 20 20 20 20 20 20 69 66  al) {.        if
7dc0: 20 28 73 71 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7b   (sql == null) {
7dd0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72  .            thr
7de0: 6f 77 20 6e 65 77 20 49 6c 6c 65 67 61 6c 41 72  ow new IllegalAr
7df0: 67 75 6d 65 6e 74 45 78 63 65 70 74 69 6f 6e 28  gumentException(
7e00: 22 73 71 6c 20 6d 75 73 74 20 6e 6f 74 20 62 65  "sql must not be
7e10: 20 6e 75 6c 6c 2e 22 29 3b 0a 20 20 20 20 20 20   null.");.      
7e20: 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 66 20    }..        if 
7e30: 28 65 78 65 63 75 74 65 53 70 65 63 69 61 6c 28  (executeSpecial(
7e40: 73 71 6c 2c 20 62 69 6e 64 41 72 67 73 2c 20 63  sql, bindArgs, c
7e50: 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c 20  onnectionFlags, 
7e60: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
7e70: 61 6c 29 29 20 7b 0a 20 20 20 20 20 20 20 20 20  al)) {.         
7e80: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20     return 0;.   
7e90: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20       }..        
7ea0: 61 63 71 75 69 72 65 43 6f 6e 6e 65 63 74 69 6f  acquireConnectio
7eb0: 6e 28 73 71 6c 2c 20 63 6f 6e 6e 65 63 74 69 6f  n(sql, connectio
7ec0: 6e 46 6c 61 67 73 2c 20 63 61 6e 63 65 6c 6c 61  nFlags, cancella
7ed0: 74 69 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f 2f 20  tionSignal); // 
7ee0: 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20  might throw.    
7ef0: 20 20 20 20 74 72 79 20 7b 0a 20 20 20 20 20 20      try {.      
7f00: 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 43 6f        return mCo
7f10: 6e 6e 65 63 74 69 6f 6e 2e 65 78 65 63 75 74 65  nnection.execute
7f20: 46 6f 72 43 68 61 6e 67 65 64 52 6f 77 43 6f 75  ForChangedRowCou
7f30: 6e 74 28 73 71 6c 2c 20 62 69 6e 64 41 72 67 73  nt(sql, bindArgs
7f40: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
7f50: 20 20 20 20 20 20 63 61 6e 63 65 6c 6c 61 74 69        cancellati
7f60: 6f 6e 53 69 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69  onSignal); // mi
7f70: 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20 20 20  ght throw.      
7f80: 20 20 7d 20 66 69 6e 61 6c 6c 79 20 7b 0a 20 20    } finally {.  
7f90: 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 73            releas
7fa0: 65 43 6f 6e 6e 65 63 74 69 6f 6e 28 29 3b 20 2f  eConnection(); /
7fb0: 2f 20 6d 69 67 68 74 20 74 68 72 6f 77 0a 20 20  / might throw.  
7fc0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20        }.    }.. 
7fd0: 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 45 78     /**.     * Ex
7fe0: 65 63 75 74 65 73 20 61 20 73 74 61 74 65 6d 65  ecutes a stateme
7ff0: 6e 74 20 74 68 61 74 20 72 65 74 75 72 6e 73 20  nt that returns 
8000: 74 68 65 20 72 6f 77 20 69 64 20 6f 66 20 74 68  the row id of th
8010: 65 20 6c 61 73 74 20 72 6f 77 20 69 6e 73 65 72  e last row inser
8020: 74 65 64 0a 20 20 20 20 20 2a 20 62 79 20 74 68  ted.     * by th
8030: 65 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 55 73  e statement.  Us
8040: 65 20 66 6f 72 20 49 4e 53 45 52 54 20 53 51 4c  e for INSERT SQL
8050: 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 20 20 20   statements..   
8060: 20 20 2a 0a 20 20 20 20 20 2a 20 40 70 61 72 61    *.     * @para
8070: 6d 20 73 71 6c 20 54 68 65 20 53 51 4c 20 73 74  m sql The SQL st
8080: 61 74 65 6d 65 6e 74 20 74 6f 20 65 78 65 63 75  atement to execu
8090: 74 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61  te..     * @para
80a0: 6d 20 62 69 6e 64 41 72 67 73 20 54 68 65 20 61  m bindArgs The a
80b0: 72 67 75 6d 65 6e 74 73 20 74 6f 20 62 69 6e 64  rguments to bind
80c0: 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e  , or null if non
80d0: 65 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d  e..     * @param
80e0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73   connectionFlags
80f0: 20 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20   The connection 
8100: 66 6c 61 67 73 20 74 6f 20 75 73 65 20 69 66 20  flags to use if 
8110: 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75 73  a connection mus
8120: 74 20 62 65 0a 20 20 20 20 20 2a 20 61 63 71 75  t be.     * acqu
8130: 69 72 65 64 20 62 79 20 74 68 69 73 20 6f 70 65  ired by this ope
8140: 72 61 74 69 6f 6e 2e 20 20 52 65 66 65 72 20 74  ration.  Refer t
8150: 6f 20 7b 40 6c 69 6e 6b 20 53 51 4c 69 74 65 43  o {@link SQLiteC
8160: 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c 7d 2e 0a  onnectionPool}..
8170: 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 63 61       * @param ca
8180: 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c  ncellationSignal
8190: 20 41 20 73 69 67 6e 61 6c 20 74 6f 20 63 61 6e   A signal to can
81a0: 63 65 6c 20 74 68 65 20 6f 70 65 72 61 74 69 6f  cel the operatio
81b0: 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 20 6f  n in progress, o
81c0: 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65 2e 0a  r null if none..
81d0: 20 20 20 20 20 2a 20 40 72 65 74 75 72 6e 20 54       * @return T
81e0: 68 65 20 72 6f 77 20 69 64 20 6f 66 20 74 68 65  he row id of the
81f0: 20 6c 61 73 74 20 72 6f 77 20 74 68 61 74 20 77   last row that w
8200: 61 73 20 69 6e 73 65 72 74 65 64 2c 20 6f 72 20  as inserted, or 
8210: 30 20 69 66 20 6e 6f 6e 65 2e 0a 20 20 20 20 20  0 if none..     
8220: 2a 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77 73  *.     * @throws
8230: 20 53 51 4c 69 74 65 45 78 63 65 70 74 69 6f 6e   SQLiteException
8240: 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   if an error occ
8250: 75 72 73 2c 20 73 75 63 68 20 61 73 20 61 20 73  urs, such as a s
8260: 79 6e 74 61 78 20 65 72 72 6f 72 0a 20 20 20 20  yntax error.    
8270: 20 2a 20 6f 72 20 69 6e 76 61 6c 69 64 20 6e 75   * or invalid nu
8280: 6d 62 65 72 20 6f 66 20 62 69 6e 64 20 61 72 67  mber of bind arg
8290: 75 6d 65 6e 74 73 2e 0a 20 20 20 20 20 2a 20 40  uments..     * @
82a0: 74 68 72 6f 77 73 20 4f 70 65 72 61 74 69 6f 6e  throws Operation
82b0: 43 61 6e 63 65 6c 65 64 45 78 63 65 70 74 69 6f  CanceledExceptio
82c0: 6e 20 69 66 20 74 68 65 20 6f 70 65 72 61 74 69  n if the operati
82d0: 6f 6e 20 77 61 73 20 63 61 6e 63 65 6c 65 64 2e  on was canceled.
82e0: 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62  .     */.    pub
82f0: 6c 69 63 20 6c 6f 6e 67 20 65 78 65 63 75 74 65  lic long execute
8300: 46 6f 72 4c 61 73 74 49 6e 73 65 72 74 65 64 52  ForLastInsertedR
8310: 6f 77 49 64 28 53 74 72 69 6e 67 20 73 71 6c 2c  owId(String sql,
8320: 20 4f 62 6a 65 63 74 5b 5d 20 62 69 6e 64 41 72   Object[] bindAr
8330: 67 73 2c 20 69 6e 74 20 63 6f 6e 6e 65 63 74 69  gs, int connecti
8340: 6f 6e 46 6c 61 67 73 2c 0a 20 20 20 20 20 20 20  onFlags,.       
8350: 20 20 20 20 20 43 61 6e 63 65 6c 6c 61 74 69 6f       Cancellatio
8360: 6e 53 69 67 6e 61 6c 20 63 61 6e 63 65 6c 6c 61  nSignal cancella
8370: 74 69 6f 6e 53 69 67 6e 61 6c 29 20 7b 0a 20 20  tionSignal) {.  
8380: 20 20 20 20 20 20 69 66 20 28 73 71 6c 20 3d 3d        if (sql ==
8390: 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20 20   null) {.       
83a0: 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20 49       throw new I
83b0: 6c 6c 65 67 61 6c 41 72 67 75 6d 65 6e 74 45 78  llegalArgumentEx
83c0: 63 65 70 74 69 6f 6e 28 22 73 71 6c 20 6d 75 73  ception("sql mus
83d0: 74 20 6e 6f 74 20 62 65 20 6e 75 6c 6c 2e 22 29  t not be null.")
83e0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20  ;.        }..   
83f0: 20 20 20 20 20 69 66 20 28 65 78 65 63 75 74 65       if (execute
8400: 53 70 65 63 69 61 6c 28 73 71 6c 2c 20 62 69 6e  Special(sql, bin
8410: 64 41 72 67 73 2c 20 63 6f 6e 6e 65 63 74 69 6f  dArgs, connectio
8420: 6e 46 6c 61 67 73 2c 20 63 61 6e 63 65 6c 6c 61  nFlags, cancella
8430: 74 69 6f 6e 53 69 67 6e 61 6c 29 29 20 7b 0a 20  tionSignal)) {. 
8440: 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72             retur
8450: 6e 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a  n 0;.        }..
8460: 20 20 20 20 20 20 20 20 61 63 71 75 69 72 65 43          acquireC
8470: 6f 6e 6e 65 63 74 69 6f 6e 28 73 71 6c 2c 20 63  onnection(sql, c
8480: 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c 20  onnectionFlags, 
8490: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
84a0: 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68  al); // might th
84b0: 72 6f 77 0a 20 20 20 20 20 20 20 20 74 72 79 20  row.        try 
84c0: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65  {.            re
84d0: 74 75 72 6e 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e  turn mConnection
84e0: 2e 65 78 65 63 75 74 65 46 6f 72 4c 61 73 74 49  .executeForLastI
84f0: 6e 73 65 72 74 65 64 52 6f 77 49 64 28 73 71 6c  nsertedRowId(sql
8500: 2c 20 62 69 6e 64 41 72 67 73 2c 0a 20 20 20 20  , bindArgs,.    
8510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8520: 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e  cancellationSign
8530: 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68  al); // might th
8540: 72 6f 77 0a 20 20 20 20 20 20 20 20 7d 20 66 69  row.        } fi
8550: 6e 61 6c 6c 79 20 7b 0a 20 20 20 20 20 20 20 20  nally {.        
8560: 20 20 20 20 72 65 6c 65 61 73 65 43 6f 6e 6e 65      releaseConne
8570: 63 74 69 6f 6e 28 29 3b 20 2f 2f 20 6d 69 67 68  ction(); // migh
8580: 74 20 74 68 72 6f 77 0a 20 20 20 20 20 20 20 20  t throw.        
8590: 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a  }.    }..    /**
85a0: 0a 20 20 20 20 20 2a 20 45 78 65 63 75 74 65 73  .     * Executes
85b0: 20 61 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64   a statement and
85c0: 20 70 6f 70 75 6c 61 74 65 73 20 74 68 65 20 73   populates the s
85d0: 70 65 63 69 66 69 65 64 20 7b 40 6c 69 6e 6b 20  pecified {@link 
85e0: 43 75 72 73 6f 72 57 69 6e 64 6f 77 7d 0a 20 20  CursorWindow}.  
85f0: 20 20 20 2a 20 77 69 74 68 20 61 20 72 61 6e 67     * with a rang
8600: 65 20 6f 66 20 72 65 73 75 6c 74 73 2e 20 20 52  e of results.  R
8610: 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65  eturns the numbe
8620: 72 20 6f 66 20 72 6f 77 73 20 74 68 61 74 20 77  r of rows that w
8630: 65 72 65 20 63 6f 75 6e 74 65 64 0a 20 20 20 20  ere counted.    
8640: 20 2a 20 64 75 72 69 6e 67 20 71 75 65 72 79 20   * during query 
8650: 65 78 65 63 75 74 69 6f 6e 2e 0a 20 20 20 20 20  execution..     
8660: 2a 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20  *.     * @param 
8670: 73 71 6c 20 54 68 65 20 53 51 4c 20 73 74 61 74  sql The SQL stat
8680: 65 6d 65 6e 74 20 74 6f 20 65 78 65 63 75 74 65  ement to execute
8690: 2e 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20  ..     * @param 
86a0: 62 69 6e 64 41 72 67 73 20 54 68 65 20 61 72 67  bindArgs The arg
86b0: 75 6d 65 6e 74 73 20 74 6f 20 62 69 6e 64 2c 20  uments to bind, 
86c0: 6f 72 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65 2e  or null if none.
86d0: 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 77  .     * @param w
86e0: 69 6e 64 6f 77 20 54 68 65 20 63 75 72 73 6f 72  indow The cursor
86f0: 20 77 69 6e 64 6f 77 20 74 6f 20 63 6c 65 61 72   window to clear
8700: 20 61 6e 64 20 66 69 6c 6c 2e 0a 20 20 20 20 20   and fill..     
8710: 2a 20 40 70 61 72 61 6d 20 73 74 61 72 74 50 6f  * @param startPo
8720: 73 20 54 68 65 20 73 74 61 72 74 20 70 6f 73 69  s The start posi
8730: 74 69 6f 6e 20 66 6f 72 20 66 69 6c 6c 69 6e 67  tion for filling
8740: 20 74 68 65 20 77 69 6e 64 6f 77 2e 0a 20 20 20   the window..   
8750: 20 20 2a 20 40 70 61 72 61 6d 20 72 65 71 75 69    * @param requi
8760: 72 65 64 50 6f 73 20 54 68 65 20 70 6f 73 69 74  redPos The posit
8770: 69 6f 6e 20 6f 66 20 61 20 72 6f 77 20 74 68 61  ion of a row tha
8780: 74 20 4d 55 53 54 20 62 65 20 69 6e 20 74 68 65  t MUST be in the
8790: 20 77 69 6e 64 6f 77 2e 0a 20 20 20 20 20 2a 20   window..     * 
87a0: 49 66 20 69 74 20 77 6f 6e 27 74 20 66 69 74 2c  If it won't fit,
87b0: 20 74 68 65 6e 20 74 68 65 20 71 75 65 72 79 20   then the query 
87c0: 73 68 6f 75 6c 64 20 64 69 73 63 61 72 64 20 70  should discard p
87d0: 61 72 74 20 6f 66 20 77 68 61 74 20 69 74 20 66  art of what it f
87e0: 69 6c 6c 65 64 0a 20 20 20 20 20 2a 20 73 6f 20  illed.     * so 
87f0: 74 68 61 74 20 69 74 20 64 6f 65 73 2e 20 20 4d  that it does.  M
8800: 75 73 74 20 62 65 20 67 72 65 61 74 65 72 20 74  ust be greater t
8810: 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20  han or equal to 
8820: 3c 63 6f 64 65 3e 73 74 61 72 74 50 6f 73 3c 2f  <code>startPos</
8830: 63 6f 64 65 3e 2e 0a 20 20 20 20 20 2a 20 40 70  code>..     * @p
8840: 61 72 61 6d 20 63 6f 75 6e 74 41 6c 6c 52 6f 77  aram countAllRow
8850: 73 20 54 72 75 65 20 74 6f 20 63 6f 75 6e 74 20  s True to count 
8860: 61 6c 6c 20 72 6f 77 73 20 74 68 61 74 20 74 68  all rows that th
8870: 65 20 71 75 65 72 79 20 77 6f 75 6c 64 20 72 65  e query would re
8880: 74 75 72 6e 0a 20 20 20 20 20 2a 20 72 65 67 61  turn.     * rega
8890: 67 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72  gless of whether
88a0: 20 74 68 65 79 20 66 69 74 20 69 6e 20 74 68 65   they fit in the
88b0: 20 77 69 6e 64 6f 77 2e 0a 20 20 20 20 20 2a 20   window..     * 
88c0: 40 70 61 72 61 6d 20 63 6f 6e 6e 65 63 74 69 6f  @param connectio
88d0: 6e 46 6c 61 67 73 20 54 68 65 20 63 6f 6e 6e 65  nFlags The conne
88e0: 63 74 69 6f 6e 20 66 6c 61 67 73 20 74 6f 20 75  ction flags to u
88f0: 73 65 20 69 66 20 61 20 63 6f 6e 6e 65 63 74 69  se if a connecti
8900: 6f 6e 20 6d 75 73 74 20 62 65 0a 20 20 20 20 20  on must be.     
8910: 2a 20 61 63 71 75 69 72 65 64 20 62 79 20 74 68  * acquired by th
8920: 69 73 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 52  is operation.  R
8930: 65 66 65 72 20 74 6f 20 7b 40 6c 69 6e 6b 20 53  efer to {@link S
8940: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 50  QLiteConnectionP
8950: 6f 6f 6c 7d 2e 0a 20 20 20 20 20 2a 20 40 70 61  ool}..     * @pa
8960: 72 61 6d 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e  ram cancellation
8970: 53 69 67 6e 61 6c 20 41 20 73 69 67 6e 61 6c 20  Signal A signal 
8980: 74 6f 20 63 61 6e 63 65 6c 20 74 68 65 20 6f 70  to cancel the op
8990: 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72  eration in progr
89a0: 65 73 73 2c 20 6f 72 20 6e 75 6c 6c 20 69 66 20  ess, or null if 
89b0: 6e 6f 6e 65 2e 0a 20 20 20 20 20 2a 20 40 72 65  none..     * @re
89c0: 74 75 72 6e 20 54 68 65 20 6e 75 6d 62 65 72 20  turn The number 
89d0: 6f 66 20 72 6f 77 73 20 74 68 61 74 20 77 65 72  of rows that wer
89e0: 65 20 63 6f 75 6e 74 65 64 20 64 75 72 69 6e 67  e counted during
89f0: 20 71 75 65 72 79 20 65 78 65 63 75 74 69 6f 6e   query execution
8a00: 2e 20 20 4d 69 67 68 74 0a 20 20 20 20 20 2a 20  .  Might.     * 
8a10: 6e 6f 74 20 62 65 20 61 6c 6c 20 72 6f 77 73 20  not be all rows 
8a20: 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73 65  in the result se
8a30: 74 20 75 6e 6c 65 73 73 20 3c 63 6f 64 65 3e 63  t unless <code>c
8a40: 6f 75 6e 74 41 6c 6c 52 6f 77 73 3c 2f 63 6f 64  ountAllRows</cod
8a50: 65 3e 20 69 73 20 74 72 75 65 2e 0a 20 20 20 20  e> is true..    
8a60: 20 2a 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77   *.     * @throw
8a70: 73 20 53 51 4c 69 74 65 45 78 63 65 70 74 69 6f  s SQLiteExceptio
8a80: 6e 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63  n if an error oc
8a90: 63 75 72 73 2c 20 73 75 63 68 20 61 73 20 61 20  curs, such as a 
8aa0: 73 79 6e 74 61 78 20 65 72 72 6f 72 0a 20 20 20  syntax error.   
8ab0: 20 20 2a 20 6f 72 20 69 6e 76 61 6c 69 64 20 6e    * or invalid n
8ac0: 75 6d 62 65 72 20 6f 66 20 62 69 6e 64 20 61 72  umber of bind ar
8ad0: 67 75 6d 65 6e 74 73 2e 0a 20 20 20 20 20 2a 20  guments..     * 
8ae0: 40 74 68 72 6f 77 73 20 4f 70 65 72 61 74 69 6f  @throws Operatio
8af0: 6e 43 61 6e 63 65 6c 65 64 45 78 63 65 70 74 69  nCanceledExcepti
8b00: 6f 6e 20 69 66 20 74 68 65 20 6f 70 65 72 61 74  on if the operat
8b10: 69 6f 6e 20 77 61 73 20 63 61 6e 63 65 6c 65 64  ion was canceled
8b20: 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75  ..     */.    pu
8b30: 62 6c 69 63 20 69 6e 74 20 65 78 65 63 75 74 65  blic int execute
8b40: 46 6f 72 43 75 72 73 6f 72 57 69 6e 64 6f 77 28  ForCursorWindow(
8b50: 53 74 72 69 6e 67 20 73 71 6c 2c 20 4f 62 6a 65  String sql, Obje
8b60: 63 74 5b 5d 20 62 69 6e 64 41 72 67 73 2c 0a 20  ct[] bindArgs,. 
8b70: 20 20 20 20 20 20 20 20 20 20 20 43 75 72 73 6f             Curso
8b80: 72 57 69 6e 64 6f 77 20 77 69 6e 64 6f 77 2c 20  rWindow window, 
8b90: 69 6e 74 20 73 74 61 72 74 50 6f 73 2c 20 69 6e  int startPos, in
8ba0: 74 20 72 65 71 75 69 72 65 64 50 6f 73 2c 20 62  t requiredPos, b
8bb0: 6f 6f 6c 65 61 6e 20 63 6f 75 6e 74 41 6c 6c 52  oolean countAllR
8bc0: 6f 77 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20  ows,.           
8bd0: 20 69 6e 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 46   int connectionF
8be0: 6c 61 67 73 2c 20 43 61 6e 63 65 6c 6c 61 74 69  lags, Cancellati
8bf0: 6f 6e 53 69 67 6e 61 6c 20 63 61 6e 63 65 6c 6c  onSignal cancell
8c00: 61 74 69 6f 6e 53 69 67 6e 61 6c 29 20 7b 0a 20  ationSignal) {. 
8c10: 20 20 20 20 20 20 20 69 66 20 28 73 71 6c 20 3d         if (sql =
8c20: 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20  = null) {.      
8c30: 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20        throw new 
8c40: 49 6c 6c 65 67 61 6c 41 72 67 75 6d 65 6e 74 45  IllegalArgumentE
8c50: 78 63 65 70 74 69 6f 6e 28 22 73 71 6c 20 6d 75  xception("sql mu
8c60: 73 74 20 6e 6f 74 20 62 65 20 6e 75 6c 6c 2e 22  st not be null."
8c70: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
8c80: 20 20 20 20 20 69 66 20 28 77 69 6e 64 6f 77 20       if (window 
8c90: 3d 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20  == null) {.     
8ca0: 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77         throw new
8cb0: 20 49 6c 6c 65 67 61 6c 41 72 67 75 6d 65 6e 74   IllegalArgument
8cc0: 45 78 63 65 70 74 69 6f 6e 28 22 77 69 6e 64 6f  Exception("windo
8cd0: 77 20 6d 75 73 74 20 6e 6f 74 20 62 65 20 6e 75  w must not be nu
8ce0: 6c 6c 2e 22 29 3b 0a 20 20 20 20 20 20 20 20 7d  ll.");.        }
8cf0: 0a 0a 20 20 20 20 20 20 20 20 69 66 20 28 65 78  ..        if (ex
8d00: 65 63 75 74 65 53 70 65 63 69 61 6c 28 73 71 6c  ecuteSpecial(sql
8d10: 2c 20 62 69 6e 64 41 72 67 73 2c 20 63 6f 6e 6e  , bindArgs, conn
8d20: 65 63 74 69 6f 6e 46 6c 61 67 73 2c 20 63 61 6e  ectionFlags, can
8d30: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29  cellationSignal)
8d40: 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ) {.            
8d50: 77 69 6e 64 6f 77 2e 63 6c 65 61 72 28 29 3b 0a  window.clear();.
8d60: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75              retu
8d70: 72 6e 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a  rn 0;.        }.
8d80: 0a 20 20 20 20 20 20 20 20 61 63 71 75 69 72 65  .        acquire
8d90: 43 6f 6e 6e 65 63 74 69 6f 6e 28 73 71 6c 2c 20  Connection(sql, 
8da0: 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c  connectionFlags,
8db0: 20 63 61 6e 63 65 6c 6c 61 74 69 6f 6e 53 69 67   cancellationSig
8dc0: 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74  nal); // might t
8dd0: 68 72 6f 77 0a 20 20 20 20 20 20 20 20 74 72 79  hrow.        try
8de0: 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72   {.            r
8df0: 65 74 75 72 6e 20 6d 43 6f 6e 6e 65 63 74 69 6f  eturn mConnectio
8e00: 6e 2e 65 78 65 63 75 74 65 46 6f 72 43 75 72 73  n.executeForCurs
8e10: 6f 72 57 69 6e 64 6f 77 28 73 71 6c 2c 20 62 69  orWindow(sql, bi
8e20: 6e 64 41 72 67 73 2c 0a 20 20 20 20 20 20 20 20  ndArgs,.        
8e30: 20 20 20 20 20 20 20 20 20 20 20 20 77 69 6e 64              wind
8e40: 6f 77 2c 20 73 74 61 72 74 50 6f 73 2c 20 72 65  ow, startPos, re
8e50: 71 75 69 72 65 64 50 6f 73 2c 20 63 6f 75 6e 74  quiredPos, count
8e60: 41 6c 6c 52 6f 77 73 2c 0a 20 20 20 20 20 20 20  AllRows,.       
8e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e               can
8e80: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29  cellationSignal)
8e90: 3b 20 2f 2f 20 6d 69 67 68 74 20 74 68 72 6f 77  ; // might throw
8ea0: 0a 20 20 20 20 20 20 20 20 7d 20 66 69 6e 61 6c  .        } final
8eb0: 6c 79 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20  ly {.           
8ec0: 20 72 65 6c 65 61 73 65 43 6f 6e 6e 65 63 74 69   releaseConnecti
8ed0: 6f 6e 28 29 3b 20 2f 2f 20 6d 69 67 68 74 20 74  on(); // might t
8ee0: 68 72 6f 77 0a 20 20 20 20 20 20 20 20 7d 0a 20  hrow.        }. 
8ef0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20     }..    /**.  
8f00: 20 20 20 2a 20 50 65 72 66 6f 72 6d 73 20 73 70     * Performs sp
8f10: 65 63 69 61 6c 20 72 65 69 6e 74 65 72 70 72 65  ecial reinterpre
8f20: 74 61 74 69 6f 6e 20 6f 66 20 63 65 72 74 61 69  tation of certai
8f30: 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73  n SQL statements
8f40: 20 73 75 63 68 20 61 73 20 22 42 45 47 49 4e 22   such as "BEGIN"
8f50: 2c 0a 20 20 20 20 20 2a 20 22 43 4f 4d 4d 49 54  ,.     * "COMMIT
8f60: 22 20 61 6e 64 20 22 52 4f 4c 4c 42 41 43 4b 22  " and "ROLLBACK"
8f70: 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 74 20   to ensure that 
8f80: 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 74 61 74  transaction stat
8f90: 65 20 69 6e 76 61 72 69 61 6e 74 73 20 61 72 65  e invariants are
8fa0: 0a 20 20 20 20 20 2a 20 6d 61 69 6e 74 61 69 6e  .     * maintain
8fb0: 65 64 2e 0a 20 20 20 20 20 2a 0a 20 20 20 20 20  ed..     *.     
8fc0: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
8fd0: 69 73 20 6d 61 69 6e 6c 79 20 75 73 65 64 20 74  is mainly used t
8fe0: 6f 20 73 75 70 70 6f 72 74 20 6c 65 67 61 63 79  o support legacy
8ff0: 20 61 70 70 73 20 74 68 61 74 20 70 65 72 66 6f   apps that perfo
9000: 72 6d 20 74 68 65 69 72 0a 20 20 20 20 20 2a 20  rm their.     * 
9010: 6f 77 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 73  own transactions
9020: 20 62 79 20 65 78 65 63 75 74 69 6e 67 20 72 61   by executing ra
9030: 77 20 53 51 4c 20 72 61 74 68 65 72 20 74 68 61  w SQL rather tha
9040: 6e 20 63 61 6c 6c 69 6e 67 20 7b 40 6c 69 6e 6b  n calling {@link
9050: 20 23 62 65 67 69 6e 54 72 61 6e 73 61 63 74 69   #beginTransacti
9060: 6f 6e 7d 0a 20 20 20 20 20 2a 20 61 6e 64 20 74  on}.     * and t
9070: 68 65 20 6c 69 6b 65 2e 0a 20 20 20 20 20 2a 0a  he like..     *.
9080: 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 73 71       * @param sq
9090: 6c 20 54 68 65 20 53 51 4c 20 73 74 61 74 65 6d  l The SQL statem
90a0: 65 6e 74 20 74 6f 20 65 78 65 63 75 74 65 2e 0a  ent to execute..
90b0: 20 20 20 20 20 2a 20 40 70 61 72 61 6d 20 62 69       * @param bi
90c0: 6e 64 41 72 67 73 20 54 68 65 20 61 72 67 75 6d  ndArgs The argum
90d0: 65 6e 74 73 20 74 6f 20 62 69 6e 64 2c 20 6f 72  ents to bind, or
90e0: 20 6e 75 6c 6c 20 69 66 20 6e 6f 6e 65 2e 0a 20   null if none.. 
90f0: 20 20 20 20 2a 20 40 70 61 72 61 6d 20 63 6f 6e      * @param con
9100: 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 54 68 65  nectionFlags The
9110: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 66 6c 61 67   connection flag
9120: 73 20 74 6f 20 75 73 65 20 69 66 20 61 20 63 6f  s to use if a co
9130: 6e 6e 65 63 74 69 6f 6e 20 6d 75 73 74 20 62 65  nnection must be
9140: 0a 20 20 20 20 20 2a 20 61 63 71 75 69 72 65 64  .     * acquired
9150: 20 62 79 20 74 68 69 73 20 6f 70 65 72 61 74 69   by this operati
9160: 6f 6e 2e 20 20 52 65 66 65 72 20 74 6f 20 7b 40  on.  Refer to {@
9170: 6c 69 6e 6b 20 53 51 4c 69 74 65 43 6f 6e 6e 65  link SQLiteConne
9180: 63 74 69 6f 6e 50 6f 6f 6c 7d 2e 0a 20 20 20 20  ctionPool}..    
9190: 20 2a 20 40 70 61 72 61 6d 20 63 61 6e 63 65 6c   * @param cancel
91a0: 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 20 41 20 73  lationSignal A s
91b0: 69 67 6e 61 6c 20 74 6f 20 63 61 6e 63 65 6c 20  ignal to cancel 
91c0: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e  the operation in
91d0: 20 70 72 6f 67 72 65 73 73 2c 20 6f 72 20 6e 75   progress, or nu
91e0: 6c 6c 20 69 66 20 6e 6f 6e 65 2e 0a 20 20 20 20  ll if none..    
91f0: 20 2a 20 40 72 65 74 75 72 6e 20 54 72 75 65 20   * @return True 
9200: 69 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  if the statement
9210: 20 77 61 73 20 6f 66 20 61 20 73 70 65 63 69 61   was of a specia
9220: 6c 20 66 6f 72 6d 20 74 68 61 74 20 77 61 73 20  l form that was 
9230: 68 61 6e 64 6c 65 64 20 68 65 72 65 2c 0a 20 20  handled here,.  
9240: 20 20 20 2a 20 66 61 6c 73 65 20 6f 74 68 65 72     * false other
9250: 77 69 73 65 2e 0a 20 20 20 20 20 2a 0a 20 20 20  wise..     *.   
9260: 20 20 2a 20 40 74 68 72 6f 77 73 20 53 51 4c 69    * @throws SQLi
9270: 74 65 45 78 63 65 70 74 69 6f 6e 20 69 66 20 61  teException if a
9280: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20  n error occurs, 
9290: 73 75 63 68 20 61 73 20 61 20 73 79 6e 74 61 78  such as a syntax
92a0: 20 65 72 72 6f 72 0a 20 20 20 20 20 2a 20 6f 72   error.     * or
92b0: 20 69 6e 76 61 6c 69 64 20 6e 75 6d 62 65 72 20   invalid number 
92c0: 6f 66 20 62 69 6e 64 20 61 72 67 75 6d 65 6e 74  of bind argument
92d0: 73 2e 0a 20 20 20 20 20 2a 20 40 74 68 72 6f 77  s..     * @throw
92e0: 73 20 4f 70 65 72 61 74 69 6f 6e 43 61 6e 63 65  s OperationCance
92f0: 6c 65 64 45 78 63 65 70 74 69 6f 6e 20 69 66 20  ledException if 
9300: 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 77 61  the operation wa
9310: 73 20 63 61 6e 63 65 6c 65 64 2e 0a 20 20 20 20  s canceled..    
9320: 20 2a 2f 0a 20 20 20 20 70 72 69 76 61 74 65 20   */.    private 
9330: 62 6f 6f 6c 65 61 6e 20 65 78 65 63 75 74 65 53  boolean executeS
9340: 70 65 63 69 61 6c 28 53 74 72 69 6e 67 20 73 71  pecial(String sq
9350: 6c 2c 20 4f 62 6a 65 63 74 5b 5d 20 62 69 6e 64  l, Object[] bind
9360: 41 72 67 73 2c 20 69 6e 74 20 63 6f 6e 6e 65 63  Args, int connec
9370: 74 69 6f 6e 46 6c 61 67 73 2c 0a 20 20 20 20 20  tionFlags,.     
9380: 20 20 20 20 20 20 20 43 61 6e 63 65 6c 6c 61 74         Cancellat
9390: 69 6f 6e 53 69 67 6e 61 6c 20 63 61 6e 63 65 6c  ionSignal cancel
93a0: 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 20 7b 0a  lationSignal) {.
93b0: 20 20 20 20 20 20 20 20 69 66 20 28 63 61 6e 63          if (canc
93c0: 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 20 21  ellationSignal !
93d0: 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20  = null) {.      
93e0: 20 20 20 20 20 20 63 61 6e 63 65 6c 6c 61 74 69        cancellati
93f0: 6f 6e 53 69 67 6e 61 6c 2e 74 68 72 6f 77 49 66  onSignal.throwIf
9400: 43 61 6e 63 65 6c 65 64 28 29 3b 0a 20 20 20 20  Canceled();.    
9410: 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 66      }..        f
9420: 69 6e 61 6c 20 69 6e 74 20 74 79 70 65 20 3d 20  inal int type = 
9430: 44 61 74 61 62 61 73 65 55 74 69 6c 73 2e 67 65  DatabaseUtils.ge
9440: 74 53 71 6c 53 74 61 74 65 6d 65 6e 74 54 79 70  tSqlStatementTyp
9450: 65 28 73 71 6c 29 3b 0a 20 20 20 20 20 20 20 20  e(sql);.        
9460: 73 77 69 74 63 68 20 28 74 79 70 65 29 20 7b 0a  switch (type) {.
9470: 20 20 20 20 20 20 20 20 20 20 20 20 63 61 73 65              case
9480: 20 44 61 74 61 62 61 73 65 55 74 69 6c 73 2e 53   DatabaseUtils.S
9490: 54 41 54 45 4d 45 4e 54 5f 42 45 47 49 4e 3a 0a  TATEMENT_BEGIN:.
94a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
94b0: 62 65 67 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e  beginTransaction
94c0: 28 54 52 41 4e 53 41 43 54 49 4f 4e 5f 4d 4f 44  (TRANSACTION_MOD
94d0: 45 5f 45 58 43 4c 55 53 49 56 45 2c 20 6e 75 6c  E_EXCLUSIVE, nul
94e0: 6c 2c 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  l, connectionFla
94f0: 67 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  gs,.            
9500: 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e 63              canc
9510: 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 3b  ellationSignal);
9520: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
9530: 20 72 65 74 75 72 6e 20 74 72 75 65 3b 0a 0a 20   return true;.. 
9540: 20 20 20 20 20 20 20 20 20 20 20 63 61 73 65 20             case 
9550: 44 61 74 61 62 61 73 65 55 74 69 6c 73 2e 53 54  DatabaseUtils.ST
9560: 41 54 45 4d 45 4e 54 5f 43 4f 4d 4d 49 54 3a 0a  ATEMENT_COMMIT:.
9570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9580: 73 65 74 54 72 61 6e 73 61 63 74 69 6f 6e 53 75  setTransactionSu
9590: 63 63 65 73 73 66 75 6c 28 29 3b 0a 20 20 20 20  ccessful();.    
95a0: 20 20 20 20 20 20 20 20 20 20 20 20 65 6e 64 54              endT
95b0: 72 61 6e 73 61 63 74 69 6f 6e 28 63 61 6e 63 65  ransaction(cance
95c0: 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29 3b 0a  llationSignal);.
95d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
95e0: 72 65 74 75 72 6e 20 74 72 75 65 3b 0a 0a 20 20  return true;..  
95f0: 20 20 20 20 20 20 20 20 20 20 63 61 73 65 20 44            case D
9600: 61 74 61 62 61 73 65 55 74 69 6c 73 2e 53 54 41  atabaseUtils.STA
9610: 54 45 4d 45 4e 54 5f 41 42 4f 52 54 3a 0a 20 20  TEMENT_ABORT:.  
9620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 6e                en
9630: 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 63 61 6e  dTransaction(can
9640: 63 65 6c 6c 61 74 69 6f 6e 53 69 67 6e 61 6c 29  cellationSignal)
9650: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;.              
9660: 20 20 72 65 74 75 72 6e 20 74 72 75 65 3b 0a 20    return true;. 
9670: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
9680: 20 72 65 74 75 72 6e 20 66 61 6c 73 65 3b 0a 20   return false;. 
9690: 20 20 20 7d 0a 0a 20 20 20 20 70 72 69 76 61 74     }..    privat
96a0: 65 20 76 6f 69 64 20 61 63 71 75 69 72 65 43 6f  e void acquireCo
96b0: 6e 6e 65 63 74 69 6f 6e 28 53 74 72 69 6e 67 20  nnection(String 
96c0: 73 71 6c 2c 20 69 6e 74 20 63 6f 6e 6e 65 63 74  sql, int connect
96d0: 69 6f 6e 46 6c 61 67 73 2c 0a 20 20 20 20 20 20  ionFlags,.      
96e0: 20 20 20 20 20 20 43 61 6e 63 65 6c 6c 61 74 69        Cancellati
96f0: 6f 6e 53 69 67 6e 61 6c 20 63 61 6e 63 65 6c 6c  onSignal cancell
9700: 61 74 69 6f 6e 53 69 67 6e 61 6c 29 20 7b 0a 20  ationSignal) {. 
9710: 20 20 20 20 20 20 20 69 66 20 28 6d 43 6f 6e 6e         if (mConn
9720: 65 63 74 69 6f 6e 20 3d 3d 20 6e 75 6c 6c 29 20  ection == null) 
9730: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 73  {.            as
9740: 73 65 72 74 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e  sert mConnection
9750: 55 73 65 43 6f 75 6e 74 20 3d 3d 20 30 3b 0a 20  UseCount == 0;. 
9760: 20 20 20 20 20 20 20 20 20 20 20 6d 43 6f 6e 6e             mConn
9770: 65 63 74 69 6f 6e 20 3d 20 6d 43 6f 6e 6e 65 63  ection = mConnec
9780: 74 69 6f 6e 50 6f 6f 6c 2e 61 63 71 75 69 72 65  tionPool.acquire
9790: 43 6f 6e 6e 65 63 74 69 6f 6e 28 73 71 6c 2c 20  Connection(sql, 
97a0: 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 2c  connectionFlags,
97b0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
97c0: 20 20 20 20 20 63 61 6e 63 65 6c 6c 61 74 69 6f       cancellatio
97d0: 6e 53 69 67 6e 61 6c 29 3b 20 2f 2f 20 6d 69 67  nSignal); // mig
97e0: 68 74 20 74 68 72 6f 77 0a 20 20 20 20 20 20 20  ht throw.       
97f0: 20 20 20 20 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e       mConnection
9800: 46 6c 61 67 73 20 3d 20 63 6f 6e 6e 65 63 74 69  Flags = connecti
9810: 6f 6e 46 6c 61 67 73 3b 0a 20 20 20 20 20 20 20  onFlags;.       
9820: 20 7d 0a 20 20 20 20 20 20 20 20 6d 43 6f 6e 6e   }.        mConn
9830: 65 63 74 69 6f 6e 55 73 65 43 6f 75 6e 74 20 2b  ectionUseCount +
9840: 3d 20 31 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  = 1;.    }..    
9850: 70 72 69 76 61 74 65 20 76 6f 69 64 20 72 65 6c  private void rel
9860: 65 61 73 65 43 6f 6e 6e 65 63 74 69 6f 6e 28 29  easeConnection()
9870: 20 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72   {.        asser
9880: 74 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e 20 21 3d  t mConnection !=
9890: 20 6e 75 6c 6c 3b 0a 20 20 20 20 20 20 20 20 61   null;.        a
98a0: 73 73 65 72 74 20 6d 43 6f 6e 6e 65 63 74 69 6f  ssert mConnectio
98b0: 6e 55 73 65 43 6f 75 6e 74 20 3e 20 30 3b 0a 20  nUseCount > 0;. 
98c0: 20 20 20 20 20 20 20 69 66 20 28 2d 2d 6d 43 6f         if (--mCo
98d0: 6e 6e 65 63 74 69 6f 6e 55 73 65 43 6f 75 6e 74  nnectionUseCount
98e0: 20 3d 3d 20 30 29 20 7b 0a 20 20 20 20 20 20 20   == 0) {.       
98f0: 20 20 20 20 20 74 72 79 20 7b 0a 20 20 20 20 20       try {.     
9900: 20 20 20 20 20 20 20 20 20 20 20 6d 43 6f 6e 6e             mConn
9910: 65 63 74 69 6f 6e 50 6f 6f 6c 2e 72 65 6c 65 61  ectionPool.relea
9920: 73 65 43 6f 6e 6e 65 63 74 69 6f 6e 28 6d 43 6f  seConnection(mCo
9930: 6e 6e 65 63 74 69 6f 6e 29 3b 20 2f 2f 20 6d 69  nnection); // mi
9940: 67 68 74 20 74 68 72 6f 77 0a 20 20 20 20 20 20  ght throw.      
9950: 20 20 20 20 20 20 7d 20 66 69 6e 61 6c 6c 79 20        } finally 
9960: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  {.              
9970: 20 20 6d 43 6f 6e 6e 65 63 74 69 6f 6e 20 3d 20    mConnection = 
9980: 6e 75 6c 6c 3b 0a 20 20 20 20 20 20 20 20 20 20  null;.          
9990: 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20    }.        }.  
99a0: 20 20 7d 0a 0a 20 20 20 20 70 72 69 76 61 74 65    }..    private
99b0: 20 76 6f 69 64 20 74 68 72 6f 77 49 66 4e 6f 54   void throwIfNoT
99c0: 72 61 6e 73 61 63 74 69 6f 6e 28 29 20 7b 0a 20  ransaction() {. 
99d0: 20 20 20 20 20 20 20 69 66 20 28 6d 54 72 61 6e         if (mTran
99e0: 73 61 63 74 69 6f 6e 53 74 61 63 6b 20 3d 3d 20  sactionStack == 
99f0: 6e 75 6c 6c 29 20 7b 0a 20 20 20 20 20 20 20 20  null) {.        
9a00: 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6c      throw new Il
9a10: 6c 65 67 61 6c 53 74 61 74 65 45 78 63 65 70 74  legalStateExcept
9a20: 69 6f 6e 28 22 43 61 6e 6e 6f 74 20 70 65 72 66  ion("Cannot perf
9a30: 6f 72 6d 20 74 68 69 73 20 6f 70 65 72 61 74 69  orm this operati
9a40: 6f 6e 20 62 65 63 61 75 73 65 20 22 0a 20 20 20  on because ".   
9a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9a60: 20 2b 20 22 74 68 65 72 65 20 69 73 20 6e 6f 20   + "there is no 
9a70: 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74  current transact
9a80: 69 6f 6e 2e 22 29 3b 0a 20 20 20 20 20 20 20 20  ion.");.        
9a90: 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 69  }.    }..    pri
9aa0: 76 61 74 65 20 76 6f 69 64 20 74 68 72 6f 77 49  vate void throwI
9ab0: 66 54 72 61 6e 73 61 63 74 69 6f 6e 4d 61 72 6b  fTransactionMark
9ac0: 65 64 53 75 63 63 65 73 73 66 75 6c 28 29 20 7b  edSuccessful() {
9ad0: 0a 20 20 20 20 20 20 20 20 69 66 20 28 6d 54 72  .        if (mTr
9ae0: 61 6e 73 61 63 74 69 6f 6e 53 74 61 63 6b 20 21  ansactionStack !
9af0: 3d 20 6e 75 6c 6c 20 26 26 20 6d 54 72 61 6e 73  = null && mTrans
9b00: 61 63 74 69 6f 6e 53 74 61 63 6b 2e 6d 4d 61 72  actionStack.mMar
9b10: 6b 65 64 53 75 63 63 65 73 73 66 75 6c 29 20 7b  kedSuccessful) {
9b20: 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72  .            thr
9b30: 6f 77 20 6e 65 77 20 49 6c 6c 65 67 61 6c 53 74  ow new IllegalSt
9b40: 61 74 65 45 78 63 65 70 74 69 6f 6e 28 22 43 61  ateException("Ca
9b50: 6e 6e 6f 74 20 70 65 72 66 6f 72 6d 20 74 68 69  nnot perform thi
9b60: 73 20 6f 70 65 72 61 74 69 6f 6e 20 62 65 63 61  s operation beca
9b70: 75 73 65 20 22 0a 20 20 20 20 20 20 20 20 20 20  use ".          
9b80: 20 20 20 20 20 20 20 20 20 20 2b 20 22 74 68 65            + "the
9b90: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73   transaction has
9ba0: 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 6d 61   already been ma
9bb0: 72 6b 65 64 20 73 75 63 63 65 73 73 66 75 6c 2e  rked successful.
9bc0: 20 20 54 68 65 20 6f 6e 6c 79 20 22 0a 20 20 20    The only ".   
9bd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9be0: 20 2b 20 22 74 68 69 6e 67 20 79 6f 75 20 63 61   + "thing you ca
9bf0: 6e 20 64 6f 20 6e 6f 77 20 69 73 20 63 61 6c 6c  n do now is call
9c00: 20 65 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28   endTransaction(
9c10: 29 2e 22 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a  ).");.        }.
9c20: 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 69 76 61      }..    priva
9c30: 74 65 20 76 6f 69 64 20 74 68 72 6f 77 49 66 4e  te void throwIfN
9c40: 65 73 74 65 64 54 72 61 6e 73 61 63 74 69 6f 6e  estedTransaction
9c50: 28 29 20 7b 0a 20 20 20 20 20 20 20 20 69 66 20  () {.        if 
9c60: 28 68 61 73 4e 65 73 74 65 64 54 72 61 6e 73 61  (hasNestedTransa
9c70: 63 74 69 6f 6e 28 29 29 20 7b 0a 20 20 20 20 20  ction()) {.     
9c80: 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77         throw new
9c90: 20 49 6c 6c 65 67 61 6c 53 74 61 74 65 45 78 63   IllegalStateExc
9ca0: 65 70 74 69 6f 6e 28 22 43 61 6e 6e 6f 74 20 70  eption("Cannot p
9cb0: 65 72 66 6f 72 6d 20 74 68 69 73 20 6f 70 65 72  erform this oper
9cc0: 61 74 69 6f 6e 20 62 65 63 61 75 73 65 20 22 0a  ation because ".
9cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9ce0: 20 20 20 20 2b 20 22 61 20 6e 65 73 74 65 64 20      + "a nested 
9cf0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 69  transaction is i
9d00: 6e 20 70 72 6f 67 72 65 73 73 2e 22 29 3b 0a 20  n progress.");. 
9d10: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a         }.    }..
9d20: 20 20 20 20 70 72 69 76 61 74 65 20 54 72 61 6e      private Tran
9d30: 73 61 63 74 69 6f 6e 20 6f 62 74 61 69 6e 54 72  saction obtainTr
9d40: 61 6e 73 61 63 74 69 6f 6e 28 69 6e 74 20 6d 6f  ansaction(int mo
9d50: 64 65 2c 20 53 51 4c 69 74 65 54 72 61 6e 73 61  de, SQLiteTransa
9d60: 63 74 69 6f 6e 4c 69 73 74 65 6e 65 72 20 6c 69  ctionListener li
9d70: 73 74 65 6e 65 72 29 20 7b 0a 20 20 20 20 20 20  stener) {.      
9d80: 20 20 54 72 61 6e 73 61 63 74 69 6f 6e 20 74 72    Transaction tr
9d90: 61 6e 73 61 63 74 69 6f 6e 20 3d 20 6d 54 72 61  ansaction = mTra
9da0: 6e 73 61 63 74 69 6f 6e 50 6f 6f 6c 3b 0a 20 20  nsactionPool;.  
9db0: 20 20 20 20 20 20 69 66 20 28 74 72 61 6e 73 61        if (transa
9dc0: 63 74 69 6f 6e 20 21 3d 20 6e 75 6c 6c 29 20 7b  ction != null) {
9dd0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 54 72  .            mTr
9de0: 61 6e 73 61 63 74 69 6f 6e 50 6f 6f 6c 20 3d 20  ansactionPool = 
9df0: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 6d 50 61 72  transaction.mPar
9e00: 65 6e 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20  ent;.           
9e10: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 6d 50 61   transaction.mPa
9e20: 72 65 6e 74 20 3d 20 6e 75 6c 6c 3b 0a 20 20 20  rent = null;.   
9e30: 20 20 20 20 20 20 20 20 20 74 72 61 6e 73 61 63           transac
9e40: 74 69 6f 6e 2e 6d 4d 61 72 6b 65 64 53 75 63 63  tion.mMarkedSucc
9e50: 65 73 73 66 75 6c 20 3d 20 66 61 6c 73 65 3b 0a  essful = false;.
9e60: 20 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e              tran
9e70: 73 61 63 74 69 6f 6e 2e 6d 43 68 69 6c 64 46 61  saction.mChildFa
9e80: 69 6c 65 64 20 3d 20 66 61 6c 73 65 3b 0a 20 20  iled = false;.  
9e90: 20 20 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20        } else {. 
9ea0: 20 20 20 20 20 20 20 20 20 20 20 74 72 61 6e 73             trans
9eb0: 61 63 74 69 6f 6e 20 3d 20 6e 65 77 20 54 72 61  action = new Tra
9ec0: 6e 73 61 63 74 69 6f 6e 28 29 3b 0a 20 20 20 20  nsaction();.    
9ed0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 74 72      }.        tr
9ee0: 61 6e 73 61 63 74 69 6f 6e 2e 6d 4d 6f 64 65 20  ansaction.mMode 
9ef0: 3d 20 6d 6f 64 65 3b 0a 20 20 20 20 20 20 20 20  = mode;.        
9f00: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 6d 4c 69 73  transaction.mLis
9f10: 74 65 6e 65 72 20 3d 20 6c 69 73 74 65 6e 65 72  tener = listener
9f20: 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  ;.        return
9f30: 20 74 72 61 6e 73 61 63 74 69 6f 6e 3b 0a 20 20   transaction;.  
9f40: 20 20 7d 0a 0a 20 20 20 20 70 72 69 76 61 74 65    }..    private
9f50: 20 76 6f 69 64 20 72 65 63 79 63 6c 65 54 72 61   void recycleTra
9f60: 6e 73 61 63 74 69 6f 6e 28 54 72 61 6e 73 61 63  nsaction(Transac
9f70: 74 69 6f 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e  tion transaction
9f80: 29 20 7b 0a 20 20 20 20 20 20 20 20 74 72 61 6e  ) {.        tran
9f90: 73 61 63 74 69 6f 6e 2e 6d 50 61 72 65 6e 74 20  saction.mParent 
9fa0: 3d 20 6d 54 72 61 6e 73 61 63 74 69 6f 6e 50 6f  = mTransactionPo
9fb0: 6f 6c 3b 0a 20 20 20 20 20 20 20 20 74 72 61 6e  ol;.        tran
9fc0: 73 61 63 74 69 6f 6e 2e 6d 4c 69 73 74 65 6e 65  saction.mListene
9fd0: 72 20 3d 20 6e 75 6c 6c 3b 0a 20 20 20 20 20 20  r = null;.      
9fe0: 20 20 6d 54 72 61 6e 73 61 63 74 69 6f 6e 50 6f    mTransactionPo
9ff0: 6f 6c 20 3d 20 74 72 61 6e 73 61 63 74 69 6f 6e  ol = transaction
a000: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 69  ;.    }..    pri
a010: 76 61 74 65 20 73 74 61 74 69 63 20 66 69 6e 61  vate static fina
a020: 6c 20 63 6c 61 73 73 20 54 72 61 6e 73 61 63 74  l class Transact
a030: 69 6f 6e 20 7b 0a 20 20 20 20 20 20 20 20 70 75  ion {.        pu
a040: 62 6c 69 63 20 54 72 61 6e 73 61 63 74 69 6f 6e  blic Transaction
a050: 20 6d 50 61 72 65 6e 74 3b 0a 20 20 20 20 20 20   mParent;.      
a060: 20 20 70 75 62 6c 69 63 20 69 6e 74 20 6d 4d 6f    public int mMo
a070: 64 65 3b 0a 20 20 20 20 20 20 20 20 70 75 62 6c  de;.        publ
a080: 69 63 20 53 51 4c 69 74 65 54 72 61 6e 73 61 63  ic SQLiteTransac
a090: 74 69 6f 6e 4c 69 73 74 65 6e 65 72 20 6d 4c 69  tionListener mLi
a0a0: 73 74 65 6e 65 72 3b 0a 20 20 20 20 20 20 20 20  stener;.        
a0b0: 70 75 62 6c 69 63 20 62 6f 6f 6c 65 61 6e 20 6d  public boolean m
a0c0: 4d 61 72 6b 65 64 53 75 63 63 65 73 73 66 75 6c  MarkedSuccessful
a0d0: 3b 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63  ;.        public
a0e0: 20 62 6f 6f 6c 65 61 6e 20 6d 43 68 69 6c 64 46   boolean mChildF
a0f0: 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 7d 0a     ailed;.    }.}.