QJniObject Class

멤버 함수 문서

QJniObject::QJniObject()

유효하지 않은 JNI 객체를 생성합니다.

isValid()도 참조하십시오 .

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

className 의 기본 생성자를 호출하여 새로운 JNI 객체를 생성합니다.

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

[explicit] QJniObject::QJniObject(jclass clazz)

clazz 의 기본 생성자를 호출하여 새로운 JNI 객체를 생성합니다.

QJniObject::QJniObject(jobject object)

Java 객체 ` object`을 기반으로 새로운 JNI 객체를 생성합니다.

fromLocalRef()도 참조하십시오 .

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

args 를 인수로 사용하여 className 의 생성자를 호출함으로써 새로운 JNI 객체를 생성합니다. 이 생성자는 모든 args 가 알려진 경우에만 사용할 수 있습니다 JNI Types.

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

이 함수는 Qt 6.4에서 도입되었습니다.

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

clazz args 를 사용하여 인수를 전달해 생성자를 호출함으로써 새로운 JNI 객체를 생성합니다. 이 생성자는 모든 가 알려진 경우에만 사용할 수 있습니다 . args JNI Types

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

이 함수는 Qt 6.4에서 도입되었습니다.

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

` signature `를 사용하여 후속 인자의 유형을 지정하고, ` className `의 생성자를 호출하여 새로운 JNI 객체를 생성합니다.

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

` clazz `에서 새로운 JNI 객체를 생성합니다. 이때 ` signature `을 사용하여 생성자를 호출하고, 뒤따르는 인수의 유형을 지정합니다.

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

[noexcept default] QJniObject::QJniObject(const QJniObject &other)

QJniObject 의 인스턴스를 복사 생성합니다.

[noexcept default] QJniObject::QJniObject(QJniObject &&other)

QJniObject 의 인스턴스를 move-construct로 생성합니다.

[noexcept] QJniObject::~QJniObject()

JNI 객체를 파기하고, JNI 객체가 보유하고 있는 모든 참조를 해제합니다.

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

args 를 인수로 하여 methodName 메서드를 호출하고, Ret이 void 가 아닌 경우 해당 값을 반환합니다. Ret이 jobject 유형인 경우, 반환되는 값은 QJniObject 가 됩니다.

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

메서드 시그니처는 컴파일 시점에 Ret와 args 의 타입을 기반으로 추론됩니다. Ret는 값을 반환하는 std::expected 호환 타입이거나, 호출된 메서드에 의해 any Java exception thrown 일 수 있습니다.

이 함수는 Qt 6.4에서 도입되었습니다.

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

객체의 ` methodName ` 메서드를 호출하며, ` signature `을 통해 후속 인자 ` args`의 유형을 지정하고, `Ret`이 ` void`가 아닌 경우 해당 값을 반환합니다. `Ret`이 `jobject` 유형인 경우, 반환되는 값은 ` QJniObject`가 됩니다.

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

이 함수는 Qt 6.4에서 도입되었습니다.

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

args 를 인수로 사용하여 Java 객체의 methodName 메서드를 호출하고, 반환된 Java 객체에 대한 새로운 QJniObject 를 반환합니다.

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

메서드 시그니처는 컴파일 시점에 Ret 및 args 의 유형을 기반으로 추론됩니다. Ret은 값을 반환하는 std::expected 호환 유형이거나, 호출된 메서드가 반환하는 any Java exception thrown 일 수 있습니다.

이 함수는 Qt 6.4에서 도입되었습니다.

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

Java 객체의 ` methodName ` 메서드를 호출하며, ` signature `을 사용하여 뒤따르는 인수의 유형을 지정합니다.

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)

Klass 클래스의 정적 메서드 methodName 를 호출하고, Ret 유형의 값을 반환합니다(Ret가 void 인 경우는 제외). Ret가 jobject 유형인 경우, 반환되는 값은 QJniObject 가 됩니다.

