GeoDataExtendedData.h

// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2010 Harshit Jain <hjain.itbhu@gmail.com>
// SPDX-FileCopyrightText: 2011 Niko Sams <niko.sams@gmail.com>
//
 
#ifndef MARBLE_GEODATAEXTENDEDDATA_H
#define MARBLE_GEODATAEXTENDEDDATA_H
 
#include "GeoDocument.h"
#include "Serializable.h"
 
#include "geodata_export.h"
#include <QHash>
 
namespace Marble
{
 
class GeoDataSimpleArrayData;
class GeoDataSchemaData;
class GeoDataData;
 
class GeoDataExtendedDataPrivate;
 
/**
 * @short a class which allows to add custom data to KML Feature.
 *
 * @see GeoDataData
 */
class GEODATA_EXPORT GeoDataExtendedData : public GeoNode, public Serializable
{
public:
    GeoDataExtendedData();
    GeoDataExtendedData(const GeoDataExtendedData &other);
    ~GeoDataExtendedData() override;
 
    /// Provides type information for downcasting a GeoNode
    const char *nodeType() const override;
 
    /**
     * @brief assignment operator
     */
    GeoDataExtendedData &operator=(const GeoDataExtendedData &other);
 
    bool operator==(const GeoDataExtendedData &other) const;
    bool operator!=(const GeoDataExtendedData &other) const;
 
    /**
     * @brief return the value of GeoDataExtendedData associated with the given @p key
     */
    GeoDataData value(const QString &key) const;
 
    /**
     * @brief add a data object to the GeoDataExtendedData with the @p key
     */
    void addValue(const GeoDataData &data);
 
    /**
     * @since 0.26.0
     */
    void removeKey(const QString &key);
 
    /**
     * @brief return const Begin iterator for QHash
     */
    QHash<QString, GeoDataData>::const_iterator constBegin() const;
 
    /**
     * @brief return const End iterator for QHash
     */
 
    QHash<QString, GeoDataData>::const_iterator constEnd() const;
 
    /**
     * @brief return size of QHash
     */
 
    int size() const;
 
    /**
     * @brief return whether QHash is empty or not
     */
    bool isEmpty() const;
 
    /**
     * @brief Returns true if there exists a value for the given key
     */
    bool contains(const QString &key) const;
 
    /**
     * @brief return value of GeoDataExtendedData object associated with the given @p key as a modifiable reference
     */
    GeoDataData &valueRef(const QString &key) const;
 
    /**
     * @brief set SimpleArrayData for given @p key
     *
     * ExtendedData takes ownership of SimpleArrayData
     */
    void setSimpleArrayData(const QString &key, GeoDataSimpleArrayData *values);
 
    /**
     * @brief return SimpleArrayData for given @p key, 0 pointer if none is set
     */
    GeoDataSimpleArrayData *simpleArrayData(const QString &key) const;
 
    /**
     * @brief Adds a SchemaData @p schemaData element to schemaDataHash
     */
    GeoDataSchemaData &schemaData(const QString &schemaUrl) const;
 
    /**
     * @brief Adds a SchemaData @p schemaData element to schemaDataHash
     */
    void addSchemaData(const GeoDataSchemaData &schemaData);
 
    /**
     * @brief Removes a SchemaData element with schema url @p schemaUrl from schemaDataHash
     */
    void removeSchemaData(const QString &schemaUrl);
 
    /**
     * @brief Dump a vector containing all SchemaData element
     */
    QList<GeoDataSchemaData> schemaDataList() const;
 
    /**
     * @brief Serialize the ExtendedData to a stream
     * @param  stream  the stream
     */
    void pack(QDataStream &stream) const override;
 
    /**
     * @brief  Unserialize the ExtendedData from a stream
     * @param  stream  the stream
     */
    void unpack(QDataStream &stream) override;
 
private:
    GeoDataExtendedDataPrivate *const d;
};
 
}
 
#endif