Oracle Tuxedo Distributed Caching (TDC)のプログラミング

ここでは、以下の内容について説明します。

•	Oracle Tuxedo Distributed Caching (TDC)関連のATMI APIの使用

•	キャッシュへのOracle Tuxedoバッファの格納

•	キャッシュからのOracle Tuxedoバッファの取得

•	キャッシュからのOracle Tuxedoバッファの削除

Oracle Tuxedo Distributed Caching (TDC)関連のATMI APIの使用

 

表3-1 Oracle Tuxedo Distributed Caching (TDC)関連のATMI API

名前	説明
tpgetcache(3c)	構成に従ってOracle Tuxedoキャッシュ・ハンドルを取得します。
tpcacheput(3c)	Oracle Tuxedo型付きバッファをキーに関連付けてキャッシュに格納します。
tpcacheget(3c)	キーに関連付けられているOracle Tuxedo型付きバッファをキャッシュから取得します。
tpcacheremove(3c)	パラメータkeyに関連付けられているキャッシュ・エントリをキャッシュから削除します。
tpcachemremove(3c)	パラメータkeyarrayに関連付けられているキャッシュ・エントリをキャッシュから削除します。
tpcacheremoveall(3c)	キャッシュからすべてのキャッシュ・エントリを削除します。

前述のAPIの詳細は、「セクション3c - C関数」を参照してください。

キャッシュへのOracle Tuxedoバッファの格納

Oracle TuxedoクライアントまたはサーバーでTDC APIのtpgetcacheおよびtpcacheputを使用すると、キーに関連付けられたOracle TuxedoバッファをOracle Tuxedoキャッシュに格納できます。

tpgetcacheおよびtpcacheputの詳細は、「Oracle Tuxedo Distributed Caching (TDC)関連のATMI APIの使用」を参照してください。

リスト3-1 キーに関連付けられたOracle TuxedoバッファのOracle Tuxedoキャッシュへの格納

...

	TCACHE* mycache = NULL;

	char mykey[128];

	char* databuf = NULL;

	tpinit(NULL);

	databuf = tpalloc("STRING", NULL, 256);

	mycache = tpgetcache("tc");

	strcpy(mykey, "myname");

	strcpy(databuf, "scott");

	tpcacheput(mycache, mykey, databuf, 0, 0L);

	tpfree(databuf);

...

 

キャッシュからのOracle Tuxedoバッファの取得

Oracle TuxedoクライアントまたはサーバーでTDC APIのtpgetcacheおよびtpcachegetを使用すると、キーに従ってOracle TuxedoキャッシュからOracle Tuxedo型付きバッファを取得できます。

tpgetcacheおよびtpcachegetの詳細は、「Oracle Tuxedo Distributed Caching (TDC)関連のATMI APIの使用」を参照してください。

リスト3-2 キーに従ったOracle TuxedoキャッシュからのOracle Tuxedoバッファの取得

...

	TCACHE* mycache = NULL;

	char mykey[128];

	char* databuf = NULL;

	tpinit(NULL);

	databuf = tpalloc("STRING", NULL, 256);

	mycache = tpgetcache("tc");

	strcpy(mykey, "myname");

	tpcacheget(mycache, mykey, &databuf, NULL, 0L);

	tpfree(databuf);

...

 

キャッシュからのOracle Tuxedoバッファの削除

Oracle TuxedoクライアントまたはサーバーでTDC APIのtpgetcacheおよびtpcacheremoveを使用すると、キーに関連付けられたOracle TuxedoバッファをOracle Tuxedoキャッシュから削除できます。例は、リスト3-3を参照してください。

また、TDC APIのtpcachemremoveを使用して複数のOracle Tuxedoバッファを一度に削除したり、TDC APIのtpcacheremoveallを使用してOracle TuxedoキャッシュからすべてのOracle Tuxedoバッファを削除できます。これらのTDC APIの詳細は、「Oracle Tuxedo Distributed Caching (TDC)関連のATMI API」を参照してください。

リスト3-3 キーに関連付けられたOracle TuxedoバッファのOracle Tuxedoキャッシュからの削除

...

TCACHE* mycache = NULL; char mykey[128];

char* databuf = NULL;

tpinit(NULL);

databuf = tpalloc("STRING", NULL, 256);

mycache = tpgetcache("tc"); strcpy(mykey, "myname"); 

tpcacheremove(mycache, mykey,0L);

tpfree(databuf);

...