1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
/****************************************************************************
**
** 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 "qandroidbinder.h"
#include "qandroidbinder_p.h"
#include "qandroidparcel.h"
#include "qandroidparcel_p.h"
#include <jni/qandroidjnienvironment.h>
QT_BEGIN_NAMESPACE
QAndroidBinderPrivate::QAndroidBinderPrivate(QAndroidBinder *binder)
: handle("org/qtproject/qt5/android/extras/QtAndroidBinder", "(J)V", jlong(binder))
, m_isQtAndroidBinder(true)
{
QAndroidJniExceptionCleaner cleaner;
}
QAndroidBinderPrivate::QAndroidBinderPrivate(const QAndroidJniObject &binder)
: handle(binder)
, m_isQtAndroidBinder(false)
{
}
QAndroidBinderPrivate::~QAndroidBinderPrivate()
{
if (m_isQtAndroidBinder) {
QAndroidJniExceptionCleaner cleaner;
handle.callMethod<void>("setId", "(J)V", jlong(0));
if (m_deleteListener)
m_deleteListener();
}
}
/*!
\class QAndroidBinder
\inmodule QtAndroidExtras
\brief Wraps the most important methods of Android Binder class.
The QAndroidBinder is a convenience class that wraps the most important
\l {https://developer.android.com/reference/android/os/Binder.html}{Android Binder}
methods.
\since 5.10
*/
/*!
\enum QAndroidBinder::CallType
This enum is used with \l QAndroidBinder::transact() to describe the mode in which the
IPC call is performed.
\value Normal normal IPC, meaning that the caller waits the result from the callee
\value OneWay one-way IPC, meaning that the caller returns immediately, without waiting for a result from the callee
*/
/*!
Creates a new object which can be used to perform IPC.
\sa onTransact, transact
*/
QAndroidBinder::QAndroidBinder()
: d(new QAndroidBinderPrivate(this))
{
}
/*!
Creates a new object from the \a binder Java object.
\sa transact
*/
QAndroidBinder::QAndroidBinder(const QAndroidJniObject &binder)
: d(new QAndroidBinderPrivate(binder))
{
}
QAndroidBinder::~QAndroidBinder()
{
}
/*!
Default implementation is a stub that returns false.
The user should override this method to get the transact data from the caller.
The \a code is the action to perform.
The \a data is the marshaled data sent by the caller.\br
The \a reply is the marshaled data to be sent to the caller.\br
The \a flags are the additional operation flags.\br
\warning This method is called from Binder's thread which is different
from the thread that this object was created.
\sa transact
*/
bool QAndroidBinder::onTransact(int /*code*/, const QAndroidParcel &/*data*/, const QAndroidParcel &/*reply*/, CallType /*flags*/)
{
return false;
}
/*!
Performs an IPC call
The \a code is the action to perform. Should be between
\l {https://developer.android.com/reference/android/os/IBinder.html#FIRST_CALL_TRANSACTION}
{FIRST_CALL_TRANSACTION} and
\l {https://developer.android.com/reference/android/os/IBinder.html#LAST_CALL_TRANSACTION}
{LAST_CALL_TRANSACTION}.\br
The \a data is the marshaled data to send to the target.\br
The \a reply (if specified) is the marshaled data to be received from the target.
May be \b nullptr if you are not interested in the return value.\br
The \a flags are the additional operation flags.\br
\return true on success
*/
bool QAndroidBinder::transact(int code, const QAndroidParcel &data, QAndroidParcel *reply, CallType flags) const
{
QAndroidJniExceptionCleaner cleaner;
return d->handle.callMethod<jboolean>("transact", "(ILandroid/os/Parcel;Landroid/os/Parcel;I)Z",
jint(code), data.d->handle.object(), reply ? reply->d->handle.object() : nullptr, jint(flags));
}
/*!
The return value is useful to call other Java API which are not covered by this wrapper
*/
QAndroidJniObject QAndroidBinder::handle() const
{
return d->handle;
}
QT_END_NAMESPACE
|
