// | |
// ip/resolver_service.hpp | |
// ~~~~~~~~~~~~~~~~~~~~~~~ | |
// | |
// Copyright (c) 2003-2011 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 |