QJniObject Class

Dokumentation der Mitgliedsfunktionen

Gibt das Objekt zurück, das sich im Besitz von QJniObject befindet, entweder als jobject oder als Typ T. T kann einer von JNI Object Types sein.

QJniObject string = QJniObject::fromString("Hello, JNI");
jstring jstring = string.object<jstring>();

void functionScope()
{
    QString helloString("Hello");
    jstring myJString = 0;
    {
        QJniObject string = QJniObject::fromString(helloString);
        myJString = string.object<jstring>();
    }

   // Ops! myJString is no longer valid.
}

QJniObject::QJniObject()

Konstruiert ein ungültiges JNI-Objekt.

Siehe auch isValid().

[explicit] QJniObject::QJniObject(const char *className)

Konstruiert ein neues JNI-Objekt durch Aufruf des Standardkonstruktors von className.

QJniObject myJavaString("java/lang/String");

[explicit] QJniObject::QJniObject(jclass clazz)

Konstruiert ein neues JNI-Objekt durch Aufruf des Standardkonstruktors von clazz.

QJniObject::QJniObject(jobject object)

Konstruiert ein neues JNI-Objekt um das Java-Objekt object.

Siehe auch fromLocalRef().

[explicit, since 6.4] template <typename... Args> QJniObject::QJniObject(const char *className, Args &&... args)

Konstruiert ein neues JNI-Objekt durch Aufruf des Konstruktors von className mit den Argumenten args. Dieser Konstruktor ist nur verfügbar, wenn alle args bekannt sind JNI Types.

QJniEnvironment env;
char* str = "Hello";
jstring myJStringArg = env->NewStringUTF(str);
QJniObject myNewJavaString("java/lang/String", myJStringArg);

Diese Funktion wurde in Qt 6.4 eingeführt.

[explicit, since 6.4] template <typename... Args> QJniObject::QJniObject(jclass clazz, Args &&... args)

Konstruiert ein neues JNI-Objekt aus clazz durch Aufruf des Konstruktors mit den Argumenten args. Dieser Konstruktor ist nur verfügbar, wenn alle args bekannt sind JNI Types.

QJniEnvironment env;
jclass myClazz = env.findClass("org/qtproject/qt/TestClass");
QJniObject(myClazz, 3);

Diese Funktion wurde in Qt 6.4 eingeführt.

[explicit] QJniObject::QJniObject(const char *className, const char *signature, ...)

Konstruiert ein neues JNI-Objekt, indem es den Konstruktor von className mit signature aufruft, der die Typen aller nachfolgenden Argumente angibt.

QJniEnvironment env;
char* str = "Hello";
jstring myJStringArg = env->NewStringUTF(str);
QJniObject myNewJavaString("java/lang/String", "(Ljava/lang/String;)V", myJStringArg);

[explicit] QJniObject::QJniObject(jclass clazz, const char *signature, ...)

Konstruiert ein neues JNI-Objekt aus clazz, indem es den Konstruktor mit signature aufruft und die Typen aller nachfolgenden Argumente angibt.

QJniEnvironment env;
jclass myClazz = env.findClass("org/qtproject/qt/TestClass");
QJniObject(myClazz, "(I)V", 3);

[noexcept] QJniObject::~QJniObject()

Zerstört das JNI-Objekt und gibt alle vom JNI-Objekt gehaltenen Referenzen frei.

[since 6.4] template <typename Ret, typename... Args> auto QJniObject::callMethod(const char *methodName, Args &&... args) const

Ruft die Methode methodName mit den Argumenten args auf und gibt den Wert zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, ist der zurückgegebene Wert ein QJniObject.

QJniObject myJavaString("org/qtproject/qt/TestClass");
jint size = myJavaString.callMethod<jint>("length");

Die Signatur der Methode wird zur Kompilierzeit aus Ret und den Typen von args abgeleitet.

Diese Funktion wurde in Qt 6.4 eingeführt.

