qgsjsonutils.h

Go to the documentation of this file.

/***************************************************************************
    qgsjsonutils.h
     -------------
    Date                 : May 206
    Copyright            : (C) 2016 Nyall Dawson
    Email                : nyall dot dawson at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef QGSJSONUTILS_H
#define QGSJSONUTILS_H

#include "qgis_core.h"
#include "qgsfeature.h"
#include "qgscoordinatereferencesystem.h"
#include "qgscoordinatetransform.h"
#include "qgsfields.h"

#ifndef SIP_RUN
#include <nlohmann/json_fwd.hpp>
using json = nlohmann::json;
#endif

#include <QPointer>
#include <QJsonObject>

class QTextCodec;

class CORE_EXPORT QgsJsonExporter
{
  public:

    QgsJsonExporter( QgsVectorLayer *vectorLayer = nullptr, int precision = 6 );

    void setPrecision( int precision ) { mPrecision = precision; }

    int precision() const { return mPrecision; }

    void setIncludeGeometry( bool includeGeometry ) { mIncludeGeometry = includeGeometry; }

    bool includeGeometry() const { return mIncludeGeometry; }

    void setIncludeAttributes( bool includeAttributes ) { mIncludeAttributes = includeAttributes; }

    bool includeAttributes() const { return mIncludeAttributes; }

    void setIncludeRelated( bool includeRelated ) { mIncludeRelatedAttributes = includeRelated; }

    bool includeRelated() const { return mIncludeRelatedAttributes; }

    void setAttributeDisplayName( bool displayName ) { mAttributeDisplayName = displayName; }

    bool attributeDisplayName() const { return mAttributeDisplayName; }

    void setVectorLayer( QgsVectorLayer *vectorLayer );

    QgsVectorLayer *vectorLayer() const;

    void setSourceCrs( const QgsCoordinateReferenceSystem &crs );

    QgsCoordinateReferenceSystem sourceCrs() const;

    void setAttributes( const QgsAttributeList &attributes ) { mAttributeIndexes = attributes; }

    QgsAttributeList attributes() const { return mAttributeIndexes; }

    void setExcludedAttributes( const QgsAttributeList &attributes ) { mExcludedAttributeIndexes = attributes; }

    QgsAttributeList excludedAttributes() const { return mExcludedAttributeIndexes; }

    QString exportFeature( const QgsFeature &feature,
                           const QVariantMap &extraProperties = QVariantMap(),
                           const QVariant &id = QVariant(),
                           int indent = -1 ) const;

    json exportFeatureToJsonObject( const QgsFeature &feature,
                                    const QVariantMap &extraProperties = QVariantMap(),
                                    const QVariant &id = QVariant() ) const SIP_SKIP;


    QString exportFeatures( const QgsFeatureList &features, int indent = -1 ) const;

  private:

    int mPrecision;

    QgsAttributeList mAttributeIndexes;

    QgsAttributeList mExcludedAttributeIndexes;

    bool mIncludeGeometry = true;

    bool mIncludeAttributes = true;

    bool mIncludeRelatedAttributes = false;

    QPointer< QgsVectorLayer > mLayer;

    QgsCoordinateReferenceSystem mCrs;

    QgsCoordinateTransform mTransform;

    bool mAttributeDisplayName = false;
};

class CORE_EXPORT QgsJsonUtils
{
  public:

    static QgsFeatureList stringToFeatureList( const QString &string, const QgsFields &fields, QTextCodec *encoding );

    static QgsFields stringToFields( const QString &string, QTextCodec *encoding );

    static QString encodeValue( const QVariant &value );

    static QString exportAttributes( const QgsFeature &feature, QgsVectorLayer *layer = nullptr,
                                     const QVector<QVariant> &attributeWidgetCaches = QVector<QVariant>() );

    static json exportAttributesToJsonObject( const QgsFeature &feature, QgsVectorLayer *layer = nullptr,
        const QVector<QVariant> &attributeWidgetCaches = QVector<QVariant>() ) SIP_SKIP;

    static QVariantList parseArray( const QString &json, QVariant::Type type = QVariant::Invalid );


    static json jsonFromVariant( const QVariant &v ) SIP_SKIP;

    static QVariant parseJson( const std::string &jsonString ) SIP_SKIP;

    static QVariant parseJson( const QString &jsonString ) SIP_SKIP;

};

#endif // QGSJSONUTILS_H