QAndroidServiceConnection Class

Wraps the most important methods of Android ServiceConnection class. More...

Header: #include <QtCore/private/qandroidextras_p.h>
qmake: QT += core-private
Since: Qt 6.2
Status: Preliminary

This class is under development and is subject to change.

Public Functions

QAndroidServiceConnection()
QAndroidServiceConnection(const QJniObject &serviceConnection)
QJniObject handle() const
virtual void onServiceConnected(const QString &name, const QAndroidBinder &serviceBinder) = 0
virtual void onServiceDisconnected(const QString &name) = 0

Detailed Description

The QAndroidServiceConnection is a convenience abstract class which wraps the AndroidServiceConnection interface.

It is useful when you perform a QtAndroidPrivate::bindService operation.

When building with CMake, use the following commands to use private Qt Core APIs:

 find_package(Qt6 REQUIRED COMPONENTS Core)
 target_link_libraries(mytarget PRIVATE Qt6::CorePrivate)

Member Function Documentation

QAndroidServiceConnection::QAndroidServiceConnection()

Creates a new object

[explicit] QAndroidServiceConnection::QAndroidServiceConnection(const QJniObject &serviceConnection)

Creates a new object from an existing serviceConnection.

It's useful when you have your own Java implementation. Of course onServiceConnected()/onServiceDisconnected() will not be called anymore.

QJniObject QAndroidServiceConnection::handle() const

returns the underline QJniObject

[pure virtual] void QAndroidServiceConnection::onServiceConnected(const QString &name, const QAndroidBinder &serviceBinder)

This notification is called when the client managed to connect to the service. The name contains the server name, the serviceBinder is the binder that the client uses to perform IPC operations.

Warning: This method is called from Binder's thread which is different from the thread that this object was created.

returns the underline QJniObject

[pure virtual] void QAndroidServiceConnection::onServiceDisconnected(const QString &name)

Called when a connection to the Service has been lost. The name parameter specifies which connectioen was lost.

Warning: This method is called from Binder's thread which is different from the thread that this object was created.

returns the underline QJniObject