[since 6.4] template <typename Ret, typename... Args> auto QJniObject::callMethod(const char *methodName, const char *signature, Args &&... args) const

Ruft die Objektmethode methodName mit signature auf, wobei die Typen der nachfolgenden Argumente args angegeben werden, und gibt den Wert zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, ist der zurückgegebene Wert ein QJniObject.

QJniObject myJavaString("org/qtproject/qt/TestClass");
jint index = myJavaString.callMethod<jint>("indexOf", "(I)I", 0x0051);

Diese Funktion wurde in Qt 6.4 eingeführt.

[since 6.4] template <typename Ret, typename... Args> QJniObject QJniObject::callObjectMethod(const char *methodName, Args &&... args) const

Ruft die Java-Objekte-Methode methodName mit Argumenten args auf und gibt ein neues QJniObject für das zurückgegebene Java-Objekt zurück.

QJniObject myJavaString = QJniObject::fromString("Hello, Java");
QJniObject myJavaString2 = myJavaString1.callObjectMethod<jstring>("toString");

Die Signatur der Methode wird zur Kompilierzeit aus Ret und den Typen von args abgeleitet.

Diese Funktion wurde in Qt 6.4 eingeführt.

QJniObject QJniObject::callObjectMethod(const char *methodName, const char *signature, ...) const

Ruft die Methode des Java-Objekts methodName mit signature auf, wobei die Typen aller nachfolgenden Argumente angegeben werden.

QJniObject myJavaString = QJniObject::fromString("Hello, Java");
QJniObject mySubstring = myJavaString.callObjectMethod("substring",
                                                       "(II)Ljava/lang/String;", 7, 11);

[static, since 6.7] template <typename Klass, typename Ret, typename... Args> auto QJniObject::callStaticMethod(const char *methodName, Args &&... args)

Ruft die statische Methode methodName der Klasse Klass auf und gibt den Wert des Typs Ret zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, ist der zurückgegebene Wert ein QJniObject.

Die Signatur der Methode wird zur Kompilierzeit aus Ret und den Typen von args abgeleitet. Klass muss ein C++-Typ mit einer registrierten Typzuordnung zu einem Java-Typ sein.

Diese Funktion wurde in Qt 6.7 eingeführt.

[static, since 6.4] template <typename Ret, typename... Args> auto QJniObject::callStaticMethod(const char *className, const char *methodName, Args &&... args)

Ruft die statische Methode methodName für die Klasse className mit den Argumenten args auf und gibt den Wert des Typs Ret zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, ist der zurückgegebene Wert ein QJniObject.

jint value = QJniObject::callStaticMethod<jint>("MyClass", "staticMethod");

Die Signatur der Methode wird zur Kompilierzeit aus Ret und den Typen von args abgeleitet.

Diese Funktion wurde in Qt 6.4 eingeführt.

[static, since 6.4] template <typename Ret, typename... Args> auto QJniObject::callStaticMethod(jclass clazz, const char *methodName, Args &&... args)

Ruft die statische Methode methodName auf clazz auf und gibt den Wert des Typs Ret zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, ist der zurückgegebene Wert ein QJniObject.

QJniEnvironment env;
jclass javaMathClass = env.findClass("java/lang/Math");
jdouble randNr = QJniObject::callStaticMethod<jdouble>(javaMathClass, "random");

Die Signatur der Methode wird zur Kompilierzeit aus Ret und den Typen von args abgeleitet.

Diese Funktion wurde in Qt 6.4 eingeführt.

[static, since 6.4] template <typename Ret, typename... Args> auto QJniObject::callStaticMethod(jclass clazz, jmethodID methodId, Args &&... args)

Ruft die durch methodId identifizierte statische Methode der Klasse clazz mit allen nachfolgenden Argumenten auf und gibt den Wert des Typs Ret zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, ist der zurückgegebene Wert ein QJniObject.

