Commit | Line | Data |
---|---|---|
59f0d218 FF |
1 | /* |
2 | * Copyright (C) 2007 The Android Open Source Project | |
3 | * | |
4 | * Licensed under the Apache License, Version 2.0 (the "License"); | |
5 | * you may not use this file except in compliance with the License. | |
6 | * You may obtain a copy of the License at | |
7 | * | |
8 | * http://www.apache.org/licenses/LICENSE-2.0 | |
9 | * | |
10 | * Unless required by applicable law or agreed to in writing, software | |
11 | * distributed under the License is distributed on an "AS IS" BASIS, | |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
13 | * See the License for the specific language governing permissions and | |
14 | * limitations under the License. | |
15 | */ | |
16 | ||
17 | /* | |
18 | * JNI helper functions. | |
19 | * | |
20 | * This file may be included by C or C++ code, which is trouble because jni.h | |
21 | * uses different typedefs for JNIEnv in each language. | |
22 | */ | |
23 | #ifndef _NATIVEHELPER_JNIHELP_H | |
24 | #define _NATIVEHELPER_JNIHELP_H | |
25 | ||
26 | #include "jni.h" | |
27 | #include "utils/Log.h" | |
28 | ||
29 | #ifndef NELEM | |
30 | # define NELEM(x) ((int) (sizeof(x) / sizeof((x)[0]))) | |
31 | #endif | |
32 | ||
33 | #ifdef __cplusplus | |
34 | extern "C" { | |
35 | #endif | |
36 | ||
37 | /* | |
38 | * Register one or more native methods with a particular class. | |
39 | */ | |
40 | int jniRegisterNativeMethods(C_JNIEnv* env, const char* className, | |
41 | const JNINativeMethod* gMethods, int numMethods); | |
42 | ||
43 | /* | |
44 | * Throw an exception with the specified class and an optional message. | |
45 | * The "className" argument will be passed directly to FindClass, which | |
46 | * takes strings with slashes (e.g. "java/lang/Object"). | |
47 | * | |
48 | * Returns 0 on success, nonzero if something failed (e.g. the exception | |
49 | * class couldn't be found). | |
50 | * | |
51 | * Currently aborts the VM if it can't throw the exception. | |
52 | */ | |
53 | int jniThrowException(C_JNIEnv* env, const char* className, const char* msg); | |
54 | ||
55 | /* | |
56 | * Throw a java.lang.RuntimeException, with an optional message. | |
57 | */ | |
58 | int jniThrowRuntimeException(JNIEnv* env, const char* msg); | |
59 | ||
60 | /* | |
61 | * Throw a java.io.IOException, generating the message from errno. | |
62 | */ | |
63 | int jniThrowIOException(C_JNIEnv* env, int errnum); | |
64 | ||
65 | /* | |
66 | * Create a java.io.FileDescriptor given an integer fd | |
67 | */ | |
68 | jobject jniCreateFileDescriptor(C_JNIEnv* env, int fd); | |
69 | ||
70 | /* | |
71 | * Get an int file descriptor from a java.io.FileDescriptor | |
72 | */ | |
73 | int jniGetFDFromFileDescriptor(C_JNIEnv* env, jobject fileDescriptor); | |
74 | ||
75 | /* | |
76 | * Set an int file descriptor to a java.io.FileDescriptor | |
77 | */ | |
78 | void jniSetFileDescriptorOfFD(C_JNIEnv* env, jobject fileDescriptor, int value); | |
79 | ||
80 | #ifdef __cplusplus | |
81 | } | |
82 | #endif | |
83 | ||
84 | ||
85 | /* | |
86 | * For C++ code, we provide inlines that map to the C functions. g++ always | |
87 | * inlines these, even on non-optimized builds. | |
88 | */ | |
89 | #if defined(__cplusplus) && !defined(JNI_FORCE_C) | |
90 | inline int jniRegisterNativeMethods(JNIEnv* env, const char* className, | |
91 | const JNINativeMethod* gMethods, int numMethods) | |
92 | { | |
93 | return jniRegisterNativeMethods(&env->functions, className, gMethods, | |
94 | numMethods); | |
95 | } | |
96 | inline int jniThrowException(JNIEnv* env, const char* className, | |
97 | const char* msg) | |
98 | { | |
99 | return jniThrowException(&env->functions, className, msg); | |
100 | } | |
101 | inline int jniThrowIOException(JNIEnv* env, int errnum) | |
102 | { | |
103 | return jniThrowIOException(&env->functions, errnum); | |
104 | } | |
105 | inline jobject jniCreateFileDescriptor(JNIEnv* env, int fd) | |
106 | { | |
107 | return jniCreateFileDescriptor(&env->functions, fd); | |
108 | } | |
109 | inline int jniGetFDFromFileDescriptor(JNIEnv* env, jobject fileDescriptor) | |
110 | { | |
111 | return jniGetFDFromFileDescriptor(&env->functions, fileDescriptor); | |
112 | } | |
113 | inline void jniSetFileDescriptorOfFD(JNIEnv* env, jobject fileDescriptor, | |
114 | int value) | |
115 | { | |
116 | return jniSetFileDescriptorOfFD(&env->functions, fileDescriptor, value); | |
117 | } | |
118 | #endif | |
119 | ||
120 | #endif /*_NATIVEHELPER_JNIHELP_H*/ |