Step 11. CursorWindow.writeToParcel
这个函数定义在frameworks/base/core/java/android/database/CursorWindow.java文件中:
-
public class CursorWindow extends SQLiteClosable implements Parcelable {
-
......
-
-
public void writeToParcel(Parcel dest, int flags) {
-
......
-
dest.writeStrongBinder(native_getBinder());
-
......
-
}
-
-
......
-
}
这个函数最主要的操作就是往数据流dest写入一个Binder对象,这个Binder对象是通过调用本地方法native_getBinder来得到的。
Step 12. CursorWindow.native_getBinder
这个函数定义在frameworks/base/core/jni/android_database_CursorWindow.cpp文件中:
-
static jobject native_getBinder(JNIEnv * env, jobject object)
-
{
-
CursorWindow * window = GET_WINDOW(env, object);
-
if (window) {
-
sp<IMemory> memory = window->getMemory();
-
if (memory != NULL) {
-
sp<IBinder> binder = memory->asBinder();
-
return javaObjectForIBinder(env, binder);
-
}
-
}
-
return NULL;
-
}
在前面的Step 8中,我们在C++层创建了一个CursorWindow对象,这个对象保存在Java层创建的CursorWindow对象的成员变量nWindow中,这里通过GET_WINDOW宏来把这个在C++层创建的CurosrWindow对象返回来:
-
#define GET_WINDOW(env, object) ((CursorWindow *)env->GetIntField(object, gWindowField))
获得了这个CursorWindow对象以后,就调用它的getMemory函数来获得一个IMemory接口,这是一个Binder接口,具体可以参考前面一篇文章
Android系统匿名共享内存(Anonymous Shared Memory)C++调用接口分析
。
Step 13. CursorWindow.getMemory
这个函数定义在frameworks/base/core/jni/CursorWindow.h文件中:
-
class CursorWindow
-
{
-
public:
-
......
-
-
sp<IMemory> getMemory() {return mMemory;}
-
-
......
-
}
这个CursorWindow对象的成员变量mMemory就是在前面Step 9中创建的了。
这样,在第三方应用程序这一侧创建的匿名共享存对象就可以传递给Content Provider来使用了。回到前面的Step 10中,所有的参数都就准备就绪以后,就通过Binder进程间通信机制把数据查询请求发送给相应的Content Proivder了。这个请求是在ContentProviderNative类的onTransact函数中响应的。
Step 14. ContentProviderNative.onTransact
这个函数定义在frameworks/base/core/java/android/content/ContentProviderNative.java文件中:
-
abstract public class ContentProviderNative extends Binder implements IContentProvider {
-
......
-
-
@Override
-
public boolean onTransact(int code, Parcel data, Parcel reply, int flags)
-
throws RemoteException {
-
try {
-
switch (code) {
-
case QUERY_TRANSACTION:
-
{
-
data.enforceInterface(IContentProvider.descriptor);
-
-
Uri url = Uri.CREATOR.createFromParcel(data);
-
-
// String[] projection
-
int num = data.readInt();
-
String[] projection = null;
-
if (num > 0) {
-
projection = new String[num];
-
for (int i = 0; i < num; i++) {
-
projection[i] = data.readString();
-
}
-
}
-
-
// String selection, String[] selectionArgs...
-
String selection = data.readString();
-
num = data.readInt();
-
String[] selectionArgs = null;
-
if (num > 0) {
-
selectionArgs = new String[num];
-
for (int i = 0; i < num; i++) {
-
selectionArgs[i] = data.readString();
-
}
-
}
-
-
String sortOrder = data.readString();
-
IContentObserver observer = IContentObserver.Stub.
-
asInterface(data.readStrongBinder());
-
CursorWindow window = CursorWindow.CREATOR.createFromParcel(data);
-
-
// Flag for whether caller wants the number of
-
// rows in the cursor and the position of the
-
// "_id" column index (or -1 if non-existent)
-
// Only to be returned if binder != null.
-
boolean wantsCursorMetadata = data.readInt() != 0;
-
-
IBulkCursor bulkCursor = bulkQuery(url, projection, selection,
-
selectionArgs, sortOrder, observer, window);
-
reply.writeNoException();
-
if (bulkCursor != null) {
-
reply.writeStrongBinder(bulkCursor.asBinder());
-
-
if (wantsCursorMetadata) {
-
reply.writeInt(bulkCursor.count());
-
reply.writeInt(BulkCursorToCursorAdaptor.findRowIdColumnIndex(
-
bulkCursor.getColumnNames()));
-
}
-
} else {
-
reply.writeStrongBinder(null);
-
}
-
-
return true;
-
}
-
......
-
}
-
} catch (Exception e) {
-
DatabaseUtils.writeExceptionToParcel(reply, e);
-
return true;
-
}
-
-
return super.onTransact(code, data, reply, flags);
-
}
-
-
......
-
}
这一步其实就是前面Step 10的逆操作,把请求参数从数据流data中读取出来。这里我们同样是重点关注下面这两个参数读取的步骤:
-
CursorWindow window = CursorWindow.CREATOR.createFromParcel(data);
-
-
// Flag for whether caller wants the number of
-
// rows in the cursor and the position of the
-
// "_id" column index (or -1 if non-existent)
-
// Only to be returned if binder != null.
-
boolean wantsCursorMetadata = data.readInt() != 0;
通过调用CursorWindow.CREATOR.createFromParcel函数来从数据流data中重建一个本地的CursorWindow对象;接着又将数据流data的下一个整数值读取出来,如果这个整数值不为0,变量wantsCursorMetadata的值就为true,说明Content Provider在返回IBulkCursor接口给第三方应用程序之前,要先实际执行一把数据库查询操作,以便把结果数据的元信息返回给第三方应用程序。
通过下面的代码我们可以看到,调用bulkQuery函数之后,就得到了一个IBulkCursor接口,这表示要返回的数据准备就绪了,但是这时候实际上还没有把结果数据从数据库中提取出来,而只是准备好了一个SQL查询计划,等到真正要使用这些结果数据时,系统才会真正执行查询数据库的操作:
-
if (wantsCursorMetadata) {
-
reply.writeInt(bulkCursor.count());
-
......
-
}
在将这个IBulkCursor接口返回给第三方应用程序之前,如果发现wantsCursorMetadata的值就为true,就会调用它的count函数来获得结果数据的总行数,这样就会导致系统真正去执行数据库查询操作,并把结果数据保存到前面得到的CursorWindow对象中的匿名共享内存中去。
下面我们就重点关注CursorWindow.CREATOR.createFromParcel函数是如何从数据流data中在本地构造一个CursorWindow对象的。
Step 15. CursorWindow.CREATOR.createFromParcel
这个函数定义在frameworks/base/core/java/android/database/CursorWindow.java文件中:
-
public class CursorWindow extends SQLiteClosable implements Parcelable {
-
......
-
-
private CursorWindow(Parcel source) {
-
IBinder nativeBinder = source.readStrongBinder();
-
......
-
-
native_init(nativeBinder);
-
}
-
-
......
-
-
public static final Parcelable.Creator<CursorWindow> CREATOR
-
= new Parcelable.Creator<CursorWindow>() {
-
public CursorWindow createFromParcel(Parcel source) {
-
return new CursorWindow(source);
-
}
-
-
......
-
};
-
-
......
-
}
在创建CursorWindow对象的过程中,首先是从数据流source中将在前面Step 10中写入的Binder接口读取出来,然后使用这个Binder接口来初始化这个CursorWindow对象,通过前面的Step 13,我们知道,这个Binder接口的实际类型为IMemory,它封装了对匿名共享内存的访问操作。初始化这个匿名共享内存对象的操作是由本地方法native_init函数来实现的,下面我们就看看它的实现。
本文转自 Luoshengyang 51CTO博客,原文链接:http://blog.51cto.com/shyluo/967002,如需转载请自行联系原作者