WMSClient.h

Go to the documentation of this file.

/*  Copyright (C) 2008 National Institute For Space Research (INPE) - Brazil.
 
    This file is part of the TerraLib - a Framework for building GIS enabled applications.
 
    TerraLib is free software: you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation, either version 3 of the License,
    or (at your option) any later version.
 
    TerraLib is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU Lesser General Public License for more details.
 
    You should have received a copy of the GNU Lesser General Public License
    along with TerraLib. See COPYING. If not, write to
    TerraLib Team at <terralib-team@terralib.org>.
 */
 
/*!
  \file terralib/ws/ogc/wms/client/WCSClient.h
 
  \brief WS Client for OGC WMS
 
  \author Emerson Moraes
*/
 
#ifndef __TERRALIB_WS_OGC_WCS_CLIENT_WMS_H
#define __TERRALIB_WS_OGC_WCS_CLIENT_WMS_H
 
// STL
#include <memory>
#include <vector>
#include <map>
#include <string>
 
// TerraLib
#include "../../../../core/uri/URI.h"
#include "../../../core/CurlWrapper.h"
#include "Config.h"
#include "DataTypes.h"
#include "XMLParser.h"
 
 
namespace te
{
  namespace ws
  {
    namespace ogc
    {
 
    /*!
      \class WMSClient
 
      \brief A class to retrieve information and data from a Web Map Service.
    */
    class TEOGCWMSEXPORT WMSClient
    {
    public:
 
      /*!
        \brief Class constructor. It initializes the m_uri and m_version class members
 
        \param usrDataDir  Directory to store used temporary XML and images from WMS server.
        \param uri         The adress of WMS server.
        \param version     The WMS version.
      */
      WMSClient(const std::string& usrDataDir = "",const std::string& uri = "", const std::string& version = "1.3.0");
 
      /*!
        \brief Default destructor.
      */
      ~WMSClient();
 
      /*!
        \brief Method to get the capabilities from a WMS server and store in m_capabilities member
 
               To access the information contained in the m_capabilities, use the getCapabilities() method.
 
      */
      void updateCapabilities();
 
      /*!
        \brief Return the WMSCapabilities member.
 
               The WMSCapabilities will be empty until the updateCapabilities() method its called.
 
        \return Returns the WMSCapabilities member.
      */
      const te::ws::ogc::wms::WMSCapabilities& getCapabilities() const;
 
      void setCapabilities(const te::ws::ogc::wms::WMSCapabilities& capabilities);
 
      /*!
        \brief Return the WMSGetMapResponse member.
 
               Make the GetMapRequest and return the server answer as a WMSGetMapResponse.
 
        \return Returns a path to a file
      */
      const te::ws::ogc::wms::WMSGetMapResponse getMap(const te::ws::ogc::wms::WMSGetMapRequest& request) const;
 
      /*!
        \brief It execute a WMS GetMap and save the result image on disk.
               The request will be based on WMSGetMapRequest setted to this WMSLayer.
 
        \return std::string with saved image path.
        */
      const std::string saveGetMap(const te::ws::ogc::wms::WMSGetMapRequest &request, const std::string& filename);
 
      /*!
        \brief It execute a WMS GetFeatureInfo and returns a WMSGetFeatureInfoResponse with the result.
 
        \return a WMSGetFeatureInfoResponse with server response.
      */
      const te::ws::ogc::wms::WMSGetFeatureInfoResponse getFeatureInfo(const te::ws::ogc::wms::WMSGetFeatureInfoRequest& request) const;
 
      /*!
        \brief Executes a request on a WMS server
 
        \param url The complete url of request
 
        \return Returns a path to a file
      */
      std::string makeFileRequest(const std::string& url, const std::string& fileName) const;
 
      /*!
        \brief Executes a request on a WMS server
 
        \param url The complete url of request
 
        \return Returns the buffer with the content of the server response
      */
      std::string makeRequest(const std::string& url) const;
 
 
      /*!
       * \brief Sets the TerraLib CurlWrapper to be used internally.
       *
       *        By default it is an instance of te::ws::core::CurlWrapper class.
       *
       * \param curlWrapper Wrapper to be used.
       */
      void setCurlWrapper(te::ws::core::CurlWrapper* curlWrapper);
 
      //!< Checks if we have access to the current URI
      bool isAccessible();
 
    private:
 
      std::string buildGetMapRequestURL(const te::ws::ogc::wms::WMSGetMapRequest &request) const;
 
      std::string build130GetMapRequestURL(const te::ws::ogc::wms::WMSGetMapRequest &request) const;
 
      std::string build111GetMapRequestURL(const te::ws::ogc::wms::WMSGetMapRequest &request) const;
 
      std::string buildGetFeatureInfoURL(const te::ws::ogc::wms::WMSGetFeatureInfoRequest& request) const;
 
      std::string build130GetFeatureInfoURL(const te::ws::ogc::wms::WMSGetFeatureInfoRequest& request) const;
 
      std::string build111GetFeatureInfoURL(const te::ws::ogc::wms::WMSGetFeatureInfoRequest& request) const;
 
    private:
      std::string                                     m_version;
      std::string                                     m_dataDir;
      te::core::URI                                   m_uri;
      te::ws::ogc::wms::WMSCapabilities               m_capabilities;
      std::shared_ptr<te::ws::core::CurlWrapper>      m_curl;
      std::unique_ptr<te::ws::ogc::wms::XMLParser>    m_parser;
 
    };
    }
  }
}
 
#endif //__TERRALIB_WS_OGC_WCS_CLIENT_WMS_H