Nützlich, wenn clazz und methodId bereits von früheren Operationen zwischengespeichert sind.

QJniEnvironment env;
jclass javaMathClass = env.findClass("java/lang/Math");
jmethodID methodId = env.findStaticMethod(javaMathClass, "max", "(II)I");
if (methodId != 0) {
    jint a = 2;
    jint b = 4;
    jint max = QJniObject::callStaticMethod<jint>(javaMathClass, methodId, a, b);
}

Diese Funktion wurde in Qt 6.4 eingeführt.

[static, since 6.4] template <typename Ret, typename... Args> auto QJniObject::callStaticMethod(const char *className, const char *methodName, const char *signature, Args &&... args)

Ruft die statische Methode methodName der Klasse className auf, wobei signature die Typen aller nachfolgenden Argumente args angibt. Gibt das Ergebnis der Methode zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, dann ist der zurückgegebene Wert ein QJniObject.

jint a = 2;
jint b = 4;
jint max = QJniObject::callStaticMethod<jint>("java/lang/Math", "max", "(II)I", a, b);

Diese Funktion wurde in Qt 6.4 eingeführt.

[static] template <typename Ret, typename... Args> auto QJniObject::callStaticMethod(jclass clazz, const char *methodName, const char *signature, Args &&... args)

Ruft die statische Methode methodName von clazz auf, wobei signature die Typen aller nachfolgenden Argumente angibt. Gibt das Ergebnis der Methode zurück (sofern Ret nicht void ist). Wenn Ret ein Jobject-Typ ist, ist der zurückgegebene Wert ein QJniObject.

QJniEnvironment env;
jclass javaMathClass = env.findClass("java/lang/Math");
jint a = 2;
jint b = 4;
jint max = QJniObject::callStaticMethod<jint>(javaMathClass, "max", "(II)I", a, b);

[static, since 6.4] template <typename Ret, typename... Args> QJniObject QJniObject::callStaticObjectMethod(const char *className, const char *methodName, Args &&... args)

Ruft die statische Methode mit methodName auf der Klasse className auf, wobei Argumente args übergeben werden, und gibt ein neues QJniObject für das zurückgegebene Java-Objekt zurück.

QJniObject string = QJniObject::callStaticObjectMethod<jstring>("CustomClass", "getClassName");

Die Signatur der Methode wird zur Kompilierzeit aus Ret und den Typen von args abgeleitet.

Diese Funktion wurde in Qt 6.4 eingeführt.

[static, since 6.4] template <typename Ret, typename... Args> QJniObject QJniObject::callStaticObjectMethod(jclass clazz, const char *methodName, Args &&... args)

Ruft die statische Methode mit methodName auf clazz auf, übergibt Argumente args und gibt ein neues QJniObject für das zurückgegebene Java-Objekt zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

[static] QJniObject QJniObject::callStaticObjectMethod(jclass clazz, jmethodID methodId, ...)

Ruft die durch methodId identifizierte statische Methode der Klasse clazz mit allen nachfolgenden Argumenten auf. Nützlich, wenn clazz und methodId bereits von früheren Operationen zwischengespeichert sind.

QJniEnvironment env;
jclass clazz = env.findClass("java/lang/String");
jmethodID methodId = env.findStaticMethod(clazz, "valueOf", "(I)Ljava/lang/String;");
if (methodId != 0)
    QJniObject str = QJniObject::callStaticObjectMethod(clazz, methodId, 10);

[static] QJniObject QJniObject::callStaticObjectMethod(const char *className, const char *methodName, const char *signature, ...)

Ruft die statische Methode methodName aus der Klasse className auf, wobei signature die Typen aller nachfolgenden Argumente angibt.

QJniObject thread = QJniObject::callStaticObjectMethod("java/lang/Thread", "currentThread",
                                                       "()Ljava/lang/Thread;");
QJniObject string = QJniObject::callStaticObjectMethod("java/lang/String", "valueOf",
                                                       "(I)Ljava/lang/String;", 10);

