怎么使用OCCI編程?

Oracle給各種編程語言都提供了編程接口，其中C++的編程模塊就是OCCI，通過OCCI我們可以很方便的訪問數(shù)據(jù)的信息，讀取數(shù)據(jù)庫的屬性，下面我們看看怎么使用OCCI編程。本文使用Centos 7.0為例，Oracle的版本是12.2

一，環(huán)境準備

1.1 默認的Oracle安裝中沒有提供OCCI接口的包，需要我們在Oracle官網(wǎng)下載，地址是：https://www.oracle.com/technetwork/topics/linuxsoft-082809.html

需要安裝下面幾個內(nèi)容:

oracle-instantclient12.2-devel-12.2.0.1.0-1.i386.rpm(606,868 bytes) (cksum - 1259587459)

oracle-instantclient12.2-basic-12.2.0.1.0-1.i386.rpm(49,071,616 bytes) (cksum - 2998080493)

oracle-instantclient12.2-odbc-12.2.0.1.0-2.i386.rpm(223,276 bytes) (cksum - 1211395846)

oracle-instantclient18.3-sqlplus-18.3.0.0.0-1.i386.rpm(689,504 bytes) (cksum - 3705787612)

直接運行 #rpm –i 包名.rpm 安裝即可。

1.2 安裝完成后需要設(shè)置環(huán)境變量，在~/.bashrc中或者/etc/profile中添加下面的命令設(shè)置環(huán)境變量。

exportORACLE_HOME=/usr/lib/oracle/12.2/client64

exportTNS_ADMIN=${ORACLE_HOME}/network/admin

exportNLS_LANG='SIMPLIFIED CHINESE_CHINA.AL32UTF8'

# simplifiedchinese_china.UTF8'

exportLD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${ORACLE_HOME}/lib

exportPATH=${ORACLE_HOME}/bin:$PATH

exportHISTTIMEFORMAT="%Y-%m-%d %H:%M:%S "

添加完成后記得source~/.bashrc 或者source /etc/profile，使得環(huán)境變量立即生效。

二，OCCI編程

Oracle C++調(diào)用接口（OCCI）是一個易于使用且功能強大的C ++用于訪問Oracle對象關(guān)系數(shù)據(jù)庫的接口。 OCCI對象interface是一種無縫且優(yōu)化的訪問和操作機制來自數(shù)據(jù)庫的持久數(shù)據(jù)作為C ++對象。使用Objects接口和導(dǎo)航訪問范例，有一個單一的對象模型應(yīng)用程序和數(shù)據(jù)庫。開發(fā)人員不需要實現(xiàn)任何用于將數(shù)據(jù)庫對象映射到C ++類對象的附加代碼。這是由OCCI通過編譯時生成的代碼和運行時支持完成。結(jié)合Oracle的對象關(guān)系特性，OCCI和C ++，復(fù)雜和可以開發(fā)強大的面向?qū)ο蟮臄?shù)據(jù)庫應(yīng)用程序。

OCCI為訪問和操作在數(shù)據(jù)庫中的對象提供了2種不同的模型。在導(dǎo)航訪問模型中（使用Fetch操作），引用數(shù)據(jù)庫中的對象到客戶端，如果這些引用被取消或者關(guān)閉時，那么就直接引用客戶端的對象緩存中。使用引用（作為屬性）和對對象之間的關(guān)系進行編程，應(yīng)用程序可以引用和取消引用中的關(guān)聯(lián)對象關(guān)系。在使用導(dǎo)航訪問模型的應(yīng)用程序中數(shù)據(jù)庫變得“不可見”，應(yīng)用程序似乎是“純粹的”C ++程序。

在OCCI的導(dǎo)航訪問模型中，客戶端對象緩存在透明的管理數(shù)據(jù)庫對象（表示為C ++對象）中，應(yīng)用程序可以立即使用/取消引用，創(chuàng)建/更新/刪除對象。如果一個引用m被應(yīng)用程序取消，OCCI會搜索緩存中引用的對象，如果存在則返回緩存的對象；如果在緩存中找不到對象，則從數(shù)據(jù)庫中獲取該對象。這種取消引用過程也被稱為數(shù)據(jù)庫術(shù)語中的混合或固定。提交事務(wù)時通過OCCI應(yīng)用程序，對象緩存刷新所有“臟”（new / updated / deleted）對象到數(shù)據(jù)庫所在的位置，操作反映在持久性存儲中。對象緩存維護指向C ++對象實例的指針表示相應(yīng)的數(shù)據(jù)庫對象。

在關(guān)聯(lián)訪問模型中，SQL查詢和DML語句是執(zhí)行以獲取和更新數(shù)據(jù)庫中的對象。 沒有任何作用關(guān)聯(lián)訪問模型中的對象緩存。

與大多數(shù)C++數(shù)據(jù)庫編程類似，OCCI也提供了基礎(chǔ)的編程接口，主要是Environment，Connection，ConnectionPool，Statement，ResultSet，MetaData等，這些對象的調(diào)用關(guān)系如下：

使用OCCI編程遵循以下幾個基本的操作步驟（不可缺省）

1，初始化環(huán)境Environment。在對象模式下初始化OCCI編程環(huán)境。您的應(yīng)用程序很可能需要在頭文件中包含數(shù)據(jù)庫對象的C ++類表示。

2，建立連接Connection。使用環(huán)境句柄建立與數(shù)據(jù)庫服務(wù)器的連接。

3，準備SQL語句statement。這是本地（客戶端）步驟，可能包括綁定占位符。在對象關(guān)系應(yīng)用程序中，此SQL語句應(yīng)該向?qū)ο蠓祷匾茫≧EF）。

4，訪問該對象，將準備好的語句與數(shù)據(jù)庫服務(wù)器關(guān)聯(lián)，然后執(zhí)行該語句。

5，關(guān)閉對象，關(guān)閉相關(guān)的ResultSet對象

6，釋放資源，關(guān)閉statement對象。

7，斷開鏈接，關(guān)閉Connection

8，封閉環(huán)境，終止Environment對象。

下面我給大家詳細介紹這幾個對象，以及碰到的注意事項。

2．1．1 Environment對象

Environment類提供OCCI環(huán)境來管理OCCI對象的內(nèi)存和其他資源。應(yīng)用程序可以具有多個OCCI環(huán)境。每個環(huán)境都有自己的堆和線程安全互斥體。Environment對象的方法以及用途如下：

我們用的最多的幾個Environment方法是：

createEnvironment()，創(chuàng)建鏈接環(huán)境。創(chuàng)建一個Environment對象。 它是使用setMemMgrFunctions（）方法中指定的指定內(nèi)存管理函數(shù)創(chuàng)建的。 如果未指定內(nèi)存管理器函數(shù)，則OCCI使用其自己的默認函數(shù)。最終必須關(guān)閉Environment對象以釋放它已獲取的所有系統(tǒng)資源。如果指定的模式是THREADED_MUTEXED或THREADED_UNMUTEXED，則所有三個內(nèi)存管理功能必須是線程安全的。

createConnection() 用來創(chuàng)建一個指向數(shù)據(jù)庫的鏈接，其調(diào)用方式是：

Connection * createConnection(

const string&userName,

const string&password,

const string&connectString="")=0;

另外還有幾個重載的函數(shù)，

Connection * createConnection(

const string&userName,

const string&password,

const string&connectString,

const string&connectionClass,

constConnection::Purity &purity)=0;

可以用來創(chuàng)建一個駐留在連接池的鏈接。如果指定connectionClass參數(shù)，則可以創(chuàng)建UTF16的鏈接池，此時需要在Environment中設(shè)置OCCIUTIF16模式。

createConnectionPool()，創(chuàng)建連接，可以指定UNICODE和非UNICODE的兩種方式。其實Oracle數(shù)據(jù)庫包含一個名為SYS_DEFAULT_CONNECTION_POOL的默認連接池。 默認情況下，此池已創(chuàng)建，但尚未啟動。 要啟用數(shù)據(jù)庫駐留連接池，必須顯式啟動連接池。

您可以使用DBMS_CONNECTION_POOL包中的過程根據(jù)您的用法配置連接池。在Oracle Real Application Clusters（RAC）環(huán)境中，配置參數(shù)適用于每個Oracle RAC實例。

在SQLPlus命令行中，運行EXECUTE DBMS_CONNECTION_POOL.START_POOL(); 就可以啟動或一個連接池。

使用 EXECUTE DBMS_CONNECTION_POOL.ALTER_PARAM ('','MINSIZE','10'); 可以配置連接池的參數(shù)。

使用 EXECUTE DBMS_CONNECTION_POOL.STOPT_POOL(); 可以關(guān)閉連接池。

2．1．2 Connection對象

Connection類表示與特定數(shù)據(jù)庫的連接。同時提供了在連接的上下文中，執(zhí)行SQL語句并返回結(jié)果。其常用的方法有：

其中Connection對象中最常用的方法就是Commit,rollback, CreateStatement, ternminateStatement等，這些方法是必要，也是大家經(jīng)常使用到的，其使用方法和其他的標準SQL方法是一致的，我這里不再贅述了。

2．1．3 Statement對象

Statement對象用于執(zhí)行SQL語句。 該語句可以是返回結(jié)果集的查詢，也可以是返回更新計數(shù)的非查詢語句。 非查詢SQL可以是insert，update或delete語句。 非查詢SQL語句也可以是DML語句（例如create，grant等）或存儲過程調(diào)用。

查詢，插入/更新/刪除或存儲過程調(diào)用語句可以具有IN綁定參數(shù)，而存儲過程調(diào)用語句可以具有OUT綁定參數(shù)或綁定IN和OUT參數(shù)，稱為IN / OUT參數(shù)。

每次創(chuàng)建Statement對象時，都會有內(nèi)存和資源等資源必須在客戶端和服務(wù)器端分配游標才能存儲該對象及其數(shù)據(jù)。為了節(jié)省內(nèi)存的重新分配，請嘗試重用Statement對象。創(chuàng)建Statement對象后，只需使用它們即可重用它們，setSQL方法，如下例所示

Connection* conn = env->createConnection();

Statement* stmt = conn->createStatement();

stmt->setSQL(“INSERT INTO fruit_basket_tab VALUES(‘Apples’,3)”);

stmt->executeUpdate();

stmt->setSQL(“INSERT INTO fruit_basket_tabVALUES(‘Oranges’, 4)”);

stmt->executeUpdate();

stmt->setSQL(“INSERT INTO fruit_basket_tabVALUES(‘Bananas’, 1)”);

stmt->executeUpdate();'

stmt->setSQL(“SELECT * FROM fruit_basket_tab WHEREquantity > 2”);

為了節(jié)省更多的內(nèi)存重新分配，可以參數(shù)化將前三個SQL語句合并為一個，設(shè)置參數(shù)，然后執(zhí)行。但是，更改輸入?yún)?shù)類型，因為必須執(zhí)行重新綁定每次類型改變。以下示例演示了參數(shù)化：

stmt->setSQL(“INSERT INTOfruit_basket_tab VALUES(:1, :2)”);

stmt->setString( 1, “Apples” );

stmt->setInt( 2, 3 );

stmt->executeUpdate();

stmt->setString( 1, “Oranges” );

stmt->setInt( 2, 4 );

stmt->executeUpdate();

stmt->setString( 1, “Bananas” );

stmt->setInt( 2, 1 );

stmt->executeUpdate();

對于經(jīng)常分批進行的一些操作，浪費了很多時間網(wǎng)絡(luò)往返服務(wù)器的通信時間。 OCCI提供了一個在單個網(wǎng)絡(luò)中發(fā)送多行信息的有效機制往返。此優(yōu)化適用于INSERT，UPDATE和DELETE。首先，您必須設(shè)置最大迭代次數(shù)，然后設(shè)置最大值可變長度參數(shù)的參數(shù)大小。參數(shù)不能更改類型迭代操作。以下是上述INSERT的優(yōu)化形式：

//prepare the batching process

stmt->setMaxIterations( 3 );

stmt->setMaxParamSize( 1, 8 );

//”Bananas” is longest param

//批處理操作開始。

stmt->setSQL(“INSERT INTOfruit_basket_tab VALUES(:1, :2)”);

stmt->setString( 1, “Apples” );

stmt->setInt( 2, 3 );

stmt->addIteration(); // 添加迭代子。

stmt->setString( 1, “Oranges” );

stmt->setInt( 2, 4 );

stmt->addIteration();

stmt->setString( 1, “Bananas” );

stmt->setInt( 2, 1 );

//execute the statements

stmt->executeUpdate();

2．1．4 ResultSet對象

ResultSet提供對通過執(zhí)行Statement生成的數(shù)據(jù)表的訪問。按行順序檢索表行。在一行中，可以按任何順序訪問列值。ResultSet維護指向其當前數(shù)據(jù)行的游標。最初，光標位于第一行之前。下一個方法將光標移動到下一行。getxxx（）方法檢索當前行的列值。您可以使用列的索引號檢索值。列從1開始編號。對于getxxx（）方法，OCCI嘗試將基礎(chǔ)數(shù)據(jù)轉(zhuǎn)換為指定的C ++類型并返回C ++值。 SQL類型使用ResultSet ::getxxx（）方法映射到C ++類型。ResultSet列的數(shù)量，類型和屬性由getColumnListMetaData（）方法返回的MetaData對象提供。其常用的方法有：

2．1．5 MetaData對象

MetaData對象可用于描述ResultSet中列的類型和屬性，或數(shù)據(jù)庫中的現(xiàn)有模式對象。它還提供有關(guān)整個數(shù)據(jù)庫的信息。

MetaData類為Oracle提供大量的屬性值說明，包括表的屬性，列以及數(shù)據(jù)的屬性，我們可以根據(jù)屬性值來判斷該數(shù)據(jù)庫對象的屬性。常用的有：

具體的類型值的說明可以參考Oracle的官方文檔。

在數(shù)據(jù)庫編程中，OCCI其實用的不是非常多，也就造成了在實際應(yīng)用中可以查詢的資料不多，往往給編程者帶了困難。作者在多次踩坑以后總結(jié)出上述資料，比較詳細的介紹OCCI編程中常用的對象。希望可以和大家保持溝通和交流，互相學(xué)習(xí)和提高, 更多的C++知識，請關(guān)注《C語言專家集中營》。