qgsserverogcapihandler.h

Go to the documentation of this file.

/***************************************************************************
  qgsserverogcapihandler.h - QgsServerOgcApiHandler
 
 ---------------------
 begin                : 10.7.2019
 copyright            : (C) 2019 by Alessandro Pasotti
 email                : elpaso at itopen dot it
 ***************************************************************************
 *                                                                         *
 *   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 QGSSERVEROGCAPIHANDLER_H
#define QGSSERVEROGCAPIHANDLER_H
 
#include <QRegularExpression>
#include "qgis_server.h"
#include "qgsserverquerystringparameter.h"
#include "qgsserverogcapi.h"
#include <nlohmann/json_fwd.hpp>
#include "inja/inja.hpp"
 
#ifndef SIP_RUN
using namespace nlohmann;
#endif
 
class QgsServerApiContext;
 
class SERVER_EXPORT QgsServerOgcApiHandler
{
 
  public:
 
    virtual ~QgsServerOgcApiHandler();
 
    // /////////////////////////////////////////////
    // MAIN Section (operational)
 
    virtual QRegularExpression path() const = 0;
 
    virtual std::string operationId() const = 0;
 
    virtual QList<QgsServerQueryStringParameter> parameters( const QgsServerApiContext &context ) const  { Q_UNUSED( context ); return { }; }
 
    // /////////////////////////////////////////////
    // METADATA Sections (informative)
 
    virtual std::string summary() const = 0;
 
    virtual std::string description() const = 0;
 
    virtual std::string linkTitle() const = 0;
 
    virtual QgsServerOgcApi::Rel linkType() const = 0;
 
    virtual QStringList tags() const { return {}; }
 
    virtual QgsServerOgcApi::ContentType defaultContentType() const;
 
    QList<QgsServerOgcApi::ContentType> contentTypes() const SIP_SKIP;
 
    virtual void handleRequest( const QgsServerApiContext &context ) const SIP_THROW( QgsServerApiBadRequestException ) SIP_VIRTUALERRORHANDLER( serverapi_badrequest_exception_handler );
 
    virtual QVariantMap values( const QgsServerApiContext &context ) const SIP_THROW( QgsServerApiBadRequestException );
 
    QString contentTypeForAccept( const QString &accept ) const;
 
    // /////////////////////////////////////////////////////
    // Utility methods: override should not be required
 
#ifndef SIP_RUN  // Skip SIP
 
    void write( json &data, const QgsServerApiContext &context, const json &htmlMetadata = nullptr ) const;
 
    void jsonDump( json &data, const QgsServerApiContext &context, const QString &contentType = QStringLiteral( "application/json" ) ) const;
 
    void htmlDump( const json &data, const QgsServerApiContext &context ) const;
 
    virtual json schema( const QgsServerApiContext &context ) const;
 
    json link( const QgsServerApiContext &context,
               const QgsServerOgcApi::Rel &linkType = QgsServerOgcApi::Rel::self,
               const QgsServerOgcApi::ContentType contentType = QgsServerOgcApi::ContentType::JSON,
               const std::string &title = "" ) const;
 
    json links( const QgsServerApiContext &context ) const;
 
 
    QgsVectorLayer *layerFromContext( const QgsServerApiContext &context ) const;
 
#endif  // SIP skipped
 
    void write( QVariant &data, const QgsServerApiContext &context, const QVariantMap &htmlMetadata = QVariantMap() ) const SIP_THROW( QgsServerApiBadRequestException );
 
    std::string href( const QgsServerApiContext &context, const QString &extraPath = QString(), const QString &extension = QString() ) const;
 
    virtual const QString templatePath( const QgsServerApiContext &context ) const;
 
    virtual const QString staticPath( const QgsServerApiContext &context ) const;
 
    QgsServerOgcApi::ContentType contentTypeFromRequest( const QgsServerRequest *request ) const;
 
    static QString parentLink( const QUrl &url, int levels = 1 );
 
    static QgsVectorLayer *layerFromCollectionId( const QgsServerApiContext &context, const QString &collectionId );
 
    static json defaultResponse() SIP_SKIP;
 
    json jsonTags( ) const SIP_SKIP;
 
  protected:
 
    void setContentTypesInt( const QList<int> &contentTypes ) SIP_PYNAME( setContentTypes );
 
    void setContentTypes( const QList<QgsServerOgcApi::ContentType> &contentTypes ) SIP_SKIP;
 
  private:
 
    QList<QgsServerOgcApi::ContentType> mContentTypes = { QgsServerOgcApi::ContentType::JSON, QgsServerOgcApi::ContentType::HTML };
 
 
};
 
#endif // QGSSERVEROGCAPIHANDLER_H