QGIS API Documentation  2.3.0-Master
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
qgsgml.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsgml.h
3  ---------------------
4  begin : February 2013
5  copyright : (C) 2013 by Radim Blazek
6  email : radim dot blazek 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 #ifndef QGSGML_H
16 #define QGSGML_H
17 
18 #include <expat.h>
19 #include "qgis.h"
20 #include "qgsapplication.h"
22 #include "qgsdataprovider.h"
23 #include "qgsfeature.h"
24 #include "qgsfield.h"
25 #include "qgslogger.h"
26 #include "qgspoint.h"
27 #include "qgsrectangle.h"
28 
29 #include <QPair>
30 #include <QByteArray>
31 #include <QDomElement>
32 #include <QStringList>
33 #include <QStack>
34 
35 class QgsRectangle;
36 
41 class CORE_EXPORT QgsGml : public QObject
42 {
43  Q_OBJECT
44  public:
45  QgsGml(
46  const QString& typeName,
47  const QString& geometryAttribute,
48  const QgsFields & fields );
49 
50  ~QgsGml();
51 
61  int getFeatures( const QString& uri, QGis::WkbType* wkbType, QgsRectangle* extent = 0, const QString& userName = QString(), const QString& password = QString() );
62 
66  int getFeatures( const QByteArray &data, QGis::WkbType* wkbType, QgsRectangle* extent = 0 );
67 
69  QMap<QgsFeatureId, QgsFeature* > featuresMap() const { return mFeatures; }
70 
72  QMap<QgsFeatureId, QString > idsMap() const { return mIdMap; }
73 
76  QgsCoordinateReferenceSystem crs() const;
77 
78  private slots:
79 
80  void setFinished();
81 
83  void handleProgressEvent( qint64 progress, qint64 totalSteps );
84 
85  signals:
86  void dataReadProgress( int progress );
87  void totalStepsUpdate( int totalSteps );
88  //also emit signal with progress and totalSteps together (this is better for the status message)
89  void dataProgressAndSteps( int progress, int totalSteps );
90 
91  private:
92 
93  enum ParseMode
94  {
97  feature, // feature element containing attrs and geo (inside gml:featureMember)
104  multiPolygon
105  };
106 
108  void startElement( const XML_Char* el, const XML_Char** attr );
109  void endElement( const XML_Char* el );
110  void characters( const XML_Char* chars, int len );
111  static void start( void* data, const XML_Char* el, const XML_Char** attr )
112  {
113  static_cast<QgsGml*>( data )->startElement( el, attr );
114  }
115  static void end( void* data, const XML_Char* el )
116  {
117  static_cast<QgsGml*>( data )->endElement( el );
118  }
119  static void chars( void* data, const XML_Char* chars, int len )
120  {
121  static_cast<QgsGml*>( data )->characters( chars, len );
122  }
123 
124  //helper routines
125 
131  int readEpsgFromAttribute( int& epsgNr, const XML_Char** attr ) const;
137  QString readAttribute( const QString& attributeName, const XML_Char** attr ) const;
140  int createBBoxFromCoordinateString( QgsRectangle &bb, const QString& coordString ) const;
146  int pointsFromCoordinateString( QList<QgsPoint>& points, const QString& coordString ) const;
147 
154  int pointsFromPosListString( QList<QgsPoint>& points, const QString& coordString, int dimension ) const;
155 
156  int pointsFromString( QList<QgsPoint>& points, const QString& coordString ) const;
157  int getPointWKB( unsigned char** wkb, int* size, const QgsPoint& ) const;
158  int getLineWKB( unsigned char** wkb, int* size, const QList<QgsPoint>& lineCoordinates ) const;
159  int getRingWKB( unsigned char** wkb, int* size, const QList<QgsPoint>& ringCoordinates ) const;
165  int createMultiLineFromFragments();
166  int createMultiPointFromFragments();
167  int createPolygonFromFragments();
168  int createMultiPolygonFromFragments();
170  int totalWKBFragmentSize() const;
171 
173  QWidget* findMainWindow() const;
179  void calculateExtentFromFeatures();
180 
182  ParseMode modeStackTop() { return mParseModeStack.isEmpty() ? none : mParseModeStack.top(); }
183 
185  ParseMode modeStackPop() { return mParseModeStack.isEmpty() ? none : mParseModeStack.pop(); }
186 
187  QString mTypeName;
188  QString mUri;
189  //results are members such that handler routines are able to manipulate them
193  //QMap<QgsFeatureId, QgsFeature* > &mFeatures;
194  QMap<QgsFeatureId, QgsFeature* > mFeatures;
195  //QMap<QString, QMap<QgsFeatureId, QgsFeature* > > mFeatures;
196 
198  //QMap<QgsFeatureId, QString > &mIdMap;
199  QMap<QgsFeatureId, QString > mIdMap;
200  //QMap<QString, QMap<QgsFeatureId, QString > > mIdMap;
203  //const QMap<QString, QPair<int, QgsField> > &mThematicAttributes;
204  QMap<QString, QPair<int, QgsField> > mThematicAttributes;
207  bool mFinished;
209  QStack<ParseMode> mParseModeStack;
211  QString mStringCash;
213  QVector<QVariant> mCurrentAttributes; //attributes of current feature
217  unsigned char* mCurrentWKB;
225  QList< QList<unsigned char*> > mCurrentWKBFragments;
227  QList< QList<int> > mCurrentWKBFragmentSizes;
228  QString mAttributeName;
239  int mEpsg;
240 };
241 
242 #endif
QgsRectangle mCurrentExtent
Definition: qgsgml.h:220
A rectangle specified with double values.
Definition: qgsrectangle.h:35
enum QgsApplication::ENDIAN endian_t
constants for endian-ness
QString mAttributeName
Definition: qgsgml.h:228
QgsApplication::endian_t mEndian
Definition: qgsgml.h:229
QString mGeometryAttribute
Name of geometry attribute.
Definition: qgsgml.h:202
static void start(void *data, const XML_Char *el, const XML_Char **attr)
Definition: qgsgml.h:111
QgsFeature * mCurrentFeature
Definition: qgsgml.h:212
ParseMode modeStackPop()
Safely (if empty) pop from mode stack.
Definition: qgsgml.h:185
Container of fields for a vector layer.
Definition: qgsfield.h:164
WkbType
Used for symbology operations.
Definition: qgis.h:53
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:114
QMap< QgsFeatureId, QString > idsMap() const
Get feature ids map.
Definition: qgsgml.h:72
QString mTypeName
Definition: qgsgml.h:187
QString mCurrentFeatureId
Definition: qgsgml.h:214
QString mCoordinateSeparator
Coordinate separator for coordinate strings.
Definition: qgsgml.h:231
QString mUri
Definition: qgsgml.h:188
This class reads data from a WFS server or alternatively from a GML file.
Definition: qgsgml.h:41
int mFeatureCount
Definition: qgsgml.h:215
unsigned char * mCurrentWKB
The total WKB for a feature.
Definition: qgsgml.h:217
ParseMode modeStackTop()
Get safely (if empty) top from mode stack.
Definition: qgsgml.h:182
static void chars(void *data, const XML_Char *chars, int len)
Definition: qgsgml.h:119
QString mTupleSeparator
Tuple separator for coordinate strings.
Definition: qgsgml.h:233
QVector< QVariant > mCurrentAttributes
Definition: qgsgml.h:213
A class to represent a point geometry.
Definition: qgspoint.h:63
QGis::WkbType * mWkbType
Definition: qgsgml.h:205
static void end(void *data, const XML_Char *el)
Definition: qgsgml.h:115
QStack< ParseMode > mParseModeStack
Keep track about the most important nested elements.
Definition: qgsgml.h:209
ParseMode mCoorMode
Coordinates mode, coordinate or posList.
Definition: qgsgml.h:237
QMap< QgsFeatureId, QgsFeature * > featuresMap() const
Get parsed features for given type name.
Definition: qgsgml.h:69
QMap< QgsFeatureId, QgsFeature * > mFeatures
The features of the layer, map of feature maps for each feature type.
Definition: qgsgml.h:194
Class for storing a coordinate reference system (CRS)
bool mFinished
True if the request is finished.
Definition: qgsgml.h:207
QList< QList< unsigned char * > > mCurrentWKBFragments
WKB intermediate storage during parsing.
Definition: qgsgml.h:225
int mEpsg
EPSG of parsed features geometries.
Definition: qgsgml.h:239
QgsRectangle mExtent
Bounding box of the layer.
Definition: qgsgml.h:191
QList< QList< int > > mCurrentWKBFragmentSizes
Similar to mCurrentWKB, but only the size.
Definition: qgsgml.h:227
int mDimension
Number of dimensions in pos or posList.
Definition: qgsgml.h:235
QMap< QString, QPair< int, QgsField > > mThematicAttributes
Definition: qgsgml.h:204
double size
Definition: qgssvgcache.cpp:77
int mCurrentWKBSize
The total WKB size for a feature.
Definition: qgsgml.h:219
QMap< QgsFeatureId, QString > mIdMap
Stores the relation between provider ids and WFS server ids.
Definition: qgsgml.h:199
QString mStringCash
This contains the character data if an important element has been encountered.
Definition: qgsgml.h:211
ParseMode
Definition: qgsgml.h:93