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.os.Bundle; 207cd51efcbd2d083bf577696591ef1769034f7e2fJeff Hamiltonimport android.os.RemoteException; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 24d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown * Adapts an {@link IBulkCursor} to a {@link Cursor} for use in the local process. 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class BulkCursorToCursorAdaptor extends AbstractWindowedCursor { 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "BulkCursor"; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 31d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown private SelfContentObserver mObserverBridge = new SelfContentObserver(this); 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private IBulkCursor mBulkCursor; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String[] mColumns; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mWantsAllOnMoveCalls; 35fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown private int mCount; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 38d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown * Initializes the adaptor. 39d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown * Must be called before first use. 409ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick */ 41fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown public void initialize(BulkCursorDescriptor d) { 42fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown mBulkCursor = d.cursor; 43fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown mColumns = d.columnNames; 44fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown mRowIdColumnIndex = DatabaseUtils.findRowIdColumnIndex(mColumns); 45fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown mWantsAllOnMoveCalls = d.wantsAllOnMoveCalls; 46fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown mCount = d.count; 47fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown if (d.window != null) { 48fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown setWindow(d.window); 499ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick } 509ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick } 519ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick 529ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick /** 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets a SelfDataChangeOberserver that can be sent to a remote 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * process to receive change notifications over IPC. 559ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick * 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A SelfContentObserver hooked up to this Cursor 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 58d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown public IContentObserver getObserver() { 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mObserverBridge.getContentObserver(); 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 62d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown private void throwIfCursorIsClosed() { 63d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown if (mBulkCursor == null) { 64d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throw new StaleDataException("Attempted to access a cursor after it has been closed."); 65d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 66d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 67d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getCount() { 70d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mCount; 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onMove(int oldPosition, int newPosition) { 76d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 77d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Make sure we have the proper window 800cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown if (mWindow == null 810cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown || newPosition < mWindow.getStartPosition() 820cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown || newPosition >= mWindow.getStartPosition() + mWindow.getNumRows()) { 83d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown setWindow(mBulkCursor.getWindow(newPosition)); 840cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown } else if (mWantsAllOnMoveCalls) { 850cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown mBulkCursor.onMove(newPosition); 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We tried to get a window and failed 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Unable to get window because the remote process is dead"); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Couldn't obtain a window, something is wrong 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mWindow == null) { 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void deactivate() { 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This will call onInvalidated(), so make sure to do it before calling release, 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // which is what actually makes the data set invalid. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.deactivate(); 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 107d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown if (mBulkCursor != null) { 108d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown try { 109d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown mBulkCursor.deactivate(); 110d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } catch (RemoteException ex) { 111d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown Log.w(TAG, "Remote process exception when deactivating"); 112d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void close() { 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.close(); 119d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 120d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown if (mBulkCursor != null) { 121d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown try { 122d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown mBulkCursor.close(); 123d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } catch (RemoteException ex) { 124d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown Log.w(TAG, "Remote process exception when closing"); 125d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } finally { 126d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown mBulkCursor = null; 127d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean requery() { 133d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 134d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1360cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown mCount = mBulkCursor.requery(getObserver()); 1370cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown if (mCount != -1) { 1380cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown mPos = -1; 1390cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown closeWindow(); 1400cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown 1410cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown // super.requery() will call onChanged. Do it here instead of relying on the 1420cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown // observer from the far side so that observers can see a correct value for mCount 1430cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown // when responding to onChanged. 1440cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown super.requery(); 1450cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown return true; 1460cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown } else { 1470cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown deactivate(); 1480cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown return false; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Exception ex) { 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Unable to requery because the remote process exception " + ex.getMessage()); 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project deactivate(); 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] getColumnNames() { 159d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 160d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mColumns; 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bundle getExtras() { 166d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 167d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mBulkCursor.getExtras(); 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This should never happen because the system kills processes that are using remote 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // cursors when the provider process is killed. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException(e); 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bundle respond(Bundle extras) { 179d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 180d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mBulkCursor.respond(extras); 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 1846dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen // the system kills processes that are using remote cursors when the provider process 1856dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen // is killed, but this can still happen if this is being called from the system process, 1866dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen // so, better to log and return an empty bundle. 1876dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen Log.w(TAG, "respond() threw RemoteException, returning an empty bundle.", e); 1886dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen return Bundle.EMPTY; 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 192