23 APEX_REGION

APEX_REGIONパッケージは、リージョンを処理するためのパブリックAPIです。

• IS_READ_ONLYファンクション

• PURGE_CACHEプロシージャ

IS_READ_ONLYファンクション

このファンクションは、現在のリージョンが読取り専用でレンダリングされている場合にはTRUEを、リージョンが読取り専用でレンダリングされていない場合にはFALSEを戻します。現在処理されているリージョンがないというコンテキストからこのファンクションがコールされた場合は、NULLを戻します。たとえば、リージョンまたはその基礎となるアイテムおよびボタンの条件でこのファンクションを使用できます。

構文

FUNCTION IS_READ_ONLY 
RETURN BOOLEAN;
    

パラメータ

なし。

例

この例では、アプリケーション全体についてセッション固有のリージョン・キャッシュをパージします。

RETURN APEX_REGION.IS_READ_ONLY;

PURGE_CACHEプロシージャ

このプロシージャは、指定されたアプリケーション、ページおよびリージョンのリージョン・キャッシュをパージします。

構文

PROCEDURE PURGE_CACHE (
    p_application_id       IN NUMBER DEFAULT wwv_flow.g_flow_id,
    p_page_id              IN NUMBER DEFAULT NULL,
    p_region_id            IN NUMBER DEFAULT NULL,
    p_current_session_only IN BOOLEAN DEFAULT FALSE );

パラメータ

表23-1 PURGE_CACHEのパラメータ

パラメータ	説明
p_application_id	リージョン・キャッシュをパージするアプリケーションのID。デフォルトは、現在のアプリケーションです。
p_page_id	リージョン・キャッシュをパージするページのID。値を指定しないと(デフォルト)、アプリケーションのすべてのリージョンがパージされます。
p_region_id	ページ上の特定リージョンのID。値を指定しないと、指定されたページのすべてのリージョンがパージされます。
p_current_session_only	現在のセッション用に保存されたエントリのみをパージする場合は、TRUEを指定します。デフォルトは、FALSEです。

例

この例では、アプリケーション全体についてセッション固有のリージョン・キャッシュをパージします。

BEGIN
     APEX_REGION.PURGE_CACHE (
         p_current_session_only => true );
END;