QtJniTypes Namespace

매크로 문서

[since 6.8] Q_DECLARE_JNI_CLASS(Type, JavaSignature)

QtJniTypes 네임스페이스 내에 Java 클래스 JavaSignature 를 래핑하는 C++ 타입 Type 를 선언합니다. JavaSignature 에 명시된 Java 클래스 이름은 / 를 구분자로 사용하여 완전한 정규화된 이름을 사용해야 합니다.

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

따라서 C++ 클래스 QtJniTypes::File 및 QtJniTypes::FileWriter 은 QJniObject 과 유사한 유형(정확히 말하면 QtJniTypes::JObject 의 특화형)으로, 해당 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 및 QtJniTypes::JObject도 참조하십시오 .

[since 6.8] Q_DECLARE_JNI_NATIVE_METHOD(Method)

Method 라는 자유 C 또는 C++ 함수를 네이티브 메서드로 선언합니다. 이 메서드는 나중에 ` 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)

이전에는 declared 에 있던 네이티브 메서드 Method (범위: Scope )를 JNI 프레임워크에 등록할 수 있도록 합니다. QJniEnvironment::registerNativeMethod()를 사용하여 JNI에 메서드를 등록할 때 이 매크로를 사용하십시오.

이 매크로는 Qt 6.8에서 도입되었습니다.

Q_JNI_NATIVE_METHOD 및 Q_DECLARE_JNI_NATIVE_METHOD_IN_CURRENT_SCOPE도 참조하십시오 .