pgsql_connect类 参考

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

#include <pgsql_connect.hpp>

类 pgsql_connect 继承关系图:

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

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

详细描述

PostgreSQL数据库连接类

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

主要功能：

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

在文件 pgsql_connect.hpp 第 42 行定义.

构造及析构函数说明

~pgsql_connect()

pgsql_connect::~pgsql_connect ( )

inlineoverride

析构函数

自动关闭数据库连接。

在文件 pgsql_connect.hpp 第 59 行定义.

引用了 idb_connect::close().

成员函数说明

connect()

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

overridevirtual

建立数据库连接

参数

config

连接配置

返回

连接成功返回true

根据配置构建连接字符串，建立PostgreSQL连接。 连接成功后刷新存活时间。

实现了 idb_connect.

connected()

NEFORCE_NODISCARD bool pgsql_connect::connected ( ) const

overridevirtual

检查连接是否已建立

返回

已连接返回true

实现了 idb_connect.

get_character_set()

NEFORCE_NODISCARD string_view pgsql_connect::get_character_set ( ) const

overridevirtual

获取当前字符集

返回

字符集名称

实现了 idb_connect.

get_errno()

NEFORCE_NODISCARD uint32_t pgsql_connect::get_errno ( ) const

inlineoverridevirtual

获取最后错误码

返回

错误码

实现了 idb_connect.

在文件 pgsql_connect.hpp 第 111 行定义.

get_error()

NEFORCE_NODISCARD string_view pgsql_connect::get_error ( ) const

inlineoverridevirtual

获取最后错误信息

返回

错误描述字符串

实现了 idb_connect.

在文件 pgsql_connect.hpp 第 105 行定义.

引用了 basic_string_view< CharT, Traits >::view().

is_valid()

NEFORCE_NODISCARD bool pgsql_connect::is_valid ( ) const

inlineoverridevirtual

检查连接是否有效

返回

有效返回true

实现了 idb_connect.

在文件 pgsql_connect.hpp 第 144 行定义.

引用了 idb_connect::connected().

prepare_statement()

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

overridevirtual

创建预处理语句

参数

sql	带占位符的SQL语句（使用$1, $2等）

返回

预处理语句对象

实现了 idb_tb_connect.

query()

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

overridevirtual

执行查询SQL语句

参数

sql

SELECT语句

返回

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

实现了 idb_tb_connect.

reconnect()

bool pgsql_connect::reconnect ( const db_config & config )

overridevirtual

重新连接数据库

参数

config

连接配置

返回

重连成功返回true

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

实现了 idb_connect.

set_character_set()

bool pgsql_connect::set_character_set ( const string & encoding ) const

overridevirtual

设置字符集

参数

encoding

字符集名称

返回

设置成功返回true

实现了 idb_connect.

update()

bool pgsql_connect::update ( const string & sql ) const

overridevirtual

执行非查询SQL语句

参数

sql

SQL语句

返回

执行成功返回true

实现了 idb_connect.

---

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

• pgsql_connect.hpp