Environment类

Environment类提供了一个ACCI环境来为ACCI对象管理内存和其他资源。 应用程序可以有多个ACCI环境。每个环境都有自己的堆和线程安全互斥锁。

环境类使用的枚举值

属性	选项
Mode	DEFAULT用于创建环境对象；它没有线程安全性或对象支持。 OBJECT用于创建环境对象；它使用对象特性。（暂不支持） SHARED用于创建环境对象。（暂不支持） NO_USERCALLBACKS用于创建环境对象；它不支持用户回调。（暂不支持） THREADED_MUTEXED是用于创建环境对象的线程安全模式，由ACCI在内部进行互斥。 THREADED_UNMUTEXED是创建环境对象的线程安全模式；客户端负责互斥。（暂不支持） EVENT支持注册神通Streams高级队列中使用的事件通知。（暂不支持） USE_LDAP支持注册LDAP。（暂不支持）

createBulkImport

创建大容量导入实例

语法

BulkImport* createBulkImport(

        const ACCI_STD_NAMESPACE::string &tableName,

        const ACCI_STD_NAMESPACE::string schema = "",

        int bufferSize = 10485760,

        int rowPer = 0,

        const ACCI_STD_NAMESPACE::string formatString = "") =0;

参数	描述
tableName	表名
schema	模式名
bufferSize	缓存区大写，单位字节
rowPer	每次导入的记录数
formatString	表的格式字符串

createConnection()

建立到指定数据库的连接。(UString为utf16支持)

参数	描述
Connection * createConnection( const string &userName const string &password const string &connectString	要连接的用户名。 用户的密码。 建立连接的数据库。
Connection * createConnection( const UString &userName const UString &password const UString &connectString	要连接的用户名。 用户的密码。 建立连接的数据库。

createConnectionPool()

根据指定的参数创建连接池。(UString为字符集支持)

参数	描述
ConnectionPool * createConnectionPool const string &poolUserName const string &poolPassword const string &connectString unsigned int minConn unsigned int maxConn unsigned intincrConn	池的用户名 池的密码。 服务器的连接字符串 池中的最小连接数。此方法打开的连接的最小数目。只有在 必要时才打开其他连接。通常，minConn应该设置为应用程 序预期运行的并发语句的数量。 池中的最大连接数。有效值为1或更大。 如果当前连接数小于maxConn，则增加要打开的连接数的增 量。有效值为1或更大。
const UString &poolUserName const UString &poolPassword const UString &connectString unsigned int minConn unsigned int maxConn unsigned int incrConn	池的用户名 池的密码。 服务器的连接字符串 池中的最小连接数。此方法打开的连接的最小数目。只有在 必要时才打开其他连接。通常，minConn应该设置为应用程 序预期运行的并发语句的数量。 池中的最大连接数。有效值为1或更大。 如果当前连接数小于maxConn，则增加要打开的连接数的增 量。有效值为1或更大。

createEnvironment()

创建环境对象环境对象最终必须关闭，以释放它已获得的所有系统资源。

语法	描述
static Environment * createEnvironment( Mode mode = DEFAULT, void *ctxp = 0, void *(*malocfp)(void *ctxp,size_t size) = 0, void *(*ralocfp)(void *ctxp,void *memptr,size_t newsize) = 0, void (*mfreefp)(void *ctxp,void *memptr) = 0);	创建默认环境。
static Environment * createEnvironment( const string &charset, const string &ncharset, Mode mode = DEFAULT, void *ctxp = 0, void *(*malocfp)(void *ctxp,size_t size) = 0, void *(*ralocfp)(void *ctxp,void *memptr, size_t newsize) = 0, void (*mfreefp)(void *ctxp,void *memptr) = 0);	使用指定的字符集 和创建一个环境。

参数	描述
mode	模式(仅支持DEFAULT)
ctxp	不支持
size	不支持
newsize	不支持
memptr	不支持
malocfp	不支持
ralocfp	不支持
mfreefp	不支持
charset	指定的字符集id。
ncharset	指定的字符集id。

getACIEnvironment()

返回一个指向与此环境关联的ACI环境的指针。

语法

ACIEnv *getOCIEnvironment() const;

terminateBulkImport()

关闭大容量导入实例。

语法

void terminateBulkImport(

   BulkImport* import);

参数	描述
import	想要关闭的大容量导入实例。

terminateConnection()

关闭与环境的连接，并释放所有相关的系统资源。

语法

void terminateConnection(

    Connection *connection);

参数	描述
connection	指向要终止的连接实例的指针。

terminateConnectionPool()

关闭连接池中的连接，释放所有相关的系统资源。

语法

void terminateConnectionPool(

   ConnectionPool *poolPointer);

参数	描述
poolPointer	指向要终止的连接池实例的指针。

terminateEnvironment()

关闭环境，释放所有相关的系统资源。

语法

void terminateEnvironment(

    Environment *env);

参数	描述
env	要关闭的环境

setErrorLanguage()

设置错误信息输出语言。

语法

sword setErrorLanguage(bool language);

参数	描述
language	true：中文 false：英文

getClientVersion()

获取客户端版本信息。

语法

void getClientVersion(
       int &majorVersion,
       int &minorVersion,
       int &updateNum,
       int &patchNum,
       int &portUpdateNum );

参数	描述
majorVersion	客户端库的主要版本。
minorVersion	客户端库的次要版本。
updateNum	更新号。
patchNum	应用于库的补丁程序号。
portUpdateNum	应用于库的特定于端口的端口更新的编号。

getOCIError()

获取ACIerror句柄

语法

ACIError * getOCIError();

getMyLogIns()

获取ACCIMyLog句柄

语法

ACCIMyLog* getMyLogIns();