qgsogcutils.h

Go to the documentation of this file.

/***************************************************************************
    qgsogcutils.h
    ---------------------
    begin                : March 2013
    copyright            : (C) 2013 by Martin Dobias
    email                : wonder dot sk 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 QGSOGCUTILS_H
#define QGSOGCUTILS_H

class QColor;
class QDomNode;
class QDomElement;
class QDomDocument;
class QString;

#include <list>
#include <QVector>

class QgsExpression;
class QgsGeometry;
class QgsPoint;
class QgsRectangle;

#include "qgsgeometry.h"
#include "qgsexpression.h"
#include "qgssqlstatement.h"

class CORE_EXPORT QgsOgcUtils
{
  public:

    typedef enum
    {
      GML_2_1_2,
      GML_3_1_0,
      GML_3_2_1,
    } GMLVersion;

    static QgsGeometry* geometryFromGML( const QString& xmlString );

    static QgsGeometry* geometryFromGML( const QDomNode& geometryNode );

    static QgsRectangle rectangleFromGMLBox( const QDomNode& boxNode );

    static QgsRectangle rectangleFromGMLEnvelope( const QDomNode& envelopeNode );

    static QDomElement geometryToGML( const QgsGeometry* geometry, QDomDocument& doc,
                                      GMLVersion gmlVersion,
                                      const QString& srsName,
                                      bool invertAxisOrientation,
                                      const QString& gmlIdBase,
                                      int precision = 17 );

    static QDomElement geometryToGML( const QgsGeometry* geometry, QDomDocument& doc, const QString& format, int precision = 17 );

    static QDomElement geometryToGML( const QgsGeometry* geometry, QDomDocument& doc, int precision = 17 );

    static QDomElement rectangleToGMLBox( QgsRectangle* box, QDomDocument& doc, int precision = 17 );

    static QDomElement rectangleToGMLBox( QgsRectangle* box, QDomDocument& doc,
                                          const QString& srsName,
                                          bool invertAxisOrientation,
                                          int precision = 17 );

    static QDomElement rectangleToGMLEnvelope( QgsRectangle* env, QDomDocument& doc, int precision = 17 );

    static QDomElement rectangleToGMLEnvelope( QgsRectangle* env, QDomDocument& doc,
        const QString& srsName,
        bool invertAxisOrientation,
        int precision = 17 );


    static QColor colorFromOgcFill( const QDomElement& fillElement );

    static QgsExpression* expressionFromOgcFilter( const QDomElement& element );

    static QDomElement expressionToOgcFilter( const QgsExpression& exp, QDomDocument& doc, QString* errorMessage = nullptr );

    typedef enum
    {
      FILTER_OGC_1_0,
      FILTER_OGC_1_1,
      FILTER_FES_2_0
    } FilterVersion;

    static QDomElement expressionToOgcFilter( const QgsExpression& exp,
        QDomDocument& doc,
        GMLVersion gmlVersion,
        FilterVersion filterVersion,
        const QString& geometryName,
        const QString& srsName,
        bool honourAxisOrientation,
        bool invertAxisOrientation,
        QString* errorMessage = nullptr );

    static QDomElement expressionToOgcExpression( const QgsExpression& exp, QDomDocument& doc, QString* errorMessage = nullptr );

    static QDomElement expressionToOgcExpression( const QgsExpression& exp,
        QDomDocument& doc,
        GMLVersion gmlVersion,
        FilterVersion filterVersion,
        const QString& geometryName,
        const QString& srsName,
        bool honourAxisOrientation,
        bool invertAxisOrientation,
        QString* errorMessage = nullptr );

    class LayerProperties
    {
      public:
        LayerProperties() {}

        QString mName;
        QString mGeometryAttribute;
        QString mSRSName;
    };

    static QDomElement SQLStatementToOgcFilter( const QgsSQLStatement& statement,
        QDomDocument& doc,
        GMLVersion gmlVersion,
        FilterVersion filterVersion,
        const QList<LayerProperties>& layerProperties,
        bool honourAxisOrientation,
        bool invertAxisOrientation,
        const QMap< QString, QString>& mapUnprefixedTypenameToPrefixedTypename,
        QString* errorMessage = nullptr );

  private:

    static QgsGeometry* geometryFromGMLPoint( const QDomElement& geometryElement );
    static QgsGeometry* geometryFromGMLLineString( const QDomElement& geometryElement );
    static QgsGeometry* geometryFromGMLPolygon( const QDomElement& geometryElement );
    static QgsGeometry* geometryFromGMLMultiPoint( const QDomElement& geometryElement );
    static QgsGeometry* geometryFromGMLMultiLineString( const QDomElement& geometryElement );
    static QgsGeometry* geometryFromGMLMultiPolygon( const QDomElement& geometryElement );
    static bool readGMLCoordinates( QgsPolyline &coords, const QDomElement &elem );
    static bool readGMLPositions( QgsPolyline &coords, const QDomElement &elem );


    static QDomElement createGMLCoordinates( const QgsPolyline &points, QDomDocument& doc );

    static QDomElement createGMLPositions( const QgsPolyline &points, QDomDocument& doc );

    static QgsExpression::Node* nodeFromOgcFilter( QDomElement &element, QString &errorMessage );
    static QgsExpression::NodeBinaryOperator* nodeBinaryOperatorFromOgcFilter( QDomElement &element, QString &errorMessage );
    static QgsExpression::NodeFunction* nodeSpatialOperatorFromOgcFilter( QDomElement& element, QString& errorMessage );
    static QgsExpression::NodeUnaryOperator* nodeNotFromOgcFilter( QDomElement &element, QString &errorMessage );
    static QgsExpression::NodeFunction* nodeFunctionFromOgcFilter( QDomElement &element, QString &errorMessage );
    static QgsExpression::Node* nodeLiteralFromOgcFilter( QDomElement &element, QString &errorMessage );
    static QgsExpression::NodeColumnRef* nodeColumnRefFromOgcFilter( QDomElement &element, QString &errorMessage );
    static QgsExpression::Node* nodeIsBetweenFromOgcFilter( QDomElement& element, QString& errorMessage );
    static QgsExpression::NodeBinaryOperator* nodePropertyIsNullFromOgcFilter( QDomElement& element, QString& errorMessage );
};

class QgsOgcUtilsExprToFilter
{
  public:
    QgsOgcUtilsExprToFilter( QDomDocument& doc,
                             QgsOgcUtils::GMLVersion gmlVersion,
                             QgsOgcUtils::FilterVersion filterVersion,
                             const QString& geometryName,
                             const QString& srsName,
                             bool honourAxisOrientation,
                             bool invertAxisOrientation );

    QDomElement expressionNodeToOgcFilter( const QgsExpression::Node* node );

    bool GMLNamespaceUsed() const { return mGMLUsed; }

    const QString& errorMessage() const { return mErrorMessage; }

  private:
    QDomDocument& mDoc;
    bool mGMLUsed;
    QgsOgcUtils::GMLVersion mGMLVersion;
    QgsOgcUtils::FilterVersion mFilterVersion;
    const QString& mGeometryName;
    const QString& mSrsName;
    bool mInvertAxisOrientation;
    QString mErrorMessage;
    QString mFilterPrefix;
    QString mPropertyName;
    int mGeomId;

    QDomElement expressionUnaryOperatorToOgcFilter( const QgsExpression::NodeUnaryOperator* node );
    QDomElement expressionBinaryOperatorToOgcFilter( const QgsExpression::NodeBinaryOperator* node );
    QDomElement expressionLiteralToOgcFilter( const QgsExpression::NodeLiteral* node );
    QDomElement expressionColumnRefToOgcFilter( const QgsExpression::NodeColumnRef* node );
    QDomElement expressionInOperatorToOgcFilter( const QgsExpression::NodeInOperator* node );
    QDomElement expressionFunctionToOgcFilter( const QgsExpression::NodeFunction* node );
};

class QgsOgcUtilsSQLStatementToFilter
{
  public:
    QgsOgcUtilsSQLStatementToFilter( QDomDocument& doc,
                                     QgsOgcUtils::GMLVersion gmlVersion,
                                     QgsOgcUtils::FilterVersion filterVersion,
                                     const QList<QgsOgcUtils::LayerProperties>& layerProperties,
                                     bool honourAxisOrientation,
                                     bool invertAxisOrientation,
                                     const QMap< QString, QString>& mapUnprefixedTypenameToPrefixedTypename );

    QDomElement toOgcFilter( const QgsSQLStatement::Node* node );

    bool GMLNamespaceUsed() const { return mGMLUsed; }

    const QString& errorMessage() const { return mErrorMessage; }

  private:
    QDomDocument& mDoc;
    bool mGMLUsed;
    QgsOgcUtils::GMLVersion mGMLVersion;
    QgsOgcUtils::FilterVersion mFilterVersion;
    const QList<QgsOgcUtils::LayerProperties>& mLayerProperties;
    bool mHonourAxisOrientation;
    bool mInvertAxisOrientation;
    QString mErrorMessage;
    QString mFilterPrefix;
    QString mPropertyName;
    int mGeomId;
    QString mCurrentSRSName;
    QMap<QString, QString> mMapTableAliasToNames;
    const QMap< QString, QString>& mMapUnprefixedTypenameToPrefixedTypename;

    QDomElement toOgcFilter( const QgsSQLStatement::NodeUnaryOperator* node );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeBinaryOperator* node );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeLiteral* node );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeColumnRef* node );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeInOperator* node );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeBetweenOperator* node );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeFunction* node );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeJoin* node, const QString& leftTable );
    QDomElement toOgcFilter( const QgsSQLStatement::NodeSelect* node );

    void visit( const QgsSQLStatement::NodeTableDef* node );
    QString getGeometryColumnSRSName( const QgsSQLStatement::Node* node );
    bool processSRSName( const QgsSQLStatement::NodeFunction* mainNode,
                         QList<QgsSQLStatement::Node*> args,
                         bool lastArgIsSRSName,
                         QString& srsName,
                         bool& axisInversion );
};

#endif // QGSOGCUTILS_H