Index: webrtc/modules/utility/include/helpers_android.h |
diff --git a/webrtc/modules/utility/include/helpers_android.h b/webrtc/modules/utility/include/helpers_android.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..2840ca965ea24a2f90837edd1b5440097caa91a0 |
--- /dev/null |
+++ b/webrtc/modules/utility/include/helpers_android.h |
@@ -0,0 +1,87 @@ |
+/* |
+ * Copyright (c) 2013 The WebRTC project authors. All Rights Reserved. |
+ * |
+ * Use of this source code is governed by a BSD-style license |
+ * that can be found in the LICENSE file in the root of the source |
+ * tree. An additional intellectual property rights grant can be found |
+ * in the file PATENTS. All contributing project authors may |
+ * be found in the AUTHORS file in the root of the source tree. |
+ */ |
+ |
+#ifndef WEBRTC_MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_ |
+#define WEBRTC_MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_ |
+ |
+#include <jni.h> |
+#include <string> |
+ |
+// Abort the process if |jni| has a Java exception pending. |
+// TODO(henrika): merge with CHECK_JNI_EXCEPTION() in jni_helpers.h. |
+#define CHECK_EXCEPTION(jni) \ |
+ RTC_CHECK(!jni->ExceptionCheck()) \ |
+ << (jni->ExceptionDescribe(), jni->ExceptionClear(), "") |
+ |
+namespace webrtc { |
+ |
+// Return a |JNIEnv*| usable on this thread or NULL if this thread is detached. |
+JNIEnv* GetEnv(JavaVM* jvm); |
+ |
+// Return a |jlong| that will correctly convert back to |ptr|. This is needed |
+// because the alternative (of silently passing a 32-bit pointer to a vararg |
+// function expecting a 64-bit param) picks up garbage in the high 32 bits. |
+jlong PointerTojlong(void* ptr); |
+ |
+// JNIEnv-helper methods that wraps the API which uses the JNI interface |
+// pointer (JNIEnv*). It allows us to RTC_CHECK success and that no Java |
+// exception is thrown while calling the method. |
+jmethodID GetMethodID( |
+ JNIEnv* jni, jclass c, const char* name, const char* signature); |
+ |
+jmethodID GetStaticMethodID( |
+ JNIEnv* jni, jclass c, const char* name, const char* signature); |
+ |
+jclass FindClass(JNIEnv* jni, const char* name); |
+ |
+jobject NewGlobalRef(JNIEnv* jni, jobject o); |
+ |
+void DeleteGlobalRef(JNIEnv* jni, jobject o); |
+ |
+// Return thread ID as a string. |
+std::string GetThreadId(); |
+ |
+// Return thread ID as string suitable for debug logging. |
+std::string GetThreadInfo(); |
+ |
+// Attach thread to JVM if necessary and detach at scope end if originally |
+// attached. |
+class AttachThreadScoped { |
+ public: |
+ explicit AttachThreadScoped(JavaVM* jvm); |
+ ~AttachThreadScoped(); |
+ JNIEnv* env(); |
+ |
+ private: |
+ bool attached_; |
+ JavaVM* jvm_; |
+ JNIEnv* env_; |
+}; |
+ |
+// Scoped holder for global Java refs. |
+template<class T> // T is jclass, jobject, jintArray, etc. |
+class ScopedGlobalRef { |
+ public: |
+ ScopedGlobalRef(JNIEnv* jni, T obj) |
+ : jni_(jni), obj_(static_cast<T>(NewGlobalRef(jni, obj))) {} |
+ ~ScopedGlobalRef() { |
+ DeleteGlobalRef(jni_, obj_); |
+ } |
+ T operator*() const { |
+ return obj_; |
+ } |
+ private: |
+ JNIEnv* jni_; |
+ T obj_; |
+}; |
+ |
+} // namespace webrtc |
+ |
+#endif // WEBRTC_MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_ |