QtJniTypes Namespace

宏文档

[since 6.8] Q_DECLARE_JNI_CLASS(Type, JavaSignature)

在QtJniTypes 命名空间中声明一个C++类型Type ，该类型封装了Java类JavaSignature 。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 。