147 lines
5.0 KiB
C++
147 lines
5.0 KiB
C++
//
|
|
// detail/service_registry.hpp
|
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
//
|
|
// Copyright (c) 2003-2016 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_DETAIL_SERVICE_REGISTRY_HPP
|
|
#define BOOST_ASIO_DETAIL_SERVICE_REGISTRY_HPP
|
|
|
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
|
# pragma once
|
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
|
|
|
#include <boost/asio/detail/config.hpp>
|
|
#include <typeinfo>
|
|
#include <boost/asio/detail/mutex.hpp>
|
|
#include <boost/asio/detail/noncopyable.hpp>
|
|
#include <boost/asio/io_service.hpp>
|
|
|
|
#include <boost/asio/detail/push_options.hpp>
|
|
|
|
namespace boost {
|
|
namespace asio {
|
|
namespace detail {
|
|
|
|
template <typename T>
|
|
class typeid_wrapper {};
|
|
|
|
class service_registry
|
|
: private noncopyable
|
|
{
|
|
public:
|
|
// Constructor. Adds the initial service.
|
|
template <typename Service, typename Arg>
|
|
service_registry(boost::asio::io_service& o,
|
|
Service* initial_service, Arg arg);
|
|
|
|
// Destructor.
|
|
BOOST_ASIO_DECL ~service_registry();
|
|
|
|
// Notify all services of a fork event.
|
|
BOOST_ASIO_DECL void notify_fork(boost::asio::io_service::fork_event fork_ev);
|
|
|
|
// Get the first service object cast to the specified type. Called during
|
|
// io_service construction and so performs no locking or type checking.
|
|
template <typename Service>
|
|
Service& first_service();
|
|
|
|
// Get the service object corresponding to the specified service type. Will
|
|
// create a new service object automatically if no such object already
|
|
// exists. Ownership of the service object is not transferred to the caller.
|
|
template <typename Service>
|
|
Service& use_service();
|
|
|
|
// Add a service object. Throws on error, in which case ownership of the
|
|
// object is retained by the caller.
|
|
template <typename Service>
|
|
void add_service(Service* new_service);
|
|
|
|
// Check whether a service object of the specified type already exists.
|
|
template <typename Service>
|
|
bool has_service() const;
|
|
|
|
private:
|
|
// Initialise a service's key based on its id.
|
|
BOOST_ASIO_DECL static void init_key(
|
|
boost::asio::io_service::service::key& key,
|
|
const boost::asio::io_service::id& id);
|
|
|
|
#if !defined(BOOST_ASIO_NO_TYPEID)
|
|
// Initialise a service's key based on its id.
|
|
template <typename Service>
|
|
static void init_key(boost::asio::io_service::service::key& key,
|
|
const boost::asio::detail::service_id<Service>& /*id*/);
|
|
#endif // !defined(BOOST_ASIO_NO_TYPEID)
|
|
|
|
// Check if a service matches the given id.
|
|
BOOST_ASIO_DECL static bool keys_match(
|
|
const boost::asio::io_service::service::key& key1,
|
|
const boost::asio::io_service::service::key& key2);
|
|
|
|
// The type of a factory function used for creating a service instance.
|
|
typedef boost::asio::io_service::service*
|
|
(*factory_type)(boost::asio::io_service&);
|
|
|
|
// Factory function for creating a service instance.
|
|
template <typename Service>
|
|
static boost::asio::io_service::service* create(
|
|
boost::asio::io_service& owner);
|
|
|
|
// Destroy a service instance.
|
|
BOOST_ASIO_DECL static void destroy(
|
|
boost::asio::io_service::service* service);
|
|
|
|
// Helper class to manage service pointers.
|
|
struct auto_service_ptr;
|
|
friend struct auto_service_ptr;
|
|
struct auto_service_ptr
|
|
{
|
|
boost::asio::io_service::service* ptr_;
|
|
~auto_service_ptr() { destroy(ptr_); }
|
|
};
|
|
|
|
// Get the service object corresponding to the specified service key. Will
|
|
// create a new service object automatically if no such object already
|
|
// exists. Ownership of the service object is not transferred to the caller.
|
|
BOOST_ASIO_DECL boost::asio::io_service::service* do_use_service(
|
|
const boost::asio::io_service::service::key& key,
|
|
factory_type factory);
|
|
|
|
// Add a service object. Throws on error, in which case ownership of the
|
|
// object is retained by the caller.
|
|
BOOST_ASIO_DECL void do_add_service(
|
|
const boost::asio::io_service::service::key& key,
|
|
boost::asio::io_service::service* new_service);
|
|
|
|
// Check whether a service object with the specified key already exists.
|
|
BOOST_ASIO_DECL bool do_has_service(
|
|
const boost::asio::io_service::service::key& key) const;
|
|
|
|
// Mutex to protect access to internal data.
|
|
mutable boost::asio::detail::mutex mutex_;
|
|
|
|
// The owner of this service registry and the services it contains.
|
|
boost::asio::io_service& owner_;
|
|
|
|
// The first service in the list of contained services.
|
|
boost::asio::io_service::service* first_service_;
|
|
};
|
|
|
|
} // namespace detail
|
|
} // namespace asio
|
|
} // namespace boost
|
|
|
|
#include <boost/asio/detail/pop_options.hpp>
|
|
|
|
#include <boost/asio/detail/impl/service_registry.hpp>
|
|
#if defined(BOOST_ASIO_HEADER_ONLY)
|
|
# include <boost/asio/detail/impl/service_registry.ipp>
|
|
#endif // defined(BOOST_ASIO_HEADER_ONLY)
|
|
|
|
#endif // BOOST_ASIO_DETAIL_SERVICE_REGISTRY_HPP
|