|
MySQL++
3.3.0
|
Specialization of Connection for Unix domain sockets.
More...
#include <uds_connection.h>


Public Member Functions | |
| UnixDomainSocketConnection () | |
| Create object without connecting it to the MySQL server. | |
| UnixDomainSocketConnection (const char *path, const char *db=0, const char *user=0, const char *password=0) | |
| Create object and connect to database server over Unix domain sockets in one step. More... | |
| UnixDomainSocketConnection (const UnixDomainSocketConnection &other) | |
| Establish a new connection using the same parameters as an existing connection. More... | |
| ~UnixDomainSocketConnection () | |
| Destroy object. | |
| bool | connect (const char *path, const char *db=0, const char *user=0, const char *password=0) |
| Connect to database after object is created. More... | |
Public Member Functions inherited from mysqlpp::Connection | |
| Connection (bool te=true) | |
| Create object without connecting to the database server. More... | |
| Connection (const char *db, const char *server=0, const char *user=0, const char *password=0, unsigned int port=0) | |
| Create object and connect to database server in one step. More... | |
| Connection (const Connection &other) | |
| Establish a new connection using the same parameters as an existing connection. More... | |
| virtual | ~Connection () |
| Destroy object. | |
| std::string | client_version () const |
| Get version of library underpinning the current database driver. | |
| bool | connected () const |
| Returns true if connection was established successfully. More... | |
| ulonglong | count_rows (const std::string &table) |
| Returns the number of rows in a table. More... | |
| bool | create_db (const std::string &db) |
| Ask the database server to create a database. More... | |
| void | disconnect () |
| Drop the connection to the database server. | |
| DBDriver * | driver () |
| Returns a reference to the current database driver. | |
| bool | drop_db (const std::string &db) |
| Asks the database server to drop (destroy) a database. More... | |
| int | errnum () |
| Return last error number associated with this connection. | |
| const char * | error () const |
| Return error message for last error associated with this connection. More... | |
| std::string | ipc_info () const |
| Get information about the IPC connection to the database server. More... | |
| bool | kill (unsigned long tid) const |
| Kill a database server thread. More... | |
| operator private_bool_type () const | |
| Test whether any error has occurred within the object. More... | |
| Connection & | operator= (const Connection &rhs) |
| Copy an existing Connection object's state into this object. | |
| bool | ping () |
| "Pings" the database server More... | |
| int | protocol_version () const |
| Returns version number of the protocol the database driver uses to communicate with the server. | |
| Query | query (const char *qstr=0) |
| Return a new query object. More... | |
| Query | query (const std::string &qstr) |
| Return a new query object. More... | |
| bool | select_db (const std::string &db) |
| Change to a different database managed by the database server we are connected to. More... | |
| std::string | server_version () const |
| Get the database server's version string. | |
| bool | set_option (Option *o) |
| Sets a connection option. More... | |
| bool | shutdown () |
| Ask database server to shut down. | |
| std::string | server_status () const |
| Returns information about database server's status. | |
| unsigned long | thread_id () |
| Returns the database server's thread ID for this connection. More... | |
Public Member Functions inherited from mysqlpp::OptionalExceptions | |
| OptionalExceptions (bool e=true) | |
| Default constructor. More... | |
| virtual | ~OptionalExceptions () |
| Destroy object. | |
| void | enable_exceptions () const |
| Enable exceptions from the object. | |
| void | disable_exceptions () const |
| Disable exceptions from the object. | |
| bool | throw_exceptions () const |
| Returns true if exceptions are enabled. | |
Static Public Member Functions | |
| static bool | is_socket (const char *path, std::string *error=0) |
| Check that the given path names a Unix domain socket and that we have read-write permission for it. More... | |
Static Public Member Functions inherited from mysqlpp::Connection | |
| static bool | thread_aware () |
| Returns true if both MySQL++ and database driver we're using were compiled with thread awareness. | |
| static void | thread_end () |
| Tells the underlying database driver that this thread is done using the library. | |
| static bool | thread_start () |
| Tells the underlying database driver that the current thread is now using its services. More... | |
Additional Inherited Members | |
Protected Member Functions inherited from mysqlpp::Connection | |
| void | build_error_message (const char *core) |
| Build an error message in the standard form used whenever one of the methods can't succeed because we're not connected to the database server. | |
| void | copy (const Connection &other) |
| Establish a new connection as a copy of an existing one. More... | |
| bool | parse_ipc_method (const char *server, std::string &host, unsigned int &port, std::string &socket_name) |
| Extract elements from the server parameter in formats suitable for passing to DBDriver::connect(). | |
Protected Member Functions inherited from mysqlpp::OptionalExceptions | |
| void | set_exceptions (bool e) const |
| Sets the exception state to a particular value. More... | |
Protected Attributes inherited from mysqlpp::Connection | |
| std::string | error_message_ |
| MySQL++ specific error, if any. | |
Specialization of Connection for Unix domain sockets.
This class just simplifies the connection creation interface of Connection. It does not add new functionality.
|
inline |
Create object and connect to database server over Unix domain sockets in one step.
| path | filesystem path to socket |
| db | name of database to use |
| user | user name to log in under, or 0 to use the user name the program is running under |
| password | password to use when logging in |
BEWARE: These parameters are not in the same order as those in the corresponding constructor for Connection. This is a feature, not a bug. :)
References connect().
|
inline |
Establish a new connection using the same parameters as an existing connection.
| other | pre-existing connection to clone |
| bool mysqlpp::UnixDomainSocketConnection::connect | ( | const char * | path, |
| const char * | db = 0, |
||
| const char * | user = 0, |
||
| const char * | password = 0 |
||
| ) |
Connect to database after object is created.
It's better to use the connect-on-create constructor if you can. See its documentation for the meaning of these parameters.
If you call this method on an object that is already connected to a database server, the previous connection is dropped and a new connection is established.
Referenced by UnixDomainSocketConnection().
|
static |
Check that the given path names a Unix domain socket and that we have read-write permission for it.
| path | the filesystem path to the socket |
| error | on failure, reason is placed here; take default if you do not need a reason if it fails |
Referenced by mysqlpp::Connection::parse_ipc_method().