eiendb::PgsqlConnection类 参考

#include <eiendb_pgsql.hpp>

类 eiendb::PgsqlConnection 继承关系图:

eiendb::PgsqlConnection 的协作图:

Public 成员函数
	PgsqlConnection (winux::String const &host, winux::String const &user, winux::String const &pwd, winux::String const &dbName, winux::String const &linkCharset, winux::String const &schema="public", winux::String const &options="", winux::Mixed *dbConfig=nullptr, bool doConnect=true)
	PgsqlConnection 构造函数 更多...
virtual	~PgsqlConnection ()
virtual bool	connect () override
	连接数据库 更多...
virtual bool	close () override
	关闭连接 更多...
virtual void	alive () override
	确保该连接有效（还活着） 更多...
virtual bool	selectDb (winux::String const &database) override
	选定要操作的数据库 更多...
virtual bool	setLinkCharset (winux::String const &charset) override
	设置连接校验字符集 更多...
virtual bool	createDb (winux::String const &database) override
	创建一个库 更多...
virtual bool	dropDb (winux::String const &database) override
	删除数据库 更多...
virtual size_t	affectedRows () override
	受影响的行数 更多...
virtual size_t	insertId () override
	获得最后一次完成记录插入时的ID值 更多...
virtual int	errNo () override
	获得错误号 更多...
virtual winux::String	error () override
	获得错误信息 更多...
virtual winux::SharedPointer< IDbResult >	query (winux::String const &sql) override
	查询数据结果 更多...
virtual winux::SharedPointer< IDbResult >	query (winux::SharedPointer< IDbStatement > stmt) override
	查询数据结果 更多...
virtual bool	exec (winux::String const &sql) override
	不需要数据的查询 更多...
virtual bool	exec (winux::SharedPointer< IDbStatement > stmt) override
	不需要数据的查询 更多...
virtual winux::String	escape (winux::String const &str, winux::String const &addQuote="\'") override
	普通文本转成SQL语句安全的文本，用做SQL语句的字符串 更多...
virtual winux::String	escape (void const *buf, size_t size, winux::String const &addQuote="\'") override
	二进制数据转成SQL语句安全的文本，用做SQL语句的字符串 更多...
virtual winux::SharedPointer< IDbResult >	listDbs () override
	获得所有数据库的一个结果集 更多...
virtual winux::SharedPointer< IDbResult >	listFields (winux::String const &tableName) override
	获得数据库里某表所有字段的一个结果集 更多...
virtual winux::SharedPointer< IDbResult >	listTables () override
	获得数据库里所有表的一个结果集 更多...
virtual winux::String	tableDdl (winux::String const &tableName) override
	取得一张表的DDL 更多...
virtual winux::String	symbolQuotes (winux::String const &str, bool periodAsSeparator=true) override
	加入标识符的引用标记。如表名、字段名等等 更多...
virtual size_t	loadSqlFile (winux::IFile *sqlFile, winux::StringArray *arrSql) override
	加载SQL文件到一个字符串数组，返回语句条数 更多...
virtual size_t	getPrimaryKey (winux::String const &tableName, winux::StringArray *arrKeyColumn) override
	取得表的主键，返回主键字段数 更多...
virtual winux::SharedPointer< IDbStatement >	buildStmt (winux::String const &sql, winux::Mixed const &params=winux::mxNull) override
	构造一个语句对象 更多...
virtual	operator bool () const override
	判断一个连接是否有效 更多...
	operator DbHandle () const
Public 成员函数 继承自 eiendb::IDbConnection
virtual	~IDbConnection ()

友元
class	PgsqlResult
class	PgsqlModifier

详细描述

在文件 eiendb_pgsql.hpp 第 21 行定义.

构造及析构函数说明

eiendb::PgsqlConnection::PgsqlConnection	(	winux::String const &	host,
		winux::String const &	user,
		winux::String const &	pwd,
		winux::String const &	dbName,
		winux::String const &	linkCharset,
		winux::String const &	schema = "public",
		winux::String const &	options = "",
		winux::Mixed *	dbConfig = nullptr,
		bool	doConnect = true
	)

PgsqlConnection 构造函数

参数

host	主机或主机列表 IP[:PORT][, ...]
user	用户名
pwd	密码
dbName	数据库名
linkCharset	连接校验字符集
schema	模式名。默认"public"
options	发送给服务器的命令行选项 eg. "-c geqo=off"
dbConfig	一些数据库特有的配置
doConnect	是否连接数据库。默认true

virtual eiendb::PgsqlConnection::~PgsqlConnection ( )

virtual

成员函数说明

virtual bool eiendb::PgsqlConnection::connect ( )

overridevirtual

连接数据库

重载 eiendb::IDbConnection .

virtual bool eiendb::PgsqlConnection::close ( )

overridevirtual

关闭连接

重载 eiendb::IDbConnection .

virtual void eiendb::PgsqlConnection::alive ( )

overridevirtual

确保该连接有效（还活着）

重载 eiendb::IDbConnection .

virtual bool eiendb::PgsqlConnection::selectDb ( winux::String const &  database )

overridevirtual

选定要操作的数据库

参数

database

数据库名

返回

bool 是否成功

重载 eiendb::IDbConnection .

virtual bool eiendb::PgsqlConnection::setLinkCharset ( winux::String const &  charset )

overridevirtual

设置连接校验字符集

参数

charset

字符集

前置条件

连接数据库之后

返回

bool

重载 eiendb::IDbConnection .

virtual bool eiendb::PgsqlConnection::createDb ( winux::String const &  database )

overridevirtual

创建一个库

参数

database

数据库名

返回

bool

重载 eiendb::IDbConnection .

virtual bool eiendb::PgsqlConnection::dropDb ( winux::String const &  database )

