QtJniTypes Namespace
El espacio de nombres QtJniTypes declara tipos de C++ que se corresponden con tipos de Java. Más información...
| Encabezado: | #include <QtJniTypes> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Desde: | Qt 6.8 |
Clases
(since Qt 6.8) class | JObject |
Macros
(since 6.8) | Q_DECLARE_JNI_CLASS(Type, JavaSignature) |
(since 6.8) | Q_DECLARE_JNI_NATIVE_METHOD(Method) |
(since 6.8) | Q_DECLARE_JNI_NATIVE_METHOD(Method, JavaName) |
(since 6.8) | Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method) |
(since 6.8) | Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method, JavaName) |
(since 6.8) | Q_JNI_NATIVE_METHOD(Method) |
(since 6.8) | Q_JNI_NATIVE_SCOPED_METHOD(Method, Scope) |
Descripción detallada
El marco Java Native Interface (JNI) permite que el código nativo en C o C++ llame a las API de Java y registre funciones nativas en C o C++ que el código Java pueda llamar mediante la JVM. En Qt, los tipos QJniObject y QJniEnvironment proporcionan envoltorios prácticos para utilizar JNI.
Dado que el lenguaje Java, al igual que C++, admite la sobrecarga, las funciones deben especificarse incluyendo su cadena de firma completa. Esto resulta complejo, repetitivo y propenso a errores, especialmente cuando las funciones admiten varios parámetros. QJniObject proporciona API de plantillas variádicas que pueden deducir la cadena de firma de una llamada a función en tiempo de compilación, basándose en los tipos de C++ pasados a la plantilla. Para que esto funcione, es necesario conocer en tiempo de compilación la correspondencia entre esos tipos de C++ y su cadena JNI correspondiente.
Qt implementa esta correspondencia para la biblioteca estándar JNI types. Mediante el uso de la macro Q_DECLARE_JNI_CLASS, la correspondencia se puede ampliar a tipos Java arbitrarios.
Véase también Q_DECLARE_JNI_CLASS, Q_DECLARE_JNI_NATIVE_METHOD y Q_JNI_NATIVE_METHOD.
Clases
clase JObject
La plantilla JObject del espacio de nombres QtJniTypes es la base de los tipos Java declarados. Más...
Documentación de macros
[since 6.8] Q_DECLARE_JNI_CLASS(Type, JavaSignature)
Declara un tipo de C++ ` Type ` en el espacio de nombres ` QtJniTypes ` que envuelve la clase Java ` JavaSignature`. El nombre de la clase Java en ` JavaSignature ` debe estar completamente calificado, utilizando ` / ` como separador.
Q_DECLARE_JNI_CLASS(File, "java/io/File")
Q_DECLARE_JNI_CLASS(FileWriter, "java/io/FileWriter")Las clases de C++ QtJniTypes::File y QtJniTypes::FileWriter son, por tanto, tipos similares a QJniObject(especializaciones de QtJniTypes::JObject, para ser precisos) que pueden utilizarse para instanciar la clase Java correspondiente, llamar a métodos y pasar dichas instancias a través de métodos de plantilla variádicos de QJniObject con deducción automática de la firma en tiempo de compilación.
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);
}Además de la API QJniObject, esas clases de C++ también cuentan con una función miembro estática registerNativeMethods que se puede utilizar de la siguiente manera:
QtJniTypes::File::registerNativeMethods({
Q_JNI_NATIVE_METHOD(freeFunction)
});Esta macro se introdujo en Qt 6.8.
Véase también Q_DECLARE_JNI_NATIVE_METHOD, Q_JNI_NATIVE_METHOD y QtJniTypes::JObject.
[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD(Method)
Declara la función libre de C o C++ ` Method ` como método nativo. Posteriormente, el método se puede registrar en el marco JNI mediante `QJniEnvironment::registerNativeMethod()`, con la ayuda de la macro ` Q_JNI_NATIVE_METHOD `.
// 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);
}Esta macro se introdujo en Qt 6.8.
Véase también Q_JNI_NATIVE_METHOD y Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE.
[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD(Method, JavaName)
Declara la función libre de C o C++ ` Method ` como un método nativo disponible en Java como ` JavaName`. Posteriormente, el método se puede registrar en el marco JNI mediante `QJniEnvironment::registerNativeMethod()`, con la ayuda de la macro ` Q_JNI_NATIVE_METHOD `.
Se trata de una función sobrecargada.
Esta macro se introdujo en Qt 6.8.
Véase también Q_JNI_NATIVE_METHOD y Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE.
[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method)
Declara la función miembro estática de clase de C++ ` Method ` como método nativo. Posteriormente, el método se puede registrar en el marco JNI mediante `QJniEnvironment::registerNativeMethod()`, con la ayuda de la macro ` Q_JNI_NATIVE_SCOPED_METHOD `.
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)
});Esta macro se introdujo en Qt 6.8.
Véase también Q_DECLARE_JNI_NATIVE_METHOD y Q_JNI_NATIVE_SCOPED_METHOD.
[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE(Method, JavaName)
Declara la función miembro estática de clase de C++ ` Method ` como un método nativo disponible en Java como ` JavaName`. Posteriormente, el método se puede registrar en el marco JNI mediante `QJniEnvironment::registerNativeMethod()`, con la ayuda de la macro ` Q_JNI_NATIVE_METHOD `.
Se trata de una función sobrecargada.
Esta macro se introdujo en Qt 6.8.
Véase también Q_DECLARE_JNI_NATIVE_METHOD y Q_JNI_NATIVE_SCOPED_METHOD.
[since 6.8] Q_JNI_NATIVE_METHOD(Method)
Hace que el método nativo Method, anteriormente declared, esté disponible para su registro en el marco JNI. Utiliza esta macro al registrar el método en JNI mediante QJniEnvironment::registerNativeMethod().
Q_DECL_EXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved)
{
QJniEnvironment env;
env.registerNativeMethods<QtJniTypes::MyJavaType>({
Q_JNI_NATIVE_METHOD(nativeFunction)
});
}Esta macro se introdujo en Qt 6.8.
Véase también Q_DECLARE_JNI_NATIVE_METHOD.
[since 6.8] Q_JNI_NATIVE_SCOPED_METHOD(Method, Scope)
Hace que el método nativo Method, que anteriormente se encontraba en el ámbito declared Scope , esté disponible para su registro en el marco JNI. Utiliza esta macro al registrar el método en JNI mediante QJniEnvironment::registerNativeMethod().
Esta macro se introdujo en Qt 6.8.
Véase también Q_JNI_NATIVE_METHOD y Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.