File: scoped_nullable_primitive_array.h

package info (click to toggle)
android-platform-frameworks-base 1%3A14~beta1-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 326,092 kB
  • sloc: java: 2,032,373; xml: 343,016; cpp: 304,181; python: 3,683; ansic: 2,090; sh: 1,871; makefile: 117; sed: 19
file content (103 lines) | stat: -rw-r--r-- 4,770 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
/*
 * Copyright (C) 2017 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef SCOPED_NULLABLE_PRIMITIVE_ARRAY_H
#define SCOPED_NULLABLE_PRIMITIVE_ARRAY_H

#include <jni.h>

namespace android {

#define ARRAY_TRAITS(ARRAY_TYPE, POINTER_TYPE, NAME)                                  \
class NAME ## ArrayTraits {                                                           \
public:                                                                               \
    static constexpr void getArrayRegion(JNIEnv* env, ARRAY_TYPE array, size_t start, \
                                         size_t len, POINTER_TYPE out) {              \
        env->Get ## NAME ## ArrayRegion(array, start, len, out);                      \
    }                                                                                 \
                                                                                      \
    static constexpr POINTER_TYPE getArrayElements(JNIEnv* env, ARRAY_TYPE array) {   \
        return env->Get ## NAME ## ArrayElements(array, nullptr);                     \
    }                                                                                 \
                                                                                      \
    static constexpr void releaseArrayElements(JNIEnv* env, ARRAY_TYPE array,         \
                                               POINTER_TYPE buffer, jint mode) {      \
        env->Release ## NAME ## ArrayElements(array, buffer, mode);                   \
    }                                                                                 \
};                                                                                    \

ARRAY_TRAITS(jbooleanArray, jboolean*, Boolean)
ARRAY_TRAITS(jbyteArray, jbyte*, Byte)
ARRAY_TRAITS(jcharArray, jchar*, Char)
ARRAY_TRAITS(jdoubleArray, jdouble*, Double)
ARRAY_TRAITS(jfloatArray, jfloat*, Float)
ARRAY_TRAITS(jintArray, jint*, Int)
ARRAY_TRAITS(jlongArray, jlong*, Long)
ARRAY_TRAITS(jshortArray, jshort*, Short)

#undef ARRAY_TRAITS

template<typename JavaArrayType, typename PrimitiveType, class Traits, size_t preallocSize = 10>
class ScopedArrayRO {
public:
    ScopedArrayRO(JNIEnv* env, JavaArrayType javaArray) : mEnv(env), mJavaArray(javaArray) {
        if (mJavaArray == nullptr) {
            mSize = 0;
            mRawArray = nullptr;
        } else {
            mSize = mEnv->GetArrayLength(mJavaArray);
            if (mSize <= preallocSize) {
                Traits::getArrayRegion(mEnv, mJavaArray, 0, mSize, mBuffer);
                mRawArray = mBuffer;
            } else {
                mRawArray = Traits::getArrayElements(mEnv, mJavaArray);
            }
        }
    }

    ~ScopedArrayRO() {
        if (mRawArray != nullptr && mRawArray != mBuffer) {
            Traits::releaseArrayElements(mEnv, mJavaArray, mRawArray, JNI_ABORT);
        }
    }

    const PrimitiveType* get() const { return mRawArray; }
    const PrimitiveType& operator[](size_t n) const { return mRawArray[n]; }
    size_t size() const { return mSize; }

private:
    JNIEnv* const mEnv;
    JavaArrayType mJavaArray;
    PrimitiveType* mRawArray;
    size_t mSize;
    PrimitiveType mBuffer[preallocSize];
    DISALLOW_COPY_AND_ASSIGN(ScopedArrayRO);
};

// ScopedNullable***ArrayRO provide convenient read-only access to Java array from JNI code.
// These accept nullptr. In that case, get() returns nullptr and size() returns 0.
using ScopedNullableBooleanArrayRO = ScopedArrayRO<jbooleanArray, jboolean, BooleanArrayTraits>;
using ScopedNullableByteArrayRO = ScopedArrayRO<jbyteArray, jbyte, ByteArrayTraits>;
using ScopedNullableCharArrayRO = ScopedArrayRO<jcharArray, jchar, CharArrayTraits>;
using ScopedNullableDoubleArrayRO = ScopedArrayRO<jdoubleArray, jdouble, DoubleArrayTraits>;
using ScopedNullableFloatArrayRO = ScopedArrayRO<jfloatArray, jfloat, FloatArrayTraits>;
using ScopedNullableIntArrayRO = ScopedArrayRO<jintArray, jint, IntArrayTraits>;
using ScopedNullableLongArrayRO = ScopedArrayRO<jlongArray, jlong, LongArrayTraits>;
using ScopedNullableShortArrayRO = ScopedArrayRO<jshortArray, jshort, ShortArrayTraits>;

}  // namespace android

#endif  // SCOPED_NULLABLE_PRIMITIVE_ARRAY_H