QtJniTypes Namespace

マクロのドキュメント

[since 6.8] Q_DECLARE_JNI_CLASS(Type, JavaSignature)

QtJniTypes 名前空間内で、Java クラスJavaSignature をラップする C++ 型Type を宣言します。JavaSignature 内の Java クラス名は、/ を区切り文字として使用し、完全修飾名で指定する必要があります。

Q_DECLARE_JNI_CLASS(File, "java/io/File")
Q_DECLARE_JNI_CLASS(FileWriter, "java/io/FileWriter")

その結果、C++ クラス `QtJniTypes::File ` および `QtJniTypes::FileWriter ` は、`QJniObject` と同様の型（正確には `QtJniTypes::JObject` の特化形）となり、これを使用して対応する Java クラスのインスタンスを作成したり、メソッドを呼び出したり、コンパイル時の自動シグネチャ推論を備えた `QJniObject ` の可変引数テンプレートメソッドを通じて、そのようなインスタンスを渡したりすることができます。

using namespace QtJniTypes;

File file("path/to/file"); // instantiates the java.io.File type in Java
if (file.callMethod<bool>("createNewFile")) {
    FileWriter writer(file); // instantiates a java.io.FileWriter that operates on file
    writer.callMethod("write", 42);
}

QJniObject APIに加え、これらのC++クラスには静的なregisterNativeMethods メンバ関数も備わっており、次のように使用できます：

QtJniTypes::File::registerNativeMethods({
    Q_JNI_NATIVE_METHOD(freeFunction)
});

このマクロは Qt 6.8 で導入されました。

Q_DECLARE_JNI_NATIVE_METHOD 、Q_JNI_NATIVE_METHOD 、およびQtJniTypes::JObjectも参照してください 。

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD(Method)

CまたはC++のフリー関数Method をネイティブメソッドとして宣言します。このメソッドは、Q_JNI_NATIVE_METHOD マクロを利用し、QJniEnvironment::registerNativeMethod() を使用して、後でJNIフレームワークに登録することができます。

// C++ side

Q_DECLARE_JNI_CLASS(MyJavaType, "my/java/Type")

static void nativeFunction(JNIEnv *env, jobject thiz, jlong id)
{
    // ...
}
Q_DECLARE_JNI_NATIVE_METHOD(nativeFunction)

Q_DECL_EXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved)
{
    QJniEnvironment env;
    env.registerNativeMethods<QtJniTypes::MyJavaType>({
        Q_JNI_NATIVE_METHOD(nativeFunction)
    });
}

// Java side
public class MyJavaType
{
    native public nativeFunction(long id);
}

このマクロは Qt 6.8 で導入されました。

Q_JNI_NATIVE_METHOD およびQ_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPEも参照してください 。

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD(Method, JavaName)

CまたはC++のフリー関数Method を、JavaでJavaName として利用可能なネイティブメソッドとして宣言します。このメソッドは、Q_JNI_NATIVE_METHOD マクロを利用して、後でQJniEnvironment::registerNativeMethod()を介してJNIフレームワークに登録することができます。

このマクロは Qt 6.8 で導入されました。

Q_JNI_NATIVE_METHOD およびQ_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPEも参照してください 。

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method)

C++の静的クラスメンバ関数Method をネイティブメソッドとして宣言します。このメソッドは、Q_JNI_NATIVE_SCOPED_METHOD マクロを利用して、後でQJniEnvironment::registerNativeMethod() を用いてJNIフレームワークに登録することができます。

class NativeHandler
{
    // ...
private:
    static void handleChange(JNIEnv*, jobject, jlong id);
    Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(handleChange)
};

\dots
QJniEnvironment env;
env.registerNativeMethods<QtJniTypes::MyJavaType>({
    Q_JNI_NATIVE_SCOPED_METHOD(handleChange, NativeHandler)
});

このマクロは Qt 6.8 で導入されました。

Q_DECLARE_JNI_NATIVE_METHOD およびQ_JNI_NATIVE_SCOPED_METHODも参照してください 。

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method, JavaName)

C++の静的クラスメンバ関数Method を、JavaでJavaName として利用可能なネイティブメソッドとして宣言します。このメソッドは、Q_JNI_NATIVE_METHOD マクロを利用して、後でQJniEnvironment::registerNativeMethod()を用いてJNIフレームワークに登録することができます。

このマクロは Qt 6.8 で導入されました。

Q_DECLARE_JNI_NATIVE_METHOD およびQ_JNI_NATIVE_SCOPED_METHODも参照してください 。

[since 6.8] Q_JNI_NATIVE_METHOD(Method)

以前はdeclared として定義されていたネイティブメソッドMethod を、JNIフレームワークへの登録が可能にします。QJniEnvironment::registerNativeMethod() を使用してJNIにメソッドを登録する際は、このマクロを使用してください。

Q_DECL_EXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved)
{
    QJniEnvironment env;
    env.registerNativeMethods<QtJniTypes::MyJavaType>({
        Q_JNI_NATIVE_METHOD(nativeFunction)
    });
}

このマクロは Qt 6.8 で導入されました。

Q_DECLARE_JNI_NATIVE_METHODも参照してください 。

[since 6.8] Q_JNI_NATIVE_SCOPED_METHOD(Method, Scope)

以前はdeclared として定義されていたネイティブメソッドMethod （スコープScope ）を、JNIフレームワークへの登録が可能にします。QJniEnvironment::registerNativeMethod() を使用してJNIにメソッドを登録する際は、このマクロを使用してください。

このマクロは Qt 6.8 で導入されました。

Q_JNI_NATIVE_METHOD およびQ_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPEも参照してください 。