Home | History | Annotate | Download | only in jni 
      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