mysql_connect类 参考

MySQL数据库连接类 更多...

#include <mysql_connect.hpp>

类 mysql_connect 继承关系图:

Public 成员函数
	mysql_connect ()
	构造函数
	~mysql_connect () noexcept override
	析构函数
NEFORCE_NODISCARD bool	connect (const db_config &config) noexcept override
	建立数据库连接
NEFORCE_NODISCARD bool	reconnect (const db_config &config) override
	重新连接数据库
void	close () noexcept override
	关闭数据库连接
NEFORCE_NODISCARD bool	set_character_set (const string &encoding) const noexcept override
	设置字符集
NEFORCE_NODISCARD bool	set_options (::mysql_option option, const string &str) const noexcept
	设置MySQL连接选项
NEFORCE_NODISCARD string_view	get_character_set () const noexcept override
	获取当前字符集
NEFORCE_NODISCARD string_view	get_error () const noexcept override
	获取最后错误信息
NEFORCE_NODISCARD uint32_t	get_errno () const noexcept override
	获取最后错误码
NEFORCE_NODISCARD bool	update (const string &sql) const noexcept override
	执行非查询SQL语句
NEFORCE_NODISCARD unique_ptr< idb_tb_result >	query (const string &sql) const noexcept override
	执行查询SQL语句
NEFORCE_NODISCARD unique_ptr< idb_prepared_statement >	prepare_statement (const string &sql) const override
	创建预处理语句
NEFORCE_NODISCARD bool	connected () const noexcept override
	检查连接是否已建立
NEFORCE_NODISCARD bool	is_valid () const noexcept override
	检查连接是否有效
Public 成员函数 继承自 idb_connect
void	refresh_alive () noexcept
	刷新连接存活时间
NEFORCE_NODISCARD clock_type	get_alive () const noexcept
	获取连接空闲时间

额外继承的成员函数
Public 类型 继承自 idb_connect
using	clock_type = milliseconds
	存活时间计时器类型

详细描述

MySQL数据库连接类

实现idb_tb_connect接口，提供MySQL数据库的连接和操作功能。

主要功能：

• MySQL连接建立和关闭
• 字符集设置
• SQL语句执行
• 查询结果获取
• 预处理语句支持

在文件 mysql_connect.hpp 第 41 行定义.

构造及析构函数说明

mysql_connect()

mysql_connect::mysql_connect ( )

inline

构造函数

初始化MySQL连接句柄。

在文件 mysql_connect.hpp 第 51 行定义.

~mysql_connect()

mysql_connect::~mysql_connect ( )

inlineoverridenoexcept

析构函数

关闭数据库连接。

在文件 mysql_connect.hpp 第 58 行定义.

引用了 idb_connect::close().

成员函数说明

connect()

NEFORCE_NODISCARD bool mysql_connect::connect ( const db_config & config )

overridevirtualnoexcept

建立数据库连接

参数

config

连接配置

返回

连接成功返回true，失败返回false

使用配置建立连接，连接后自动设置字符集。

实现了 idb_connect.

connected()

NEFORCE_NODISCARD bool mysql_connect::connected ( ) const

inlineoverridevirtualnoexcept

检查连接是否已建立

返回

已连接返回true

实现了 idb_connect.

在文件 mysql_connect.hpp 第 142 行定义.

引用了 connected().

被这些函数引用 connected().

get_character_set()

NEFORCE_NODISCARD string_view mysql_connect::get_character_set ( ) const

overridevirtualnoexcept

获取当前字符集

返回

字符集名称

实现了 idb_connect.

引用了 get_character_set().

被这些函数引用 get_character_set().

get_errno()

NEFORCE_NODISCARD uint32_t mysql_connect::get_errno ( ) const

overridevirtualnoexcept

获取最后错误码

返回

MySQL错误码

实现了 idb_connect.

引用了 get_errno().

被这些函数引用 get_errno().

get_error()

NEFORCE_NODISCARD string_view mysql_connect::get_error ( ) const

overridevirtualnoexcept

获取最后错误信息

返回

错误描述字符串

实现了 idb_connect.

引用了 get_error().

被这些函数引用 get_error().

is_valid()

NEFORCE_NODISCARD bool mysql_connect::is_valid ( ) const

inlineoverridevirtualnoexcept

检查连接是否有效

返回

有效返回true

实现了 idb_connect.

在文件 mysql_connect.hpp 第 148 行定义.

prepare_statement()

NEFORCE_NODISCARD unique_ptr< idb_prepared_statement > mysql_connect::prepare_statement ( const string & sql ) const

overridevirtual

创建预处理语句

参数

sql	带占位符的SQL语句

返回

预处理语句对象

异常

database_stmt_exception

创建失败时抛出

实现了 idb_tb_connect.

引用了 prepare_statement().

被这些函数引用 prepare_statement().

query()

NEFORCE_NODISCARD unique_ptr< idb_tb_result > mysql_connect::query ( const string & sql ) const

overridevirtualnoexcept

执行查询SQL语句

参数

sql

SELECT语句

返回

查询结果集，失败返回空指针

实现了 idb_tb_connect.

引用了 query().

被这些函数引用 query().

reconnect()

NEFORCE_NODISCARD bool mysql_connect::reconnect ( const db_config & config )

overridevirtual

重新连接数据库

参数

config

连接配置

返回

重连成功返回true，失败返回false

关闭当前连接，使用新配置重新连接。

实现了 idb_connect.

set_character_set()

NEFORCE_NODISCARD bool mysql_connect::set_character_set ( const string & encoding ) const

overridevirtualnoexcept

设置字符集

参数

encoding

字符集名称

返回

设置成功返回true

实现了 idb_connect.

引用了 set_character_set().

被这些函数引用 set_character_set().

set_options()

NEFORCE_NODISCARD bool mysql_connect::set_options ( ::mysql_option option, const string & str ) const

noexcept

设置MySQL连接选项

参数

option	MySQL选项类型
str	选项值字符串

返回

设置成功返回true

引用了 set_options().

被这些函数引用 set_options().

update()

NEFORCE_NODISCARD bool mysql_connect::update ( const string & sql ) const

overridevirtualnoexcept

执行非查询SQL语句

参数

sql

SQL语句

返回

执行成功返回true

实现了 idb_connect.

引用了 update().

被这些函数引用 update().

---

该类的文档由以下文件生成:

• mysql_connect.hpp