discoverer.hpp

Go to the documentation of this file.

#ifndef SAGA_PACKAGES_SD_DISCOVERER_HPP

#define SAGA_PACKAGES_SD_DISCOVERER_HPP

// include dependent spec sections
#include <saga/saga/util.hpp>
#include <saga/saga/base.hpp>
#include <saga/saga/types.hpp>
#include <saga/saga/session.hpp>
#include <saga/saga/call.hpp> 
#include <saga/saga/exception.hpp>
#include <saga/saga/url.hpp>

#include <saga/saga/packages/sd/config.hpp>
#include <saga/saga/packages/sd/service_description.hpp>

namespace saga
{
  namespace sd {

  //  service discoverer 
  class SAGA_SD_PACKAGE_EXPORT discoverer 
       : public saga::object
  {

   public:

   private:
      // factory
      SAGA_CALL_CREATE_PRIV_2(session const&, saga::url)

      SAGA_CALL_PRIV_2 (list_services, std::string, std::string)
      SAGA_CALL_PRIV_3 (list_services, std::string, std::string, std::string)

   protected:
      TR1::shared_ptr <saga::impl::discoverer> get_impl (void) const;
      friend class saga::impl::discoverer;
      explicit discoverer(saga::impl::discoverer* impl)
         SAGA_THROW_SPEC(throw(saga::not_implemented,
               saga::no_success));

   public:
     explicit discoverer(saga::url loc = saga::url())
         SAGA_THROW_SPEC(throw(saga::not_implemented,
               saga::no_success));

      explicit discoverer(session const& s, saga::url loc = saga::url())
         SAGA_THROW_SPEC(throw(saga::not_implemented,
               saga::no_success));

      // explicit discoverer(saga::object const& o); // is this ctor necessary?
      ~discoverer (void) SAGA_THROW_SPEC(throw());

      static discoverer create(session const& s, saga::url loc = saga::url())
         SAGA_THROW_SPEC(throw(saga::not_implemented,
               saga::no_success))
      {
          return discoverer(s, loc);
      }
      SAGA_CALL_CREATE_2_DEF_1(session const&, saga::url, saga::url())

    /*saga*
     * discoverer factory.  Constructs a discoverer object using
     * a default session and the given URL.
     * 
     * @param loc      URL to use.
     *
     * @throws not_implemented
     *                 if the discoverer class is not implemented
     *                 by the SAGA implementation at all.
     * @throws no_success
     *                 if no result can be returned because of
     *                 information system or other internal problems.
     */
      static discoverer create(saga::url loc = saga::url())
         SAGA_THROW_SPEC(throw(saga::not_implemented,
               saga::no_success))
      {
          return discoverer(loc);
      }

      template <typename Tag>
      static saga::task create(saga::url loc = saga::url())
      {
         return create<Tag>(saga::detail::get_the_session(), loc);
      }

      // default operator=() and copy ctor
      discoverer& operator= (saga::object const& o) 
          SAGA_THROW_SPEC(throw());

      // public methods for the service discoverer

      std::vector<saga::sd::service_description>
         list_services(std::string service_filter, 
                       std::string authz_filter,
                       std::string data_filter)
            SAGA_THROW_SPEC(throw(saga::bad_parameter,
                  saga::authorization_failed,
                  saga::authentication_failed,
                  saga::timeout,
                  saga::no_success))
      {
         saga::task t = list_servicespriv(service_filter,
                                          authz_filter,
                                          data_filter, 
                                          saga::task_base::Sync());
         return t.get_result<std::vector<saga::sd::service_description> >();
      }
      SAGA_CALL_PUB_3_DEF_0 (list_services, std::string, std::string, std::string)

    
      std::vector<saga::sd::service_description>
         list_services(std::string service_filter, 
                       std::string data_filter)
            SAGA_THROW_SPEC(throw(saga::bad_parameter,
                  saga::authorization_failed,
                  saga::authentication_failed,
                  saga::timeout,
                  saga::no_success))
      {
         saga::task t = list_servicespriv(service_filter,
                                          data_filter, 
                                          saga::task_base::Sync());
         return t.get_result<std::vector<saga::sd::service_description> >();
      }
      SAGA_CALL_PUB_2_DEF_0 (list_services, std::string, std::string)
  }; // discoverer
 } // namespace sd
}  // namespace saga
#endif

---