diff options
Diffstat (limited to 'src/androidextras/jni/qandroidjnienvironment.cpp')
| -rw-r--r-- | src/androidextras/jni/qandroidjnienvironment.cpp | 203 |
1 files changed, 0 insertions, 203 deletions
diff --git a/src/androidextras/jni/qandroidjnienvironment.cpp b/src/androidextras/jni/qandroidjnienvironment.cpp deleted file mode 100644 index 10bf229..0000000 --- a/src/androidextras/jni/qandroidjnienvironment.cpp +++ /dev/null @@ -1,203 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2016 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:LGPL$ -** Commercial License Usage -** Licensees holding valid commercial Qt licenses may use this file in -** accordance with the commercial license agreement provided with the -** Software or, alternatively, in accordance with the terms contained in -** a written agreement between you and The Qt Company. For licensing terms -** and conditions see https://www.qt.io/terms-conditions. For further -** information use the contact form at https://www.qt.io/contact-us. -** -** GNU Lesser General Public License Usage -** Alternatively, this file may be used under the terms of the GNU Lesser -** General Public License version 3 as published by the Free Software -** Foundation and appearing in the file LICENSE.LGPL3 included in the -** packaging of this file. Please review the following information to -** ensure the GNU Lesser General Public License version 3 requirements -** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. -** -** GNU General Public License Usage -** Alternatively, this file may be used under the terms of the GNU -** General Public License version 2.0 or (at your option) the GNU General -** Public license version 3 or any later version approved by the KDE Free -** Qt Foundation. The licenses are as published by the Free Software -** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 -** included in the packaging of this file. Please review the following -** information to ensure the GNU General Public License requirements will -** be met: https://www.gnu.org/licenses/gpl-2.0.html and -** https://www.gnu.org/licenses/gpl-3.0.html. -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - -#include "qandroidjnienvironment.h" -#include <QtCore/private/qjni_p.h> -#include <QtCore/private/qjnihelpers_p.h> -#include <QtCore/qthreadstorage.h> - -QT_BEGIN_NAMESPACE - -/*! - \class QAndroidJniEnvironment - \inmodule QtAndroidExtras - \brief The QAndroidJniEnvironment provides access to the JNI Environment. - \since 5.2 -*/ - -/*! - \fn QAndroidJniEnvironment::QAndroidJniEnvironment() - - Constructs a new QAndroidJniEnvironment object and attach the current thread to the Java VM. - - \snippet code/src_androidextras_qandroidjnienvironment.cpp Create QAndroidJniEnvironment -*/ - -/*! - \fn QAndroidJniEnvironment::~QAndroidJniEnvironment() - - Detaches the current thread from the Java VM and destroys the QAndroidJniEnvironment object. -*/ - -/*! - \fn JavaVM *QAndroidJniEnvironment::javaVM() - - Returns the Java VM interface. -*/ - -/*! - \fn JNIEnv *QAndroidJniEnvironment::operator->() - - Provides access to the QAndroidJniEnvironment's JNIEnv pointer. -*/ - -/*! - \fn QAndroidJniEnvironment::operator JNIEnv *() const - - Returns the JNI Environment pointer. - */ - -/*! - \fn jclass QAndroidJniEnvironment::findClass(const char *className) - - Searches for \a className using all available class loaders. Qt on Android - uses a custom class loader to load all the .jar files and it must be used - to find any classes that are created by that class loader because these - classes are not visible in the default class loader. - - Returns the class pointer or null if is not found. - - A use case for this function is searching for a custom class then calling - its memeber method. The following code snippet create an instance of the - class \c CustomClass and then calls \c printFromJava() method: - - \code - QAndroidJniEnvironment env; - jclass javaClass = env.findClass("org/qtproject/example/qtandroidextras/CustomClass"); - QAndroidJniObject classObject(javaClass); - - QAndroidJniObject javaMessage = QAndroidJniObject::fromString("findClass example"); - classObject.callMethod<void>("printFromJava", - "(Ljava/lang/String;)V", - javaMessage.object<jstring>()); - \badcode - - \since Qt 5.12 - */ - - -QAndroidJniEnvironment::QAndroidJniEnvironment() - : d(new QJNIEnvironmentPrivate) -{ -} - -QAndroidJniEnvironment::~QAndroidJniEnvironment() -{ -} - -JavaVM *QAndroidJniEnvironment::javaVM() -{ - return QtAndroidPrivate::javaVM(); -} - -JNIEnv *QAndroidJniEnvironment::operator->() -{ - return d->jniEnv; -} - -QAndroidJniEnvironment::operator JNIEnv*() const -{ - return d->jniEnv; -} - -jclass QAndroidJniEnvironment::findClass(const char *className) -{ - return QJNIEnvironmentPrivate::findClass(className, d->jniEnv); -} - -static void clearException(bool silent) -{ - QAndroidJniEnvironment env; - if (Q_UNLIKELY(env->ExceptionCheck())) { - if (!silent) - env->ExceptionDescribe(); - env->ExceptionClear(); - } -} - -/*! - \class QAndroidJniExceptionCleaner - \inmodule QtAndroidExtras - \brief Cleans pending JNI exceptions. - - The QAndroidJniExceptionCleaner is a convenience class useful to clean - the pending JNI exceptions from the current scope. - - \since 5.10 -*/ - -/*! - \enum QAndroidJniExceptionCleaner::OutputMode - - \value Silent the exceptions are cleaned silently - \value Verbose discribes the exceptions before cleaning them -*/ - -/*! - \fn QAndroidJniExceptionCleaner::QAndroidJniExceptionCleaner(OutputMode outputMode = OutputMode::Silent) - - Cleans any pending exceptions either silently or with descriptions, depending on the \a outputMode. - */ -QAndroidJniExceptionCleaner::QAndroidJniExceptionCleaner(QAndroidJniExceptionCleaner::OutputMode outputMode) - : m_outputMode(outputMode) -{ - clearException(outputMode == OutputMode::Silent); -} - -/*! - \fn QAndroidJniExceptionCleaner::~QAndroidJniExceptionCleaner() - - Clean any pending exceptions. - */ -QAndroidJniExceptionCleaner::~QAndroidJniExceptionCleaner() -{ - clearException(m_outputMode == OutputMode::Silent); -} - -/*! - \fn void QAndroidJniExceptionCleaner::clean() - - Manually cleans any pending exceptions - */ -void QAndroidJniExceptionCleaner::clean() -{ - clearException(m_outputMode == OutputMode::Silent); -} - -QT_END_NAMESPACE |