寫在前面

在本系列的上一篇中，我將從《Qt之美1：數據指針和私有實現》中的例子抄過來，說明了Qt中源碼中(同時也是QtLcation模塊中)大量存在的D-P機制。這種設計模式實現了動態庫的二進制兼容，同時也隱藏了私有成員和潛在的實現細節；除此之外，還能基于它實現另一種Qt中大量采用的技術，即“隱式共享技術”。

以下關于“隱式共享技術”的說明內容，大多出自《Qt中的C++技術》這本書的第8章《隱式共享與d-pointer技術》。

一般地，一個類型的多個實例所占內存是相互獨立的，如果其中某些數據成員的取值完全相同，那么這些實例可共享這些數據成員，當某實例需要修改其中的數據成員時才為該對象重新分配內存；這種技術被稱為“隱式共享技術”，又被形象地描述為“寫時復制(copy on write)”。如下圖所示，假如對象O1、O2、O3和O4都有部分數據成員取值相同，都共享這部分數據成員所占用的內存A；此后需要修改O4位于共享內存A中的某個數據成員，此時不能直接修改內存A，否則會影響O1、O2和O3的數據成員；只好先復制將內存A復制成B，然后重新分配給O4，在B中修改O4需要修改的數據成員。

由于共享內存A的存在，假如要析構O3時，O1和O2還未析構，則不能簡單地釋放共享內存A，因為這樣做會使O1和O2受到牽連。只有當僅存在一個對象引用共享內存時，析構這個僅存的實例才完全釋放共享內存，其他時候僅需要“斷開”析構實例與共享內存的引用關系即可。這就需要維護一個共享內存的引用計數器(reference counter)，每當析構了一個引用該塊共享內存的對象時，就減少一個引用計數，直到引用計數為1(即僅存一個引用該內存塊的對象)時，下一次再進行減少引用計數的操作(即析構引用該內存的對象)才會完全釋放這塊內存。

剛才我們講了同一類型不同實例之間實現隱式共享的基本原理，但這并不適用于所有應用場景。其實，Qt已經在“隱式共享技術”上為我們做了很多基礎性和示范性工作，其提供了一個名為QSharedData的共享數據類型，還提供了QSharedDataPointer等共享數據類的指針，利用QSharedData和QSharedDataPointer等類型就可以實現隱式共享的進階操作，比如同一基類不同子類之間的隱式共享。

了解QGeoShape為基類的地理數據類型

這里以QtPositioning中QGeoShape類型體系的源碼作為示例，QGeoShape是所有地理形狀類型的基類，其繼承者們包括：QGeoRectangle、QGeoCircle、QGeoPath和QGeoPolygon。QGeoShape類似于 Simple Feature標準 中的Geometry類型，但QGeoShape坐標點都是QGeoCoordinate類型，只能表示經緯高坐標。

QGeoShape的源碼如下：

class QGeoRectangle;

class QGeoShapePrivate;

class Q_POSITIONING_EXPORT QGeoShape

{

Q_GADGET

Q_PROPERTY(ShapeType type READ type)

Q_PROPERTY(bool isValid READ isValid)

Q_PROPERTY(bool isEmpty READ isEmpty)

Q_ENUMS(ShapeType)

public:

QGeoShape();

QGeoShape(const QGeoShape &other);

~QGeoShape();

enum ShapeType {

UnknownType,

RectangleType,

CircleType,

PathType,

PolygonType

};

ShapeType type() const;

bool isValid() const;

bool isEmpty() const;

Q_INVOKABLE bool contains(const QGeoCoordinate &coordinate) const;

Q_INVOKABLE QGeoRectangle boundingGeoRectangle() const;

Q_INVOKABLE QGeoCoordinate center() const;

Q_INVOKABLE void extendShape(const QGeoCoordinate &coordinate);

bool operator==(const QGeoShape &other) const;

bool operator!=(const QGeoShape &other) const;

QGeoShape &operator=(const QGeoShape &other);

Q_INVOKABLE QString toString() const;

protected:

QGeoShape(QGeoShapePrivate *d);

QSharedDataPointer d_ptr;

private:

inline QGeoShapePrivate *d_func();

inline const QGeoShapePrivate *d_func() const;

};

其給出了私有共享數據類型QGeoShapePrivate的前向聲明：

class QGeoShapePrivate : public QSharedData

