QtJniTypes Namespace

Makro-Dokumentation

[since 6.8] Q_DECLARE_JNI_CLASS(Type, JavaSignature)

Deklariert einen C++-Typ „ Type “ im Namespace „ QtJniTypes “, der die Java-Klasse „ JavaSignature “ umschließt. Der Name der Java-Klasse in „ JavaSignature “ muss vollständig qualifiziert sein, wobei „ / “ als Trennzeichen verwendet wird.

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

Die C++-Klassen „ QtJniTypes::File “ und „ QtJniTypes::FileWriter “ sind dann Typen vom Typ „ QJniObject “ (genauer gesagt Spezialisierungen von „ QtJniTypes::JObject “), die verwendet werden können, um die entsprechende Java-Klasse zu instanziieren, Methoden aufzurufen und solche Instanzen an variadische Template-Methoden von „ QJniObject “ mit automatischer Signaturableitung zur Kompilierungszeit zu übergeben.

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);
}

Zusätzlich zur „ QJniObject “-API verfügen diese C++-Klassen auch über eine statische Memberfunktion „ registerNativeMethods “, die wie folgt verwendet werden kann:

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

Dieses Makro wurde in Qt 6.8 eingeführt.

Siehe auch „ Q_DECLARE_JNI_NATIVE_METHOD “, „ Q_JNI_NATIVE_METHOD “ und „ QtJniTypes::JObject “.

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD(Method)

Deklariert die freie C- oder C++-Funktion „ Method “ als native Methode. Die Methode kann später mithilfe des Makros „ Q_JNI_NATIVE_METHOD “ über „QJniEnvironment::registerNativeMethod()“ beim JNI-Framework registriert werden.

// 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);
}

Dieses Makro wurde in Qt 6.8 eingeführt.

Siehe auch Q_JNI_NATIVE_METHOD und Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE.

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD(Method, JavaName)

Deklariert die freie C- oder C++-Funktion „ Method “ als native Methode, die in Java unter dem Namen „ JavaName “ verfügbar ist. Die Methode kann später mithilfe des Makros „ Q_JNI_NATIVE_METHOD “ über „QJniEnvironment::registerNativeMethod()“ im JNI-Framework registriert werden.

Dieses Makro wurde in Qt 6.8 eingeführt.

Siehe auch „ Q_JNI_NATIVE_METHOD “ und „ Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE “.

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method)

Deklariert die statische Klassenmitgliedsfunktion „ Method “ in C++ als native Methode. Die Methode kann später mithilfe des Makros „ Q_JNI_NATIVE_SCOPED_METHOD “ über „QJniEnvironment::registerNativeMethod()“ im JNI-Framework registriert werden.

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)
});

Dieses Makro wurde in Qt 6.8 eingeführt.

Siehe auch „ Q_DECLARE_JNI_NATIVE_METHOD “ und „ Q_JNI_NATIVE_SCOPED_METHOD “.

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method, JavaName)

Deklariert die statische Klassenmitgliedsfunktion „ Method “ aus C++ als native Methode, die in Java unter dem Namen „ JavaName “ verfügbar ist. Die Methode kann später mithilfe des Makros „ Q_JNI_NATIVE_METHOD “ über „QJniEnvironment::registerNativeMethod()“ im JNI-Framework registriert werden.

Dieses Makro wurde in Qt 6.8 eingeführt.

Siehe auch „ Q_DECLARE_JNI_NATIVE_METHOD “ und „ Q_JNI_NATIVE_SCOPED_METHOD “.

[since 6.8] Q_JNI_NATIVE_METHOD(Method)

Stellt die bisher unter declared beschriebene native Methode Method für die Registrierung im JNI-Framework bereit. Verwenden Sie dieses Makro, wenn Sie die Methode mit QJniEnvironment::registerNativeMethod() bei JNI registrieren.

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

Dieses Makro wurde in Qt 6.8 eingeführt.

Siehe auch Q_DECLARE_JNI_NATIVE_METHOD.

[since 6.8] Q_JNI_NATIVE_SCOPED_METHOD(Method, Scope)

Stellt die bisher unter declared beschriebene native Methode Method im Gültigkeitsbereich Scope für die Registrierung mit dem JNI-Framework bereit. Verwenden Sie dieses Makro, wenn Sie die Methode mit QJniEnvironment::registerNativeMethod() bei JNI registrieren.

Dieses Makro wurde in Qt 6.8 eingeführt.

Siehe auch Q_JNI_NATIVE_METHOD und Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE.