QJniObject Class

Documentación de funciones miembro

QJniObject::QJniObject()

Construye un objeto JNI inválido.

Véase también isValid().

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

Construye un nuevo objeto JNI llamando al constructor por defecto de className.

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

[explicit] QJniObject::QJniObject(jclass clazz)

Construye un nuevo objeto JNI llamando al constructor por defecto de clazz.

QJniObject::QJniObject(jobject object)

Construye un nuevo objeto JNI alrededor del objeto Java object.

Véase también fromLocalRef().

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

Construye un nuevo objeto JNI llamando al constructor de className con los argumentos args. Este constructor sólo está disponible si se conocen todos los args JNI Types .

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

Esta función se introdujo en Qt 6.4.

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

Construye un nuevo objeto JNI a partir de clazz llamando al constructor con los argumentos args. Este constructor sólo está disponible si se conocen todos los args JNI Types .

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

Esta función se introdujo en Qt 6.4.

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

Construye un nuevo objeto JNI llamando al constructor de className con signature especificando los tipos de los argumentos posteriores.

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, ...)

Construye un nuevo objeto JNI a partir de clazz llamando al constructor con signature especificando los tipos de los argumentos posteriores.

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

[noexcept] QJniObject::~QJniObject()

Destruye el objeto JNI y libera las referencias que contenga.

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

Llama al método methodName con los argumentos args y devuelve el valor (a menos que Ret sea void). Si Ret es un tipo jobject, el valor devuelto será un QJniObject.

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

La firma del método se deduce en tiempo de compilación a partir de Ret y los tipos de args. Ret puede ser un tipo compatible con std::expected que devuelva un valor, o any Java exception thrown por el método llamado.

Esta función se introdujo en Qt 6.4.

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

Llama al método del objeto methodName con signature especificando los tipos de los argumentos subsiguientes args, y devuelve el valor (a menos que Ret sea void). Si Ret es un tipo jobject, entonces el valor devuelto será un QJniObject.

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

Esta función se introdujo en Qt 6.4.

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

Llama al método de objetos Java methodName con argumentos args y devuelve un nuevo QJniObject para el objeto Java devuelto.

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

La firma del método se deduce en tiempo de compilación a partir de Ret y los tipos de args. Ret puede ser un tipo compatible con std::expected que devuelve un valor, o any Java exception thrown por el método llamado.

Esta función se introdujo en Qt 6.4.

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

Llama al método del objeto Java methodName con signature especificando los tipos de cualquier argumento posterior.

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 ReturnType = void, typename... Args > auto QJniObject::callStaticMethod(const char *methodName, Args &&... args)

Llama al método estático methodName en la clase Klass y devuelve el valor del tipo Ret (a menos que Ret sea void). Si Ret es un tipo jobject, entonces el valor devuelto será un QJniObject.

La firma del método se deduce en tiempo de compilación a partir de Ret y los tipos de args. Klass tiene que ser un tipo C++ con un mapeo de tipo registrado a un tipo Java. Ret puede ser un tipo compatible con std::expected que devuelva un valor, o any Java exception thrown por el método llamado.

Esta función se introdujo en Qt 6.7.

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

Llama al método estático methodName en la clase className con argumentos args, y devuelve el valor del tipo Ret (a menos que Ret sea void). Si Ret es un tipo jobject, entonces el valor devuelto será un QJniObject.

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

La firma del método se deduce en tiempo de compilación a partir de Ret y los tipos de args. Ret puede ser un tipo compatible con std::expected que devuelve un valor, o any Java exception thrown por el método llamado.

Esta función se introdujo en Qt 6.4.

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

Llama al método estático methodName en clazz y devuelve el valor del tipo Ret (a menos que Ret sea void). Si Ret es un tipo jobject, entonces el valor devuelto será un QJniObject.

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

La firma del método se deduce en tiempo de compilación a partir de Ret y los tipos de args. Ret puede ser un tipo compatible con std::expected que devuelve un valor, o any Java exception thrown por el método llamado.

Esta función se introdujo en Qt 6.4.

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

Llama al método estático identificado por methodId de la clase clazz con cualquier argumento subsiguiente, y devuelve el valor del tipo Ret (a menos que Ret sea void). Si Ret es un tipo jobject, entonces el valor devuelto será un QJniObject.

Útil cuando clazz y methodId ya están en caché de operaciones anteriores.

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

Esta función se introdujo en Qt 6.4.

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