{

public:

explicit QGeoShapePrivate(QGeoShape::ShapeType type);

virtual ~QGeoShapePrivate();

virtual bool isValid() const = 0;

virtual bool isEmpty() const = 0;

virtual bool contains(const QGeoCoordinate &coordinate) const = 0;

virtual QGeoCoordinate center() const = 0;

virtual QGeoRectangle boundingGeoRectangle() const = 0;

virtual void extendShape(const QGeoCoordinate &coordinate) = 0;

virtual QGeoShapePrivate *clone() const = 0;

virtual bool operator==(const QGeoShapePrivate &other) const;

QGeoShape::ShapeType type;

};

本來QGeoShapePrivate應該是QGeoShape的具體實現，但是由于QGeoShape被定義為抽象基類，QGeoShapePrivate中的接口都被定義為純虛函數，實際上QGeoShape接口都是在其子類對應的私有數據類型中具體實現的，比如QGeoRectanglePrivate(繼承自QGeoShapePrivate)：

class QGeoRectanglePrivate : public QGeoShapePrivate

{

public:

QGeoRectanglePrivate();

QGeoRectanglePrivate(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight);

QGeoRectanglePrivate(const QGeoRectanglePrivate &other);

~QGeoRectanglePrivate();

bool isValid() const override;

bool isEmpty() const override;

bool contains(const QGeoCoordinate &coordinate) const override;

QGeoCoordinate center() const override;

QGeoRectangle boundingGeoRectangle() const override;

void extendShape(const QGeoCoordinate &coordinate) override;

QGeoShapePrivate *clone() const override;

bool operator==(const QGeoShapePrivate &other) const override;

QGeoCoordinate topLeft;

QGeoCoordinate bottomRight;

};

QGeoShape及其子類是地圖要素的幾何數據的主要表達形式。前端的MapPolyline、MapRectangle、MapCircle和MapPolygon等地圖元素(MapItem)，其宿主對象是由后端Qt提供的QDeclarativePolylineMapItem、QDeclarativeRectangleMapItem、QDeclarativeCircleMapItem和QDeclarativePolygonMapItem等類型，它們的地理幾何數據(geoShape方法)就分別由QGeoPath、QGeoRectangle、QGeoCircle和QGeoPolygon的實例表示。

下面以QDeclarativeRectangleMapItem源碼為例：

class Q_LOCATION_PRIVATE_EXPORT QDeclarativeRectangleMapItem: public QDeclarativeGeoMapItemBase

{

Q_OBJECT

Q_PROPERTY(QGeoCoordinate topLeft READ topLeft WRITE setTopLeft NOTIFY topLeftChanged)

Q_PROPERTY(QGeoCoordinate bottomRight READ bottomRight WRITE setBottomRight NOTIFY bottomRightChanged)

Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged)

Q_PROPERTY(QDeclarativeMapLineProperties *border READ border CONSTANT)

public:

explicit QDeclarativeRectangleMapItem(QQuickItem *parent = 0);

~QDeclarativeRectangleMapItem();

virtual void setMap(QDeclarativeGeoMap *quickMap, QGeoMap *map) override;

//from QuickItem

virtual QSGNode *updateMapItemPaintNode(QSGNode *, UpdatePaintNodeData *) override;

QGeoCoordinate topLeft();

void setTopLeft(const QGeoCoordinate &center);

QGeoCoordinate bottomRight();

void setBottomRight(const QGeoCoordinate &center);

QColor color() const;

void setColor(const QColor &color);

QDeclarativeMapLineProperties *border();

bool contains(const QPointF &point) const override;

const QGeoShape &geoShape() const override;

QGeoMap::ItemType itemType() const override;

Q_SIGNALS:

void topLeftChanged(const QGeoCoordinate &topLeft);

void bottomRightChanged(const QGeoCoordinate &bottomRight);

void colorChanged(const QColor &color);

protected:

void updatePath();

void geometryChanged(const QRectF &newGeometry, const QRectF &oldGeometry) override;

void updatePolish() override;

protected Q_SLOTS:

void markSourceDirtyAndUpdate();

virtual void afterViewportChanged(const QGeoMapViewportChangeEvent &event) override;

private:

QGeoRectangle rectangle_;

QDeclarativeMapLineProperties border_;

QColor color_;

bool dirtyMaterial_;

QGeoMapPolygonGeometry geometry_;

QGeoMapPolylineGeometry borderGeometry_;

bool updatingGeometry_;

QList pathMercator_;

};

總結

以上是生活随笔為你收集整理的qt 二维地图库_Qt轻量级地图解决方案：基于QtLocation的二次开发（四）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。