QC_DatasourcePool.dox.h
namespace Qore {
namespace SQL {
class DatasourcePool : public AbstractDatasource, public Serializable {
public:
nothing beginTransaction();
public:
nothing clearEventQueue();
public:
clearWarningCallback();
public:
nothing commit();
public:
constructor(string driver, *string user, *string pass, *string db, *string encoding, *string host, softint min = 3, softint max = 10, softint port = 0, *Qore::Thread::Queue queue, auto arg);
public:
constructor(string desc, *Qore::Thread::Queue queue, auto arg);
public:
constructor(hash<auto> opts, *Qore::Thread::Queue queue, auto arg);
public:
copy();
public:
bool currentThreadInTransaction();
public:
destructor();
public:
auto exec(string sql, ...);
public:
auto execRaw(string sql);
public:
int getCapabilities();
public:
list<auto> getCapabilityList();
public:
auto getClientVersion();
public:
hash<auto> getConfigHash();
public:
string getConfigString();
public:
*string getDBCharset();
public:
*string getDBEncoding();
public:
*string getDBName();
public:
string getDriverName();
public:
int getErrorTimeout();
public:
*string getHostName();
public:
int getMaximum();
public:
int getMinimum();
public:
string getOSCharset();
public:
*string getOSEncoding();
public:
auto getOption(string opt);
public:
hash<auto> getOptionHash();
public:
*string getPassword();
public:
*int getPort();
public:
AbstractSQLStatement getSQLStatement();
public:
auto getServerVersion();
public:
*hash<auto> getUsageInfo();
public:
*string getUserName();
public:
bool inTransaction();
public:
nothing rollback();
public:
auto select(string sql, ...);
public:
auto selectRow(string sql, ...);
public:
auto selectRows(string sql, ...);
public:
setErrorTimeout(timeout ts);
public:
nothing setEventQueue(Qore::Thread::Queue queue, auto arg);
public:
setWarningCallback(timeout ms, code callback, auto arg);
public:
string toString();
public:
auto vexec(string sql, *softlist<auto> vargs);
public:
auto vselect(string sql, *softlist<auto> vargs);
public:
auto vselectRow(string sql, *softlist<auto> vargs);
public:
auto vselectRows(string sql, *softlist<auto> vargs);
};
}
}
Qore::SQL::AbstractSQLStatement
This class defines an abstract interface for the SQLStatement class.
Definition: QC_AbstractSQLStatement.dox.h:11
Qore::SQL::DatasourcePool::getOSCharset
string getOSCharset()
Returns the Qore character encoding name for the object as a string or "(unknown)" if none is set...
Qore::Serializable::constructor
constructor()
The constructor does not perform any action; this class is just used to mark a class as serializable ...
Qore::SQL::DatasourcePool::getDBEncoding
*string getDBEncoding()
Retrieves the database-specific charset set encoding for the object.
Qore::SQL::DatasourcePool::getDriverName
string getDriverName()
Returns the name of the driver used for the object.
Qore::SQL::DatasourcePool::vselect
auto vselect(string sql, *softlist< auto > vargs)
Executes a select statement on the server and returns the results in a hash (column names) of lists (...
Qore::SQL::DatasourcePool::setEventQueue
nothing setEventQueue(Qore::Thread::Queue queue, auto arg)
Sets a queue object for DBI events on the pool.
Qore::SQL::DatasourcePool::getOSEncoding
*string getOSEncoding()
Returns the Qore character encoding name for the object as a string or NOTHING if none is set...
Qore::SQL::DatasourcePool::getPassword
*string getPassword()
Returns the password parameter as a string or NOTHING if none is set.
Qore::SQL::DatasourcePool::getHostName
*string getHostName()
Returns the hostname parameter as a string or NOTHING if none is set.
Qore::SQL::DatasourcePool
Provides transparent per-thread, per-transaction datasource connection pooling.
Definition: QC_DatasourcePool.dox.h:50
Qore::SQL::DatasourcePool::execRaw
auto execRaw(string sql)
Allocates a persistent connection to the current thread from the pool (if one has not already been al...
Qore::SQL::DatasourcePool::rollback
nothing rollback()
Rolls back the current transaction and releases the connection to the pool.
Qore::SQL::DatasourcePool::getCapabilities
int getCapabilities()
Returns an integer bitfield of DBI driver capabilities.
Qore::SQL::DatasourcePool::selectRows
auto selectRows(string sql,...)
Executes an SQL select statement on the server and returns the result as a list (rows) of hashes (the...
Qore::SQL::DatasourcePool::selectRow
auto selectRow(string sql,...)
Executes an SQL select statement on the server and returns the first row as a hash (the column values...
Qore::SQL::DatasourcePool::getConfigString
string getConfigString()
Returns a string giving the configuration of the current object in a format that can be parsed by par...
Qore::SQL::DatasourcePool::getUsageInfo
*hash< auto > getUsageInfo()
Returns a hash with usage information about the DatasourcePool object.
Qore::SQL::DatasourcePool::copy
copy()
Creates a new Datasource object with the same driver as the original and copies of all the connection...
Qore::SQL::DatasourcePool::exec
auto exec(string sql,...)
Allocates a persistent connection to the current thread from the pool (if one has not already been al...
Qore::Serializable
The Serializable class can be used to mark a class as being serializable.
Definition: QC_Serializable.dox.h:96
Qore::SQL::DatasourcePool::getPort
*int getPort()
Gets the port number that will be used for the next connection to the server.
Qore::SQL::AbstractDatasource
This class defines an abstract interface for database access, inherited by both the Datasource and Da...
Definition: QC_AbstractDatasource.dox.h:10
Qore::max
auto max(list< auto > l)
Returns the maximum value in a list.
Qore::SQL::DatasourcePool::vselectRow
auto vselectRow(string sql, *softlist< auto > vargs)
Executes a select statement on the server and returns the first row as a hash (column names and value...
Qore::SQL::DatasourcePool::getDBCharset
*string getDBCharset()
Retrieves the database-specific charset set encoding for the object.
Qore::SQL::DatasourcePool::inTransaction
bool inTransaction()
Returns True if a transaction is currently in progress (meaning in this case that a datasource form t...
Qore::SQL::DatasourcePool::commit
nothing commit()
Commits the current transaction and releases the connection to the pool.
Qore::SQL::DatasourcePool::getOptionHash
hash< auto > getOptionHash()
returns the valid options for the driver associated with the Datasource with descriptions and current...
Qore::SQL::DatasourcePool::toString
string toString()
Returns a string with technical information about the object.
Qore::min
auto min(list< auto > l)
Returns the minumum value in a list.
Qore::SQL::DatasourcePool::getDBName
*string getDBName()
Returns the database name parameter as a string or NOTHING if none is set.
Qore::SQL::DatasourcePool::getMaximum
int getMaximum()
Returns the maximum number of connections in this object.
Qore::SQL::DatasourcePool::clearEventQueue
nothing clearEventQueue()
Clears the queue object for DBI events on the pool.
Qore::SQL::DatasourcePool::currentThreadInTransaction
bool currentThreadInTransaction()
Returns True if the current thread is in a transaction (i.e. has a dedicated datasource allocation)...
Qore::SQL::DatasourcePool::getClientVersion
auto getClientVersion()
Retrieves the driver-specific client library version information; this method may not be implemented ...
Qore::SQL::DatasourcePool::setWarningCallback
setWarningCallback(timeout ms, code callback, auto arg)
sets a connection delay warning callback to be called any time the delay assigning a connection from ...
Qore::SQL::DatasourcePool::vexec
auto vexec(string sql, *softlist< auto > vargs)
Allocates a persistent connection to the current thread from the pool (if one has not already been al...
Qore::SQL::DatasourcePool::getMinimum
int getMinimum()
Returns the minimum number of connections in this object.
Qore::SQL::DatasourcePool::clearWarningCallback
clearWarningCallback()
clears any connection delay warning callback from the object
Qore::SQL::DatasourcePool::vselectRows
auto vselectRows(string sql, *softlist< auto > vargs)
Executes a select statement on the server and returns the results in a list (rows) of hashes (column ...
Qore::SQL::DatasourcePool::getServerVersion
auto getServerVersion()
Returns the driver-specific server version data for the current connection.
Qore::SQL::DatasourcePool::getErrorTimeout
int getErrorTimeout()
Returns the error timeout period for waiting for a connection to come free as an integer giving milli...
Qore::Thread::Queue
Queue objects provide a blocking, thread-safe message-passing object to Qore programs ...
Definition: QC_Queue.dox.h:22
Qore::SQL::DatasourcePool::getOption
auto getOption(string opt)
Returns the current value for the given option.
Qore::SQL::DatasourcePool::getUserName
*string getUserName()
Returns the username parameter as a string or NOTHING if none is set.
Qore
main Qore-language namespace
Definition: Pseudo_QC_All.dox.h:3
Qore::SQL::DatasourcePool::setErrorTimeout
setErrorTimeout(timeout ts)
Sets the timeout period for waiting for a connection to come free; note that timeout values less than...
Qore::SQL::DatasourcePool::destructor
destructor()
Throws an exception if any transactions are in progress and returns immediately; the object is destro...
Qore::SQL::DatasourcePool::beginTransaction
nothing beginTransaction()
Manually allocates a persistent connection from the pool to the calling thread.
Qore::SQL::DatasourcePool::getCapabilityList
list< auto > getCapabilityList()
Returns a list of strings giving the capabilities of the current DBI driver.
Qore::SQL::DatasourcePool::select
auto select(string sql,...)
Executes an SQL select statement on the server and returns the result as a hash (column names) of lis...
Qore::SQL::DatasourcePool::getSQLStatement
AbstractSQLStatement getSQLStatement()
Returns an AbstractSQLStatement object based on the current database connection object.
Qore::SQL::DatasourcePool::getConfigHash
hash< auto > getConfigHash()
Returns a datasource hash describing the configuration of the current object.