QtJniTypes Namespace

マクロ・ドキュメント

[since 6.8] Q_DECLARE_JNI_CLASS(Type, JavaSignature)

Java クラスJavaSignature をラップする C++ 型Type をQtJniTypes 名前空間で宣言します。JavaSignature の Java クラス名は、/ をセパレーターとして完全修飾する必要があります。

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

C++ クラスQtJniTypes::File とQtJniTypes::FileWriter は、対応する Java クラスをインスタンス化したり、メソッドを呼び出したり、自動的なコンパイル時シグニチャ推論でQJniObject 変数テンプレート・メソッドを通してそのようなインスタンスを渡したりするために使用できる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も参照してください 。

[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)

スコープScope のdeclared ネイティブメソッドMethod を、JNI フレームワークで登録できるようにします。このマクロは、QJniEnvironment::registerNativeMethod() を使用して JNI にメソッドを登録するときに使用します。

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

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