1 /* 2 * Copyright 2008, The Android Open Source Project 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * * Redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer. 9 * * Redistributions in binary form must reproduce the above copyright 10 * notice, this list of conditions and the following disclaimer in the 11 * documentation and/or other materials provided with the distribution. 12 * 13 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY 14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY 21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 24 */ 25 26 #ifndef ANDROID_WEBKIT_WEBCOREJNI_H 27 #define ANDROID_WEBKIT_WEBCOREJNI_H 28 29 #include "PlatformString.h" 30 #include <jni.h> 31 32 namespace android { 33 34 // A helper class that automatically deletes the local reference to the jobject 35 // returned from getRealObject. 36 class AutoJObject { 37 public: 38 ~AutoJObject() { 39 if (m_obj) 40 m_env->DeleteLocalRef(m_obj); 41 } 42 jobject get() const { 43 return m_obj; 44 } 45 // Releases the local reference to the caller. The caller *must* delete the 46 // local reference when it is done with it. 47 jobject release() { 48 jobject obj = m_obj; 49 m_obj = 0; 50 return obj; 51 } 52 JNIEnv* env() const { 53 return m_env; 54 } 55 private: 56 AutoJObject(JNIEnv* env, jobject obj) 57 : m_env(env) 58 , m_obj(obj) {} 59 JNIEnv* m_env; 60 jobject m_obj; 61 friend AutoJObject getRealObject(JNIEnv*, jobject); 62 }; 63 64 // Get the real object stored in the weak reference returned as an 65 // AutoJObject. 66 AutoJObject getRealObject(JNIEnv*, jobject); 67 68 // Helper method for check java exceptions. Returns true if an exception 69 // occurred and logs the exception. 70 bool checkException(JNIEnv* env); 71 72 // Create a WebCore::String object from a jstring object. 73 WebCore::String to_string(JNIEnv* env, jstring str); 74 75 } 76 77 #endif 78