Clean up base::android::Init/GetApplicationContext()

- Modify InitApplicationContext() to take a ScopedJavaRef
- Clarify documentation


Review URL: http://codereview.chromium.org/8894002

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@114010 0039d316-1c4b-4281-b951-d872f2087c98

base/android/jni_android.cc

@@ -6,7 +6,6 @@
 
 #include <map>
 
-#include "base/android/scoped_java_ref.h"
 #include "base/atomicops.h"
 #include "base/lazy_instance.h"
 #include "base/logging.h"
@@ -55,7 +54,6 @@ namespace android {
 JNIEnv* AttachCurrentThread() {
   if (!g_jvm)
     return NULL;
-
   JNIEnv* env = NULL;
   jint ret = g_jvm->AttachCurrentThread(&env, NULL);
   DCHECK_EQ(ret, JNI_OK);
@@ -74,9 +72,9 @@ void InitVM(JavaVM* vm) {
   g_jvm = vm;
 }
 
-void InitApplicationContext(jobject context) {
+void InitApplicationContext(const JavaRef<jobject>& context) {
   DCHECK(!g_application_context);
-  g_application_context = context;
+  g_application_context = context.env()->NewGlobalRef(context.obj());
 }
 
 jobject GetApplicationContext() {

base/android/jni_android.h

@@ -8,6 +8,8 @@
 #include <jni.h>
 #include <sys/types.h>
 
+#include "base/android/scoped_java_ref.h"
+
 namespace base {
 namespace android {
 
@@ -21,13 +23,15 @@ void DetachFromVM();
 // InitApplicationContext().
 void InitVM(JavaVM* vm);
 
-// Initializes the global application context object. The |context| should be
-// the global reference of application context object.  It is not necessarily
-// called after InitVM().
+// Initializes the global application context object. The |context| can be any
+// valid reference to the application context. Internally holds a global ref to
+// the context. InitVM and InitApplicationContext maybe called in either order.
 // TODO: We might combine InitVM() and InitApplicationContext() into one method.
-void InitApplicationContext(jobject context);
+void InitApplicationContext(const JavaRef<jobject>& context);
 
-// Returns the application context assigned by InitApplicationContext().
+// Gets a global ref to the application context set with
+// InitApplicationContext(). Ownership is retained by the function - the caller
+// must NOT release it.
 jobject GetApplicationContext();
 
 // Gets the method ID from the class name. Clears the pending Java exception