메서드 시그니처는 컴파일 시점에 Ret와 args 의 타입을 기반으로 추론됩니다. Klass 는 Java 타입에 매핑된 등록된 타입을 가진 C++ 타입이어야 합니다. Ret는 값을 반환하는 std::expected 호환 타입이거나, 호출된 메서드에 의해 any Java exception thrown 가 될 수 있습니다.

이 함수는 Qt 6.7에서 도입되었습니다.

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

className 클래스의 정적 메서드 methodName 를 인자 args 와 함께 호출하고, Ret 유형의 값을 반환합니다(Ret가 void 인 경우는 제외). Ret가 jobject 유형인 경우, 반환되는 값은 QJniObject 가 됩니다.

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

메서드 시그니처는 컴파일 시점에 Ret와 args 의 유형을 기반으로 추론됩니다. Ret는 값을 반환하는 std::expected 호환 유형이거나, 호출된 메서드에 의해 any Java exception thrown 일 수 있습니다.

이 함수는 Qt 6.4에서 도입되었습니다.

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

clazz 에 대한 정적 메서드 methodName 를 호출하고, Ret 유형의 값을 반환합니다(Ret가 void 인 경우는 제외). Ret가 jobject 유형인 경우, 반환되는 값은 QJniObject 가 됩니다.

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

메서드 시그니처는 컴파일 시 Ret와 args 의 타입을 기반으로 추론됩니다. Ret는 값을 반환하는 std::expected 호환 타입이거나, 호출된 메서드에 의해 any Java exception thrown 일 수 있습니다.

이 함수는 Qt 6.4에서 도입되었습니다.

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

clazz 클래스의 methodId 로 식별되는 정적 메서드를 뒤따르는 인자들과 함께 호출하고, Ret 유형의 값을 반환합니다(Ret가 void 인 경우는 제외). Ret가 jobject 유형인 경우, 반환되는 값은 QJniObject 가 됩니다.

이 함수는 이전 연산에서 clazz 및 methodId 가 이미 캐시된 경우 유용합니다.

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

이 함수는 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)

className 클래스의 정적 메서드 ` methodName `를 호출하며, ` signature `를 통해 후속 인자의 유형 ` args`을 지정합니다. 메서드의 결과를 반환합니다(단, `Ret`가 ` void`인 경우는 제외). `Ret`가 `jobject` 유형인 경우, 반환 값은 ` QJniObject`가 됩니다.

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

이 함수는 Qt 6.4에서 도입되었습니다.

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

