]>
Commit | Line | Data |
---|---|---|
7c673cae FG |
1 | // |
2 | // ip/resolver_service.hpp | |
3 | // ~~~~~~~~~~~~~~~~~~~~~~~ | |
4 | // | |
5 | // Copyright (c) 2003-2016 Christopher M. Kohlhoff (chris at kohlhoff dot com) | |
6 | // | |
7 | // Distributed under the Boost Software License, Version 1.0. (See accompanying | |
8 | // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) | |
9 | // | |
10 | ||
11 | #ifndef BOOST_ASIO_IP_RESOLVER_SERVICE_HPP | |
12 | #define BOOST_ASIO_IP_RESOLVER_SERVICE_HPP | |
13 | ||
14 | #if defined(_MSC_VER) && (_MSC_VER >= 1200) | |
15 | # pragma once | |
16 | #endif // defined(_MSC_VER) && (_MSC_VER >= 1200) | |
17 | ||
18 | #include <boost/asio/detail/config.hpp> | |
19 | #include <boost/asio/async_result.hpp> | |
20 | #include <boost/system/error_code.hpp> | |
21 | #include <boost/asio/io_service.hpp> | |
22 | #include <boost/asio/ip/basic_resolver_iterator.hpp> | |
23 | #include <boost/asio/ip/basic_resolver_query.hpp> | |
24 | ||
25 | #if defined(BOOST_ASIO_WINDOWS_RUNTIME) | |
26 | # include <boost/asio/detail/winrt_resolver_service.hpp> | |
27 | #else | |
28 | # include <boost/asio/detail/resolver_service.hpp> | |
29 | #endif | |
30 | ||
31 | #include <boost/asio/detail/push_options.hpp> | |
32 | ||
33 | namespace boost { | |
34 | namespace asio { | |
35 | namespace ip { | |
36 | ||
37 | /// Default service implementation for a resolver. | |
38 | template <typename InternetProtocol> | |
39 | class resolver_service | |
40 | #if defined(GENERATING_DOCUMENTATION) | |
41 | : public boost::asio::io_service::service | |
42 | #else | |
43 | : public boost::asio::detail::service_base< | |
44 | resolver_service<InternetProtocol> > | |
45 | #endif | |
46 | { | |
47 | public: | |
48 | #if defined(GENERATING_DOCUMENTATION) | |
49 | /// The unique service identifier. | |
50 | static boost::asio::io_service::id id; | |
51 | #endif | |
52 | ||
53 | /// The protocol type. | |
54 | typedef InternetProtocol protocol_type; | |
55 | ||
56 | /// The endpoint type. | |
57 | typedef typename InternetProtocol::endpoint endpoint_type; | |
58 | ||
59 | /// The query type. | |
60 | typedef basic_resolver_query<InternetProtocol> query_type; | |
61 | ||
62 | /// The iterator type. | |
63 | typedef basic_resolver_iterator<InternetProtocol> iterator_type; | |
64 | ||
65 | private: | |
66 | // The type of the platform-specific implementation. | |
67 | #if defined(BOOST_ASIO_WINDOWS_RUNTIME) | |
68 | typedef boost::asio::detail::winrt_resolver_service<InternetProtocol> | |
69 | service_impl_type; | |
70 | #else | |
71 | typedef boost::asio::detail::resolver_service<InternetProtocol> | |
72 | service_impl_type; | |
73 | #endif | |
74 | ||
75 | public: | |
76 | /// The type of a resolver implementation. | |
77 | #if defined(GENERATING_DOCUMENTATION) | |
78 | typedef implementation_defined implementation_type; | |
79 | #else | |
80 | typedef typename service_impl_type::implementation_type implementation_type; | |
81 | #endif | |
82 | ||
83 | /// Construct a new resolver service for the specified io_service. | |
84 | explicit resolver_service(boost::asio::io_service& io_service) | |
85 | : boost::asio::detail::service_base< | |
86 | resolver_service<InternetProtocol> >(io_service), | |
87 | service_impl_(io_service) | |
88 | { | |
89 | } | |
90 | ||
91 | /// Construct a new resolver implementation. | |
92 | void construct(implementation_type& impl) | |
93 | { | |
94 | service_impl_.construct(impl); | |
95 | } | |
96 | ||
97 | /// Destroy a resolver implementation. | |
98 | void destroy(implementation_type& impl) | |
99 | { | |
100 | service_impl_.destroy(impl); | |
101 | } | |
102 | ||
103 | /// Cancel pending asynchronous operations. | |
104 | void cancel(implementation_type& impl) | |
105 | { | |
106 | service_impl_.cancel(impl); | |
107 | } | |
108 | ||
109 | /// Resolve a query to a list of entries. | |
110 | iterator_type resolve(implementation_type& impl, const query_type& query, | |
111 | boost::system::error_code& ec) | |
112 | { | |
113 | return service_impl_.resolve(impl, query, ec); | |
114 | } | |
115 | ||
116 | /// Asynchronously resolve a query to a list of entries. | |
117 | template <typename ResolveHandler> | |
118 | BOOST_ASIO_INITFN_RESULT_TYPE(ResolveHandler, | |
119 | void (boost::system::error_code, iterator_type)) | |
120 | async_resolve(implementation_type& impl, const query_type& query, | |
121 | BOOST_ASIO_MOVE_ARG(ResolveHandler) handler) | |
122 | { | |
123 | boost::asio::detail::async_result_init< | |
124 | ResolveHandler, void (boost::system::error_code, iterator_type)> init( | |
125 | BOOST_ASIO_MOVE_CAST(ResolveHandler)(handler)); | |
126 | ||
127 | service_impl_.async_resolve(impl, query, init.handler); | |
128 | ||
129 | return init.result.get(); | |
130 | } | |
131 | ||
132 | /// Resolve an endpoint to a list of entries. | |
133 | iterator_type resolve(implementation_type& impl, | |
134 | const endpoint_type& endpoint, boost::system::error_code& ec) | |
135 | { | |
136 | return service_impl_.resolve(impl, endpoint, ec); | |
137 | } | |
138 | ||
139 | /// Asynchronously resolve an endpoint to a list of entries. | |
140 | template <typename ResolveHandler> | |
141 | BOOST_ASIO_INITFN_RESULT_TYPE(ResolveHandler, | |
142 | void (boost::system::error_code, iterator_type)) | |
143 | async_resolve(implementation_type& impl, const endpoint_type& endpoint, | |
144 | BOOST_ASIO_MOVE_ARG(ResolveHandler) handler) | |
145 | { | |
146 | boost::asio::detail::async_result_init< | |
147 | ResolveHandler, void (boost::system::error_code, iterator_type)> init( | |
148 | BOOST_ASIO_MOVE_CAST(ResolveHandler)(handler)); | |
149 | ||
150 | service_impl_.async_resolve(impl, endpoint, init.handler); | |
151 | ||
152 | return init.result.get(); | |
153 | } | |
154 | ||
155 | private: | |
156 | // Destroy all user-defined handler objects owned by the service. | |
157 | void shutdown_service() | |
158 | { | |
159 | service_impl_.shutdown_service(); | |
160 | } | |
161 | ||
162 | // Perform any fork-related housekeeping. | |
163 | void fork_service(boost::asio::io_service::fork_event event) | |
164 | { | |
165 | service_impl_.fork_service(event); | |
166 | } | |
167 | ||
168 | // The platform-specific implementation. | |
169 | service_impl_type service_impl_; | |
170 | }; | |
171 | ||
172 | } // namespace ip | |
173 | } // namespace asio | |
174 | } // namespace boost | |
175 | ||
176 | #include <boost/asio/detail/pop_options.hpp> | |
177 | ||
178 | #endif // BOOST_ASIO_IP_RESOLVER_SERVICE_HPP |