[static] QJniObject QJniObject::callStaticObjectMethod(jclass clazz, const char *methodName, const char *signature, ...)

Ruft die statische Methode methodName der Klasse clazz auf, wobei signature die Typen aller nachfolgenden Argumente angibt.

[since 6.2] QByteArray QJniObject::className() const

Gibt den Namen des Klassenobjekts zurück, das von QJniObject als QByteArray gehalten wird.

Diese Funktion wurde in Qt 6.2 eingeführt.

[static, since 6.4] template <typename Class, typename... Args> QJniObject QJniObject::construct(Args &&... args)

Konstruiert eine Instanz der Java-Klasse, die das Äquivalent von Class ist, und gibt ein QJniObject zurück, das das JNI-Objekt enthält. Die Argumente in args werden an den Java-Konstruktor übergeben.

QJniObject javaString = QJniObject::construct<jstring>();

Diese Funktion ist nur verfügbar, wenn alle args bekannt sind JNI Types.

Diese Funktion wurde in Qt 6.4 eingeführt.

[static] QJniObject QJniObject::fromLocalRef(jobject localRef)

Erzeugt eine QJniObject aus der lokalen JNI-Referenz localRef. Diese Funktion übernimmt das Eigentum an localRef und gibt es vor der Rückkehr wieder frei.

jobject localRef = env->GetObjectArrayElement(array, index);
QJniObject element = QJniObject::fromLocalRef(localRef);

[static] QJniObject QJniObject::fromString(const QString &string)

Erzeugt eine Java-Zeichenkette aus der QString string und gibt eine QJniObject mit dieser Zeichenkette zurück.

QString myQString = "QString";
QJniObject myJavaString = QJniObject::fromString(myQString);

Siehe auch toString().

template <typename T> auto QJniObject::getField(const char *fieldName) const

Ruft den Wert des Feldes fieldName ab.

QJniObject volumeControl("org/qtproject/qt/TestClass");
jint fieldValue = volumeControl.getField<jint>("FIELD_NAME");

template <typename T> QJniObject QJniObject::getObjectField(const char *fieldName) const

Ruft ein JNI-Objekt aus dem Feld fieldName ab.

QJniObject field = jniObject.getObjectField<jstring>("FIELD_NAME");

QJniObject QJniObject::getObjectField(const char *fieldName, const char *signature) const

Ruft ein JNI-Objekt aus dem Feld fieldName mit signature ab.

QJniObject field = jniObject.getObjectField("FIELD_NAME", "Ljava/lang/String;");

[static] template <typename Klass, typename T> auto QJniObject::getStaticField(const char *fieldName)

Ruft den Wert aus dem statischen Feld fieldName für die Klasse Klass ab.

Klass muss ein C++-Typ mit einer registrierten Typzuordnung zu einem Java-Typ sein.

[static] template <typename T> auto QJniObject::getStaticField(const char *className, const char *fieldName)

Ruft den Wert aus dem statischen Feld fieldName der Klasse className ab.

[static] template <typename T> auto QJniObject::getStaticField(jclass clazz, const char *fieldName)

Ruft den Wert aus dem statischen Feld fieldName auf clazz ab.

[static] template <typename T> QJniObject QJniObject::getStaticObjectField(const char *className, const char *fieldName)

Ruft das Objekt aus dem Feld fieldName der Klasse className ab.

QJniObject jobj = QJniObject::getStaticObjectField<jstring>("class/with/Fields", "FIELD_NAME");

[static] template <typename T> QJniObject QJniObject::getStaticObjectField(jclass clazz, const char *fieldName)

Ruft das Objekt aus dem Feld fieldName auf clazz ab.

QJniObject jobj = QJniObject::getStaticObjectField<jstring>(clazz, "FIELD_NAME");

[static] QJniObject QJniObject::getStaticObjectField(const char *className, const char *fieldName, const char *signature)