clazz 의 정적 메서드 ` methodName `를 호출하며, ` signature `를 사용하여 후속 인자의 유형을 지정합니다. 메서드의 결과를 반환합니다(단, `Ret`가 ` void`인 경우는 제외). `Ret`가 `jobject` 유형인 경우, 반환 값은 ` 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)

className 클래스의 methodName 를 사용하여 args 인수를 전달하고, 반환된 Java 객체에 대한 새로운 QJniObject 를 반환합니다.

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

메서드 시그니처는 컴파일 시점에 Ret 및 args 의 타입을 기반으로 추론됩니다. Ret는 값을 반환하는 std::expected 호환 타입이거나, 호출된 메서드가 반환하는 any Java exception thrown 일 수 있습니다.

이 함수는 Qt 6.4에서 도입되었습니다.

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

clazz 의 ` methodName ` 메서드를 호출하여 인자 ` args`를 전달하고, 반환된 Java 객체에 대한 새로운 ` QJniObject `를 반환합니다.

이 함수는 Qt 6.4에서 도입되었습니다.

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

clazz 클래스의 ` methodId `로 식별되는 정적 메서드를, 뒤따르는 인자와 함께 호출합니다. 이전 작업에서 ` clazz ` 및 ` methodId `가 이미 캐시에 저장되어 있을 때 유용합니다.

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

className 클래스의 정적 메서드 ` methodName `를 호출하며, ` signature `를 사용하여 그 뒤의 인자 유형을 지정합니다.

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

clazz 클래스의 정적 메서드 ` methodName `을 호출하며, ` signature `을 사용하여 이후 인자의 유형을 지정합니다.

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

QJniObject 가 보유한 클래스 객체의 이름을 QByteArray 형식으로 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

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

Class 과 동등한 Java 클래스의 인스턴스를 생성하고, JNI 객체를 포함하는 QJniObject 를 반환합니다. args 의 인수는 Java 생성자에 전달됩니다.

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

이 함수는 모든 args 가 JNI Types 로 알려진 경우에만 사용할 수 있습니다.

이 함수는 Qt 6.4에서 도입되었습니다.

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

로컬 JNI 참조 localRef 를 사용하여 QJniObject 를 생성합니다. 이 함수는 localRef 에 대한 소유권을 인수한 후, 반환하기 전에 이를 해제합니다.

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

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

QString string 를 사용하여 Java 문자열을 생성하고, 해당 문자열을 포함하는 QJniObject 을 반환합니다.

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

toString()도 참조하십시오 .

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

fieldName 필드의 값을 가져옵니다.

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

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

fieldName 필드에서 JNI 객체를 가져옵니다.

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

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

signature 를 사용하여 fieldName 필드에서 JNI 객체를 가져옵니다.

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

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

Klass 클래스의 정적 필드 ` fieldName `에서 값을 가져옵니다.

Klass Java 타입으로 매핑된 등록된 타입을 가진 C++ 타입이어야 합니다.

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

className 클래스의 정적 필드 ` fieldName `에서 값을 가져옵니다.

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

clazz 의 정적 필드 fieldName 에서 값을 가져옵니다.

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

className 클래스의 fieldName 필드에서 객체를 가져옵니다.

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

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

clazz 의 fieldName 필드에서 객체를 가져옵니다.

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

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

className 클래스의 signature 를 사용하여 fieldName 필드에서 JNI 객체를 가져옵니다.

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

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

clazz 클래스의 signature 를 가진 fieldName 필드에서 JNI 객체를 가져옵니다.

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

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

Java 클래스 className 를 사용할 수 있는 경우 true를 반환합니다.

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

bool QJniObject::isValid() const

이 인스턴스가 유효한 Java 객체를 포함하고 있는 경우 true를 반환합니다.

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

QJniObject 가 보유한 객체를 jobject 또는 T 형식으로 반환합니다. T는 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

QJniObject 가 보유한 클래스 객체를 jclass 형태로 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

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

fieldName 의 값을 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)

` signature `를 사용하여 ` fieldName `의 값을 ` 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)

Klass 클래스의 정적 필드 ` fieldName `을 ` value`으로 설정합니다.

Klass Java 유형으로 매핑된 등록된 유형을 가진 C++ 유형이어야 합니다.

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

className 클래스의 정적 필드 ` fieldName `를 ` value`로 설정합니다.

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

clazz 클래스의 정적 필드 ` fieldName `을 ` value`으로 설정합니다.

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

signature 를 사용하는 세터 메서드를 통해 className 클래스의 정적 필드 ` fieldName `를 ` value `로 설정합니다.

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

signature 를 사용하여 setter를 통해 clazz 클래스의 정적 필드 ` fieldName `을 ` value `으로 설정합니다.

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

이 객체를 ` other`와 교체합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

이 함수는 Qt 6.8에서 도입되었습니다.

QString QJniObject::toString() const

Java 객체의 문자열 표현을 담은 ` QString `를 반환합니다. Java `String` 객체에 대해 이 함수를 호출하면 실제 문자열 데이터를 편리하게 얻을 수 있습니다.

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

fromString()도 참조하십시오 .

[noexcept default] QJniObject &QJniObject::operator=(QJniObject &&other)

other 를 이 QJniObject 인스턴스에 할당합니다.

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

현재 객체를 ` object`로 교체합니다. 기존 Java 객체는 해제됩니다.

[noexcept default] QJniObject &QJniObject::operator=(const QJniObject &other)

other 를 이 QJniObject 인스턴스에 복사-할당합니다.