用于获取/释放资源的JNI C ++模板

时间:2012-10-22 18:16:06

标签: c++ templates java-native-interface release

从C ++代码获取/释放JNI资源的推荐模板集或库是什么?

“糟糕”的例子:

//C++ code
extern "C"
JNIEXPORT void JNICALL Java_ClassName_MethodName
  (JNIEnv *env, jobject obj, jstring javaString)
{
    //Get the native string from javaString
    const char *nativeString = env->GetStringUTFChars(javaString, 0);

    //Do something with the nativeString

    //DON'T FORGET THIS LINE!!!
    env->ReleaseStringUTFChars(javaString, nativeString);
}

显然,每个人都使用模板集,而不是上面的代码。

对于jstring,当对象超出范围时,它调用GetStringUTFChars获取资源,释放ReleaseStringUTFChars。

与auto_ptr模板类似,但是为JNI量身定制,例如为jstring调用GetStringUTFChars / ReleaseStringUTFChars。

2 个答案:

答案 0 :(得分:8)

你可以在C ++ 11中使用std::unique_ptr,它允许你自己设置删除器:

#include <memory>
#include <functional>

typedef std::unique_ptr<char const[], std::function<void(char const*)>> jni_string_ptr;
// the "std::function" is needed to store any callable†

extern "C"
JNIEXPORT void JNICALL Java_ClassName_MethodName
  (JNIEnv *env, jobject obj, jstring javaString)
{
    //Get the native string from javaString
    jni_string_ptr nativeString(env->GetStringUTFChars(javaString, 0),
        [=](char const* p) mutable{ env->ReleaseStringUTFChars(javaString, p); });
    // lambda as the deleter
    // mutable needed if "ReleaseStringUTFChars" is a non-const method

    //Do something with the nativeString

    // nativeString automatically calls the passed deleter
}

如果您遇到C ++ 03且无法访问std::unique_ptr,则boost::shared_array会提供.. 可行的替代方案。

#include <boost/shared_ptr.hpp>

typedef boost::shared_array<char const*> jni_string_ptr;

struct jni_string_deleter{
  jni_string_deleter(JNIEnv* e, jstring js)
    : _env(e), _java_string(js) {}

  void operator()(char const* p) const{
    _env->ReleaseStringUTFChars(_java_string, p);
  }

private:
  JNIEnv* _env;
  jstring _java_string;
};

extern "C"
JNIEXPORT void JNICALL Java_ClassName_MethodName
  (JNIEnv *env, jobject obj, jstring javaString)
{
    //Get the native string from javaString
    jni_string_ptr nativeString(env->GetStringUTFChars(javaString, 0),
        jni_string_deleter(env, javaString));

    //Do something with the nativeString

    // nativeString automatically calls the passed deleter
}

†您也可以在此处使用特定的逗号类型,与shared_array示例一样,以避免std::function的类型擦除开销:

struct jni_string_deleter{
  jni_string_deleter(JNIEnv* e, jstring js)
    : _env(e), _java_string(js) {}

  void operator()(char const* p) const{
    _env->ReleaseStringUTFChars(_java_string, p);
  }

private:
  JNIEnv* _env;
  jstring _java_string;
};

typedef std::unique_ptr<char const[], jni_string_deleter> jni_string_ptr;

// create
jni_string_ptr(env->get_the_chars(), jni_string_deleter(env, javaString));

答案 1 :(得分:3)

此处的关键字为RAII

class jni_string {
public:
    jni_string(JNIEnv *env, jstring javaString)
        : env_(env), javaString_(javaString)
    { nativeString_ = env_->GetStringUTFChars(javaString_, 0); }

    ~jni_string() { env_->ReleaseStringUTFChars(javaString_, nativeString_); }

    operator const char *() const { return nativeString_; }
private:
    jni_string(const jni_string &x);
    jni_string &operator=(const jni_string &x);

    JNIEnv *env_;
    jstring javaString_;
    const char *nativeString_;
};

用法是:

//C++ code
extern "C"
JNIEXPORT void JNICALL Java_ClassName_MethodName
  (JNIEnv *env, jobject obj, jstring javaString)
{
    //Get the native string from javaString
    jni_string nativeString(env, javaString);

    //Do something with the nativeString
}