From ffd680a132db99f1fa1e9ebb75c844c491afa83b Mon Sep 17 00:00:00 2001 From: BogDan Vatra Date: Mon, 20 Aug 2018 11:09:39 +0300 Subject: Safer and easier navigation APIs for plugins Each QDeclarativeNavigator will create and manage its own QAbstractNavigator using the QNavigationManagerEngine, this way the QNavigationManagerEngine doesn't have to manage the sessions itself based on a const reference. Change-Id: Ibe006524969b4f8100e71ea188d951072b846c6c Reviewed-by: Paolo Angelelli --- src/location/maps/qnavigationmanager.cpp | 39 +++----------- src/location/maps/qnavigationmanager_p.h | 26 +++------- src/location/maps/qnavigationmanagerengine.cpp | 72 ++++++++++++++++++-------- src/location/maps/qnavigationmanagerengine_p.h | 48 +++++++++++++---- 4 files changed, 100 insertions(+), 85 deletions(-) (limited to 'src/location/maps') diff --git a/src/location/maps/qnavigationmanager.cpp b/src/location/maps/qnavigationmanager.cpp index 5372e3a5..5cae6a04 100644 --- a/src/location/maps/qnavigationmanager.cpp +++ b/src/location/maps/qnavigationmanager.cpp @@ -46,8 +46,6 @@ public: ~QNavigationManagerPrivate(); QNavigationManagerEngine *engine = nullptr; - QDeclarativeNavigatorPrivate *navigator = nullptr; - QList parameters; private: Q_DISABLE_COPY(QNavigationManagerPrivate) @@ -89,16 +87,6 @@ bool QNavigationManager::isInitialized() const return d_ptr->engine->isInitialized(); } -void QNavigationManager::setNavigator(QDeclarativeNavigatorPrivate *navigator) -{ - d_ptr->navigator = navigator; -} - -QDeclarativeNavigatorPrivate *QNavigationManager::declarativeNavigator() const -{ - return d_ptr->navigator; -} - void QNavigationManager::setLocale(const QLocale &locale) { d_ptr->engine->setLocale(locale); @@ -109,34 +97,19 @@ QLocale QNavigationManager::locale() const return d_ptr->engine->locale(); } -void QNavigationManager::setParameters(const QList ¶meters) -{ - d_ptr->parameters = parameters; -} - -QList QNavigationManager::parameters() const -{ - return d_ptr->parameters; -} - -bool QNavigationManager::ready() const -{ - return d_ptr->engine->ready(*d_ptr->navigator, d_ptr->parameters); -} - -bool QNavigationManager::start() +void QNavigationManager::setMeasurementSystem(QLocale::MeasurementSystem system) { - return d_ptr->engine->start(*d_ptr->navigator, d_ptr->parameters); + d_ptr->engine->setMeasurementSystem(system); } -bool QNavigationManager::stop() +QLocale::MeasurementSystem QNavigationManager::measurementSystem() const { - return d_ptr->engine->stop(*d_ptr->navigator); + return d_ptr->engine->measurementSystem(); } -bool QNavigationManager::active() const +QAbstractNavigator *QNavigationManager::createNavigator(const QSharedPointer &navigator) { - return d_ptr->engine->active(*d_ptr->navigator); + return d_ptr->engine->createNavigator(navigator); } QNavigationManager::QNavigationManager(QNavigationManagerEngine *engine, QObject *parent) : QObject(parent), diff --git a/src/location/maps/qnavigationmanager_p.h b/src/location/maps/qnavigationmanager_p.h index 1d8c1722..544e15f5 100644 --- a/src/location/maps/qnavigationmanager_p.h +++ b/src/location/maps/qnavigationmanager_p.h @@ -51,6 +51,7 @@ #include #include #include +#include #include #include @@ -58,11 +59,11 @@ QT_BEGIN_NAMESPACE class QNavigationManagerEngine; class QNavigationManagerPrivate; -class QDeclarativeNavigatorPrivate; +class QDeclarativeNavigatorParams; class QDeclarativeGeoWaypoint; class QGeoRoute; class QGeoRouteSegment; - +class QAbstractNavigator; class Q_LOCATION_PRIVATE_EXPORT QNavigationManager : public QObject { Q_OBJECT @@ -75,32 +76,19 @@ public: QNavigationManagerEngine *engine(); bool isInitialized() const; - void setNavigator(QDeclarativeNavigatorPrivate *navigator); - QDeclarativeNavigatorPrivate *declarativeNavigator() const; - void setLocale(const QLocale &locale); QLocale locale() const; + void setMeasurementSystem(QLocale::MeasurementSystem system); + QLocale::MeasurementSystem measurementSystem() const; - void setParameters(const QList ¶meters); - QList parameters() const; - - bool ready() const; - bool start(); - bool stop(); - bool active() const; + QAbstractNavigator *createNavigator(const QSharedPointer &navigator); Q_SIGNALS: void initialized(); - // These must be emitted by the engine - void activeChanged(bool active); - void waypointReached(const QDeclarativeGeoWaypoint *pos); - void destinationReached(); - void currentRouteChanged(const QGeoRoute &route); - void currentSegmentChanged(int segment); protected: - QNavigationManager(QNavigationManagerEngine *engine, QObject *parent = 0); + QNavigationManager(QNavigationManagerEngine *engine, QObject *parent = nullptr); private: QNavigationManagerPrivate *d_ptr; diff --git a/src/location/maps/qnavigationmanagerengine.cpp b/src/location/maps/qnavigationmanagerengine.cpp index b9191e74..1f82b4a1 100644 --- a/src/location/maps/qnavigationmanagerengine.cpp +++ b/src/location/maps/qnavigationmanagerengine.cpp @@ -49,9 +49,47 @@ public: bool initialized = false; }; +class QAbstractNavigatorPrivate +{ +public: + QLocale locale; + QLocale::MeasurementSystem measurementSystem; + bool initialized = false; +}; + +QAbstractNavigator::QAbstractNavigator(QObject *parent) + : QObject(parent) + , d(new QAbstractNavigatorPrivate) +{ +} + +QAbstractNavigator::~QAbstractNavigator() +{ +} + +void QAbstractNavigator::setLocale(const QLocale &locale) +{ + d->locale = locale; +} + +QLocale QAbstractNavigator::locale() const +{ + return d->locale; +} + +void QAbstractNavigator::setMeasurementSystem(QLocale::MeasurementSystem system) +{ + d->measurementSystem = system; +} + +QLocale::MeasurementSystem QAbstractNavigator::measurementSystem() const +{ + return d->measurementSystem; +} + QNavigationManagerEngine::QNavigationManagerEngine(const QVariantMap ¶meters, QObject *parent) : QObject(parent) - , d_ptr(new QNavigationManagerEnginePrivate) + , d(new QNavigationManagerEnginePrivate) { Q_UNUSED(parameters) } @@ -62,64 +100,52 @@ QNavigationManagerEngine::~QNavigationManagerEngine() void QNavigationManagerEngine::setManagerName(const QString &name) { - d_ptr->managerName = name; + d->managerName = name; } QString QNavigationManagerEngine::managerName() const { - return d_ptr->managerName; + return d->managerName; } void QNavigationManagerEngine::setManagerVersion(int version) { - d_ptr->managerVersion = version; + d->managerVersion = version; } int QNavigationManagerEngine::managerVersion() const { - return d_ptr->managerVersion; + return d->managerVersion; } void QNavigationManagerEngine::setLocale(const QLocale &locale) { - d_ptr->locale = locale; + d->locale = locale; } QLocale QNavigationManagerEngine::locale() const { - return d_ptr->locale; + return d->locale; } void QNavigationManagerEngine::setMeasurementSystem(QLocale::MeasurementSystem system) { - d_ptr->measurementSystem = system; + d->measurementSystem = system; } QLocale::MeasurementSystem QNavigationManagerEngine::measurementSystem() const { - return d_ptr->measurementSystem; + return d->measurementSystem; } bool QNavigationManagerEngine::isInitialized() const { - return d_ptr->initialized; -} - -// Subclasses are supposed to emit activeChanged from here. -bool QNavigationManagerEngine::start(QDeclarativeNavigatorPrivate & /*navigator*/, const QList & /*navigationParams*/) -{ - - return false; -} - -bool QNavigationManagerEngine::stop(QDeclarativeNavigatorPrivate & /*navigator*/) // navigator needed to find the right navi session to stop. -{ - return false; + return d->initialized; } void QNavigationManagerEngine::engineInitialized() { - d_ptr->initialized = true; + d->initialized = true; emit initialized(); } diff --git a/src/location/maps/qnavigationmanagerengine_p.h b/src/location/maps/qnavigationmanagerengine_p.h index 803050c5..62d9eb87 100644 --- a/src/location/maps/qnavigationmanagerengine_p.h +++ b/src/location/maps/qnavigationmanagerengine_p.h @@ -55,39 +55,67 @@ QT_BEGIN_NAMESPACE +class QAbstractNavigatorPrivate; class QGeoMap; class QGeoMapParameter; class QMapRouteObject; +class QGeoRoute; +class QNavigationManager; class QNavigationManagerEnginePrivate; -class QDeclarativeNavigatorPrivate; +class QDeclarativeNavigatorParams; +class QDeclarativeGeoWaypoint; + +class Q_LOCATION_PRIVATE_EXPORT QAbstractNavigator: public QObject +{ + Q_OBJECT +public: + QAbstractNavigator(QObject *parent = nullptr); + ~QAbstractNavigator() override; + virtual void setLocale(const QLocale &locale); + virtual QLocale locale() const; + virtual void setMeasurementSystem(QLocale::MeasurementSystem system); + virtual QLocale::MeasurementSystem measurementSystem() const; + virtual bool active() const = 0; + virtual bool ready() const = 0; + +public slots: + virtual bool start() = 0; + virtual bool stop() = 0; + +signals: + // These must be emitted by the engine + void activeChanged(bool active); + void waypointReached(const QDeclarativeGeoWaypoint *pos); + void destinationReached(); + void currentRouteChanged(const QGeoRoute &route); + void currentSegmentChanged(int segment); + +private: + QScopedPointer d; +}; class Q_LOCATION_PRIVATE_EXPORT QNavigationManagerEngine : public QObject { Q_OBJECT public: explicit QNavigationManagerEngine(const QVariantMap ¶meters, QObject *parent = nullptr); - virtual ~QNavigationManagerEngine(); + ~QNavigationManagerEngine() override; void setManagerName(const QString &name); QString managerName() const; void setManagerVersion(int version); int managerVersion() const; - virtual void setLocale(const QLocale &locale); virtual QLocale locale() const; virtual void setMeasurementSystem(QLocale::MeasurementSystem system); virtual QLocale::MeasurementSystem measurementSystem() const; + virtual bool isInitialized() const; - virtual bool ready(const QDeclarativeNavigatorPrivate &navigator, const QList &navigationParams) = 0; - virtual bool active(const QDeclarativeNavigatorPrivate &navigator) = 0; + virtual QAbstractNavigator *createNavigator(const QSharedPointer &navigator) = 0; signals: void initialized(); -public slots: - virtual bool start(QDeclarativeNavigatorPrivate &navigator, const QList &navigationParams); - virtual bool stop(QDeclarativeNavigatorPrivate &navigator); - protected: /*! Marks the engine as initialized. Subclasses of QGeoMappingManagerEngine are to @@ -96,7 +124,7 @@ protected: */ virtual void engineInitialized(); - QScopedPointer d_ptr; + QScopedPointer d; }; QT_END_NAMESPACE -- cgit v1.2.1