qgsrelation.h

Go to the documentation of this file.

/***************************************************************************
    qgsrelation.h
     --------------------------------------
    Date                 : 29.4.2013
    Copyright            : (C) 2013 Matthias Kuhn
    Email                : matthias at opengis dot ch
 ***************************************************************************
 *                                                                         *
 *   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 QGSRELATION_H
#define QGSRELATION_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgsattributes.h"
#include "qgsreadwritecontext.h"
#include "qgsrelationcontext.h"
 
#include <QDomNode>
#include <QList>
#include <QPair>
 
class QgsFeatureIterator;
class QgsFeatureRequest;
class QgsVectorLayer;
class QgsRelationPrivate;
class QgsPolymorphicRelation;

class CORE_EXPORT QgsRelation
{
    Q_GADGET
 
    Q_PROPERTY( QString id READ id WRITE setId )
    Q_PROPERTY( QString referencingLayerId READ referencingLayerId WRITE setReferencingLayer )
    Q_PROPERTY( QgsVectorLayer *referencingLayer READ referencingLayer )
    Q_PROPERTY( QList<int> referencingFields READ referencedFields )
    Q_PROPERTY( QString referencedLayerId READ referencedLayerId WRITE setReferencedLayer )
    Q_PROPERTY( QgsVectorLayer *referencedLayer READ referencedLayer )
    Q_PROPERTY( QList<int> referencedFields READ referencedFields )
    Q_PROPERTY( QString name READ name WRITE setName )
    Q_PROPERTY( bool isValid READ isValid )
    Q_PROPERTY( Qgis::RelationshipStrength strength READ strength WRITE setStrength )
    Q_PROPERTY( QString polymorphicRelationId READ polymorphicRelationId WRITE setPolymorphicRelationId )
    Q_PROPERTY( QgsPolymorphicRelation polymorphicRelation READ polymorphicRelation )
 
  public:
 
#ifndef SIP_RUN

    class FieldPair : public QPair< QString, QString >
    {
      public:
        FieldPair() = default;

        FieldPair( const QString &referencingField, const QString &referencedField )
          : QPair< QString, QString >( referencingField, referencedField ) {}

        QString referencingField() const { return first; }
        QString referencedField() const { return second; }
 
        bool operator==( const FieldPair &other ) const { return first == other.first && second == other.second; }
    };
#endif

    QgsRelation();
    ~QgsRelation();

    QgsRelation( const QgsRelationContext &context );

    QgsRelation( const QgsRelation &other );
    SIP_SKIP QgsRelation( QgsRelation &&other );

    QgsRelation &operator=( const QgsRelation &other );
    QgsRelation &operator=( QgsRelation &&other );

    static QgsRelation createFromXml( const QDomNode &node, QgsReadWriteContext &context, const QgsRelationContext &relationContext = QgsRelationContext() );

    void writeXml( QDomNode &node, QDomDocument &doc ) const;

    void setId( const QString &id );

    void setName( const QString &name );

    void setStrength( Qgis::RelationshipStrength strength );

    void setReferencingLayer( const QString &id );

    void setReferencedLayer( const QString &id );

    Q_INVOKABLE void addFieldPair( const QString &referencingField, const QString &referencedField );

    void addFieldPair( const FieldPair &fieldPair ) SIP_SKIP;

    QgsFeatureIterator getRelatedFeatures( const QgsFeature &feature ) const;

    QgsFeatureRequest getRelatedFeaturesRequest( const QgsFeature &feature ) const;

    Q_INVOKABLE QString getRelatedFeaturesFilter( const QgsFeature &feature ) const;

    QgsFeatureRequest getReferencedFeatureRequest( const QgsAttributes &attributes ) const;

    QgsFeatureRequest getReferencedFeatureRequest( const QgsFeature &feature ) const;

    Q_INVOKABLE QgsFeature getReferencedFeature( const QgsFeature &feature ) const;

    QString name() const;

    Qgis::RelationshipStrength strength() const;

    QString id() const;

    void generateId();

    QString referencingLayerId() const;

    QgsVectorLayer *referencingLayer() const;

    QString referencedLayerId() const;

    QgsVectorLayer *referencedLayer() const;

#ifndef SIP_RUN
    QList< QgsRelation::FieldPair > fieldPairs() const;
#else
    QMap< QString, QString > fieldPairs() const;
    % MethodCode
    const QList< QgsRelation::FieldPair > &pairs = sipCpp->fieldPairs();
    sipRes = new QMap< QString, QString >();
    for ( const QgsRelation::FieldPair &pair : pairs )
    {
      sipRes->insert( pair.first, pair.second );
    }
    % End
#endif

    QgsAttributeList referencedFields() const;

    QgsAttributeList referencingFields() const;

    bool referencingFieldsAllowNull() const;

    bool isValid() const;

    QString validationError() const;

    bool hasEqualDefinition( const QgsRelation &other ) const;

    Q_INVOKABLE QString resolveReferencedField( const QString &referencingField ) const;

    Q_INVOKABLE QString resolveReferencingField( const QString &referencedField ) const;

    void updateRelationStatus();

    void setPolymorphicRelationId( const QString &polymorphicRelationId );

    QString polymorphicRelationId() const;

    QgsPolymorphicRelation polymorphicRelation() const;

    Qgis::RelationshipType type() const;

    static QString cardinalityToDisplayString( Qgis::RelationshipCardinality cardinality );

    static QString strengthToDisplayString( Qgis::RelationshipStrength strength );
 
  private:
 
    mutable QExplicitlySharedDataPointer<QgsRelationPrivate> d;
 
    QgsRelationContext mContext;
};
 
// Register QgsRelation for usage with QVariant
Q_DECLARE_METATYPE( QgsRelation )
 
#endif // QGSRELATION_H