OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef BASE_ANDROID_JNI_ANDROID_H_ | 5 #ifndef BASE_ANDROID_JNI_ANDROID_H_ |
6 #define BASE_ANDROID_JNI_ANDROID_H_ | 6 #define BASE_ANDROID_JNI_ANDROID_H_ |
7 | 7 |
8 #include <jni.h> | 8 #include <jni.h> |
9 #include <sys/types.h> | 9 #include <sys/types.h> |
10 | 10 |
(...skipping 12 matching lines...) Expand all Loading... |
23 | 23 |
24 // Initializes the global application context object. The |context| should be | 24 // Initializes the global application context object. The |context| should be |
25 // the global reference of application context object. It is not necessarily | 25 // the global reference of application context object. It is not necessarily |
26 // called after InitVM(). | 26 // called after InitVM(). |
27 // TODO: We might combine InitVM() and InitApplicationContext() into one method. | 27 // TODO: We might combine InitVM() and InitApplicationContext() into one method. |
28 void InitApplicationContext(jobject context); | 28 void InitApplicationContext(jobject context); |
29 | 29 |
30 // Returns the application context assigned by InitApplicationContext(). | 30 // Returns the application context assigned by InitApplicationContext(). |
31 jobject GetApplicationContext(); | 31 jobject GetApplicationContext(); |
32 | 32 |
33 // Wraps a method ID. | 33 // Gets the method ID from the class name. Clears the pending Java exception |
34 class MethodID { | 34 // and returns NULL if the method is not found. Caches results. Note that |
35 public: | 35 // GetMethodID() below avoids a class lookup, but does not cache results. |
36 jmethodID id() { return id_; } | 36 // Strings passed to this function are held in the cache and MUST remain valid |
37 protected: | 37 // beyond the duration of all future calls to this function, across all |
38 // Gets the method ID from the class name. Clears the pending Java exception | 38 // threads. In practice, this means that the function should only be used with |
39 // and returns NULL if the method is not found. Note that GetMethodID() below | 39 // string constants. |
40 // avoids a class lookup, so should be used in preference when possible. | 40 jmethodID GetMethodIDFromClassName(JNIEnv* env, |
41 MethodID(JNIEnv* env, const char* class_name, const char* method, | 41 const char* class_name, |
42 const char* jni_signature); | 42 const char* method, |
43 private: | 43 const char* jni_signature); |
44 jmethodID id_; | |
45 }; | |
46 | 44 |
47 // Get the method ID for a method. Will clear the pending Java | 45 // Get the method ID for a method. Will clear the pending Java |
48 // exception and return 0 if the method is not found. | 46 // exception and return 0 if the method is not found. |
49 jmethodID GetMethodID(JNIEnv* env, | 47 jmethodID GetMethodID(JNIEnv* env, |
50 jclass clazz, | 48 jclass clazz, |
51 const char* const method, | 49 const char* const method, |
52 const char* const jni_signature); | 50 const char* const jni_signature); |
53 | 51 |
54 // Get the method ID for a class static method. Will clear the pending Java | 52 // Get the method ID for a class static method. Will clear the pending Java |
55 // exception and return 0 if the method is not found. | 53 // exception and return 0 if the method is not found. |
(...skipping 10 matching lines...) Expand all Loading... |
66 const char* jni_signature); | 64 const char* jni_signature); |
67 | 65 |
68 // Returns true if an exception is pending in the provided JNIEnv*. If an | 66 // Returns true if an exception is pending in the provided JNIEnv*. If an |
69 // exception is pending, this function prints and then clears it. | 67 // exception is pending, this function prints and then clears it. |
70 bool CheckException(JNIEnv* env); | 68 bool CheckException(JNIEnv* env); |
71 | 69 |
72 } // namespace android | 70 } // namespace android |
73 } // namespace base | 71 } // namespace base |
74 | 72 |
75 #endif // BASE_ANDROID_JNI_ANDROID_H_ | 73 #endif // BASE_ANDROID_JNI_ANDROID_H_ |
OLD | NEW |