SQLite Android Bindings
Hex Artifact Content
Not logged in

Artifact 7cfddc4c3b785827b9a907f217e4547290e99759:


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 30 20 54 68 65 20 41 6e 64  (C) 2010 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 69 6d 70 6f 72 74 20 61 6e 64 72  ite;.import andr
0300: 6f 69 64 2e 75 74 69 6c 2e 4c 6f 67 3b 0a 0a 2f  oid.util.Log;../
0310: 2a 2a 0a 20 2a 20 43 6c 6f 73 65 47 75 61 72 64  **. * CloseGuard
0320: 20 69 73 20 61 20 6d 65 63 68 61 6e 69 73 6d 20   is a mechanism 
0330: 66 6f 72 20 66 6c 61 67 67 69 6e 67 20 69 6d 70  for flagging imp
0340: 6c 69 63 69 74 20 66 69 6e 61 6c 69 7a 65 72 20  licit finalizer 
0350: 63 6c 65 61 6e 75 70 20 6f 66 0a 20 2a 20 72 65  cleanup of. * re
0360: 73 6f 75 72 63 65 73 20 74 68 61 74 20 73 68 6f  sources that sho
0370: 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20 63 6c  uld have been cl
0380: 65 61 6e 65 64 20 75 70 20 62 79 20 65 78 70 6c  eaned up by expl
0390: 69 63 69 74 20 63 6c 6f 73 65 0a 20 2a 20 6d 65  icit close. * me
03a0: 74 68 6f 64 73 20 28 61 6b 61 20 22 65 78 70 6c  thods (aka "expl
03b0: 69 63 69 74 20 74 65 72 6d 69 6e 61 74 69 6f 6e  icit termination
03c0: 20 6d 65 74 68 6f 64 73 22 20 69 6e 20 45 66 66   methods" in Eff
03d0: 65 63 74 69 76 65 20 4a 61 76 61 29 2e 0a 20 2a  ective Java).. *
03e0: 20 3c 70 3e 0a 20 2a 20 41 20 73 69 6d 70 6c 65   <p>. * A simple
03f0: 20 65 78 61 6d 70 6c 65 3a 20 3c 70 72 65 3e 20   example: <pre> 
0400: 20 20 7b 40 63 6f 64 65 0a 20 2a 20 20 20 63 6c    {@code. *   cl
0410: 61 73 73 20 46 6f 6f 20 7b 0a 20 2a 0a 20 2a 20  ass Foo {. *. * 
0420: 20 20 20 20 20 20 70 72 69 76 61 74 65 20 66 69        private fi
0430: 6e 61 6c 20 43 6c 6f 73 65 47 75 61 72 64 20 67  nal CloseGuard g
0440: 75 61 72 64 20 3d 20 43 6c 6f 73 65 47 75 61 72  uard = CloseGuar
0450: 64 2e 67 65 74 28 29 3b 0a 20 2a 0a 20 2a 20 20  d.get();. *. *  
0460: 20 20 20 20 20 2e 2e 2e 0a 20 2a 0a 20 2a 20 20       .... *. *  
0470: 20 20 20 20 20 70 75 62 6c 69 63 20 46 6f 6f 28       public Foo(
0480: 29 20 7b 0a 20 2a 20 20 20 20 20 20 20 20 20 20  ) {. *          
0490: 20 2e 2e 2e 3b 0a 20 2a 20 20 20 20 20 20 20 20   ...;. *        
04a0: 20 20 20 67 75 61 72 64 2e 6f 70 65 6e 28 22 63     guard.open("c
04b0: 6c 65 61 6e 75 70 22 29 3b 0a 20 2a 20 20 20 20  leanup");. *    
04c0: 20 20 20 7d 0a 20 2a 0a 20 2a 20 20 20 20 20 20     }. *. *      
04d0: 20 70 75 62 6c 69 63 20 76 6f 69 64 20 63 6c 65   public void cle
04e0: 61 6e 75 70 28 29 20 7b 0a 20 2a 20 20 20 20 20  anup() {. *     
04f0: 20 20 20 20 20 67 75 61 72 64 2e 63 6c 6f 73 65       guard.close
0500: 28 29 3b 0a 20 2a 20 20 20 20 20 20 20 20 20 20  ();. *          
0510: 2e 2e 2e 3b 0a 20 2a 20 20 20 20 20 20 20 7d 0a  ...;. *       }.
0520: 20 2a 0a 20 2a 20 20 20 20 20 20 20 70 72 6f 74   *. *       prot
0530: 65 63 74 65 64 20 76 6f 69 64 20 66 69 6e 61 6c  ected void final
0540: 69 7a 65 28 29 20 74 68 72 6f 77 73 20 54 68 72  ize() throws Thr
0550: 6f 77 61 62 6c 65 20 7b 0a 20 2a 20 20 20 20 20  owable {. *     
0560: 20 20 20 20 20 20 74 72 79 20 7b 0a 20 2a 20 20        try {. *  
0570: 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20               if 
0580: 28 67 75 61 72 64 20 21 3d 20 6e 75 6c 6c 29 20  (guard != null) 
0590: 7b 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 20  {. *            
05a0: 20 20 20 20 20 20 20 67 75 61 72 64 2e 77 61 72         guard.war
05b0: 6e 49 66 4f 70 65 6e 28 29 3b 0a 20 2a 20 20 20  nIfOpen();. *   
05c0: 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 2a              }. *
05d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63                 c
05e0: 6c 65 61 6e 75 70 28 29 3b 0a 20 2a 20 20 20 20  leanup();. *    
05f0: 20 20 20 20 20 20 20 7d 20 66 69 6e 61 6c 6c 79         } finally
0600: 20 7b 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20   {. *           
0610: 20 20 20 20 73 75 70 65 72 2e 66 69 6e 61 6c 69      super.finali
0620: 7a 65 28 29 3b 0a 20 2a 20 20 20 20 20 20 20 20  ze();. *        
0630: 20 20 20 7d 0a 20 2a 20 20 20 20 20 20 20 7d 0a     }. *       }.
0640: 20 2a 20 20 20 7d 0a 20 2a 20 7d 3c 2f 70 72 65   *   }. * }</pre
0650: 3e 0a 20 2a 0a 20 2a 20 49 6e 20 75 73 61 67 65  >. *. * In usage
0660: 20 77 68 65 72 65 20 74 68 65 20 72 65 73 6f 75   where the resou
0670: 72 63 65 20 74 6f 20 62 65 20 65 78 70 6c 69 63  rce to be explic
0680: 69 74 6c 79 20 63 6c 65 61 6e 65 64 20 75 70 20  itly cleaned up 
0690: 61 72 65 0a 20 2a 20 61 6c 6c 6f 63 61 74 65 64  are. * allocated
06a0: 20 61 66 74 65 72 20 6f 62 6a 65 63 74 20 63 6f   after object co
06b0: 6e 73 74 72 75 63 74 69 6f 6e 2c 20 43 6c 6f 73  nstruction, Clos
06c0: 65 47 75 61 72 64 20 70 72 6f 74 65 63 74 69 6f  eGuard protectio
06d0: 6e 20 63 61 6e 0a 20 2a 20 62 65 20 64 65 66 65  n can. * be defe
06e0: 72 72 65 64 2e 20 46 6f 72 20 65 78 61 6d 70 6c  rred. For exampl
06f0: 65 3a 20 3c 70 72 65 3e 20 20 20 7b 40 63 6f 64  e: <pre>   {@cod
0700: 65 0a 20 2a 20 20 20 63 6c 61 73 73 20 42 61 72  e. *   class Bar
0710: 20 7b 0a 20 2a 0a 20 2a 20 20 20 20 20 20 20 70   {. *. *       p
0720: 72 69 76 61 74 65 20 66 69 6e 61 6c 20 43 6c 6f  rivate final Clo
0730: 73 65 47 75 61 72 64 20 67 75 61 72 64 20 3d 20  seGuard guard = 
0740: 43 6c 6f 73 65 47 75 61 72 64 2e 67 65 74 28 29  CloseGuard.get()
0750: 3b 0a 20 2a 0a 20 2a 20 20 20 20 20 20 20 2e 2e  ;. *. *       ..
0760: 2e 0a 20 2a 0a 20 2a 20 20 20 20 20 20 20 70 75  .. *. *       pu
0770: 62 6c 69 63 20 42 61 72 28 29 20 7b 0a 20 2a 20  blic Bar() {. * 
0780: 20 20 20 20 20 20 20 20 20 20 2e 2e 2e 3b 0a 20            ...;. 
0790: 2a 20 20 20 20 20 20 20 7d 0a 20 2a 0a 20 2a 20  *       }. *. * 
07a0: 20 20 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69        public voi
07b0: 64 20 63 6f 6e 6e 65 63 74 28 29 20 7b 0a 20 2a  d connect() {. *
07c0: 20 20 20 20 20 20 20 20 20 20 2e 2e 2e 3b 0a 20            ...;. 
07d0: 2a 20 20 20 20 20 20 20 20 20 20 67 75 61 72 64  *          guard
07e0: 2e 6f 70 65 6e 28 22 63 6c 65 61 6e 75 70 22 29  .open("cleanup")
07f0: 3b 0a 20 2a 20 20 20 20 20 20 20 7d 0a 20 2a 0a  ;. *       }. *.
0800: 20 2a 20 20 20 20 20 20 20 70 75 62 6c 69 63 20   *       public 
0810: 76 6f 69 64 20 63 6c 65 61 6e 75 70 28 29 20 7b  void cleanup() {
0820: 0a 20 2a 20 20 20 20 20 20 20 20 20 20 67 75 61  . *          gua
0830: 72 64 2e 63 6c 6f 73 65 28 29 3b 0a 20 2a 20 20  rd.close();. *  
0840: 20 20 20 20 20 20 20 20 2e 2e 2e 3b 0a 20 2a 20          ...;. * 
0850: 20 20 20 20 20 20 7d 0a 20 2a 0a 20 2a 20 20 20        }. *. *   
0860: 20 20 20 20 70 72 6f 74 65 63 74 65 64 20 76 6f      protected vo
0870: 69 64 20 66 69 6e 61 6c 69 7a 65 28 29 20 74 68  id finalize() th
0880: 72 6f 77 73 20 54 68 72 6f 77 61 62 6c 65 20 7b  rows Throwable {
0890: 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 74 72  . *           tr
08a0: 79 20 7b 0a 20 2a 20 20 20 20 20 20 20 20 20 20  y {. *          
08b0: 20 20 20 20 20 69 66 20 28 67 75 61 72 64 20 21       if (guard !
08c0: 3d 20 6e 75 6c 6c 29 20 7b 0a 20 2a 20 20 20 20  = null) {. *    
08d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 67                 g
08e0: 75 61 72 64 2e 77 61 72 6e 49 66 4f 70 65 6e 28  uard.warnIfOpen(
08f0: 29 3b 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20  );. *           
0900: 20 20 20 20 7d 0a 20 2a 20 20 20 20 20 20 20 20      }. *        
0910: 20 20 20 20 20 20 20 63 6c 65 61 6e 75 70 28 29         cleanup()
0920: 3b 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 7d  ;. *           }
0930: 20 66 69 6e 61 6c 6c 79 20 7b 0a 20 2a 20 20 20   finally {. *   
0940: 20 20 20 20 20 20 20 20 20 20 20 20 73 75 70 65              supe
0950: 72 2e 66 69 6e 61 6c 69 7a 65 28 29 3b 0a 20 2a  r.finalize();. *
0960: 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 2a 20             }. * 
0970: 20 20 20 20 20 20 7d 0a 20 2a 20 20 20 7d 0a 20        }. *   }. 
0980: 2a 20 7d 3c 2f 70 72 65 3e 0a 20 2a 0a 20 2a 20  * }</pre>. *. * 
0990: 57 68 65 6e 20 75 73 65 64 20 69 6e 20 61 20 63  When used in a c
09a0: 6f 6e 73 74 72 75 63 74 6f 72 20 63 61 6c 6c 73  onstructor calls
09b0: 20 74 6f 20 7b 40 63 6f 64 65 20 6f 70 65 6e 7d   to {@code open}
09c0: 20 73 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 74   should occur at
09d0: 0a 20 2a 20 74 68 65 20 65 6e 64 20 6f 66 20 74  . * the end of t
09e0: 68 65 20 63 6f 6e 73 74 72 75 63 74 6f 72 20 73  he constructor s
09f0: 69 6e 63 65 20 61 6e 20 65 78 63 65 70 74 69 6f  ince an exceptio
0a00: 6e 20 74 68 61 74 20 77 6f 75 6c 64 20 63 61 75  n that would cau
0a10: 73 65 0a 20 2a 20 61 62 72 75 70 74 20 74 65 72  se. * abrupt ter
0a20: 6d 69 6e 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  mination of the 
0a30: 63 6f 6e 73 74 72 75 63 74 6f 72 20 77 69 6c 6c  constructor will
0a40: 20 6d 65 61 6e 20 74 68 61 74 20 74 68 65 20 75   mean that the u
0a50: 73 65 72 20 77 69 6c 6c 0a 20 2a 20 6e 6f 74 20  ser will. * not 
0a60: 68 61 76 65 20 61 20 72 65 66 65 72 65 6e 63 65  have a reference
0a70: 20 74 6f 20 74 68 65 20 6f 62 6a 65 63 74 20 74   to the object t
0a80: 6f 20 63 6c 65 61 6e 75 70 20 65 78 70 6c 69 63  o cleanup explic
0a90: 69 74 6c 79 2e 20 57 68 65 6e 20 75 73 65 64 0a  itly. When used.
0aa0: 20 2a 20 69 6e 20 61 20 6d 65 74 68 6f 64 2c 20   * in a method, 
0ab0: 74 68 65 20 63 61 6c 6c 20 74 6f 20 7b 40 63 6f  the call to {@co
0ac0: 64 65 20 6f 70 65 6e 7d 20 73 68 6f 75 6c 64 20  de open} should 
0ad0: 6f 63 63 75 72 20 6a 75 73 74 20 61 66 74 65 72  occur just after
0ae0: 0a 20 2a 20 72 65 73 6f 75 72 63 65 20 61 63 71  . * resource acq
0af0: 75 69 73 69 74 69 6f 6e 2e 0a 20 2a 0a 20 2a 20  uisition.. *. * 
0b00: 3c 70 3e 0a 20 2a 0a 20 2a 20 4e 6f 74 65 20 74  <p>. *. * Note t
0b10: 68 61 74 20 74 68 65 20 6e 75 6c 6c 20 63 68 65  hat the null che
0b20: 63 6b 20 6f 6e 20 7b 40 63 6f 64 65 20 67 75 61  ck on {@code gua
0b30: 72 64 7d 20 69 6e 20 74 68 65 20 66 69 6e 61 6c  rd} in the final
0b40: 69 7a 65 72 20 69 73 20 74 6f 0a 20 2a 20 63 6f  izer is to. * co
0b50: 76 65 72 20 63 61 73 65 73 20 77 68 65 72 65 20  ver cases where 
0b60: 61 20 63 6f 6e 73 74 72 75 63 74 6f 72 20 74 68  a constructor th
0b70: 72 6f 77 73 20 61 6e 20 65 78 63 65 70 74 69 6f  rows an exceptio
0b80: 6e 20 63 61 75 73 69 6e 67 20 74 68 65 0a 20 2a  n causing the. *
0b90: 20 7b 40 63 6f 64 65 20 67 75 61 72 64 7d 20 74   {@code guard} t
0ba0: 6f 20 62 65 20 75 6e 69 6e 69 74 69 61 6c 69 7a  o be uninitializ
0bb0: 65 64 2e 0a 20 2a 0a 20 2a 20 40 68 69 64 65 0a  ed.. *. * @hide.
0bc0: 20 2a 2f 0a 70 75 62 6c 69 63 20 66 69 6e 61 6c   */.public final
0bd0: 20 63 6c 61 73 73 20 43 6c 6f 73 65 47 75 61 72   class CloseGuar
0be0: 64 20 7b 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20  d {..    /**.   
0bf0: 20 20 2a 20 49 6e 73 74 61 6e 63 65 20 75 73 65    * Instance use
0c00: 64 20 77 68 65 6e 20 43 6c 6f 73 65 47 75 61 72  d when CloseGuar
0c10: 64 20 69 73 20 64 69 73 61 62 6c 65 64 20 74 6f  d is disabled to
0c20: 20 61 76 6f 69 64 20 61 6c 6c 6f 63 61 74 69 6f   avoid allocatio
0c30: 6e 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70  n..     */.    p
0c40: 72 69 76 61 74 65 20 73 74 61 74 69 63 20 66 69  rivate static fi
0c50: 6e 61 6c 20 43 6c 6f 73 65 47 75 61 72 64 20 4e  nal CloseGuard N
0c60: 4f 4f 50 20 3d 20 6e 65 77 20 43 6c 6f 73 65 47  OOP = new CloseG
0c70: 75 61 72 64 28 29 3b 0a 0a 20 20 20 20 2f 2a 2a  uard();..    /**
0c80: 0a 20 20 20 20 20 2a 20 45 6e 61 62 6c 65 64 20  .     * Enabled 
0c90: 62 79 20 64 65 66 61 75 6c 74 20 73 6f 20 77 65  by default so we
0ca0: 20 63 61 6e 20 63 61 74 63 68 20 69 73 73 75 65   can catch issue
0cb0: 73 20 65 61 72 6c 79 20 69 6e 20 56 4d 20 73 74  s early in VM st
0cc0: 61 72 74 75 70 2e 0a 20 20 20 20 20 2a 20 4e 6f  artup..     * No
0cd0: 74 65 2c 20 68 6f 77 65 76 65 72 2c 20 74 68 61  te, however, tha
0ce0: 74 20 41 6e 64 72 6f 69 64 20 64 69 73 61 62 6c  t Android disabl
0cf0: 65 73 20 74 68 69 73 20 65 61 72 6c 79 20 69 6e  es this early in
0d00: 20 69 74 73 20 73 74 61 72 74 75 70 2c 0a 20 20   its startup,.  
0d10: 20 20 20 2a 20 62 75 74 20 65 6e 61 62 6c 65 73     * but enables
0d20: 20 69 74 20 77 69 74 68 20 44 72 6f 70 42 6f 78   it with DropBox
0d30: 69 6e 67 20 66 6f 72 20 73 79 73 74 65 6d 20 61  ing for system a
0d40: 70 70 73 20 6f 6e 20 64 65 62 75 67 20 62 75 69  pps on debug bui
0d50: 6c 64 73 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20  lds..     */.   
0d60: 20 70 72 69 76 61 74 65 20 73 74 61 74 69 63 20   private static 
0d70: 76 6f 6c 61 74 69 6c 65 20 62 6f 6f 6c 65 61 6e  volatile boolean
0d80: 20 45 4e 41 42 4c 45 44 20 3d 20 74 72 75 65 3b   ENABLED = true;
0d90: 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a  ..    /**.     *
0da0: 20 48 6f 6f 6b 20 66 6f 72 20 63 75 73 74 6f 6d   Hook for custom
0db0: 69 7a 69 6e 67 20 68 6f 77 20 43 6c 6f 73 65 47  izing how CloseG
0dc0: 75 61 72 64 20 69 73 73 75 65 73 20 61 72 65 20  uard issues are 
0dd0: 72 65 70 6f 72 74 65 64 2e 0a 20 20 20 20 20 2a  reported..     *
0de0: 2f 0a 20 20 20 20 70 72 69 76 61 74 65 20 73 74  /.    private st
0df0: 61 74 69 63 20 76 6f 6c 61 74 69 6c 65 20 52 65  atic volatile Re
0e00: 70 6f 72 74 65 72 20 52 45 50 4f 52 54 45 52 20  porter REPORTER 
0e10: 3d 20 6e 65 77 20 44 65 66 61 75 6c 74 52 65 70  = new DefaultRep
0e20: 6f 72 74 65 72 28 29 3b 0a 0a 20 20 20 20 2f 2a  orter();..    /*
0e30: 2a 0a 20 20 20 20 20 2a 20 52 65 74 75 72 6e 73  *.     * Returns
0e40: 20 61 20 43 6c 6f 73 65 47 75 61 72 64 20 69 6e   a CloseGuard in
0e50: 73 74 61 6e 63 65 2e 20 49 66 20 43 6c 6f 73 65  stance. If Close
0e60: 47 75 61 72 64 20 69 73 20 65 6e 61 62 6c 65 64  Guard is enabled
0e70: 2c 20 7b 40 63 6f 64 65 0a 20 20 20 20 20 2a 20  , {@code.     * 
0e80: 23 6f 70 65 6e 28 53 74 72 69 6e 67 29 7d 20 63  #open(String)} c
0e90: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 65  an be used to se
0ea0: 74 20 75 70 20 74 68 65 20 69 6e 73 74 61 6e 63  t up the instanc
0eb0: 65 20 74 6f 20 77 61 72 6e 20 6f 6e 0a 20 20 20  e to warn on.   
0ec0: 20 20 2a 20 66 61 69 6c 75 72 65 20 74 6f 20 63    * failure to c
0ed0: 6c 6f 73 65 2e 20 49 66 20 43 6c 6f 73 65 47 75  lose. If CloseGu
0ee0: 61 72 64 20 69 73 20 64 69 73 61 62 6c 65 64 2c  ard is disabled,
0ef0: 20 61 20 6e 6f 6e 2d 6e 75 6c 6c 20 6e 6f 2d 6f   a non-null no-o
0f00: 70 0a 20 20 20 20 20 2a 20 69 6e 73 74 61 6e 63  p.     * instanc
0f10: 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 20  e is returned.. 
0f20: 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69      */.    publi
0f30: 63 20 73 74 61 74 69 63 20 43 6c 6f 73 65 47 75  c static CloseGu
0f40: 61 72 64 20 67 65 74 28 29 20 7b 0a 20 20 20 20  ard get() {.    
0f50: 20 20 20 20 69 66 20 28 21 45 4e 41 42 4c 45 44      if (!ENABLED
0f60: 29 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ) {.            
0f70: 72 65 74 75 72 6e 20 4e 4f 4f 50 3b 0a 20 20 20  return NOOP;.   
0f80: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 72       }.        r
0f90: 65 74 75 72 6e 20 6e 65 77 20 43 6c 6f 73 65 47  eturn new CloseG
0fa0: 75 61 72 64 28 29 3b 0a 20 20 20 20 7d 0a 0a 20  uard();.    }.. 
0fb0: 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 55 73     /**.     * Us
0fc0: 65 64 20 74 6f 20 65 6e 61 62 6c 65 20 6f 72 20  ed to enable or 
0fd0: 64 69 73 61 62 6c 65 20 43 6c 6f 73 65 47 75 61  disable CloseGua
0fe0: 72 64 2e 20 4e 6f 74 65 20 74 68 61 74 20 43 6c  rd. Note that Cl
0ff0: 6f 73 65 47 75 61 72 64 20 6f 6e 6c 79 0a 20 20  oseGuard only.  
1000: 20 20 20 2a 20 77 61 72 6e 73 20 69 66 20 69 74     * warns if it
1010: 20 69 73 20 65 6e 61 62 6c 65 64 20 66 6f 72 20   is enabled for 
1020: 62 6f 74 68 20 61 6c 6c 6f 63 61 74 69 6f 6e 20  both allocation 
1030: 61 6e 64 20 66 69 6e 61 6c 69 7a 61 74 69 6f 6e  and finalization
1040: 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75  ..     */.    pu
1050: 62 6c 69 63 20 73 74 61 74 69 63 20 76 6f 69 64  blic static void
1060: 20 73 65 74 45 6e 61 62 6c 65 64 28 62 6f 6f 6c   setEnabled(bool
1070: 65 61 6e 20 65 6e 61 62 6c 65 64 29 20 7b 0a 20  ean enabled) {. 
1080: 20 20 20 20 20 20 20 45 4e 41 42 4c 45 44 20 3d         ENABLED =
1090: 20 65 6e 61 62 6c 65 64 3b 0a 20 20 20 20 7d 0a   enabled;.    }.
10a0: 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20  .    /**.     * 
10b0: 55 73 65 64 20 74 6f 20 72 65 70 6c 61 63 65 20  Used to replace 
10c0: 64 65 66 61 75 6c 74 20 52 65 70 6f 72 74 65 72  default Reporter
10d0: 20 75 73 65 64 20 74 6f 20 77 61 72 6e 20 6f 66   used to warn of
10e0: 20 43 6c 6f 73 65 47 75 61 72 64 0a 20 20 20 20   CloseGuard.    
10f0: 20 2a 20 76 69 6f 6c 61 74 69 6f 6e 73 2e 20 4d   * violations. M
1100: 75 73 74 20 62 65 20 6e 6f 6e 2d 6e 75 6c 6c 2e  ust be non-null.
1110: 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62  .     */.    pub
1120: 6c 69 63 20 73 74 61 74 69 63 20 76 6f 69 64 20  lic static void 
1130: 73 65 74 52 65 70 6f 72 74 65 72 28 52 65 70 6f  setReporter(Repo
1140: 72 74 65 72 20 72 65 70 6f 72 74 65 72 29 20 7b  rter reporter) {
1150: 0a 20 20 20 20 20 20 20 20 69 66 20 28 72 65 70  .        if (rep
1160: 6f 72 74 65 72 20 3d 3d 20 6e 75 6c 6c 29 20 7b  orter == null) {
1170: 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72  .            thr
1180: 6f 77 20 6e 65 77 20 4e 75 6c 6c 50 6f 69 6e 74  ow new NullPoint
1190: 65 72 45 78 63 65 70 74 69 6f 6e 28 22 72 65 70  erException("rep
11a0: 6f 72 74 65 72 20 3d 3d 20 6e 75 6c 6c 22 29 3b  orter == null");
11b0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
11c0: 20 20 20 52 45 50 4f 52 54 45 52 20 3d 20 72 65     REPORTER = re
11d0: 70 6f 72 74 65 72 3b 0a 20 20 20 20 7d 0a 0a 20  porter;.    }.. 
11e0: 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 52 65     /**.     * Re
11f0: 74 75 72 6e 73 20 6e 6f 6e 2d 6e 75 6c 6c 20 43  turns non-null C
1200: 6c 6f 73 65 47 75 61 72 64 2e 52 65 70 6f 72 74  loseGuard.Report
1210: 65 72 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20  er..     */.    
1220: 70 75 62 6c 69 63 20 73 74 61 74 69 63 20 52 65  public static Re
1230: 70 6f 72 74 65 72 20 67 65 74 52 65 70 6f 72 74  porter getReport
1240: 65 72 28 29 20 7b 0a 20 20 20 20 20 20 20 20 72  er() {.        r
1250: 65 74 75 72 6e 20 52 45 50 4f 52 54 45 52 3b 0a  eturn REPORTER;.
1260: 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 69 76 61      }..    priva
1270: 74 65 20 43 6c 6f 73 65 47 75 61 72 64 28 29 20  te CloseGuard() 
1280: 7b 7d 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20 20  {}..    /**.    
1290: 20 2a 20 49 66 20 43 6c 6f 73 65 47 75 61 72 64   * If CloseGuard
12a0: 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 7b 40 63   is enabled, {@c
12b0: 6f 64 65 20 6f 70 65 6e 7d 20 69 6e 69 74 69 61  ode open} initia
12c0: 6c 69 7a 65 73 20 74 68 65 20 69 6e 73 74 61 6e  lizes the instan
12d0: 63 65 0a 20 20 20 20 20 2a 20 77 69 74 68 20 61  ce.     * with a
12e0: 20 77 61 72 6e 69 6e 67 20 74 68 61 74 20 74 68   warning that th
12f0: 65 20 63 61 6c 6c 65 72 20 73 68 6f 75 6c 64 20  e caller should 
1300: 68 61 76 65 20 65 78 70 6c 69 63 69 74 6c 79 20  have explicitly 
1310: 63 61 6c 6c 65 64 20 74 68 65 0a 20 20 20 20 20  called the.     
1320: 2a 20 7b 40 63 6f 64 65 20 63 6c 6f 73 65 72 7d  * {@code closer}
1330: 20 6d 65 74 68 6f 64 20 69 6e 73 74 65 61 64 20   method instead 
1340: 6f 66 20 72 65 6c 79 69 6e 67 20 6f 6e 20 66 69  of relying on fi
1350: 6e 61 6c 69 7a 61 74 69 6f 6e 2e 0a 20 20 20 20  nalization..    
1360: 20 2a 0a 20 20 20 20 20 2a 20 40 70 61 72 61 6d   *.     * @param
1370: 20 63 6c 6f 73 65 72 20 6e 6f 6e 2d 6e 75 6c 6c   closer non-null
1380: 20 6e 61 6d 65 20 6f 66 20 65 78 70 6c 69 63 69   name of explici
1390: 74 20 74 65 72 6d 69 6e 61 74 69 6f 6e 20 6d 65  t termination me
13a0: 74 68 6f 64 0a 20 20 20 20 20 2a 20 40 74 68 72  thod.     * @thr
13b0: 6f 77 73 20 4e 75 6c 6c 50 6f 69 6e 74 65 72 45  ows NullPointerE
13c0: 78 63 65 70 74 69 6f 6e 20 69 66 20 63 6c 6f 73  xception if clos
13d0: 65 72 20 69 73 20 6e 75 6c 6c 2c 20 72 65 67 61  er is null, rega
13e0: 72 64 6c 65 73 73 20 6f 66 0a 20 20 20 20 20 2a  rdless of.     *
13f0: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
1400: 43 6c 6f 73 65 47 75 61 72 64 20 69 73 20 65 6e  CloseGuard is en
1410: 61 62 6c 65 64 0a 20 20 20 20 20 2a 2f 0a 20 20  abled.     */.  
1420: 20 20 70 75 62 6c 69 63 20 76 6f 69 64 20 6f 70    public void op
1430: 65 6e 28 53 74 72 69 6e 67 20 63 6c 6f 73 65 72  en(String closer
1440: 29 20 7b 0a 20 20 20 20 20 20 20 20 2f 2f 20 61  ) {.        // a
1450: 6c 77 61 79 73 20 70 65 72 66 6f 72 6d 20 74 68  lways perform th
1460: 65 20 63 68 65 63 6b 20 66 6f 72 20 76 61 6c 69  e check for vali
1470: 64 20 41 50 49 20 75 73 61 67 65 2e 2e 2e 0a 20  d API usage.... 
1480: 20 20 20 20 20 20 20 69 66 20 28 63 6c 6f 73 65         if (close
1490: 72 20 3d 3d 20 6e 75 6c 6c 29 20 7b 0a 20 20 20  r == null) {.   
14a0: 20 20 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e           throw n
14b0: 65 77 20 4e 75 6c 6c 50 6f 69 6e 74 65 72 45 78  ew NullPointerEx
14c0: 63 65 70 74 69 6f 6e 28 22 63 6c 6f 73 65 72 20  ception("closer 
14d0: 3d 3d 20 6e 75 6c 6c 22 29 3b 0a 20 20 20 20 20  == null");.     
14e0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 2f 2f 20     }.        // 
14f0: 2e 2e 2e 62 75 74 20 61 76 6f 69 64 20 61 6c 6c  ...but avoid all
1500: 6f 63 61 74 69 6e 67 20 61 6e 20 61 6c 6c 6f 63  ocating an alloc
1510: 61 74 69 6f 6e 53 69 74 65 20 69 66 20 64 69 73  ationSite if dis
1520: 61 62 6c 65 64 0a 20 20 20 20 20 20 20 20 69 66  abled.        if
1530: 20 28 74 68 69 73 20 3d 3d 20 4e 4f 4f 50 20 7c   (this == NOOP |
1540: 7c 20 21 45 4e 41 42 4c 45 44 29 20 7b 0a 20 20  | !ENABLED) {.  
1550: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e            return
1560: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
1570: 20 20 20 20 53 74 72 69 6e 67 20 6d 65 73 73 61      String messa
1580: 67 65 20 3d 20 22 45 78 70 6c 69 63 69 74 20 74  ge = "Explicit t
1590: 65 72 6d 69 6e 61 74 69 6f 6e 20 6d 65 74 68 6f  ermination metho
15a0: 64 20 27 22 20 2b 20 63 6c 6f 73 65 72 20 2b 20  d '" + closer + 
15b0: 22 27 20 6e 6f 74 20 63 61 6c 6c 65 64 22 3b 0a  "' not called";.
15c0: 20 20 20 20 20 20 20 20 61 6c 6c 6f 63 61 74 69          allocati
15d0: 6f 6e 53 69 74 65 20 3d 20 6e 65 77 20 54 68 72  onSite = new Thr
15e0: 6f 77 61 62 6c 65 28 6d 65 73 73 61 67 65 29 3b  owable(message);
15f0: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 69 76  .    }..    priv
1600: 61 74 65 20 54 68 72 6f 77 61 62 6c 65 20 61 6c  ate Throwable al
1610: 6c 6f 63 61 74 69 6f 6e 53 69 74 65 3b 0a 0a 20  locationSite;.. 
1620: 20 20 20 2f 2a 2a 0a 20 20 20 20 20 2a 20 4d 61     /**.     * Ma
1630: 72 6b 73 20 74 68 69 73 20 43 6c 6f 73 65 47 75  rks this CloseGu
1640: 61 72 64 20 69 6e 73 74 61 6e 63 65 20 61 73 20  ard instance as 
1650: 63 6c 6f 73 65 64 20 74 6f 20 61 76 6f 69 64 20  closed to avoid 
1660: 77 61 72 6e 69 6e 67 73 20 6f 6e 0a 20 20 20 20  warnings on.    
1670: 20 2a 20 66 69 6e 61 6c 69 7a 61 74 69 6f 6e 2e   * finalization.
1680: 0a 20 20 20 20 20 2a 2f 0a 20 20 20 20 70 75 62  .     */.    pub
1690: 6c 69 63 20 76 6f 69 64 20 63 6c 6f 73 65 28 29  lic void close()
16a0: 20 7b 0a 20 20 20 20 20 20 20 20 61 6c 6c 6f 63   {.        alloc
16b0: 61 74 69 6f 6e 53 69 74 65 20 3d 20 6e 75 6c 6c  ationSite = null
16c0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a  ;.    }..    /**
16d0: 0a 20 20 20 20 20 2a 20 49 66 20 43 6c 6f 73 65  .     * If Close
16e0: 47 75 61 72 64 20 69 73 20 65 6e 61 62 6c 65 64  Guard is enabled
16f0: 2c 20 6c 6f 67 73 20 61 20 77 61 72 6e 69 6e 67  , logs a warning
1700: 20 69 66 20 74 68 65 20 63 61 6c 6c 65 72 20 64   if the caller d
1710: 69 64 20 6e 6f 74 0a 20 20 20 20 20 2a 20 70 72  id not.     * pr
1720: 6f 70 65 72 6c 79 20 63 6c 65 61 6e 75 70 20 62  operly cleanup b
1730: 79 20 63 61 6c 6c 69 6e 67 20 61 6e 20 65 78 70  y calling an exp
1740: 6c 69 63 69 74 20 63 6c 6f 73 65 20 6d 65 74 68  licit close meth
1750: 6f 64 0a 20 20 20 20 20 2a 20 62 65 66 6f 72 65  od.     * before
1760: 20 66 69 6e 61 6c 69 7a 61 74 69 6f 6e 2e 20 49   finalization. I
1770: 66 20 43 6c 6f 73 65 47 75 61 72 64 20 69 73 20  f CloseGuard is 
1780: 64 69 73 61 62 6c 65 64 2c 20 6e 6f 20 61 63 74  disabled, no act
1790: 69 6f 6e 20 69 73 0a 20 20 20 20 20 2a 20 70 65  ion is.     * pe
17a0: 72 66 6f 72 6d 65 64 2e 0a 20 20 20 20 20 2a 2f  rformed..     */
17b0: 0a 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69 64  .    public void
17c0: 20 77 61 72 6e 49 66 4f 70 65 6e 28 29 20 7b 0a   warnIfOpen() {.
17d0: 20 20 20 20 20 20 20 20 69 66 20 28 61 6c 6c 6f          if (allo
17e0: 63 61 74 69 6f 6e 53 69 74 65 20 3d 3d 20 6e 75  cationSite == nu
17f0: 6c 6c 20 7c 7c 20 21 45 4e 41 42 4c 45 44 29 20  ll || !ENABLED) 
1800: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65  {.            re
1810: 74 75 72 6e 3b 0a 20 20 20 20 20 20 20 20 7d 0a  turn;.        }.
1820: 0a 20 20 20 20 20 20 20 20 53 74 72 69 6e 67 20  .        String 
1830: 6d 65 73 73 61 67 65 20 3d 0a 20 20 20 20 20 20  message =.      
1840: 20 20 20 20 20 20 20 20 20 20 28 22 41 20 72 65            ("A re
1850: 73 6f 75 72 63 65 20 77 61 73 20 61 63 71 75 69  source was acqui
1860: 72 65 64 20 61 74 20 61 74 74 61 63 68 65 64 20  red at attached 
1870: 73 74 61 63 6b 20 74 72 61 63 65 20 62 75 74 20  stack trace but 
1880: 6e 65 76 65 72 20 72 65 6c 65 61 73 65 64 2e 20  never released. 
1890: 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ".              
18a0: 20 20 20 2b 20 22 53 65 65 20 6a 61 76 61 2e 69     + "See java.i
18b0: 6f 2e 43 6c 6f 73 65 61 62 6c 65 20 66 6f 72 20  o.Closeable for 
18c0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 61  information on a
18d0: 76 6f 69 64 69 6e 67 20 72 65 73 6f 75 72 63 65  voiding resource
18e0: 20 6c 65 61 6b 73 2e 22 29 3b 0a 0a 20 20 20 20   leaks.");..    
18f0: 20 20 20 20 52 45 50 4f 52 54 45 52 2e 72 65 70      REPORTER.rep
1900: 6f 72 74 28 6d 65 73 73 61 67 65 2c 20 61 6c 6c  ort(message, all
1910: 6f 63 61 74 69 6f 6e 53 69 74 65 29 3b 0a 20 20  ocationSite);.  
1920: 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a 0a 20 20 20    }..    /**.   
1930: 20 20 2a 20 49 6e 74 65 72 66 61 63 65 20 74 6f    * Interface to
1940: 20 61 6c 6c 6f 77 20 63 75 73 74 6f 6d 69 7a 61   allow customiza
1950: 74 69 6f 6e 20 6f 66 20 72 65 70 6f 72 74 69 6e  tion of reportin
1960: 67 20 62 65 68 61 76 69 6f 72 2e 0a 20 20 20 20  g behavior..    
1970: 20 2a 2f 0a 20 20 20 20 70 75 62 6c 69 63 20 73   */.    public s
1980: 74 61 74 69 63 20 69 6e 74 65 72 66 61 63 65 20  tatic interface 
1990: 52 65 70 6f 72 74 65 72 20 7b 0a 20 20 20 20 20  Reporter {.     
19a0: 20 20 20 70 75 62 6c 69 63 20 76 6f 69 64 20 72     public void r
19b0: 65 70 6f 72 74 20 28 53 74 72 69 6e 67 20 6d 65  eport (String me
19c0: 73 73 61 67 65 2c 20 54 68 72 6f 77 61 62 6c 65  ssage, Throwable
19d0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 53 69 74 65 29   allocationSite)
19e0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2a  ;.    }..    /**
19f0: 0a 20 20 20 20 20 2a 20 44 65 66 61 75 6c 74 20  .     * Default 
1a00: 52 65 70 6f 72 74 65 72 20 77 68 69 63 68 20 72  Reporter which r
1a10: 65 70 6f 72 74 73 20 43 6c 6f 73 65 47 75 61 72  eports CloseGuar
1a20: 64 20 76 69 6f 6c 61 74 69 6f 6e 73 20 74 6f 20  d violations to 
1a30: 74 68 65 20 6c 6f 67 2e 0a 20 20 20 20 20 2a 2f  the log..     */
1a40: 0a 20 20 20 20 70 72 69 76 61 74 65 20 73 74 61  .    private sta
1a50: 74 69 63 20 66 69 6e 61 6c 20 63 6c 61 73 73 20  tic final class 
1a60: 44 65 66 61 75 6c 74 52 65 70 6f 72 74 65 72 20  DefaultReporter 
1a70: 69 6d 70 6c 65 6d 65 6e 74 73 20 52 65 70 6f 72  implements Repor
1a80: 74 65 72 20 7b 0a 20 20 20 20 20 20 20 20 40 4f  ter {.        @O
1a90: 76 65 72 72 69 64 65 20 70 75 62 6c 69 63 20 76  verride public v
1aa0: 6f 69 64 20 72 65 70 6f 72 74 20 28 53 74 72 69  oid report (Stri
1ab0: 6e 67 20 6d 65 73 73 61 67 65 2c 20 54 68 72 6f  ng message, Thro
1ac0: 77 61 62 6c 65 20 61 6c 6c 6f 63 61 74 69 6f 6e  wable allocation
1ad0: 53 69 74 65 29 20 7b 0a 20 20 20 20 20 20 20 20  Site) {.        
1ae0: 20 20 20 20 4c 6f 67 2e 77 28 6d 65 73 73 61 67      Log.w(messag
1af0: 65 2c 20 61 6c 6c 6f 63 61 74 69 6f 6e 53 69 74  e, allocationSit
1b00: 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  e);.        }.  
1b10: 20 20 7d 0a 7d 0a                                  }.}.