///////////////////////////////////////////////////////////////////////////////
//
// Copyright (C) 2010-2011 Artyom Beilis (Tonkikh) <artyomtnk@yahoo.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)
//
// or (at your opinion) under:
//
// The MIT License
// (See accompanying file MIT.txt or a copy at
// http://www.opensource.org/licenses/mit-license.php)
//
///////////////////////////////////////////////////////////////////////////////
#ifndef CPPDB_DRIVER_MANAGER_H
#define CPPDB_DRIVER_MANAGER_H
#include <cppdb/defs.h>
#include <cppdb/ref_ptr.h>
#include <cppdb/mutex.h>
#include <map>
#include <string>
#include <vector>
namespace cppdb {
namespace backend {
class connection;
class driver;
}
class connection_info;
///
/// \brief this class is used to handle all drivers, loading them, unloading them etc.
///
/// All its member functions are thread safe
///
class CPPDB_API driver_manager {
public:
///
/// Get the singleton instance of the class
///
static driver_manager &instance();
///
/// Install new driver \a drv named \a name to the manager.
///
void install_driver(std::string const &name,ref_ptr<backend::driver> drv);
///
/// Unload all drivers that have no more open connections.
///
void collect_unused();
///
/// Add a path were the driver should search for loadable modules
///
void add_search_path(std::string const &);
///
/// Clear previously added a paths
///
void clear_search_paths();
///
/// Search the library under default directory (i.e. empty path prefix) or not, default is true
///
void use_default_search_path(bool v);
///
/// Create a new connection object using parsed connection string \a ci
///
backend::connection *connect(connection_info const &ci);
///
/// Create a new connection object using connection string \a connectoin_string
///
backend::connection *connect(std::string const &connectoin_string);
private:
driver_manager(driver_manager const &);
void operator=(driver_manager const &);
// Borland erros on hidden destructors in classes without only static methods.
#ifndef __BORLANDC__
~driver_manager();
#endif
driver_manager();
ref_ptr<backend::driver> load_driver(connection_info const &ci);
typedef std::map<std::string,ref_ptr<backend::driver> > drivers_type;
std::vector<std::string> search_paths_;
bool no_default_directory_;
drivers_type drivers_;
mutex lock_;
};
}
#endif
