helpers_android.h - mozsearch

Enable keyboard shortcuts

/*

 *  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_