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 android.content.ContentResolver; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.Uri; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Config; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.HandlerThread; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.ref.WeakReference; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.UnsupportedOperationException; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.HashMap; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.Map; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is an abstract cursor class that handles a lot of the common code 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that all cursors need to deal with and is provided for convenience reasons. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class AbstractCursor implements CrossProcessCursor { 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "Cursor"; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DataSetObservable mDataSetObservable = new DataSetObservable(); 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ContentObservable mContentObservable = new ContentObservable(); 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* -------------------------------------------------------- */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* These need to be implemented by subclasses */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public int getCount(); 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public String[] getColumnNames(); 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public String getString(int column); 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public short getShort(int column); 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public int getInt(int column); 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public long getLong(int column); 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public float getFloat(int column); 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public double getDouble(int column); 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project abstract public boolean isNull(int column); 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // TODO implement getBlob in all cursor types 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] getBlob(int column) { 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new UnsupportedOperationException("getBlob is not supported"); 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* -------------------------------------------------------- */ 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Methods that may optionally be implemented by subclasses */ 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns a pre-filled window, return NULL if no such window 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CursorWindow getWindow() { 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getColumnCount() { 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getColumnNames().length; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void deactivate() { 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project deactivateInternal(); 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void deactivateInternal() { 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mSelfObserver != null) { 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentResolver.unregisterContentObserver(mSelfObserver); 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelfObserverRegistered = false; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataSetObservable.notifyInvalidated(); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean requery() { 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mSelfObserver != null && mSelfObserverRegistered == false) { 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentResolver.registerContentObserver(mNotifyUri, true, mSelfObserver); 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelfObserverRegistered = true; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataSetObservable.notifyChanged(); 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isClosed() { 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mClosed; 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void close() { 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mClosed = true; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentObservable.unregisterAll(); 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project deactivateInternal(); 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean commitUpdates(Map<? extends Long,? extends Map<String,Object>> values) { 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean deleteRow() { 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function is called every time the cursor is successfully scrolled 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to a new position, giving the subclass a chance to update any state it 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * may have. If it returns false the move function will also do so and the 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cursor will scroll to the beforeFirst position. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oldPosition the position that we're moving from 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param newPosition the position that we're moving to 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the move is successful, false otherwise 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onMove(int oldPosition, int newPosition) { 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyStringToBuffer(int columnIndex, CharArrayBuffer buffer) { 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Default implementation, uses getString 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String result = getString(columnIndex); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (result != null) { 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] data = buffer.data; 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (data == null || data.length < result.length()) { 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project buffer.data = result.toCharArray(); 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result.getChars(0, result.length(), data, 0); 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project buffer.sizeCopied = result.length(); 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* -------------------------------------------------------- */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Implementation */ 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public AbstractCursor() { 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPos = -1; 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRowIdColumnIndex = -1; 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCurrentRowID = null; 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mUpdatedRows = new HashMap<Long, Map<String, Object>>(); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getPosition() { 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPos; 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean moveToPosition(int position) { 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Make sure position isn't past the end of the cursor 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int count = getCount(); 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (position >= count) { 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPos = count; 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Make sure position isn't before the beginning of the cursor 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (position < 0) { 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPos = -1; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Check for no-op moves, and skip the rest of the work for them 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (position == mPos) { 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean result = onMove(mPos, position); 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (result == false) { 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPos = -1; 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPos = position; 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRowIdColumnIndex != -1) { 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCurrentRowID = Long.valueOf(getLong(mRowIdColumnIndex)); 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copy data from cursor to CursorWindow 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param position start position of data 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param window 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void fillWindow(int position, CursorWindow window) { 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (position < 0 || position > getCount()) { 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project window.acquireReference(); 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int oldpos = mPos; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPos = position - 1; 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project window.clear(); 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project window.setStartPosition(position); 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int columnNum = getColumnCount(); 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project window.setNumColumns(columnNum); 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (moveToNext() && window.allocRow()) { 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < columnNum; i++) { 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String field = getString(i); 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (field != null) { 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!window.putString(field, mPos, i)) { 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project window.freeLastRow(); 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!window.putNull(mPos, i)) { 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project window.freeLastRow(); 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPos = oldpos; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IllegalStateException e){ 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // simply ignore it 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project window.releaseReference(); 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean move(int offset) { 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return moveToPosition(mPos + offset); 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean moveToFirst() { 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return moveToPosition(0); 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean moveToLast() { 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return moveToPosition(getCount() - 1); 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean moveToNext() { 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return moveToPosition(mPos + 1); 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean moveToPrevious() { 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return moveToPosition(mPos - 1); 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isFirst() { 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPos == 0 && getCount() != 0; 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isLast() { 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int cnt = getCount(); 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPos == (cnt - 1) && cnt != 0; 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isBeforeFirst() { 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (getCount() == 0) { 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPos == -1; 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isAfterLast() { 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (getCount() == 0) { 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPos == getCount(); 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getColumnIndex(String columnName) { 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Hack according to bug 903852 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int periodIndex = columnName.lastIndexOf('.'); 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (periodIndex != -1) { 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Exception e = new Exception(); 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "requesting column name with table name -- " + columnName, e); 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project columnName = columnName.substring(periodIndex + 1); 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String columnNames[] = getColumnNames(); 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = columnNames.length; 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < length; i++) { 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (columnNames[i].equalsIgnoreCase(columnName)) { 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return i; 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Config.LOGV) { 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (getCount() > 0) { 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.w("AbstractCursor", "Unknown column " + columnName); 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getColumnIndexOrThrow(String columnName) { 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int index = getColumnIndex(columnName); 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0) { 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("column '" + columnName + "' does not exist"); 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return index; 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getColumnName(int columnIndex) { 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getColumnNames()[columnIndex]; 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateBlob(int columnIndex, byte[] value) { 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, value); 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateString(int columnIndex, String value) { 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, value); 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateShort(int columnIndex, short value) { 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, Short.valueOf(value)); 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateInt(int columnIndex, int value) { 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, Integer.valueOf(value)); 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateLong(int columnIndex, long value) { 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, Long.valueOf(value)); 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateFloat(int columnIndex, float value) { 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, Float.valueOf(value)); 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateDouble(int columnIndex, double value) { 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, Double.valueOf(value)); 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean updateToNull(int columnIndex) { 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return update(columnIndex, null); 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean update(int columnIndex, Object obj) { 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!supportsUpdates()) { 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Long.valueOf() returns null sometimes! 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// Long rowid = Long.valueOf(getLong(mRowIdColumnIndex)); 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Long rowid = new Long(getLong(mRowIdColumnIndex)); 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rowid == null) { 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException("null rowid. mRowIdColumnIndex = " + mRowIdColumnIndex); 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mUpdatedRows) { 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Map<String, Object> row = mUpdatedRows.get(rowid); 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (row == null) { 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project row = new HashMap<String, Object>(); 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mUpdatedRows.put(rowid, row); 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project row.put(getColumnNames()[columnIndex], obj); 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns <code>true</code> if there are pending updates that have not yet been committed. 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return <code>true</code> if there are pending updates that have not yet been committed. 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasUpdates() { 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mUpdatedRows) { 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mUpdatedRows.size() > 0; 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void abortUpdates() { 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(mUpdatedRows) { 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mUpdatedRows.clear(); 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean commitUpdates() { 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return commitUpdates(null); 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean supportsUpdates() { 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mRowIdColumnIndex != -1; 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void registerContentObserver(ContentObserver observer) { 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentObservable.registerObserver(observer); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unregisterContentObserver(ContentObserver observer) { 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // cursor will unregister all observers when it close 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!mClosed) { 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentObservable.unregisterObserver(observer); 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 466935ae463d495d41155e27feb849768ad2b8b16dbDianne Hackborn * This is hidden until the data set change model has been re-evaluated. 467935ae463d495d41155e27feb849768ad2b8b16dbDianne Hackborn * @hide 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void notifyDataSetChange() { 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataSetObservable.notifyChanged(); 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 474935ae463d495d41155e27feb849768ad2b8b16dbDianne Hackborn * This is hidden until the data set change model has been re-evaluated. 475935ae463d495d41155e27feb849768ad2b8b16dbDianne Hackborn * @hide 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected DataSetObservable getDataSetObservable() { 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDataSetObservable; 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void registerDataSetObserver(DataSetObserver observer) { 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataSetObservable.registerObserver(observer); 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void unregisterDataSetObserver(DataSetObserver observer) { 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDataSetObservable.unregisterObserver(observer); 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Subclasses must call this method when they finish committing updates to notify all 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * observers. 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param selfChange 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onChange(boolean selfChange) { 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mSelfObserverLock) { 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentObservable.dispatchChange(selfChange); 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mNotifyUri != null && selfChange) { 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentResolver.notifyChange(mNotifyUri, mSelfObserver); 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Specifies a content URI to watch for changes. 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cr The content resolver from the caller's context. 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param notifyUri The URI to watch for changes. This can be a 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specific row URI, or a base URI for a whole class of content. 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setNotificationUri(ContentResolver cr, Uri notifyUri) { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mSelfObserverLock) { 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNotifyUri = notifyUri; 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentResolver = cr; 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mSelfObserver != null) { 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentResolver.unregisterContentObserver(mSelfObserver); 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelfObserver = new SelfContentObserver(this); 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentResolver.registerContentObserver(mNotifyUri, true, mSelfObserver); 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSelfObserverRegistered = true; 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getWantsAllOnMoveCalls() { 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bundle getExtras() { 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Bundle.EMPTY; 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bundle respond(Bundle extras) { 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Bundle.EMPTY; 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function returns true if the field has been updated and is 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * used in conjunction with {@link #getUpdatedField} to allow subclasses to 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support reading uncommitted updates. NOTE: This function and 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getUpdatedField} should be called together inside of a 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * block synchronized on mUpdatedRows. 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param columnIndex the column index of the field to check 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the field has been updated, false otherwise 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected boolean isFieldUpdated(int columnIndex) { 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRowIdColumnIndex != -1 && mUpdatedRows.size() > 0) { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Map<String, Object> updates = mUpdatedRows.get(mCurrentRowID); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (updates != null && updates.containsKey(getColumnNames()[columnIndex])) { 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function returns the uncommitted updated value for the field 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * at columnIndex. NOTE: This function and {@link #isFieldUpdated} should 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be called together inside of a block synchronized on mUpdatedRows. 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param columnIndex the column index of the field to retrieve 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the updated value 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected Object getUpdatedField(int columnIndex) { 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Map<String, Object> updates = mUpdatedRows.get(mCurrentRowID); 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return updates.get(getColumnNames()[columnIndex]); 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function throws CursorIndexOutOfBoundsException if 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the cursor position is out of bounds. Subclass implementations of 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the get functions should call this before attempting 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to retrieve data. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CursorIndexOutOfBoundsException 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void checkPosition() { 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (-1 == mPos || getCount() == mPos) { 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CursorIndexOutOfBoundsException(mPos, getCount()); 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() { 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mSelfObserver != null && mSelfObserverRegistered == true) { 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mContentResolver.unregisterContentObserver(mSelfObserver); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cursors use this class to track changes others make to their URI. 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected static class SelfContentObserver extends ContentObserver { 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WeakReference<AbstractCursor> mCursor; 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public SelfContentObserver(AbstractCursor cursor) { 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(null); 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCursor = new WeakReference<AbstractCursor>(cursor); 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean deliverSelfNotifications() { 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onChange(boolean selfChange) { 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AbstractCursor cursor = mCursor.get(); 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (cursor != null) { 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cursor.onChange(false); 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This HashMap contains a mapping from Long rowIDs to another Map 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that maps from String column names to new values. A NULL value means to 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remove an existing value, and all numeric values are in their class 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * forms, i.e. Integer, Long, Float, etc. 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected HashMap<Long, Map<String, Object>> mUpdatedRows; 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This must be set to the index of the row ID column by any 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * subclass that wishes to support updates. 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected int mRowIdColumnIndex; 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected int mPos; 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected Long mCurrentRowID; 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected ContentResolver mContentResolver; 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected boolean mClosed = false; 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Uri mNotifyUri; 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private ContentObserver mSelfObserver; 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final private Object mSelfObserverLock = new Object(); 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mSelfObserverRegistered; 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 639