OCI(Oracle Call Inte***ce)是由頭文件和庫函數等組成的一套Oracle數據庫應用程序編程接口工具,OCI程序實質上就是用高級語言寫的程序,其特點是內部含有對OCI子函數庫的調用。
OCI程序對開發環境的要求相對較低,只要有C語言的OCI開發工具包和C編譯器就可以,程序設計相比PRO*C復雜了點。
1、創建和初始化OCI環境
首先要在源程序中包含OCI頭文件:#include <oci.h>
OCI環境即OCI函數的工作環境,在調用其他函數之前必須先調用OCIInitialize()和OCIEnvInit()函數創建和初始化OCI環境,其他OCI函數要在這個環境中才能執行。
先定義變量:
OCIEnv** m_envhp;
OCIError* m_errhp;
OCIServer* m_srvhp;
OCISvcCtx* m_svchp;
OCIStmt * m_stmthp;
OCIInitialize(
(ub4) OCI_DEFAULT,
(dvoid *)0,
(dvoid * (*)(dvoid *, size_t))0,
(dvoid * (*)(dvoid *, dvoid *, size_t))0,
(void (*)(dvoid *, dvoid *))0
);
OCIEnvInit(
(OCIEnv **)&m_envhp,
OCI_DEFAULT, (size_t)0,
(dvoid **)0
);
其中m_envhp為輸出參數,是一個指向OCI環境句柄的指針,OCI_DEFAULT 是OCI環境的初始化模式。OCIEnvInit()函數中的size_t類型變量為分配給用戶的內存數量,dvoid **類型變量指向用戶的內存區域,該區域的大小等于size_t類型變量。
OCI函數中,大量使用OCI定義的數據類型和宏,其定義可參考$ORACLE_HOME/rdbms/demo目錄下的oci.h頭文件。
2、申請句柄
句柄是指向OCI庫所分配的內存區域的指針,該內存區域中的數據由OCI庫維護,應用程序可通過句柄訪問其中的數據。下面是應用程序中最常用的幾個句柄:
OCIHandleAlloc(
(dvoid *)m_envhp,
(dvoid **)&m_errhp,
OCI_HTYPE_ERROR,
(size_t)0,
(dvoid **)0
);
OCIHandleAlloc(
(dvoid *)m_envhp,
(dvoid **)&m_srvhp,
OCI_HTYPE_SERVER,
(size_t)0,
(dvoid **)0
);
OCIHandleAlloc(
(dvoid *)m_envhp,
(dvoid **)&m_svchp,
OCI_HTYPE_SVCCTX,
(size_t) 0,
(dvoid **)0
);
OCIHandleAlloc(
(dvoid *)m_envhp,
(dvoid **)&m_stmthp,
OCI_HTYPE_STMT,
(size_t)0,
(dvoid **)0
);
其中m_errhp為新申請的句柄,m_envhp為它的父環境句柄,OCI_HTYPE_ERROR為句柄類型,表示這是一個錯誤報告句柄,OCI_HTYPE_SERVER表示服務器句柄,OCI_HTYPE_SVCCTX表示服務環境句柄,OCI_HTYPE_STMT表示語句句柄。
存儲在句柄中的數據稱為句柄屬性,所有OCI句柄都具有屬性,可以調用OCIAttrGet()和OCIAttrSet()函數來讀取、設置句柄屬性。
3、連接服務器建立會話
首先調用
OCIServerAttach(m_srvhp, m_errhp, (text *)"", strlen(""), OCI_DEFAULT);
函數建立與指定服務器的連接,text *類型變量為空,表示連接默認數據庫服務,OCI_DEFAULT表示應用程序的操作模式為阻塞模式,在這種方式下,只有當OCI調用完成后才將控制權返回給客戶端應用程序。
然后調用
OCILogon(m_envhp,m_errhp, &m_svchp, (text*)m_szUser,strlen(m_szUser), (text*)m_szPassword, strlen(m_szPassword), (text*)m_szDbName, strlen(m_szDbName));
建立數據庫會話。此函數隱含申請服務器句柄和用戶會話句柄,登錄后,句柄是只讀的,不能再設置句柄屬性。
4、執行SQL語句并處理數據
將要執行的SQL語句copy到szSqlStr字符串中:
snprintf( szSqlStr, sizeof(szSqlStr), "select PASSWORD from USERS where USERNAME=’chen’ ");
執行下列語句:
OCIStmtPrepare(m_stmthp, m_errhp, (text*)szSqlStr, (ub4) strlen(szSqlStr), (ub4)OCI_NTV_SYNTAX, (ub4)OCI_DEFAULT); //準備SQL語句
OCIDefine *defnp0 = (OCIDefine *) 0; //定義輸出變量
OCIDefineByPos( m_stmthp, &defnp0, m_errhp, 1, (dvoid *)szUSERNAME, 100, SQLT_STR, (dvoid *) 0, (ub2 *)0, (ub2 *)0, OCI_DEFAULT); //綁定變量
OCIStmtExecute( m_svchp, m_stmthp, m_errhp, (ub4) 1, (ub4) 0, (OCISnapshot *) NULL,(OCISnapshot *) NULL, (ub4) OCI_DEFAULT); //執行SQL語句
5、結束會話斷開數據庫連接
OCILogoff( m_svchp, m_errhp );
6、斷開與數據源的連接,釋放句柄
OCIServerDetach( m_srvhp, m_errhp, OCI_DEFAULT ); //斷開與數據源的連接
OCIHandleFree((dvoid *) m_stmthp, OCI_HTYPE_STMT); //釋放句柄
OCIHandleFree((dvoid *) m_svchp, OCI_HTYPE_SVCCTX);
OCIHandleFree((dvoid *) m_srvhp, OCI_HTYPE_SERVER);
OCIHandleFree((dvoid *) m_errhp, OCI_HTYPE_ERROR)
3.7生成可執行文件(兩種方法)
(1)同普通的C程序:
gcc -o exampled –I. –I$(ORACLE_HOME)/precomp/public example.c
(2)利用Oracle自帶的Make文件:
首先將$ORACLE_HOME/rdbms/demo/demo_rdbms.mk文件copy到OCI源程序所在的目錄,將源文件編譯為目標文件:
#gcc –c example.o -I$(ORACLE_HOME)/rdbms/demo -I$(ORACLE_HOME)/network/public -I$(ORACLE_HOME)/rdbms/public/ example.c
然后用命令:#make -f demo_rdbms.mk build OBJ*=**ample.o EXE=exampled,exampled就為生成的可執行文件