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 mWantsAllOnMoveCalls = d.wantsAllOnMoveCalls; 45fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown mCount = d.count; 46fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown if (d.window != null) { 47fb5a4964b8d402b39754f406dd2255035ff2148dJeff Brown setWindow(d.window); 489ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick } 499ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick } 509ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick 519ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick /** 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets a SelfDataChangeOberserver that can be sent to a remote 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * process to receive change notifications over IPC. 549ffdfa0c238fce3b85741d7f6828fd484cd8f195Brad Fitzpatrick * 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A SelfContentObserver hooked up to this Cursor 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 57d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown public IContentObserver getObserver() { 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mObserverBridge.getContentObserver(); 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 61d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown private void throwIfCursorIsClosed() { 62d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown if (mBulkCursor == null) { 63d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throw new StaleDataException("Attempted to access a cursor after it has been closed."); 64d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 65d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 66d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getCount() { 69d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mCount; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onMove(int oldPosition, int newPosition) { 75d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 76d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Make sure we have the proper window 790cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown if (mWindow == null 800cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown || newPosition < mWindow.getStartPosition() 810cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown || newPosition >= mWindow.getStartPosition() + mWindow.getNumRows()) { 82d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown setWindow(mBulkCursor.getWindow(newPosition)); 830cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown } else if (mWantsAllOnMoveCalls) { 840cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown mBulkCursor.onMove(newPosition); 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // We tried to get a window and failed 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Unable to get window because the remote process is dead"); 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Couldn't obtain a window, something is wrong 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mWindow == null) { 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void deactivate() { 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This will call onInvalidated(), so make sure to do it before calling release, 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // which is what actually makes the data set invalid. 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.deactivate(); 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 106d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown if (mBulkCursor != null) { 107d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown try { 108d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown mBulkCursor.deactivate(); 109d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } catch (RemoteException ex) { 110d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown Log.w(TAG, "Remote process exception when deactivating"); 111d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void close() { 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.close(); 118d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 119d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown if (mBulkCursor != null) { 120d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown try { 121d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown mBulkCursor.close(); 122d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } catch (RemoteException ex) { 123d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown Log.w(TAG, "Remote process exception when closing"); 124d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } finally { 125d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown mBulkCursor = null; 126d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown } 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean requery() { 132d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 133d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1350cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown mCount = mBulkCursor.requery(getObserver()); 1360cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown if (mCount != -1) { 1370cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown mPos = -1; 1380cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown closeWindow(); 1390cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown 1400cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown // super.requery() will call onChanged. Do it here instead of relying on the 1410cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown // observer from the far side so that observers can see a correct value for mCount 1420cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown // when responding to onChanged. 1430cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown super.requery(); 1440cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown return true; 1450cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown } else { 1460cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown deactivate(); 1470cde89f5f025b7826be009ebb9673b970e180e32Jeff Brown return false; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Exception ex) { 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "Unable to requery because the remote process exception " + ex.getMessage()); 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project deactivate(); 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] getColumnNames() { 158d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 159d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mColumns; 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bundle getExtras() { 165d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 166d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mBulkCursor.getExtras(); 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This should never happen because the system kills processes that are using remote 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // cursors when the provider process is killed. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException(e); 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bundle respond(Bundle extras) { 178d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown throwIfCursorIsClosed(); 179d2183654e03d589b120467f4e98da1b178ceeadbJeff Brown 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mBulkCursor.respond(extras); 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 1836dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen // the system kills processes that are using remote cursors when the provider process 1846dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen // is killed, but this can still happen if this is being called from the system process, 1856dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen // so, better to log and return an empty bundle. 1866dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen Log.w(TAG, "respond() threw RemoteException, returning an empty bundle.", e); 1876dc0ef005d31f1aaf277164e8bc79be9068e8bf2Karl Rosaen return Bundle.EMPTY; 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 191