OWA_COOKIEパッケージでは、クライアントのブラウザからHTTP Cookieの送信および取得を行うインタフェースを提供します。
関連項目: このパッケージの実装の詳細は、次のマニュアルを参照してください。
|
この章では、次の項目について説明します。
概要
データ型
ルールおよび制限
Cookieとは、HTTPコール間の状態を維持するためにブラウザに送信される不透明な文字列です。状態は、クライアントのセッションの間維持されるか、または期限切れ日が含まれている場合はそれより長く維持されます。 システム日は、OWA_CUSTOMパッケージで指定された情報に対して計算されます。
このデータ型には、Cookieの名前/値ペアが含まれます。HTTP標準にはオーバーロードされたCookie名を許可する(すなわち同じCookie名に複数の値を関連付けられる)ため、PL/SQL RECORD
は特定のCookie名に関連するすべての値を保持します。
TYPE vc_arr IS TABLE OF VARCHAR2(4000) INDEX BY BINARY_INTEGER. TYPE COOKIE IS RECORD ( name VARCHAR2(4000), vals vc_arr, num_vals INTEGER);
すべてのHTTPヘッダーは、英語およびASCII文字セットで使用する必要があります。ヘッダーがデータベースから生成された場合、それらが英語で作成されていることを確認する必要があります。
表172-1 OWA_COOKIEパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
|
指定したCookieの値を取得します。 |
|
Cookieの名前/値ペアを取得します。 |
|
指定されたCookieを削除します。 |
|
HTTPヘッダーのSet-Cookie行を生成します。 |
このファンクションは、指定したCookieに関連付けられた値を戻します。 値は、OWA_COOKIE.COOKIE
データ型で戻されます。
構文
OWA_COOKIE.GET( name IN VARCHAR2) RETURN COOKIE;
パラメータ
戻り値
OWA_COOKIE.COOKIE
データ型。
このプロシージャは、クライアントのブラウザからすべてのCookie名およびその値を戻します。値は、ブラウザから送信された順序で表示されます。
構文
OWA_COOKIE.GET_ALL( names OUT vc_arr, vals OUT vc_arr, num_vals OUT INTEGER);
パラメータ
このプロシージャは、HTTPヘッダーのSet-Cookie行のexpiresフィールドを01-Jan-1990に設定することにより、Cookieを即時に期限切れにします。このプロシージャは、HTTPヘッダーのコンテキスト内でコールされます。
構文
OWA_COOKIE.REMOVE( name IN VARCHAR2, val IN VARCHAR2, path IN VARCHAR2 DEFAULT NULL);
パラメータ
このプロシージャは、Cookieをクライアントに送信するSet-Cookie行を生成します。このプロシージャは、HTTPヘッダーのコンテキスト内で発生します。
構文
OWA_COOKIE.SEND( name in varchar2, value in varchar2, expires in date DEFAULT NULL, path in varchar2 DEFAULT NULL, domain in varchar2 DEFAULT NULL, secure in varchar2 DEFAULT NULL);
パラメータ