DatabaseUtils.java revision ce38b98feb1e7c9c1799eb270c40798d833aa9ae
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.database; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport org.apache.commons.codec.binary.Hex; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.ContentValues; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 238943737692169f564cd34a9c8d471f3a5d438712Fred Quintanaimport android.content.OperationApplicationException; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteAbortException; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteConstraintException; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteDatabase; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteDatabaseCorruptException; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteDiskIOException; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteException; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteFullException; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteProgram; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.database.sqlite.SQLiteStatement; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.TextUtils; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Config; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.FileNotFoundException; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.PrintStream; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.text.Collator; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.HashMap; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.Map; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Static utility methods for dealing with databases and {@link Cursor}s. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class DatabaseUtils { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "DatabaseUtils"; 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final boolean DEBUG = false; 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final boolean LOCAL_LOGV = DEBUG ? Config.LOGD : Config.LOGV; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String[] countProjection = new String[]{"count(*)"}; 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 55ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** One of the values returned by {@link #getSqlStatementType(String)}. */ 56ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static final int STATEMENT_SELECT = 1; 57ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** One of the values returned by {@link #getSqlStatementType(String)}. */ 58ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static final int STATEMENT_UPDATE = 2; 59ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** One of the values returned by {@link #getSqlStatementType(String)}. */ 60ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static final int STATEMENT_ATTACH = 3; 61ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** One of the values returned by {@link #getSqlStatementType(String)}. */ 62ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static final int STATEMENT_BEGIN = 4; 63ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** One of the values returned by {@link #getSqlStatementType(String)}. */ 64ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static final int STATEMENT_COMMIT = 5; 65ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** One of the values returned by {@link #getSqlStatementType(String)}. */ 66ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static final int STATEMENT_ABORT = 6; 67ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** One of the values returned by {@link #getSqlStatementType(String)}. */ 68ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static final int STATEMENT_OTHER = 7; 69ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Special function for writing an exception result at the header of 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a parcel, to be used when returning an exception from a transaction. 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exception will be re-thrown by the function in another process 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param reply Parcel to write to 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param e The Exception to be written. 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Parcel#writeNoException 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Parcel#writeException 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final void writeExceptionToParcel(Parcel reply, Exception e) { 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int code = 0; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean logException = true; 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (e instanceof FileNotFoundException) { 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 1; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project logException = false; 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof IllegalArgumentException) { 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 2; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof UnsupportedOperationException) { 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 3; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof SQLiteAbortException) { 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 4; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof SQLiteConstraintException) { 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 5; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof SQLiteDatabaseCorruptException) { 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 6; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof SQLiteFullException) { 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 7; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof SQLiteDiskIOException) { 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 8; 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof SQLiteException) { 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = 9; 1018943737692169f564cd34a9c8d471f3a5d438712Fred Quintana } else if (e instanceof OperationApplicationException) { 1028943737692169f564cd34a9c8d471f3a5d438712Fred Quintana code = 10; 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project reply.writeException(e); 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Writing exception to parcel", e); 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project reply.writeInt(code); 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project reply.writeString(e.getMessage()); 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (logException) { 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Writing exception to parcel", e); 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Special function for reading an exception result from the header of 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a parcel, to be used after receiving the result of a transaction. This 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will throw the exception for you if it had been written to the Parcel, 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * otherwise return and let you read the normal result data from the Parcel. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param reply Parcel to read from 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Parcel#writeNoException 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Parcel#readException 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final void readExceptionFromParcel(Parcel reply) { 1265b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick int code = reply.readExceptionCode(); 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (code == 0) return; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String msg = reply.readString(); 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DatabaseUtils.readExceptionFromParcel(reply, msg, code); 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void readExceptionWithFileNotFoundExceptionFromParcel( 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel reply) throws FileNotFoundException { 1345b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick int code = reply.readExceptionCode(); 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (code == 0) return; 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String msg = reply.readString(); 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (code == 1) { 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new FileNotFoundException(msg); 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DatabaseUtils.readExceptionFromParcel(reply, msg, code); 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1448943737692169f564cd34a9c8d471f3a5d438712Fred Quintana public static void readExceptionWithOperationApplicationExceptionFromParcel( 1458943737692169f564cd34a9c8d471f3a5d438712Fred Quintana Parcel reply) throws OperationApplicationException { 1465b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick int code = reply.readExceptionCode(); 1478943737692169f564cd34a9c8d471f3a5d438712Fred Quintana if (code == 0) return; 1488943737692169f564cd34a9c8d471f3a5d438712Fred Quintana String msg = reply.readString(); 1498943737692169f564cd34a9c8d471f3a5d438712Fred Quintana if (code == 10) { 1508943737692169f564cd34a9c8d471f3a5d438712Fred Quintana throw new OperationApplicationException(msg); 1518943737692169f564cd34a9c8d471f3a5d438712Fred Quintana } else { 1528943737692169f564cd34a9c8d471f3a5d438712Fred Quintana DatabaseUtils.readExceptionFromParcel(reply, msg, code); 1538943737692169f564cd34a9c8d471f3a5d438712Fred Quintana } 1548943737692169f564cd34a9c8d471f3a5d438712Fred Quintana } 1558943737692169f564cd34a9c8d471f3a5d438712Fred Quintana 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final void readExceptionFromParcel(Parcel reply, String msg, int code) { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (code) { 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 2: 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException(msg); 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 3: 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException(msg); 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 4: 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new SQLiteAbortException(msg); 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 5: 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new SQLiteConstraintException(msg); 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 6: 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new SQLiteDatabaseCorruptException(msg); 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 7: 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new SQLiteFullException(msg); 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 8: 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new SQLiteDiskIOException(msg); 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 9: 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new SQLiteException(msg); 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project reply.readException(code, msg); 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binds the given Object to the given SQLiteProgram using the proper 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * typing. For example, bind numbers as longs/doubles, and everything else 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a string by call toString() on it. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param prog the program to bind the object to 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the 1-based index to bind at 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void bindObjectToProgram(SQLiteProgram prog, int index, 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object value) { 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (value == null) { 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.bindNull(index); 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (value instanceof Double || value instanceof Float) { 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.bindDouble(index, ((Number)value).doubleValue()); 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (value instanceof Number) { 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.bindLong(index, ((Number)value).longValue()); 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (value instanceof Boolean) { 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Boolean bool = (Boolean)value; 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bool) { 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.bindLong(index, 1); 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.bindLong(index, 0); 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (value instanceof byte[]){ 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.bindBlob(index, (byte[]) value); 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.bindString(index, value.toString()); 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2118b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * Returns data type of the given object's value. 2128b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori *<p> 2138b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * Returned values are 2148b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * <ul> 2158b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * <li>{@link Cursor#FIELD_TYPE_NULL}</li> 2168b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * <li>{@link Cursor#FIELD_TYPE_INTEGER}</li> 2178b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * <li>{@link Cursor#FIELD_TYPE_FLOAT}</li> 2188b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * <li>{@link Cursor#FIELD_TYPE_STRING}</li> 2198b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * <li>{@link Cursor#FIELD_TYPE_BLOB}</li> 2208b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori *</ul> 2218b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori *</p> 2228b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * 2238b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * @param obj the object whose value type is to be returned 2248b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * @return object value type 2258b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori * @hide 2268b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori */ 2278b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori public static int getTypeOfObject(Object obj) { 2288b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori if (obj == null) { 2298b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori return Cursor.FIELD_TYPE_NULL; 2308b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori } else if (obj instanceof byte[]) { 2318b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori return Cursor.FIELD_TYPE_BLOB; 2328b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori } else if (obj instanceof Float || obj instanceof Double) { 2338b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori return Cursor.FIELD_TYPE_FLOAT; 2348b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori } else if (obj instanceof Long || obj instanceof Integer) { 2358b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori return Cursor.FIELD_TYPE_INTEGER; 2368b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori } else { 2378b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori return Cursor.FIELD_TYPE_STRING; 2388b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori } 2398b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori } 2408b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori 2418b0dd7da360d70920a37802eb455ba41500d3b45Vasu Nori /** 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Appends an SQL string to the given StringBuilder, including the opening 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and closing single quotes. Any single quotes internal to sqlString will 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be escaped. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is deprecated because we want to encourage everyone 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to use the "?" binding form. However, when implementing a 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ContentProvider, one may want to add WHERE clauses that were 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not provided by the caller. Since "?" is a positional form, 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using it in this case could break the caller because the 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * indexes would be shifted to accomodate the ContentProvider's 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * internal bindings. In that case, it may be necessary to 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * construct a WHERE clause manually. This method is useful for 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * those cases. 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sb the StringBuilder that the SQL string will be appended to 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sqlString the raw string to be appended, which may contain single 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * quotes 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void appendEscapedSQLString(StringBuilder sb, String sqlString) { 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append('\''); 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sqlString.indexOf('\'') != -1) { 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = sqlString.length(); 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < length; i++) { 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char c = sqlString.charAt(i); 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (c == '\'') { 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append('\''); 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(c); 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(sqlString); 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append('\''); 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 27522f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * SQL-escape a string. 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String sqlEscapeString(String value) { 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder escaper = new StringBuilder(); 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DatabaseUtils.appendEscapedSQLString(escaper, value); 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return escaper.toString(); 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Appends an Object to an SQL string with the proper escaping, etc. 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final void appendValueToSql(StringBuilder sql, Object value) { 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (value == null) { 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sql.append("NULL"); 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (value instanceof Boolean) { 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Boolean bool = (Boolean)value; 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bool) { 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sql.append('1'); 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sql.append('0'); 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project appendEscapedSQLString(sql, value.toString()); 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 30422f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Concatenates two SQL WHERE clauses, handling empty or null values. 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String concatenateWhere(String a, String b) { 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (TextUtils.isEmpty(a)) { 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b; 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (TextUtils.isEmpty(b)) { 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return a; 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 31622f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "(" + a + ") AND (" + b + ")"; 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 31922f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 32122f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana * return the collation key 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the collation key 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String getCollationKey(String name) { 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte [] arr = getCollationKeyInBytes(name); 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new String(arr, 0, getKeyLen(arr), "ISO8859_1"); 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Exception ex) { 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ""; 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 33322f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return the collation key in hex format 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the collation key in hex format 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String getHexCollationKey(String name) { 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte [] arr = getCollationKeyInBytes(name); 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] keys = Hex.encodeHex(arr); 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new String(keys, 0, getKeyLen(arr) * 2); 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 34422f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static int getKeyLen(byte[] arr) { 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (arr[arr.length - 1] != 0) { 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return arr.length; 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // remove zero "termination" 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return arr.length-1; 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 35322f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static byte[] getCollationKeyInBytes(String name) { 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mColl == null) { 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mColl = Collator.getInstance(); 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mColl.setStrength(Collator.PRIMARY); 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 35922f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana return mColl.getCollationKey(name).toByteArray(); 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 36122f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana 36222f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana private static Collator mColl = null; 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prints the contents of a Cursor to System.out. The position is restored 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after printing. 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void dumpCursor(Cursor cursor) { 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dumpCursor(cursor, System.out); 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prints the contents of a Cursor to a PrintSteam. The position is restored 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after printing. 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stream the stream to print to 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void dumpCursor(Cursor cursor, PrintStream stream) { 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream.println(">>>>> Dumping cursor " + cursor); 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (cursor != null) { 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startPos = cursor.getPosition(); 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursor.moveToPosition(-1); 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (cursor.moveToNext()) { 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dumpCurrentRow(cursor, stream); 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursor.moveToPosition(startPos); 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream.println("<<<<<"); 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prints the contents of a Cursor to a StringBuilder. The position 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is restored after printing. 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sb the StringBuilder to print to 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void dumpCursor(Cursor cursor, StringBuilder sb) { 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(">>>>> Dumping cursor " + cursor + "\n"); 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (cursor != null) { 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int startPos = cursor.getPosition(); 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursor.moveToPosition(-1); 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (cursor.moveToNext()) { 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dumpCurrentRow(cursor, sb); 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursor.moveToPosition(startPos); 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("<<<<<\n"); 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prints the contents of a Cursor to a String. The position is restored 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after printing. 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a String that contains the dumped cursor 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String dumpCursorToString(Cursor cursor) { 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dumpCursor(cursor, sb); 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prints the contents of a Cursor's current row to System.out. 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print from 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void dumpCurrentRow(Cursor cursor) { 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dumpCurrentRow(cursor, System.out); 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prints the contents of a Cursor's current row to a PrintSteam. 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stream the stream to print to 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void dumpCurrentRow(Cursor cursor, PrintStream stream) { 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] cols = cursor.getColumnNames(); 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream.println("" + cursor.getPosition() + " {"); 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = cols.length; 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i< length; i++) { 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String value; 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project value = cursor.getString(i); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (SQLiteException e) { 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // assume that if the getString threw this exception then the column is not 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // representable by a string, e.g. it is a BLOB. 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project value = "<unprintable>"; 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream.println(" " + cols[i] + '=' + value); 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream.println("}"); 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prints the contents of a Cursor's current row to a StringBuilder. 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sb the StringBuilder to print to 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void dumpCurrentRow(Cursor cursor, StringBuilder sb) { 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] cols = cursor.getColumnNames(); 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("" + cursor.getPosition() + " {\n"); 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = cols.length; 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < length; i++) { 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String value; 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project value = cursor.getString(i); 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (SQLiteException e) { 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // assume that if the getString threw this exception then the column is not 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // representable by a string, e.g. it is a BLOB. 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project value = "<unprintable>"; 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(" " + cols[i] + '=' + value + "\n"); 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("}\n"); 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Dump the contents of a Cursor's current row to a String. 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to print 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a String that contains the dumped cursor row 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String dumpCurrentRowToString(Cursor cursor) { 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dumpCurrentRow(cursor, sb); 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a String out of a field in a Cursor and writes it to a Map. 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The TEXT field to read 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into, with the field as the key 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorStringToContentValues(Cursor cursor, String field, 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ContentValues values) { 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursorStringToContentValues(cursor, field, values, field); 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a String out of a field in a Cursor and writes it to an InsertHelper. 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The TEXT field to read 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param inserter The InsertHelper to bind into 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the bind entry in the InsertHelper 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorStringToInsertHelper(Cursor cursor, String field, 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project InsertHelper inserter, int index) { 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inserter.bind(index, cursor.getString(cursor.getColumnIndexOrThrow(field))); 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a String out of a field in a Cursor and writes it to a Map. 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The TEXT field to read 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into, with the field as the key 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key to store the value with in the map 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorStringToContentValues(Cursor cursor, String field, 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ContentValues values, String key) { 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(key, cursor.getString(cursor.getColumnIndexOrThrow(field))); 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads an Integer out of a field in a Cursor and writes it to a Map. 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The INTEGER field to read 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into, with the field as the key 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorIntToContentValues(Cursor cursor, String field, ContentValues values) { 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursorIntToContentValues(cursor, field, values, field); 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a Integer out of a field in a Cursor and writes it to a Map. 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The INTEGER field to read 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into, with the field as the key 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key to store the value with in the map 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorIntToContentValues(Cursor cursor, String field, ContentValues values, 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String key) { 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int colIndex = cursor.getColumnIndex(field); 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!cursor.isNull(colIndex)) { 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(key, cursor.getInt(colIndex)); 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(key, (Integer) null); 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a Long out of a field in a Cursor and writes it to a Map. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The INTEGER field to read 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into, with the field as the key 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorLongToContentValues(Cursor cursor, String field, ContentValues values) 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursorLongToContentValues(cursor, field, values, field); 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a Long out of a field in a Cursor and writes it to a Map. 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The INTEGER field to read 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key to store the value with in the map 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorLongToContentValues(Cursor cursor, String field, ContentValues values, 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String key) { 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int colIndex = cursor.getColumnIndex(field); 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!cursor.isNull(colIndex)) { 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Long value = Long.valueOf(cursor.getLong(colIndex)); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(key, value); 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(key, (Long) null); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a Double out of a field in a Cursor and writes it to a Map. 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The REAL field to read 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorDoubleToCursorValues(Cursor cursor, String field, ContentValues values) 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursorDoubleToContentValues(cursor, field, values, field); 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reads a Double out of a field in a Cursor and writes it to a Map. 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor The cursor to read from 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param field The REAL field to read 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values The {@link ContentValues} to put the value into 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key to store the value with in the map 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorDoubleToContentValues(Cursor cursor, String field, 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ContentValues values, String key) { 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int colIndex = cursor.getColumnIndex(field); 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!cursor.isNull(colIndex)) { 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(key, cursor.getDouble(colIndex)); 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(key, (Double) null); 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read the entire contents of a cursor row and store them in a ContentValues. 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cursor the cursor to read from. 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values the {@link ContentValues} to put the row into. 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void cursorRowToContentValues(Cursor cursor, ContentValues values) { 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AbstractWindowedCursor awc = 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (cursor instanceof AbstractWindowedCursor) ? (AbstractWindowedCursor) cursor : null; 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] columns = cursor.getColumnNames(); 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = columns.length; 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < length; i++) { 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (awc != null && awc.isBlob(i)) { 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(columns[i], cursor.getBlob(i)); 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project values.put(columns[i], cursor.getString(i)); 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Query the table for the number of rows in the table. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param db the database the table is in 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param table the name of the table to query 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the number of rows in the table 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static long queryNumEntries(SQLiteDatabase db, String table) { 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Cursor cursor = db.query(table, countProjection, 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project null, null, null, null, null); 65522f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana try { 65622f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana cursor.moveToFirst(); 65722f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana return cursor.getLong(0); 65822f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana } finally { 65922f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana cursor.close(); 66022f711423e66750cd44a64e75372ea66304fb9a1Fred Quintana } 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility method to run the query on the db and return the value in the 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * first column of the first row. 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static long longForQuery(SQLiteDatabase db, String query, String[] selectionArgs) { 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SQLiteStatement prog = db.compileStatement(query); 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return longForQuery(prog, selectionArgs); 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.close(); 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility method to run the pre-compiled query and return the value in the 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * first column of the first row. 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static long longForQuery(SQLiteStatement prog, String[] selectionArgs) { 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (selectionArgs != null) { 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int size = selectionArgs.length; 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < size; i++) { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bindObjectToProgram(prog, i + 1, selectionArgs[i]); 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long value = prog.simpleQueryForLong(); 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return value; 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility method to run the query on the db and return the value in the 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * first column of the first row. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String stringForQuery(SQLiteDatabase db, String query, String[] selectionArgs) { 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SQLiteStatement prog = db.compileStatement(query); 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return stringForQuery(prog, selectionArgs); 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project prog.close(); 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility method to run the pre-compiled query and return the value in the 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * first column of the first row. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static String stringForQuery(SQLiteStatement prog, String[] selectionArgs) { 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (selectionArgs != null) { 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int size = selectionArgs.length; 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < size; i++) { 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bindObjectToProgram(prog, i + 1, selectionArgs[i]); 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String value = prog.simpleQueryForString(); 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return value; 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7202ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Reads a String out of a column in a Cursor and writes it to a ContentValues. 7212ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Adds nothing to the ContentValues if the column isn't present or if its value is null. 7222ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * 7232ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param cursor The cursor to read from 7242ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param column The column to read 7252ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param values The {@link ContentValues} to put the value into 7262ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana */ 7272ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana public static void cursorStringToContentValuesIfPresent(Cursor cursor, ContentValues values, 7282ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana String column) { 7292ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana final int index = cursor.getColumnIndexOrThrow(column); 7302ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana if (!cursor.isNull(index)) { 7312ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana values.put(column, cursor.getString(index)); 7322ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7332ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7342ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana 7352ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana /** 7362ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Reads a Long out of a column in a Cursor and writes it to a ContentValues. 7372ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Adds nothing to the ContentValues if the column isn't present or if its value is null. 7382ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * 7392ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param cursor The cursor to read from 7402ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param column The column to read 7412ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param values The {@link ContentValues} to put the value into 7422ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana */ 7432ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana public static void cursorLongToContentValuesIfPresent(Cursor cursor, ContentValues values, 7442ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana String column) { 7452ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana final int index = cursor.getColumnIndexOrThrow(column); 7462ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana if (!cursor.isNull(index)) { 7472ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana values.put(column, cursor.getLong(index)); 7482ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7492ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7502ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana 7512ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana /** 7522ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Reads a Short out of a column in a Cursor and writes it to a ContentValues. 7532ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Adds nothing to the ContentValues if the column isn't present or if its value is null. 7542ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * 7552ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param cursor The cursor to read from 7562ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param column The column to read 7572ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param values The {@link ContentValues} to put the value into 7582ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana */ 7592ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana public static void cursorShortToContentValuesIfPresent(Cursor cursor, ContentValues values, 7602ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana String column) { 7612ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana final int index = cursor.getColumnIndexOrThrow(column); 7622ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana if (!cursor.isNull(index)) { 7632ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana values.put(column, cursor.getShort(index)); 7642ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7652ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7662ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana 7672ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana /** 7682ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Reads a Integer out of a column in a Cursor and writes it to a ContentValues. 7692ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Adds nothing to the ContentValues if the column isn't present or if its value is null. 7702ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * 7712ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param cursor The cursor to read from 7722ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param column The column to read 7732ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param values The {@link ContentValues} to put the value into 7742ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana */ 7752ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana public static void cursorIntToContentValuesIfPresent(Cursor cursor, ContentValues values, 7762ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana String column) { 7772ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana final int index = cursor.getColumnIndexOrThrow(column); 7782ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana if (!cursor.isNull(index)) { 7792ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana values.put(column, cursor.getInt(index)); 7802ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7812ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7822ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana 7832ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana /** 7842ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Reads a Float out of a column in a Cursor and writes it to a ContentValues. 7852ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Adds nothing to the ContentValues if the column isn't present or if its value is null. 7862ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * 7872ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param cursor The cursor to read from 7882ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param column The column to read 7892ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param values The {@link ContentValues} to put the value into 7902ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana */ 7912ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana public static void cursorFloatToContentValuesIfPresent(Cursor cursor, ContentValues values, 7922ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana String column) { 7932ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana final int index = cursor.getColumnIndexOrThrow(column); 7942ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana if (!cursor.isNull(index)) { 7952ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana values.put(column, cursor.getFloat(index)); 7962ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7972ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 7982ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana 7992ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana /** 8002ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Reads a Double out of a column in a Cursor and writes it to a ContentValues. 8012ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * Adds nothing to the ContentValues if the column isn't present or if its value is null. 8022ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * 8032ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param cursor The cursor to read from 8042ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param column The column to read 8052ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana * @param values The {@link ContentValues} to put the value into 8062ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana */ 8072ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana public static void cursorDoubleToContentValuesIfPresent(Cursor cursor, ContentValues values, 8082ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana String column) { 8092ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana final int index = cursor.getColumnIndexOrThrow(column); 8102ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana if (!cursor.isNull(index)) { 8112ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana values.put(column, cursor.getDouble(index)); 8122ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 8132ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana } 8142ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana 8152ec6c5699181316e5a5c2cd293c006ac4a8bb101Fred Quintana /** 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class allows users to do multiple inserts into a table but 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * compile the SQL insert statement only once, which may increase 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * performance. 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class InsertHelper { 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final SQLiteDatabase mDb; 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final String mTableName; 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private HashMap<String, Integer> mColumns; 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mInsertSQL = null; 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private SQLiteStatement mInsertStatement = null; 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private SQLiteStatement mReplaceStatement = null; 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private SQLiteStatement mPreparedStatement = null; 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * These are the columns returned by sqlite's "PRAGMA 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * table_info(...)" command that we depend on. 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int TABLE_INFO_PRAGMA_COLUMNNAME_INDEX = 1; 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int TABLE_INFO_PRAGMA_DEFAULT_INDEX = 4; 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param db the SQLiteDatabase to insert into 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tableName the name of the table to insert into 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public InsertHelper(SQLiteDatabase db, String tableName) { 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDb = db; 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTableName = tableName; 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void buildSQL() throws SQLException { 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(128); 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("INSERT INTO "); 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(mTableName); 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(" ("); 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sbv = new StringBuilder(128); 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sbv.append("VALUES ("); 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i = 1; 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Cursor cur = null; 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cur = mDb.rawQuery("PRAGMA table_info(" + mTableName + ")", null); 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mColumns = new HashMap<String, Integer>(cur.getCount()); 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (cur.moveToNext()) { 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String columnName = cur.getString(TABLE_INFO_PRAGMA_COLUMNNAME_INDEX); 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String defaultValue = cur.getString(TABLE_INFO_PRAGMA_DEFAULT_INDEX); 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mColumns.put(columnName, i); 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("'"); 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(columnName); 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("'"); 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (defaultValue == null) { 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sbv.append("?"); 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sbv.append("COALESCE(?, "); 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sbv.append(defaultValue); 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sbv.append(")"); 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(i == cur.getCount() ? ") " : ", "); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sbv.append(i == cur.getCount() ? ");" : ", "); 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ++i; 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (cur != null) cur.close(); 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(sbv); 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInsertSQL = sb.toString(); 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (LOCAL_LOGV) Log.v(TAG, "insert statement is " + mInsertSQL); 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private SQLiteStatement getStatement(boolean allowReplace) throws SQLException { 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (allowReplace) { 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mReplaceStatement == null) { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mInsertSQL == null) buildSQL(); 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // chop "INSERT" off the front and prepend "INSERT OR REPLACE" instead. 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String replaceSQL = "INSERT OR REPLACE" + mInsertSQL.substring(6); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mReplaceStatement = mDb.compileStatement(replaceSQL); 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mReplaceStatement; 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mInsertStatement == null) { 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mInsertSQL == null) buildSQL(); 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInsertStatement = mDb.compileStatement(mInsertSQL); 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mInsertStatement; 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Performs an insert, adding a new row with the given values. 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values the set of values with which to populate the 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new row 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param allowReplace if true, the statement does "INSERT OR 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * REPLACE" instead of "INSERT", silently deleting any 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously existing rows that would cause a conflict 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the row ID of the newly inserted row, or -1 if an 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error occurred 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private synchronized long insertInternal(ContentValues values, boolean allowReplace) { 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SQLiteStatement stmt = getStatement(allowReplace); 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stmt.clearBindings(); 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (LOCAL_LOGV) Log.v(TAG, "--- inserting in table " + mTableName); 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (Map.Entry<String, Object> e: values.valueSet()) { 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String key = e.getKey(); 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i = getColumnIndex(key); 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DatabaseUtils.bindObjectToProgram(stmt, i, e.getValue()); 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (LOCAL_LOGV) { 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.v(TAG, "binding " + e.getValue() + " to column " + 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i + " (" + key + ")"); 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return stmt.executeInsert(); 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (SQLException e) { 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Error inserting " + values + " into table " + mTableName, e); 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the index of the specified column. This is index is suitagble for use 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in calls to bind(). 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key the column name 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the index of the column 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getColumnIndex(String key) { 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getStatement(false); 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Integer index = mColumns.get(key); 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index == null) { 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("column '" + key + "' is invalid"); 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return index; 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind the value to an index. A prepareForInsert() or prepareForReplace() 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bind(int index, double value) { 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindDouble(index, value); 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind the value to an index. A prepareForInsert() or prepareForReplace() 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bind(int index, float value) { 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindDouble(index, value); 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind the value to an index. A prepareForInsert() or prepareForReplace() 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bind(int index, long value) { 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindLong(index, value); 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind the value to an index. A prepareForInsert() or prepareForReplace() 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bind(int index, int value) { 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindLong(index, value); 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind the value to an index. A prepareForInsert() or prepareForReplace() 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bind(int index, boolean value) { 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindLong(index, value ? 1 : 0); 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind null to an index. A prepareForInsert() or prepareForReplace() 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bindNull(int index) { 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindNull(index); 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind the value to an index. A prepareForInsert() or prepareForReplace() 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bind(int index, byte[] value) { 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (value == null) { 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindNull(index); 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindBlob(index, value); 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bind the value to an index. A prepareForInsert() or prepareForReplace() 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without a matching execute() must have already have been called. 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index the index of the slot to which to bind 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value the value to bind 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void bind(int index, String value) { 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (value == null) { 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindNull(index); 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.bindString(index, value); 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Performs an insert, adding a new row with the given values. 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the table contains conflicting rows, an error is 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned. 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values the set of values with which to populate the 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new row 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the row ID of the newly inserted row, or -1 if an 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error occurred 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long insert(ContentValues values) { 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return insertInternal(values, false); 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Execute the previously prepared insert or replace using the bound values 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * since the last call to prepareForInsert or prepareForReplace. 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note that calling bind() and then execute() is not thread-safe. The only thread-safe 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * way to use this class is to call insert() or replace(). 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the row ID of the newly inserted row, or -1 if an 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error occurred 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long execute() { 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreparedStatement == null) { 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException("you must prepare this inserter before calling " 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "execute"); 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (LOCAL_LOGV) Log.v(TAG, "--- doing insert or replace in table " + mTableName); 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreparedStatement.executeInsert(); 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (SQLException e) { 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Error executing InsertHelper with table " + mTableName, e); 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // you can only call this once per prepare 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement = null; 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prepare the InsertHelper for an insert. The pattern for this is: 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>prepareForInsert() 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>bind(index, value); 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>bind(index, value); 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>... 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>bind(index, value); 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>execute(); 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void prepareForInsert() { 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement = getStatement(false); 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.clearBindings(); 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prepare the InsertHelper for a replace. The pattern for this is: 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>prepareForReplace() 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>bind(index, value); 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>bind(index, value); 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>... 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>bind(index, value); 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>execute(); 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void prepareForReplace() { 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement = getStatement(true); 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreparedStatement.clearBindings(); 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Performs an insert, adding a new row with the given values. 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the table contains conflicting rows, they are deleted 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and replaced with the new row. 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param values the set of values with which to populate the 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new row 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the row ID of the newly inserted row, or -1 if an 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error occurred 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long replace(ContentValues values) { 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return insertInternal(values, true); 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Close this object and release any resources associated with 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it. The behavior of calling <code>insert()</code> after 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling this method is undefined. 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void close() { 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mInsertStatement != null) { 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInsertStatement.close(); 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInsertStatement = null; 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mReplaceStatement != null) { 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mReplaceStatement.close(); 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mReplaceStatement = null; 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInsertSQL = null; 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mColumns = null; 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a db and populates it with the sql statements in sqlStatements. 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context the context to use to create the db 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dbName the name of the db to create 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dbVersion the version to set on the db 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sqlStatements the statements to use to populate the db. This should be a single string 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the form returned by sqlite3's <tt>.dump</tt> command (statements separated by 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * semicolons) 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static public void createDbFromSqlStatements( 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Context context, String dbName, int dbVersion, String sqlStatements) { 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SQLiteDatabase db = context.openOrCreateDatabase(dbName, 0, null); 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // TODO: this is not quite safe since it assumes that all semicolons at the end of a line 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // terminate statements. It is possible that a text field contains ;\n. We will have to fix 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // this if that turns out to be a problem. 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] statements = TextUtils.split(sqlStatements, ";\n"); 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String statement : statements) { 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (TextUtils.isEmpty(statement)) continue; 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project db.execSQL(statement); 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project db.setVersion(dbVersion); 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project db.close(); 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1177ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori 1178ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori /** 1179ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * Returns one of the following which represent the type of the given SQL statement. 1180ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <ol> 1181ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <li>{@link #STATEMENT_SELECT}</li> 1182ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <li>{@link #STATEMENT_UPDATE}</li> 1183ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <li>{@link #STATEMENT_ATTACH}</li> 1184ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <li>{@link #STATEMENT_BEGIN}</li> 1185ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <li>{@link #STATEMENT_COMMIT}</li> 1186ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <li>{@link #STATEMENT_ABORT}</li> 1187ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * <li>{@link #STATEMENT_OTHER}</li> 1188ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * </ol> 1189ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * @param sql the SQL statement whose type is returned by this method 1190ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori * @return one of the values listed above 1191ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori */ 1192ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori public static int getSqlStatementType(String sql) { 1193ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori sql = sql.trim(); 1194ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori if (sql.length() < 3) { 1195ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_OTHER; 1196ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } 1197ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori String prefixSql = sql.substring(0, 3).toUpperCase(); 1198ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori if (prefixSql.equals("SEL")) { 1199ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_SELECT; 1200ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } else if (prefixSql.equals("INS") || 1201ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori prefixSql.equals("UPD") || 1202ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori prefixSql.equals("REP") || 1203ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori prefixSql.equals("DEL")) { 1204ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_UPDATE; 1205ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } else if (prefixSql.equals("ATT")) { 1206ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_ATTACH; 1207ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } else if (prefixSql.equals("COM")) { 1208ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_COMMIT; 1209ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } else if (prefixSql.equals("END")) { 1210ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_COMMIT; 1211ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } else if (prefixSql.equals("ROL")) { 1212ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_ABORT; 1213ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } else if (prefixSql.equals("BEG")) { 1214ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_BEGIN; 1215ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } 1216ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori return STATEMENT_OTHER; 1217ce38b98feb1e7c9c1799eb270c40798d833aa9aeVasu Nori } 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1219