附录1：主要接口

LuaSQL提供建立和管理与Vastbase G100 数据库连接、执行SQL 语句和对结果集进行储存管理的若干接口。主要接口说明如下：

env:connect(sourcename[,username[,password[,hostname[,port]]]])

此方法用于创建新的数据库会话并返回新的connection对象。参数说明如下：

返回值：connection对象（连接Vastbase G100数据库实例的对象）。

调用示例见附录2。

conn:execute(statement[vars_list])

此方法执行被参数化的SQL语句（即占位符，而不是SQL文字）。LuaSQL支持用％s标志的占位符。参数说明如下：

返回值：cursor对象。

调用示例见附录2。

conn:commit()

此方法将当前挂起的事务提交到数据库。

参数：无。

返回值：成功时返回true，当操作无法执行或未执行时返回false。

调用示例见附录2。

conn:rollback()

此方法回滚当前挂起事务。

参数：无。

返回值：成功时返回true，当操作无法执行或未执行时返回false。

调用示例见附录2。

cur:fetch([table[,modestring]])

此方法提取查询结果集的下一行，并返回一个元组。如果无参调用fetch，则结果值将直接返回给调用者。

参数说明如下：

返回值：data，或者如果没有更多行则返回nil。

调用示例见附录2。

cur:close()

此方法用于关闭该游标。

参数：无。

返回值：成功时返回true，该游标已经关闭则返回false。

调用示例见附录2。

conn:close()

此方法用于关闭连接conn。只有当与之相关的所有游标都已关闭且连接仍处于打开状态时才会成功。

参数：无。

返回值：成功时返回true，失败时返回false。

调用示例见附录2。

env:close()

此方法用于关闭该环境env。只有在所有与之相关的连接都先关闭的情况下才会成功。

参数：无。

返回值：成功时返回true，当该环境已经关闭时返回false。

调用示例见附录2。