Ruft ein JNI-Objekt aus dem Feld fieldName mit signature aus der Klasse className ab.

QJniObject jobj = QJniObject::getStaticObjectField("class/with/Fields", "FIELD_NAME",
                                                   "Ljava/lang/String;");

[static] QJniObject QJniObject::getStaticObjectField(jclass clazz, const char *fieldName, const char *signature)

Ruft ein JNI-Objekt aus dem Feld fieldName mit signature aus der Klasse clazz ab.

QJniObject jobj = QJniObject::getStaticObjectField(clazz, "FIELD_NAME", "Ljava/lang/String;");

[static] bool QJniObject::isClassAvailable(const char *className)

Gibt true zurück, wenn die Java-Klasse className verfügbar ist.

if (QJniObject::isClassAvailable("java/lang/String")) {
    // condition statement
}

bool QJniObject::isValid() const

Gibt true zurück, wenn diese Instanz ein gültiges Java-Objekt enthält.

QJniObject qjniObject;                        // ==> isValid() == false
QJniObject qjniObject(0)                      // ==> isValid() == false
QJniObject qjniObject("could/not/find/Class") // ==> isValid() == false

[since 6.2] jclass QJniObject::objectClass() const

Gibt das Klassenobjekt zurück, das von QJniObject als jclass gehalten wird.

Diese Funktion wurde in Qt 6.2 eingeführt.

template <typename T> void QJniObject::setField(const char *fieldName, T value)

Setzt den Wert von fieldName auf value.

QJniObject obj;
obj.setField<jint>("AN_INT_FIELD", 10);
jstring myString = ...;
obj.setField<jstring>("A_STRING_FIELD", myString);

template <typename T> void QJniObject::setField(const char *fieldName, const char *signature, T value)

Setzt den Wert von fieldName mit signature auf value.

QJniObject stringArray = ...;
QJniObject obj = ...;
obj.setObjectField<jobjectArray>("KEY_VALUES", "([Ljava/lang/String;)V",
                           stringArray.object<jobjectArray>())

[static] template <typename Klass, typename T> auto QJniObject::setStaticField(const char *fieldName, T value)

Setzt das statische Feld fieldName der Klasse Klass auf value.

Klass muss ein C++-Typ mit einer registrierten Typzuordnung zu einem Java-Typ sein.

[static] template <typename T> void QJniObject::setStaticField(const char *className, const char *fieldName, T value)

Setzt das statische Feld fieldName der Klasse className auf value.

[static] template <typename T> void QJniObject::setStaticField(jclass clazz, const char *fieldName, T value)

Setzt das statische Feld fieldName der Klasse clazz auf value.

[static] template <typename T> void QJniObject::setStaticField(const char *className, const char *fieldName, const char *signature, T value)

Setzt das statische Feld fieldName der Klasse className über den Setter mit signature auf value.

[static] template <typename T> void QJniObject::setStaticField(jclass clazz, const char *fieldName, const char *signature, T value)

Setzt das statische Feld fieldName der Klasse clazz über den Setter mit signature auf value.

[noexcept, since 6.8] void QJniObject::swap(QJniObject &other)

Tauscht dieses Objekt mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

Diese Funktion wurde in Qt 6.8 eingeführt.

QString QJniObject::toString() const

Gibt eine QString mit einer String-Darstellung des Java-Objekts zurück. Der Aufruf dieser Funktion für ein Java-String-Objekt ist ein bequemer Weg, um die tatsächlichen String-Daten zu erhalten.

QJniObject string = ...; //  "Hello Java"
QString qstring = string.toString(); // "Hello Java"

Siehe auch fromString().

template <typename T, std::enable_if_t<std::is_convertible_v<T, jobject>, bool> = true> QJniObject &QJniObject::operator=(T object)

Ersetzen Sie das aktuelle Objekt durch object. Das alte Java-Objekt wird freigegeben.