20認識so里的JNI_OnLoad()函數.doc

20.認識*.so里的JNI_OnLoad()函數當Android的VM(VirtualMachine)執(zhí)行到C組件(即*so文件)里的System.loadLibrary()函數時，首先會去執(zhí)行C組件里的JNI_OnLoad()函數。它的用途有二：1.告訴VM此C組件使用那一個JNI版本。如果你的*.so文件沒有提供JNI_OnLoad()函數，VM會默認該*.so檔是使用最老的JNI1.1版本。由于新版的JNI做了許多擴充，如果需要使用JNI的新版功能，例如JNI1.4的java.nio.ByteBuffer,就必須藉由JNI_OnLoad()函數來告知VM。2.由于VM執(zhí)行到System.loadLibrary()函數時，就會立即先呼叫JNI_OnLoad()，所以C組件的開發(fā)者可以藉由JNI_OnLoad()來進行C組件內的初期值之設定(Initialization)。例如，在Android的/system/lib/libmedia_jni.so檔案里，就提供了JNI_OnLoad()函數，其程序代碼片段為：/#defineLOG_NDEBUG0#defineLOG_TAGMediaPlayer-JNIjintJNI_OnLoad(JavaVM*vm,void*reserved)JNIEnv*env=NULL；jintresult=-1；if(vm-GetEnv(void*)&env,JNI_VERSION_1_4)!=JNI_OK)LOGE(ERROR:GetEnvfailedn)；gotobail；assert(env!=NULL)；if(register_android_media_MediaPlayer(env)0)LOGE(ERROR:MediaPlayernativeregistrationfailedn)；gotobail；if(register_android_media_MediaRecorder(env)0)LOGE(ERROR:MediaRecordernativeregistrationfailedn)；gotobail；if(register_android_media_MediaScanner(env)0)LOGE(ERROR:MediaScannernativeregistrationfailedn)；gotobail；if(register_android_media_MediaMetadataRetriever(env)0)LOGE(ERROR:MediaMetadataRetrievernativeregistrationfailedn)；gotobail；/*success-returnvalidversionnumber*/result=JNI_VERSION_1_4；bail:returnresult；/KTHXBYE此函數回傳JNI_VERSION_1_4值給VM，于是VM知道了其所使用的JNI版本了。此外，它也做了一些初期的動作(可呼叫任何本地函數)，例如指令：if(register_android_media_MediaPlayer(env)GetEnv(void*)&env,JNI_VERSION_1_4)!=JNI_OK)LOGE(ERROR:GetEnvfailedn)；gotobail；由于VM通常是多執(zhí)行緒(Multi-threading)的執(zhí)行環(huán)境。每一個執(zhí)行緒在呼叫JNI_OnLoad()時，所傳遞進來的JNIEnv指標值都是不同的。為了配合這種多執(zhí)行緒的環(huán)境，C組件開發(fā)者在撰寫本地函數時，可藉由JNIEnv指標值之不同而避免執(zhí)行緒的數據沖突問題，才能確保所寫的本地函數能安全地在Android的多執(zhí)行緒VM里安全地執(zhí)行。基于這個理由，當在呼叫C組件的函數時，都會將JNIEnv指標值傳遞給它，如下：jintJNI_OnLoad(JavaVM*vm,void*reserved)JNIEnv*env=NULL；.if(register_android_media_MediaPlayer(env)MonitorEnter(env,obj)!=JNI_OK)查看是否已經有其它執(zhí)行緒進入此對象，如果沒有，此執(zhí)行緒