QGIS API Documentation  3.8.0-Zanzibar (11aff65)
qgsjsonutils.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsjsonutils.h
3  -------------
4  Date : May 206
5  Copyright : (C) 2016 Nyall Dawson
6  Email : nyall dot dawson at gmail dot com
7  ***************************************************************************
8  * *
9  * This program is free software; you can redistribute it and/or modify *
10  * it under the terms of the GNU General Public License as published by *
11  * the Free Software Foundation; either version 2 of the License, or *
12  * (at your option) any later version. *
13  * *
14  ***************************************************************************/
15 
16 #ifndef QGSJSONUTILS_H
17 #define QGSJSONUTILS_H
18 
19 #include "qgis_core.h"
20 #include "qgsfeature.h"
22 #include "qgscoordinatetransform.h"
23 #include "qgsfields.h"
24 
25 #ifndef SIP_RUN
26 #include <nlohmann/json_fwd.hpp>
28 #endif
29 
30 #include <QPointer>
31 #include <QJsonObject>
32 
33 class QTextCodec;
34 
45 class CORE_EXPORT QgsJsonExporter
46 {
47  public:
48 
55  QgsJsonExporter( QgsVectorLayer *vectorLayer = nullptr, int precision = 6 );
56 
63  void setPrecision( int precision ) { mPrecision = precision; }
64 
69  int precision() const { return mPrecision; }
70 
76  void setIncludeGeometry( bool includeGeometry ) { mIncludeGeometry = includeGeometry; }
77 
82  bool includeGeometry() const { return mIncludeGeometry; }
83 
89  void setIncludeAttributes( bool includeAttributes ) { mIncludeAttributes = includeAttributes; }
90 
95  bool includeAttributes() const { return mIncludeAttributes; }
96 
104  void setIncludeRelated( bool includeRelated ) { mIncludeRelatedAttributes = includeRelated; }
105 
110  bool includeRelated() const { return mIncludeRelatedAttributes; }
111 
117  void setAttributeDisplayName( bool displayName ) { mAttributeDisplayName = displayName; }
118 
124  bool attributeDisplayName() const { return mAttributeDisplayName; }
125 
132  void setVectorLayer( QgsVectorLayer *vectorLayer );
133 
138  QgsVectorLayer *vectorLayer() const;
139 
147  void setSourceCrs( const QgsCoordinateReferenceSystem &crs );
148 
154  QgsCoordinateReferenceSystem sourceCrs() const;
155 
165  void setAttributes( const QgsAttributeList &attributes ) { mAttributeIndexes = attributes; }
166 
175  QgsAttributeList attributes() const { return mAttributeIndexes; }
176 
184  void setExcludedAttributes( const QgsAttributeList &attributes ) { mExcludedAttributeIndexes = attributes; }
185 
192  QgsAttributeList excludedAttributes() const { return mExcludedAttributeIndexes; }
193 
205  QString exportFeature( const QgsFeature &feature,
206  const QVariantMap &extraProperties = QVariantMap(),
207  const QVariant &id = QVariant(),
208  int indent = -1 ) const;
209 
219  json exportFeatureToJsonObject( const QgsFeature &feature,
220  const QVariantMap &extraProperties = QVariantMap(),
221  const QVariant &id = QVariant() ) const SIP_SKIP;
222 
223 
231  QString exportFeatures( const QgsFeatureList &features, int indent = -1 ) const;
232 
233  private:
234 
236  int mPrecision;
237 
242  QgsAttributeList mAttributeIndexes;
243 
245  QgsAttributeList mExcludedAttributeIndexes;
246 
248  bool mIncludeGeometry = true;
249 
251  bool mIncludeAttributes = true;
252 
254  bool mIncludeRelatedAttributes = false;
255 
257  QPointer< QgsVectorLayer > mLayer;
258 
260 
261  QgsCoordinateTransform mTransform;
262 
263  bool mAttributeDisplayName = false;
264 };
265 
273 class CORE_EXPORT QgsJsonUtils
274 {
275  public:
276 
286  static QgsFeatureList stringToFeatureList( const QString &string, const QgsFields &fields, QTextCodec *encoding );
287 
296  static QgsFields stringToFields( const QString &string, QTextCodec *encoding );
297 
304  static QString encodeValue( const QVariant &value );
305 
314  static QString exportAttributes( const QgsFeature &feature, QgsVectorLayer *layer = nullptr,
315  const QVector<QVariant> &attributeWidgetCaches = QVector<QVariant>() );
316 
327  static json exportAttributesToJsonObject( const QgsFeature &feature, QgsVectorLayer *layer = nullptr,
328  const QVector<QVariant> &attributeWidgetCaches = QVector<QVariant>() ) SIP_SKIP;
329 
338  static QVariantList parseArray( const QString &json, QVariant::Type type = QVariant::Invalid );
339 
340 
346  static json jsonFromVariant( const QVariant &v ) SIP_SKIP;
347 
353  static QVariant parseJson( const std::string &jsonString ) SIP_SKIP;
354 
360  static QVariant parseJson( const QString &jsonString ) SIP_SKIP;
361 
362 };
363 
364 #endif // QGSJSONUTILS_H
QgsAttributeList excludedAttributes() const
Returns a list of attributes which will be specifically excluded from the JSON exports.
Definition: qgsjsonutils.h:192
int precision
bool includeRelated() const
Returns whether attributes of related (child) features will be included in the JSON exports...
Definition: qgsjsonutils.h:110
void setAttributeDisplayName(bool displayName)
Sets whether to print original names of attributes or aliases if defined.
Definition: qgsjsonutils.h:117
void setIncludeAttributes(bool includeAttributes)
Sets whether to include attributes in the JSON exports.
Definition: qgsjsonutils.h:89
QList< QgsFeature > QgsFeatureList
Definition: qgsfeature.h:571
void setIncludeGeometry(bool includeGeometry)
Sets whether to include geometry in the JSON exports.
Definition: qgsjsonutils.h:76
Helper utilities for working with JSON and GeoJSON conversions.
Definition: qgsjsonutils.h:273
Container of fields for a vector layer.
Definition: qgsfields.h:42
bool includeAttributes() const
Returns whether attributes will be included in the JSON exports.
Definition: qgsjsonutils.h:95
int precision() const
Returns the maximum number of decimal places to use in geometry coordinates.
Definition: qgsjsonutils.h:69
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:55
const QgsCoordinateReferenceSystem & crs
bool attributeDisplayName() const
Returns whether original names of attributes or aliases are printed.
Definition: qgsjsonutils.h:124
void setAttributes(const QgsAttributeList &attributes)
Sets the list of attributes to include in the JSON exports.
Definition: qgsjsonutils.h:165
#define SIP_SKIP
Definition: qgis_sip.h:119
void setExcludedAttributes(const QgsAttributeList &attributes)
Sets a list of attributes to specifically exclude from the JSON exports.
Definition: qgsjsonutils.h:184
QgsAttributeList attributes() const
Returns the list of attributes which will be included in the JSON exports, or an empty list if all at...
Definition: qgsjsonutils.h:175
void setIncludeRelated(bool includeRelated)
Sets whether to include attributes of features linked via references in the JSON exports.
Definition: qgsjsonutils.h:104
nlohmann::json json
Definition: qgsjsonutils.h:27
Handles exporting QgsFeature features to GeoJSON features.
Definition: qgsjsonutils.h:45
bool includeGeometry() const
Returns whether geometry will be included in the JSON exports.
Definition: qgsjsonutils.h:82
This class represents a coordinate reference system (CRS).
Class for doing transforms between two map coordinate systems.
QList< int > QgsAttributeList
Definition: qgsfield.h:27
void setPrecision(int precision)
Sets the maximum number of decimal places to use in geometry coordinates.
Definition: qgsjsonutils.h:63
Represents a vector layer which manages a vector based data sets.