OLD | NEW |
| (Empty) |
1 /* | |
2 * Copyright (c) 2013 The WebRTC project authors. All Rights Reserved. | |
3 * | |
4 * Use of this source code is governed by a BSD-style license | |
5 * that can be found in the LICENSE file in the root of the source | |
6 * tree. An additional intellectual property rights grant can be found | |
7 * in the file PATENTS. All contributing project authors may | |
8 * be found in the AUTHORS file in the root of the source tree. | |
9 */ | |
10 | |
11 #ifndef WEBRTC_MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_ | |
12 #define WEBRTC_MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_ | |
13 | |
14 #include <jni.h> | |
15 #include <string> | |
16 | |
17 // Abort the process if |jni| has a Java exception pending. | |
18 // TODO(henrika): merge with CHECK_JNI_EXCEPTION() in jni_helpers.h. | |
19 #define CHECK_EXCEPTION(jni) \ | |
20 RTC_CHECK(!jni->ExceptionCheck()) \ | |
21 << (jni->ExceptionDescribe(), jni->ExceptionClear(), "") | |
22 | |
23 namespace webrtc { | |
24 | |
25 // Return a |JNIEnv*| usable on this thread or NULL if this thread is detached. | |
26 JNIEnv* GetEnv(JavaVM* jvm); | |
27 | |
28 // Return a |jlong| that will correctly convert back to |ptr|. This is needed | |
29 // because the alternative (of silently passing a 32-bit pointer to a vararg | |
30 // function expecting a 64-bit param) picks up garbage in the high 32 bits. | |
31 jlong PointerTojlong(void* ptr); | |
32 | |
33 // JNIEnv-helper methods that wraps the API which uses the JNI interface | |
34 // pointer (JNIEnv*). It allows us to RTC_CHECK success and that no Java | |
35 // exception is thrown while calling the method. | |
36 jmethodID GetMethodID( | |
37 JNIEnv* jni, jclass c, const char* name, const char* signature); | |
38 | |
39 jmethodID GetStaticMethodID( | |
40 JNIEnv* jni, jclass c, const char* name, const char* signature); | |
41 | |
42 jclass FindClass(JNIEnv* jni, const char* name); | |
43 | |
44 jobject NewGlobalRef(JNIEnv* jni, jobject o); | |
45 | |
46 void DeleteGlobalRef(JNIEnv* jni, jobject o); | |
47 | |
48 // Return thread ID as a string. | |
49 std::string GetThreadId(); | |
50 | |
51 // Return thread ID as string suitable for debug logging. | |
52 std::string GetThreadInfo(); | |
53 | |
54 // Attach thread to JVM if necessary and detach at scope end if originally | |
55 // attached. | |
56 class AttachThreadScoped { | |
57 public: | |
58 explicit AttachThreadScoped(JavaVM* jvm); | |
59 ~AttachThreadScoped(); | |
60 JNIEnv* env(); | |
61 | |
62 private: | |
63 bool attached_; | |
64 JavaVM* jvm_; | |
65 JNIEnv* env_; | |
66 }; | |
67 | |
68 // Scoped holder for global Java refs. | |
69 template<class T> // T is jclass, jobject, jintArray, etc. | |
70 class ScopedGlobalRef { | |
71 public: | |
72 ScopedGlobalRef(JNIEnv* jni, T obj) | |
73 : jni_(jni), obj_(static_cast<T>(NewGlobalRef(jni, obj))) {} | |
74 ~ScopedGlobalRef() { | |
75 DeleteGlobalRef(jni_, obj_); | |
76 } | |
77 T operator*() const { | |
78 return obj_; | |
79 } | |
80 private: | |
81 JNIEnv* jni_; | |
82 T obj_; | |
83 }; | |
84 | |
85 } // namespace webrtc | |
86 | |
87 #endif // WEBRTC_MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_ | |
OLD | NEW |