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 的类型，可用于实例化相应的 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 。

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