Make QJniObject and QJniEnvironment public API

As part of Qt 6 restructring for the extras modules, this change exposes
the Jni APIs which are very important for Android platform. This patch
adds the APIs QJniObject, QJniEnvironment, QJniExceptionCleaner based
from private QtCore and QtAndroidExtras.

The Jni interface is cross-platform which justifies the name, but
currently, this API is used mainly for Android, and the naming comes
generic without Android keyword to avoid any future limitation on
supporting other platforms.

[ChangeLog][QtCore] Add new QJniObject, QJniEnvironment and
QJniExceptionCleaner APIs.

Task-number: QTBUG-89482
Fixes: QTBUG-89633
Change-Id: I4382dd53a225375759b9d042f6035a4a9810572b
Reviewed-by: Ville Voutilainen <ville.voutilainen@qt.io>

1 files changed, 177 insertions, 0 deletions

diff --git a/tests/auto/corelib/kernel/qjniobject/testdata/src/org/qtproject/qt/android/testdata/QtJniObjectTestClass.java b/tests/auto/corelib/kernel/qjniobject/testdata/src/org/qtproject/qt/android/testdata/QtJniObjectTestClass.java
new file mode 100644
index 0000000000..4d6db749a5
--- /dev/null
+++ b/tests/auto/corelib/kernel/qjniobject/testdata/src/org/qtproject/qt/android/testdata/QtJniObjectTestClass.java
@@ -0,0 +1,177 @@
+/****************************************************************************
+**
+** Copyright (C) 2021 The Qt Company Ltd.
+** Contact: https://www.qt.io/licensing/
+**
+** This file is part of the test suite of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:GPL-EXCEPT$
+** 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 General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3 as published by the Free Software
+** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT
+** 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-3.0.html.
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+package org.qtproject.qt.android.testdatapackage;
+
+public class QtJniObjectTestClass
+{
+    static final byte A_BYTE_VALUE = 127;
+    static final short A_SHORT_VALUE = 32767;
+    static final int A_INT_VALUE = 060701;
+    static final long A_LONG_VALUE = 060701;
+    static final float A_FLOAT_VALUE = 1.0f;
+    static final double A_DOUBLE_VALUE = 1.0;
+    static final boolean A_BOOLEAN_VALUE = true;
+    static final char A_CHAR_VALUE = 'Q';
+    static final String A_STRING_OBJECT = "TEST_DATA_STRING";
+    static final Class A_CLASS_OBJECT = QtJniObjectTestClass.class;
+    static final Object A_OBJECT_OBJECT = new QtJniObjectTestClass();
+    static final Throwable A_THROWABLE_OBJECT = new Throwable(A_STRING_OBJECT);
+
+    // --------------------------------------------------------------------------------------------
+    public static void staticVoidMethod() { return; }
+    public static void staticVoidMethodWithArgs(int a, boolean b, char c) { return; }
+
+    public void voidMethod() { return; }
+    public void voidMethodWithArgs(int a, boolean b, char c) { return; }
+
+    // --------------------------------------------------------------------------------------------
+    public static boolean staticBooleanMethod() { return A_BOOLEAN_VALUE; }
+    public static boolean staticBooleanMethodWithArgs(boolean a, boolean b, boolean c)
+    { return staticBooleanMethod(); }
+
+    public boolean booleanMethod() { return staticBooleanMethod(); }
+    public boolean booleanMethodWithArgs(boolean a, boolean b, boolean c)
+    { return staticBooleanMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static byte staticByteMethod() { return A_BYTE_VALUE; }
+    public static byte staticByteMethodWithArgs(byte a, byte b, byte c) { return staticByteMethod(); }
+
+    public byte byteMethod() { return staticByteMethod(); }
+    public byte byteMethodWithArgs(byte a, byte b, byte c)
+    { return staticByteMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static char staticCharMethod() { return A_CHAR_VALUE; }
+    public static char staticCharMethodWithArgs(char a, char b, char c) { return staticCharMethod(); }
+
+    public char charMethod() { return staticCharMethod(); }
+    public char charMethodWithArgs(char a, char b, char c)
+    { return staticCharMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static short staticShortMethod() { return A_SHORT_VALUE; }
+    public static short staticShortMethodWithArgs(short a, short b, short c) { return staticShortMethod(); }
+
+    public short shortMethod() { return staticShortMethod(); }
+    public short shortMethodWithArgs(short a, short b, short c)
+    { return staticShortMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static int staticIntMethod() { return A_INT_VALUE; }
+    public static int staticIntMethodWithArgs(int a, int b, int c) { return staticIntMethod(); }
+
+    public int intMethod() { return staticIntMethod(); }
+    public int intMethodWithArgs(int a, int b, int c) { return staticIntMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static long staticLongMethod() { return A_LONG_VALUE; }
+    public static long staticLongMethodWithArgs(long a, long b, long c) { return staticLongMethod(); }
+
+    public long longMethod() { return staticLongMethod(); }
+    public long longMethodWithArgs(long a, long b, long c)
+    { return staticLongMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static float staticFloatMethod() { return A_FLOAT_VALUE; }
+    public static float staticFloatMethodWithArgs(float a, float b, float c) { return staticFloatMethod(); }
+
+    public float floatMethod() { return staticFloatMethod(); }
+    public float floatMethodWithArgs(float a, float b, float c)
+    { return staticFloatMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static double staticDoubleMethod() { return A_DOUBLE_VALUE; }
+    public static double staticDoubleMethodWithArgs(double a, double b, double c)
+    { return staticDoubleMethod(); }
+
+    public double doubleMethod() { return staticDoubleMethod(); }
+    public double doubleMethodWithArgs(double a, double b, double c)
+    { return staticDoubleMethodWithArgs(a, b, c); }
+
+    // --------------------------------------------------------------------------------------------
+    public static Object staticObjectMethod() { return A_OBJECT_OBJECT; }
+    public Object objectMethod() { return staticObjectMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static Class staticClassMethod() { return A_CLASS_OBJECT; }
+    public Class classMethod() { return staticClassMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static String staticStringMethod() { return A_STRING_OBJECT; }
+    public String stringMethod() { return staticStringMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static Throwable staticThrowableMethod() { return A_THROWABLE_OBJECT; }
+    public Throwable throwableMethod() { return staticThrowableMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static Object[] staticObjectArrayMethod()
+    { Object[] array = { new Object(), new Object(), new Object() }; return array; }
+    public Object[] objectArrayMethod() { return staticObjectArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static boolean[] staticBooleanArrayMethod()
+    { boolean[] array = { true, true, true }; return array; }
+    public boolean[] booleanArrayMethod() { return staticBooleanArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static byte[] staticByteArrayMethod()
+    { byte[] array = { 'a', 'b', 'c' }; return array; }
+    public byte[] byteArrayMethod() { return staticByteArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static char[] staticCharArrayMethod()
+    { char[] array = { 'a', 'b', 'c' }; return array; }
+    public char[] charArrayMethod() { return staticCharArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static short[] staticShortArrayMethod() { short[] array = { 3, 2, 1 }; return array; }
+    public short[] shortArrayMethod() { return staticShortArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static int[] staticIntArrayMethod() { int[] array = { 3, 2, 1 }; return array; }
+    public int[] intArrayMethod() { return staticIntArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static long[] staticLongArrayMethod()
+    { long[] array = { 3, 2, 1 }; return array; }
+    public long[] longArrayMethod() { return staticLongArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static float[] staticFloatArrayMethod()
+    { float[] array = { 1.0f, 2.0f, 3.0f }; return array; }
+    public float[] floatArrayMethod() { return staticFloatArrayMethod(); }
+
+    // --------------------------------------------------------------------------------------------
+    public static double[] staticDoubleArrayMethod()
+    { double[] array = { 3.0, 2.0, 1.0 }; return array; }
+    public double[] doubleArrayMethod() { return staticDoubleArrayMethod(); }
+}
+