| // |
| // ip/resolver_service.hpp |
| // ~~~~~~~~~~~~~~~~~~~~~~~ |
| // |
| // Copyright (c) 2003-2010 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 BOOST_ASIO_IP_RESOLVER_SERVICE_HPP |
| #define BOOST_ASIO_IP_RESOLVER_SERVICE_HPP |
| |
| #if defined(_MSC_VER) && (_MSC_VER >= 1200) |
| # pragma once |
| #endif // defined(_MSC_VER) && (_MSC_VER >= 1200) |
| |
| #include <boost/asio/detail/config.hpp> |
| #include <boost/system/error_code.hpp> |
| #include <boost/asio/detail/resolver_service.hpp> |
| #include <boost/asio/io_service.hpp> |
| #include <boost/asio/ip/basic_resolver_iterator.hpp> |
| #include <boost/asio/ip/basic_resolver_query.hpp> |
| |
| #include <boost/asio/detail/push_options.hpp> |
| |
| namespace boost { |
| namespace asio { |
| namespace ip { |
| |
| /// Default service implementation for a resolver. |
| template <typename InternetProtocol> |
| class resolver_service |
| #if defined(GENERATING_DOCUMENTATION) |
| : public boost::asio::io_service::service |
| #else |
| : public boost::asio::detail::service_base< |
| resolver_service<InternetProtocol> > |
| #endif |
| { |
| public: |
| #if defined(GENERATING_DOCUMENTATION) |
| /// The unique service identifier. |
| static boost::asio::io_service::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; |
| |
| private: |
| // The type of the platform-specific implementation. |
| typedef boost::asio::detail::resolver_service<InternetProtocol> |
| service_impl_type; |
| |
| 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_service. |
| explicit resolver_service(boost::asio::io_service& io_service) |
| : boost::asio::detail::service_base< |
| resolver_service<InternetProtocol> >(io_service), |
| service_impl_(io_service) |
| { |
| } |
| |
| /// Destroy all user-defined handler objects owned by the service. |
| void shutdown_service() |
| { |
| service_impl_.shutdown_service(); |
| } |
| |
| /// 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. |
| iterator_type resolve(implementation_type& impl, const query_type& query, |
| boost::system::error_code& ec) |
| { |
| return service_impl_.resolve(impl, query, ec); |
| } |
| |
| /// Asynchronously resolve a query to a list of entries. |
| template <typename Handler> |
| void async_resolve(implementation_type& impl, const query_type& query, |
| Handler handler) |
| { |
| service_impl_.async_resolve(impl, query, handler); |
| } |
| |
| /// Resolve an endpoint to a list of entries. |
| iterator_type resolve(implementation_type& impl, |
| const endpoint_type& endpoint, boost::system::error_code& ec) |
| { |
| return service_impl_.resolve(impl, endpoint, ec); |
| } |
| |
| /// Asynchronously resolve an endpoint to a list of entries. |
| template <typename ResolveHandler> |
| void async_resolve(implementation_type& impl, const endpoint_type& endpoint, |
| ResolveHandler handler) |
| { |
| return service_impl_.async_resolve(impl, endpoint, handler); |
| } |
| |
| private: |
| // The platform-specific implementation. |
| service_impl_type service_impl_; |
| }; |
| |
| } // namespace ip |
| } // namespace asio |
| } // namespace boost |
| |
| #include <boost/asio/detail/pop_options.hpp> |
| |
| #endif // BOOST_ASIO_IP_RESOLVER_SERVICE_HPP |