Llama al método estático methodName de la clase className con signature especificando los tipos de cualquier argumento subsiguiente args. Devuelve el resultado del método (a menos que Ret sea void). Si Ret es un tipo jobject, entonces el valor devuelto será un QJniObject.

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

Esta función se introdujo en Qt 6.4.

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

Llama al método estático methodName desde clazz con signature especificando los tipos de los argumentos subsiguientes. Devuelve el resultado del método (a menos que Ret sea void). Si Ret es un tipo jobject, entonces el valor devuelto será un 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)

Llama al método estático con methodName en la clase className, pasando argumentos args, y devuelve un nuevo QJniObject para el objeto Java devuelto.

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

La firma del método se deduce en tiempo de compilación a partir de Ret y los tipos de args. Ret puede ser un tipo std::expected-compatible que devuelve un valor, o any Java exception thrown por el método llamado.

Esta función se introdujo en Qt 6.4.

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

Llama al método estático con methodName en clazz, pasando argumentos args, y devuelve un nuevo QJniObject para el objeto Java devuelto.

Esta función se introdujo en Qt 6.4.

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

Llama al método estático identificado por methodId desde la clase clazz con cualquier argumento posterior. Útil cuando clazz y methodId ya están en caché de operaciones anteriores.

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, ...)

Llama al método estático methodName de la clase className con signature especificando los tipos de los argumentos subsiguientes.

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, ...)

Llama al método estático methodName de la clase clazz con signature especificando los tipos de los argumentos subsiguientes.

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

Devuelve el nombre del objeto de clase que contiene QJniObject como QByteArray.

Esta función se introdujo en Qt 6.2.

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

Construye una instancia de la clase Java equivalente a Class y devuelve un QJniObject que contiene el objeto JNI. Los argumentos de args se pasan al constructor Java.

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

Esta función sólo está disponible si se conocen todos los args JNI Types .

Esta función se introdujo en Qt 6.4.

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

Crea un QJniObject a partir de la referencia JNI local localRef. Esta función toma posesión de localRef y la libera antes de retornar.

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

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

Crea una cadena Java a partir de QString string y devuelve QJniObject con dicha cadena.

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

Véase también toString().

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

Recupera el valor del campo fieldName.

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

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

Recupera un objeto JNI del campo fieldName.

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

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

Recupera un objeto JNI del campo fieldName con signature.

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

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

Recupera el valor del campo estático fieldName para la clase Klass.

Klass necesita ser un tipo C++ con un mapeo de tipo registrado a un tipo Java.

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

Recupera el valor del campo estático fieldName de la clase className.

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

Recupera el valor del campo estático fieldName en clazz.

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

Recupera el objeto del campo fieldName en la clase className.

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

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

Recupera el objeto del campo fieldName en clazz.

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

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

Recupera un objeto JNI del campo fieldName con signature de la clase className.

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

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

Recupera un objeto JNI del campo fieldName con signature de la clase clazz.

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

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

Devuelve true si la clase Java className está disponible.

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

bool QJniObject::isValid() const

Devuelve true si esta instancia contiene un objeto Java válido.

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

Devuelve el objeto que contiene QJniObject, ya sea como jobject o como tipo T. T puede ser uno de JNI Object Types.

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.
    QString myQtString = QJniObject(myJString).toString();
}

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

Devuelve el objeto de clase mantenido por el QJniObject como un jclass.

Esta función se introdujo en Qt 6.2.

template <typename Ret = void, typename Type> auto QJniObject::setField(const char *fieldName, Type value)

Establece el valor de fieldName en value.

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

template <typename Ret = void, typename Type> auto QJniObject::setField(const char *fieldName, const char *signature, Type value)

Establece el valor de fieldName con signature a value.

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

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

Establece el campo estático fieldName de la clase Klass a value.

Klass necesita ser un tipo C++ con un mapeo de tipo registrado a un tipo Java.

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

Establece el campo estático fieldName de la clase className a value.

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

Establece el campo estático fieldName de la clase clazz a value.

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

Establece el campo estático fieldName en la clase className a value utilizando el setter con signature.

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

Establece el campo estático fieldName en la clase clazz a value utilizando el setter con signature.

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

Intercambia este objeto con other. Esta operación es muy rápida y nunca falla.

Esta función se introdujo en Qt 6.8.

QString QJniObject::toString() const

Devuelve un QString con una representación de cadena del objeto java. Llamar a esta función en un objeto Java String es una forma conveniente de obtener los datos reales de la cadena.

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

Véase también fromString().

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

Sustituye el objeto actual por object. El objeto Java antiguo será liberado.