Say hello to low level Android Service & Binder implementations

These are the building blocks for higher level APIs such as Qt Remote
Objects.

[ChangeLog][Android] Added low level APIs for Android Service & Binder.

Change-Id: I320214d310a398541bbde985ecf67bf6101c0b67
Reviewed-by: Eskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@qt.io>

1 files changed, 243 insertions, 0 deletions

diff --git a/src/androidextras/android/qandroidparcel.cpp b/src/androidextras/android/qandroidparcel.cpp
new file mode 100644
index 0000000..c2e80a0
--- /dev/null
+++ b/src/androidextras/android/qandroidparcel.cpp
@@ -0,0 +1,243 @@
+/****************************************************************************
+**
+** Copyright (C) 2017 BogDan Vatra <bogdan@kde.org>
+** 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 "qandroidparcel.h"
+
+#include "qandroidbinder.h"
+#include "qandroidbinder_p.h"
+#include "qandroidparcel_p.h"
+
+#include <QAndroidJniObject>
+#include <QAndroidJniEnvironment>
+#include <QBuffer>
+#include <QDataStream>
+#include <QVariant>
+
+QT_BEGIN_NAMESPACE
+
+struct FileDescriptor
+{
+    explicit FileDescriptor(int fd = -1)
+        : handle("java/io/FileDescriptor")
+    {
+        QAndroidJniExceptionCleaner cleaner;
+        setFileDescriptor(fd);
+    }
+
+    inline void setFileDescriptor(int fd)
+    {
+        QAndroidJniExceptionCleaner cleaner;
+        handle.setField("descriptor", fd);
+    }
+
+    QAndroidJniObject handle;
+};
+
+QAndroidParcelPrivate::QAndroidParcelPrivate()
+    : handle(QAndroidJniObject::callStaticObjectMethod("android/os/Parcel","obtain", "()Landroid/os/Parcel;").object())
+{}
+
+QAndroidParcelPrivate::QAndroidParcelPrivate(const QAndroidJniObject &parcel)
+    : handle(parcel)
+{}
+
+void QAndroidParcelPrivate::writeData(const QByteArray &data) const
+{
+    if (data.isEmpty())
+        return;
+
+    QAndroidJniExceptionCleaner cleaner;
+    QAndroidJniEnvironment env;
+    jbyteArray array = env->NewByteArray(data.size());
+    env->SetByteArrayRegion(array, 0, data.length(), reinterpret_cast<const jbyte*>(data.constData()));
+    handle.callMethod<void>("writeByteArray", "([B)V", array);
+    env->DeleteLocalRef(array);
+}
+
+void QAndroidParcelPrivate::writeBinder(const QAndroidBinder &binder) const
+{
+    QAndroidJniExceptionCleaner cleaner;
+    handle.callMethod<void>("writeStrongBinder", "(Landroid/os/IBinder;)V", binder.handle().object());
+}
+
+void QAndroidParcelPrivate::writeFileDescriptor(int fd) const
+{
+    QAndroidJniExceptionCleaner cleaner;
+    handle.callMethod<void>("writeFileDescriptor", "(Ljava/io/FileDescriptor;)V", FileDescriptor(fd).handle.object());
+}
+
+QByteArray QAndroidParcelPrivate::readData() const
+{
+    QAndroidJniExceptionCleaner cleaner;
+    auto array = handle.callObjectMethod("createByteArray", "()[B");
+    QAndroidJniEnvironment env;
+    auto sz = env->GetArrayLength(jbyteArray(array.object()));
+    QByteArray res(sz, Qt::Initialization::Uninitialized);
+    env->GetByteArrayRegion(jbyteArray(array.object()), 0, sz, reinterpret_cast<jbyte *>(res.data()));
+    return res;
+}
+
+int QAndroidParcelPrivate::readFileDescriptor() const
+{
+    QAndroidJniExceptionCleaner cleaner;
+    auto parcelFD = handle.callObjectMethod("readFileDescriptor", "()Landroid/os/ParcelFileDescriptor;");
+    if (parcelFD.isValid())
+        return parcelFD.callMethod<jint>("getFd", "()I");
+    return -1;
+}
+
+QAndroidBinder QAndroidParcelPrivate::readBinder() const
+{
+    QAndroidJniExceptionCleaner cleaner;
+    auto strongBinder = handle.callObjectMethod("readStrongBinder", "()Landroid/os/IBinder;");
+    return QAndroidBinder(strongBinder.object());
+}
+
+/*!
+    \class QAndroidParcel
+    \inmodule QtAndroidExtras
+
+    The QAndroidParcel is a convenience class that wraps the most important
+    \l {https://developer.android.com/reference/android/os/Parcel.html} {Android Parcel} methods.
+
+    \since 5.10
+*/
+
+/*!
+    Creates a new object.
+ */
+QAndroidParcel::QAndroidParcel()
+    : d(new QAndroidParcelPrivate())
+{
+}
+
+/*!
+    Wraps the \a parcel object.
+ */
+QAndroidParcel::QAndroidParcel(const QAndroidJniObject& parcel)
+    : d(new QAndroidParcelPrivate(parcel))
+{
+
+}
+
+QAndroidParcel::~QAndroidParcel()
+{
+}
+
+/*!
+    Writes the provided \a data as a byte array
+ */
+void QAndroidParcel::writeData(const QByteArray &data) const
+{
+    d->writeData(data);
+}
+
+/*!
+    Writes the provided \a value. The value is converted into a
+    QByteArray before is written.
+ */
+void QAndroidParcel::writeVariant(const QVariant &value) const
+{
+    QByteArray buff;
+    QDataStream stream(&buff, QIODevice::WriteOnly);
+    stream << value;
+    d->writeData(buff);
+}
+
+/*!
+    Writes a \a binder object. This is useful for a client to
+    send to a server a binder which can be used by the server callback the client.
+ */
+void QAndroidParcel::writeBinder(const QAndroidBinder &binder) const
+{
+    d->writeBinder(binder);
+}
+
+/*!
+    Writes the provided \a fd.
+ */
+void QAndroidParcel::writeFileDescriptor(int fd) const
+{
+    d->writeFileDescriptor(fd);
+}
+
+/*!
+    Returns the data as a QByteArray
+ */
+QByteArray QAndroidParcel::readData() const
+{
+    return d->readData();
+}
+
+/*!
+    Returns the data as a QVariant
+ */
+QVariant QAndroidParcel::readVariant() const
+{
+    QDataStream stream(d->readData());
+    QVariant res;
+    stream >> res;
+    return res;
+}
+
+/*!
+    Returns the binder as a QAndroidBinder
+ */
+QAndroidBinder QAndroidParcel::readBinder() const
+{
+    return d->readBinder();
+}
+
+/*!
+    Returns the file descriptor
+ */
+int QAndroidParcel::readFileDescriptor() const
+{
+    return d->readFileDescriptor();
+}
+
+/*!
+    The return value is useful to call other Java API which are not covered by this wrapper
+ */
+QAndroidJniObject QAndroidParcel::handle() const
+{
+    return d->handle;
+}
+
+QT_END_NAMESPACE