81 lines
2.5 KiB
C
81 lines
2.5 KiB
C
|
/*
|
||
|
* 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 MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_
|
||
|
#define MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_
|
||
|
|
||
|
#include <jni.h>
|
||
|
|
||
|
#include <string>
|
||
|
|
||
|
#include "rtc_base/system/arch.h"
|
||
|
|
||
|
// 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(), "")
|
||
|
|
||
|
#if defined(WEBRTC_ARCH_X86)
|
||
|
// Dalvik JIT generated code doesn't guarantee 16-byte stack alignment on
|
||
|
// x86 - use force_align_arg_pointer to realign the stack at the JNI
|
||
|
// boundary. bugs.webrtc.org/9050
|
||
|
#define JNI_FUNCTION_ALIGN __attribute__((force_align_arg_pointer))
|
||
|
#else
|
||
|
#define JNI_FUNCTION_ALIGN
|
||
|
#endif
|
||
|
|
||
|
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);
|
||
|
|
||
|
// 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_;
|
||
|
};
|
||
|
|
||
|
} // namespace webrtc
|
||
|
|
||
|
#endif // MODULES_UTILITY_INCLUDE_HELPERS_ANDROID_H_
|