|
- //
- // ip/resolver_service.hpp
- // ~~~~~~~~~~~~~~~~~~~~~~~
- //
- // Copyright (c) 2003-2015 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- //
- // Distributed under the Boost Software License, Version 1.0. (See accompanying
- // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- //
-
- #ifndef ASIO_IP_RESOLVER_SERVICE_HPP
- #define ASIO_IP_RESOLVER_SERVICE_HPP
-
- #if defined(_MSC_VER) && (_MSC_VER >= 1200)
- # pragma once
- #endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
-
- #include "asio/detail/config.hpp"
- #include "asio/async_result.hpp"
- #include "asio/error_code.hpp"
- #include "asio/io_context.hpp"
- #include "asio/ip/basic_resolver_iterator.hpp"
- #include "asio/ip/basic_resolver_query.hpp"
- #include "asio/ip/basic_resolver_results.hpp"
-
- #if defined(ASIO_WINDOWS_RUNTIME)
- # include "asio/detail/winrt_resolver_service.hpp"
- #else
- # include "asio/detail/resolver_service.hpp"
- #endif
-
- #include "asio/detail/push_options.hpp"
-
- namespace asio {
- namespace ip {
-
- /// Default service implementation for a resolver.
- template <typename InternetProtocol>
- class resolver_service
- #if defined(GENERATING_DOCUMENTATION)
- : public asio::io_context::service
- #else
- : public asio::detail::service_base<
- resolver_service<InternetProtocol> >
- #endif
- {
- public:
- #if defined(GENERATING_DOCUMENTATION)
- /// The unique service identifier.
- static asio::io_context::id id;
- #endif
-
- /// The protocol type.
- typedef InternetProtocol protocol_type;
-
- /// The endpoint type.
- typedef typename InternetProtocol::endpoint endpoint_type;
-
- /// The query type.
- typedef basic_resolver_query<InternetProtocol> query_type;
-
- /// The iterator type.
- typedef basic_resolver_iterator<InternetProtocol> iterator_type;
-
- /// The results type.
- typedef basic_resolver_results<InternetProtocol> results_type;
-
- private:
- // The type of the platform-specific implementation.
- #if defined(ASIO_WINDOWS_RUNTIME)
- typedef asio::detail::winrt_resolver_service<InternetProtocol>
- service_impl_type;
- #else
- typedef asio::detail::resolver_service<InternetProtocol>
- service_impl_type;
- #endif
-
- public:
- /// The type of a resolver implementation.
- #if defined(GENERATING_DOCUMENTATION)
- typedef implementation_defined implementation_type;
- #else
- typedef typename service_impl_type::implementation_type implementation_type;
- #endif
-
- /// Construct a new resolver service for the specified io_context.
- explicit resolver_service(asio::io_context& io_context)
- : asio::detail::service_base<
- resolver_service<InternetProtocol> >(io_context),
- service_impl_(io_context)
- {
- }
-
- /// Construct a new resolver implementation.
- void construct(implementation_type& impl)
- {
- service_impl_.construct(impl);
- }
-
- /// Destroy a resolver implementation.
- void destroy(implementation_type& impl)
- {
- service_impl_.destroy(impl);
- }
-
- /// Cancel pending asynchronous operations.
- void cancel(implementation_type& impl)
- {
- service_impl_.cancel(impl);
- }
-
- /// Resolve a query to a list of entries.
- results_type resolve(implementation_type& impl, const query_type& query,
- asio::error_code& ec)
- {
- return service_impl_.resolve(impl, query, ec);
- }
-
- /// Asynchronously resolve a query to a list of entries.
- template <typename ResolveHandler>
- ASIO_INITFN_RESULT_TYPE(ResolveHandler,
- void (asio::error_code, results_type))
- async_resolve(implementation_type& impl, const query_type& query,
- ASIO_MOVE_ARG(ResolveHandler) handler)
- {
- asio::async_completion<ResolveHandler,
- void (asio::error_code, results_type)> init(handler);
-
- service_impl_.async_resolve(impl, query, init.handler);
-
- return init.result.get();
- }
-
- /// Resolve an endpoint to a list of entries.
- results_type resolve(implementation_type& impl,
- const endpoint_type& endpoint, asio::error_code& ec)
- {
- return service_impl_.resolve(impl, endpoint, ec);
- }
-
- /// Asynchronously resolve an endpoint to a list of entries.
- template <typename ResolveHandler>
- ASIO_INITFN_RESULT_TYPE(ResolveHandler,
- void (asio::error_code, results_type))
- async_resolve(implementation_type& impl, const endpoint_type& endpoint,
- ASIO_MOVE_ARG(ResolveHandler) handler)
- {
- asio::async_completion<ResolveHandler,
- void (asio::error_code, results_type)> init(handler);
-
- service_impl_.async_resolve(impl, endpoint, init.handler);
-
- return init.result.get();
- }
-
- private:
- // Destroy all user-defined handler objects owned by the service.
- void shutdown()
- {
- service_impl_.shutdown();
- }
-
- // Perform any fork-related housekeeping.
- void notify_fork(asio::io_context::fork_event event)
- {
- service_impl_.notify_fork(event);
- }
-
- // The platform-specific implementation.
- service_impl_type service_impl_;
- };
-
- } // namespace ip
- } // namespace asio
-
- #include "asio/detail/pop_options.hpp"
-
- #endif // ASIO_IP_RESOLVER_SERVICE_HPP
|