/** @file
Parser: sql driver manager implementation.
Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
*/
static const char* IDENT_SQL_DRIVER_MANAGER_C="$Date: 2003/03/24 17:12:34 $";
#include "pa_sql_driver_manager.h"
#include "ltdl.h"
#include "pa_threads.h"
#include "pa_sql_connection.h"
#include "pa_exception.h"
#include "pa_common.h"
#include "pa_vhash.h"
#include "pa_vtable.h"
// globals
SQL_Driver_manager SQL_driver_manager;
// consts
const time_t EXPIRE_UNUSED_CONNECTION_SECONDS=60;
const time_t CHECK_EXPIRED_CONNECTIONS_SECONDS=EXPIRE_UNUSED_CONNECTION_SECONDS*2;
// helpers
const String& SQL_Driver_services_impl::url_without_login() const {
String& result=*new String;
result << furl->mid(0, furl->pos(':')) << "://****";
size_t at_pos=furl->pos('@');
if(at_pos!=STRING_NOT_FOUND)
result << furl->mid(at_pos, furl->length());
return result;
}
// helpers
static void expire_connection(SQL_Connection& connection, time_t older_dies) {
if(connection.connected() && connection.expired(older_dies))
connection.disconnect();
}
static void expire_connections(
SQL_Driver_manager::connection_cache_type::key_type /*key*/,
SQL_Driver_manager::connection_cache_type::value_type stack,
time_t older_dies) {
for(int i=0; i<=stack->top_index(); i++)
expire_connection(*stack->get(i), older_dies);
}
// SQL_Driver_manager
SQL_Driver_manager::SQL_Driver_manager():
prev_expiration_pass_time(0), is_dlinited(false) {
cache_managers.put(StringBody("sql"), this);
}
SQL_Driver_manager::~SQL_Driver_manager() {
connection_cache.for_each(expire_connections, time(0)+(time_t)1/*=in future=expire all*/);
if(is_dlinited)
lt_dlexit();
}
/// @param aurl protocol://[driver-dependent]
SQL_Connection* SQL_Driver_manager::get_connection(const String& aurl,
Table *protocol2driver_and_client) {
// we have table for locating protocol's library
if(!protocol2driver_and_client)
throw Exception("parser.runtime",
&aurl,
"$"MAIN_SQL_NAME":"MAIN_SQL_DRIVERS_NAME" table must be defined");
// first trying to get cached connection
SQL_Connection* connection=get_connection_from_cache(aurl);
if(connection) {
connection->set_url();
if(!connection->ping()) { // we have some cached connection, is it pingable?
connection->disconnect(); // kill unpingabe=dead connection
connection=0;
}
}
char *url_cstr;
if(connection)
url_cstr=0; // calm, compiler
else { // no cached connection or it were unpingabe: connect/reconnect
if(aurl.pos("://")==STRING_NOT_FOUND)
throw Exception("parser.runtime",
aurl.length()?&aurl:0,
"connection string must start with protocol://");
char *protocol_cstr=lsplit(&url_cstr, ':');
// skip "//" after ':'
while(*url_cstr=='/')
url_cstr++;
const String& protocol=*new String(protocol_cstr);
SQL_Driver *driver;
// first trying to get cached driver
if(!(driver=get_driver_from_cache(protocol))) {
// no cached
const String* library=0;
const String* dlopen_file_spec=0;
if(protocol2driver_and_client->locate(0, protocol)) {
if(!(library=protocol2driver_and_client->item(1)) || library->length()==0)
throw Exception("parser.runtime",
0,
"driver library column for protocol '%s' is empty",
protocol_cstr);
dlopen_file_spec=protocol2driver_and_client->item(2);
} else
throw Exception("parser.runtime",
&aurl,
"undefined protocol '%s'",
protocol_cstr);
if(!is_dlinited) {
if(lt_dlinit())
throw Exception(0,
library,
"prepare to dynamic loading failed, %s", lt_dlerror());
is_dlinited=true;
}
const char* filename=library->cstr(String::L_FILE_SPEC);
lt_dlhandle handle=lt_dlopen(filename);
if (!handle)
throw Exception(0,
library,
"can not open the module, %s", lt_dlerror());
SQL_Driver_create_func create=(SQL_Driver_create_func)lt_dlsym(handle,
SQL_DRIVER_CREATE_NAME);
if(!create)
throw Exception(0,
library,
"function '"SQL_DRIVER_CREATE_NAME"' was not found");
// create library-driver!
driver=(*create)();
// validate driver api version
int driver_api_version=driver->api_version();
if(driver_api_version!=SQL_DRIVER_API_VERSION)
throw Exception(0,
library,
"driver implements API version 0x%04X not equal to 0x%04X",
driver_api_version, SQL_DRIVER_API_VERSION);
// initialise by connecting to sql client dynamic link library
char* dlopen_file_spec_cstr=
dlopen_file_spec && dlopen_file_spec->length()?
dlopen_file_spec->cstrm(String::L_AS_IS):0;
if(const char* error=driver->initialize(dlopen_file_spec_cstr))
throw Exception(0,
library,
"driver failed to initialize client library '%s', %s",
dlopen_file_spec_cstr?dlopen_file_spec_cstr:"unspecifed",
error);
// cache it
put_driver_to_cache(protocol, driver);
}
connection=new SQL_Connection(aurl, *driver);
// associate with pool[request] (deassociates at close)
connection->set_url();
}
// if not connected yet, do that now, when connection has services
if(!connection->connected())
connection->connect(url_cstr);
// return autoclosing object for it
return connection;
}
void SQL_Driver_manager::close_connection(connection_cache_type::key_type url,
SQL_Connection* connection) {
put_connection_to_cache(url, connection);
}
// driver cache
SQL_Driver *SQL_Driver_manager::get_driver_from_cache(driver_cache_type::key_type protocol) {
SYNCHRONIZED;
return driver_cache.get(protocol);
}
void SQL_Driver_manager::put_driver_to_cache(
driver_cache_type::key_type protocol,
driver_cache_type::value_type driver) {
SYNCHRONIZED;
driver_cache.put(protocol, driver);
}
// connection cache
/// @todo get rid of memory spending Stack [zeros deep inside got accumulated]
SQL_Connection* SQL_Driver_manager::get_connection_from_cache(
connection_cache_type::key_type url) {
SYNCHRONIZED;
if(connection_cache_type::value_type connections=connection_cache.get(url))
while(connections->top_index()>=0) { // there are cached connections to that 'url'
SQL_Connection* result=connections->pop();
if(result->connected()) // not expired?
return result;
}
return 0;
}
void SQL_Driver_manager::put_connection_to_cache(
connection_cache_type::key_type url,
SQL_Connection* connection) {
SYNCHRONIZED;
connection_cache_type::value_type connections=connection_cache.get(url);
if(!connections) { // there are no cached connections to that 'url' yet?
connections=new connection_cache_element_base_type;
connection_cache.put(url, connections);
}
connections->push(connection);
}
void SQL_Driver_manager::maybe_expire_cache() {
time_t now=time(0);
if(prev_expiration_pass_time<now-CHECK_EXPIRED_CONNECTIONS_SECONDS) {
connection_cache.for_each(expire_connections, time_t(now-EXPIRE_UNUSED_CONNECTION_SECONDS));
prev_expiration_pass_time=now;
}
}
/*
static void add_connection_to_status_cache_table(Array::Item *value, void *info) {
SQL_Connection& connection=*static_cast<SQL_Connection* >(value);
Table& table=*static_cast<Table *>(info);
if(connection.connected()) {
=table.pool();
Array& row=*new Array();
// url
row+=&url_without_login(connection.get_url());
// time
time_t time_used=connection.get_time_used();
const char* unsafe_time_cstr=ctime(&time_used);
int time_buf_size=strlen(unsafe_time_cstr);
char *safe_time_buf=pool.copy(unsafe_time_cstr, time_buf_size);
row+=new String(safe_time_buf, time_buf_size);
table+=&row;
}
}
static void add_connections_to_status_cache_table(const Hash::Key& key, Hash::Val *value, void *info) {
Stack& stack=*static_cast<Stack *>(value);
Array_iter iter(stack);
for(int countdown=stack.top_index(); countdown-->=0; )
add_connection_to_status_cache_table(iter.next(), info);
}*/
/// @todo convert to object_ptr
Value* SQL_Driver_manager::get_status() {
Value* result=new VHash;
/*
// cache
{
Array& columns=*new Array();
columns+=new String("url");
columns+=new String("time");
Table& table=*new Table(0, &columns, connection_cache.length());
connection_cache.for_each(add_connections_to_status_cache_table, &table);
result.hash(source).put(*new String("cache"), new VTable(&table));
}*/
return result;
}
E-mail: