1 /* //device/libs/android_runtime/android_util_Binder.h 2 ** 3 ** Copyright 2006, The Android Open Source Project 4 ** 5 ** Licensed under the Apache License, Version 2.0 (the "License"); 6 ** you may not use this file except in compliance with the License. 7 ** You may obtain a copy of the License at 8 ** 9 ** http://www.apache.org/licenses/LICENSE-2.0 10 ** 11 ** Unless required by applicable law or agreed to in writing, software 12 ** distributed under the License is distributed on an "AS IS" BASIS, 13 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 ** See the License for the specific language governing permissions and 15 ** limitations under the License. 16 */ 17 18 #ifndef ANDROID_UTIL_BINDER_H 19 #define ANDROID_UTIL_BINDER_H 20 21 #include <binder/IBinder.h> 22 23 #include "jni.h" 24 25 namespace android { 26 27 /** 28 * Conversion to Java IBinder Object from C++ IBinder instance. 29 * 30 * WARNING: this function returns global and local references. This can be 31 * figured out using GetObjectRefType. Though, when this function is called 32 * from within a Java context, the local ref will automatically be cleaned 33 * up. If this is called outside of a Java frame, 34 * PushObjectFrame/PopObjectFrame can simulate this automatic cleanup. The 35 * platform provides ScopedLocalFrame as an RAII object for this. 36 */ 37 extern jobject javaObjectForIBinder(JNIEnv* env, const sp<IBinder>& val); 38 /** Conversion from Java IBinder Object to C++ IBinder instance. */ 39 extern sp<IBinder> ibinderForJavaObject(JNIEnv* env, jobject obj); 40 41 extern jobject newParcelFileDescriptor(JNIEnv* env, jobject fileDesc); 42 43 extern void set_dalvik_blockguard_policy(JNIEnv* env, jint strict_policy); 44 45 extern void signalExceptionForError(JNIEnv* env, jobject obj, status_t err, 46 bool canThrowRemoteException = false, int parcelSize = 0); 47 48 // does not take ownership of the exception, aborts if this is an error 49 void binder_report_exception(JNIEnv* env, jthrowable excep, const char* msg); 50 } 51 52 #endif 53