QJniObject Class

멤버 함수 문서

QJniObject 가 보유한 객체를 잡젝트 또는 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.
}

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)

args 인수를 사용하여 생성자를 호출하여 clazz 에서 새 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, ...)

className 의 생성자를 호출하고 signature 후속 인수의 유형을 지정하여 새 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, ...)

signature 으로 생성자를 호출하고 후속 인수의 유형을 지정하여 clazz 에서 새 JNI 객체를 생성합니다.

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

[noexcept] QJniObject::~QJniObject()

JNI 객체를 삭제하고 JNI 객체가 보유한 모든 참조를 해제합니다.

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

args 인수를 사용하여 methodName 메서드를 호출하고 값을 반환합니다( Ret 이 void 이 아닌 경우). Ret 이 잡젝트 타입인 경우 반환되는 값은 QJniObject 입니다.

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

메서드 서명은 컴파일 타임에 Ret 와 args 의 형으로부터 추론됩니다.

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

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

후속 인수의 유형을 지정하는 signature 을 사용하여 객체의 메서드 methodName 를 호출하고 args 값을 반환합니다( Ret 이 void 이 아닌 경우). Ret 이 잡젝트 타입이면, 반환되는 값은 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 의 유형으로부터 추론됩니다.

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

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

후속 인수의 유형을 지정하는 signature 을 사용하여 Java 객체의 메서드 methodName 를 호출합니다.

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)

Klass 클래스에서 정적 메서드 methodName 를 호출하고 Ret 타입의 값을 반환합니다( Ret 이 void 인 경우 제외). Ret 이 잡젝트 타입인 경우 반환되는 값은 QJniObject 입니다.

메서드 서명은 컴파일 시 Ret 에서 args 의 타입을 추론합니다. Klass 는 Java 타입에 등록된 타입 매핑이 있는 C++ 타입이어야 합니다.

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

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

인자 args 를 사용하여 className 클래스에서 정적 메서드 methodName 를 호출하고 Ret 타입의 값을 반환합니다( Ret 가 void 인 경우 제외). Ret 이 잡젝트 타입이면 반환되는 값은 QJniObject 입니다.

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

메서드 서명은 컴파일 타임에 Ret 와 args 의 형으로부터 추론됩니다.

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

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

clazz 에서 정적 메서드 methodName 를 호출하고 Ret 타입의 값을 반환합니다( Ret 이 void 인 경우 제외). Ret 가 잡젝트 타입인 경우 반환되는 값은 QJniObject 입니다.

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

메서드 서명은 컴파일 타임에 Ret 와 args 의 형으로부터 추론됩니다.

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

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

clazz 클래스에서 methodId 로 식별되는 정적 메서드를 후속 인자와 함께 호출하고 Ret 타입의 값을 반환합니다( Ret 이 void 인 경우 제외). Ret 이 잡젝트 유형인 경우 반환되는 값은 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, typename... Args> auto QJniObject::callStaticMethod(const char *className, const char *methodName, const char *signature, Args &&... args)

className 클래스에서 정적 메서드 methodName 를 호출하고 signature 후속 인자의 유형을 지정합니다 args. 메서드의 결과를 반환합니다( Ret 이 void 이 아닌 경우). Ret 이 잡젝트 타입이면, 반환되는 값은 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, typename... Args> auto QJniObject::callStaticMethod(jclass clazz, const char *methodName, const char *signature, Args &&... args)

clazz 에서 정적 메서드 methodName 를 호출하고 signature 에서 후속 인수의 유형을 지정합니다. 메서드의 결과를 반환합니다( Ret 이 void 이 아닌 경우). Ret 가 잡젝트 유형인 경우 반환되는 값은 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 의 유형으로부터 추론됩니다.

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

필드에서 JNI 객체를 검색합니다 fieldName.

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 T> auto QJniObject::getStaticField(const char *className, const char *fieldName)

className 클래스의 정적 필드 fieldName 에서 값을 검색합니다.

[static] template <typename T> 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

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

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

이 기능은 Qt 6.2에 도입되었습니다.

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

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

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

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

Klass Java 타입에 등록된 타입 매핑이 있는 C++ 타입이어야 합니다.

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

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

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

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

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

signature 와 함께 세터를 사용하여 className 클래스의 정적 필드 fieldName 를 value 로 설정합니다.

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

signature 와 함께 세터를 사용하여 clazz 클래스의 정적 필드 fieldName 를 value 로 설정합니다.

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

이 객체를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

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

QString QJniObject::toString() const

자바 객체의 문자열 표현으로 QString 을 반환합니다. Java 문자열 객체에서 이 함수를 호출하면 실제 문자열 데이터를 편리하게 가져올 수 있습니다.

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

fromString()도 참조하세요 .

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

현재 객체를 object 로 바꿉니다. 이전 Java 객체가 릴리스됩니다.