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 |