211 OWA_CACHE

OWA_CACHEパッケージは、PL/SQL GatewayキャッシュでPL/SQL Webアプリケーションの性能を向上できるようにするためのインタフェースを提供します。

関連項目: このパッケージの実装の詳細は、次のマニュアルを参照してください。 『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』 『Oracle Fusion Middleware mod_plsqlユーザーズ・ガイド』

この章では、次の項目について説明します。

• OWA_CACHEの使用方法

  • 定数

• OWA_CACHEサブプログラムの要約

OWA_CACHEの使用方法

• 定数

定数

• system_level CONSTANT VARCHAR(6) := 'SYSTEM';

• user_level CONSTANT VARCHAR(4) := 'USER';

OWA_CACHEサブプログラムの要約

表211-1 OWA_CACHEパッケージのサブプログラム

サブプログラム	説明
DISABLEプロシージャ	指定した特定の要求に対するキャッシュを使用禁止にします。
GET_ETAGファンクション	キャッシュされた内容に関連するタグを戻します(検証テクニック・モデルのみで使用)。
GET_LEVELファンクション	キャッシュ・レベルを戻します(検証テクニック・モデルのみで使用)。
SET_CACHEプロシージャ	検証モデル・キャッシュ・タイプのキャッシュ・ヘッダーを設定します。
SET_EXPIRESプロシージャ	期限切れモデル・キャッシュ・タイプのキャッシュ・ヘッダーを設定します。
SET_NOT_MODIFIEDプロシージャ	変更なしキャッシュ・ヒットのヘッダーを設定します(検証テクニック・モデルのみで使用)。
SET_SURROGATE_CONTROLプロシージャ	Webキャッシュのサロゲート制御ヘッダーに使用するヘッダーを設定します。

DISABLEプロシージャ

このプロシージャは、指定した特定の要求に対するキャッシュを使用禁止にします。

構文

OWA_CACHE.DISABLE;

GET_ETAGファンクション

キャッシュされた内容に関連するタグを戻します。検証方式でのみ使用します。

構文

OWA_CACHE.GET_ETAG
  RETURN VARCHAR2;

戻り値

キャッシュ・ヒットのタグ。それ以外はNULLが戻されます。

GET_LEVELファンクション

キャッシュ・レベルを返します。検証方式モデルでのみ使用します。

構文

OWA_CACHE.GET_LEVEL
  RETURN VARCHAR2;

戻り値

キャッシュ・ヒットのキャッシュ・レベル文字列('USER'または'SYSTEM')。それ以外はNULLが戻されます。

SET_CACHEプロシージャ

検証モデル・キャッシュ・タイプのキャッシュ・ヘッダーを設定します。

構文

OWA_CACHE.SET_CACHE(
   p_etag        IN       VARCHAR2,
   p_level       IN       VARCHAR2);

パラメータ

表211-2 SET_CACHEプロシージャのパラメータ

パラメータ	説明
p_etag	指定した内容に関連するetag。
p_level	キャッシュ・レベル('USER'または'SYSTEM')。

例外

次の場合はVALUE_ERRORがスローされます。

• p_etagが55より大きい場合

• p_levelが'USER'または'SYSTEM'ではない場合

SET_EXPIRESプロシージャ

このプロシージャは、期限切れモデル・キャッシュ・タイプのキャッシュ・ヘッダーを設定します。

構文

OWA_CACHE.SET_EXPIRES(
   p_expires      IN       NUMBER,
   p_level        IN       VARCHAR2);

パラメータ

表211-3 SET_EXPIRESプロシージャのパラメータ

パラメータ	説明
p_expires	指定した内容の有効期間(分)。
p_level	キャッシュ・レベル('USER'または'SYSTEM')。

例外

次の場合はVALUE_ERRORがスローされます。

• p_expiresが負の値または0の場合

• p_levelが'USER'または'SYSTEM'ではない場合

• p_expiresが525600(1年)より大きい場合

SET_NOT_MODIFIEDプロシージャ

変更なしキャッシュ・ヒットのヘッダーを設定します。検証方式でのみ使用します。

構文

OWA_CACHE.SET_NOT_MODIFIED;

例外

etagが渡されていない場合は、VALUE_ERRORがスローされます。

SET_SURROGATE_CONTROLプロシージャ

このプロシージャは、Webキャッシュのサロゲート制御ヘッダーに使用するヘッダーを設定します。

構文

OWA_CACHE.SET_SURROGATE_CONTROL(
   p_value        IN       VARCHAR2);

パラメータ

表211-4 SET_SURROGATE_CONTROLプロシージャのパラメータ

パラメータ	説明
p_value	サロゲート制御ヘッダーとして渡される値。

例外

p_valueの長さが55よりも長い場合は、VALUE_ERRORがスローされます。