overridevirtual

删除数据库

参数

database

数据库名

返回

bool

重载 eiendb::IDbConnection .

virtual size_t eiendb::PgsqlConnection::affectedRows ( )

overridevirtual

受影响的行数

前置条件

在改变数据库内容或结构之后

返回

size_t

重载 eiendb::IDbConnection .

virtual size_t eiendb::PgsqlConnection::insertId ( )

overridevirtual

获得最后一次完成记录插入时的ID值

您可以用执行SQL里的LAST_INSERT_ID()代替此函数

返回

size_t

重载 eiendb::IDbConnection .

virtual int eiendb::PgsqlConnection::errNo ( )

overridevirtual

获得错误号

返回

int

返回值

0	没有错误
非0	出错。可用error()查看错误信息

重载 eiendb::IDbConnection .

virtual winux::String eiendb::PgsqlConnection::error ( )

overridevirtual

获得错误信息

返回

string

重载 eiendb::IDbConnection .

virtual winux::SharedPointer<IDbResult> eiendb::PgsqlConnection::query ( winux::String const &  sql )

overridevirtual

查询数据结果

参数

sql

string

返回

SharedPointer<IDbResult>

重载 eiendb::IDbConnection .

virtual winux::SharedPointer<IDbResult> eiendb::PgsqlConnection::query ( winux::SharedPointer< IDbStatement >  stmt )

overridevirtual

查询数据结果

参数

stmt	SharedPointer<IDbStatement>

返回

SharedPointer<IDbResult>

重载 eiendb::IDbConnection .

virtual bool eiendb::PgsqlConnection::exec ( winux::String const &  sql )

overridevirtual

不需要数据的查询

这函数可以用来执行INSERT、UPDATE、DROP等等一些不需要查询数据的操作

参数

sql

string

返回

bool 是否成功，改变的行数可用affectedRows()取得

重载 eiendb::IDbConnection .

virtual bool eiendb::PgsqlConnection::exec ( winux::SharedPointer< IDbStatement >  stmt )

overridevirtual

不需要数据的查询

这函数可以用来执行INSERT、UPDATE、DROP等等一些不需要查询数据的操作

参数

stmt	SharedPointer<IDbStatement>

返回

bool 是否成功，改变的行数可用affectedRows()取得

重载 eiendb::IDbConnection .

virtual winux::String eiendb::PgsqlConnection::escape ( winux::String const &  str, winux::String const &  addQuote = "\'"  )

overridevirtual

普通文本转成SQL语句安全的文本，用做SQL语句的字符串

参数

str	String 需要换码的字符串
addQuote	String 表示需要在首尾加上的引号，为空则不加

返回

String

重载 eiendb::IDbConnection .

virtual winux::String eiendb::PgsqlConnection::escape ( void const *  buf, size_t  size, winux::String const &  addQuote = "\'"  )

overridevirtual

二进制数据转成SQL语句安全的文本，用做SQL语句的字符串

参数

buf	void const *
size	size_t
addQuote	winux::String const &

返回

String

重载 eiendb::IDbConnection .

virtual winux::SharedPointer<IDbResult> eiendb::PgsqlConnection::listDbs ( )

overridevirtual

获得所有数据库的一个结果集

返回

SharedPointer<IDbResult>

重载 eiendb::IDbConnection .

virtual winux::SharedPointer<IDbResult> eiendb::PgsqlConnection::listFields ( winux::String const &  tableName )

overridevirtual

获得数据库里某表所有字段的一个结果集

参数

tableName

表名

返回

SharedPointer<IDbResult>

重载 eiendb::IDbConnection .

virtual winux::SharedPointer<IDbResult> eiendb::PgsqlConnection::listTables ( )

overridevirtual

获得数据库里所有表的一个结果集

返回

SharedPointer<IDbResult>

重载 eiendb::IDbConnection .

virtual winux::String eiendb::PgsqlConnection::tableDdl ( winux::String const &  tableName )

overridevirtual

取得一张表的DDL

重载 eiendb::IDbConnection .

virtual winux::String eiendb::PgsqlConnection::symbolQuotes ( winux::String const &  str, bool  periodAsSeparator = true  )

overridevirtual

加入标识符的引用标记。如表名、字段名等等

参数

str	数据库各种对象标识符
periodAsSeparator	句点是否当作分隔符，默认true

返回

winux::String 加入左右俩标记的标识符

重载 eiendb::IDbConnection .

virtual size_t eiendb::PgsqlConnection::loadSqlFile ( winux::IFile *  sqlFile, winux::StringArray *  arrSql  )

overridevirtual

加载SQL文件到一个字符串数组，返回语句条数

重载 eiendb::IDbConnection .

virtual size_t eiendb::PgsqlConnection::getPrimaryKey ( winux::String const &  tableName, winux::StringArray *  arrKeyColumn  )

overridevirtual

取得表的主键，返回主键字段数

重载 eiendb::IDbConnection .

virtual winux::SharedPointer<IDbStatement> eiendb::PgsqlConnection::buildStmt ( winux::String const &  sql, winux::Mixed const &  params = winux::mxNull  )

overridevirtual

构造一个语句对象

重载 eiendb::IDbConnection .

virtual eiendb::PgsqlConnection::operator bool ( ) const

overridevirtual

判断一个连接是否有效

实现了 eiendb::IDbConnection.

eiendb::PgsqlConnection::operator DbHandle

(

)

const

友元及相关函数文档

friend class PgsqlResult

friend

在文件 eiendb_pgsql.hpp 第 91 行定义.

friend class PgsqlModifier

friend

在文件 eiendb_pgsql.hpp 第 92 行定义.

---

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

• eiendb_pgsql.hpp