221 OWA_COOKIE
OWA_COOKIEパッケージでは、クライアントのブラウザからHTTP Cookieの送信および取得を行うインタフェースを提供します。
参照:
この章の内容は次のとおりです。
221.1 OWA_CUSTOMの概要
Cookieとは、HTTPコール間の状態を維持するためにブラウザに送信される不透明な文字列です。状態は、クライアントのセッションの間維持されるか、または期限切れ日が含まれている場合はそれより長く維持されます。システム日は、OWA_CUSTOMパッケージで指定された情報に対して計算されます。
221.2 OWA_COOKIEのタイプ
このデータ・タイプには、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);
221.3 OWA_COOKIEのルールおよび制限
すべてのHTTPヘッダーは、英語およびASCII文字セットで使用する必要があります。ヘッダーがデータベースから生成された場合、それらが英語で作成されていることを確認する必要があります。
221.4 OWA_COOKIEサブプログラムの要約
この表は、OWA_COOKIE
サブプログラムを示し、簡単に説明しています。
表221-1 OWA_COOKIEパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
指定したCookieの値を取得します。 |
|
Cookieの名前/値ペアを取得します。 |
|
指定されたCookieを削除します。 |
|
HTTPヘッダーのSet-Cookie行を生成します。 |
221.4.1 GETファンクション
このファンクションは、指定したCookieに関連付けられた値を戻します。値は、OWA_COOKIE.COOKIE
データ・タイプで戻されます。
構文
OWA_COOKIE.GET( name IN VARCHAR2) RETURN COOKIE;
パラメータ
表221-2 GETファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
Cookieの名前。 |
戻り値
OWA_COOKIE.COOKIE
データ・タイプ。
221.4.2 GET_ALLプロシージャ
このプロシージャは、クライアントのブラウザからすべてのCookie名およびその値を戻します。値は、ブラウザから送信された順序で表示されます。
構文
OWA_COOKIE.GET_ALL( names OUT vc_arr, vals OUT vc_arr, num_vals OUT INTEGER);
パラメータ
表221-3 GET_ALLプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
Cookieの名前。 |
|
Cookieの値。 |
|
Cookie/値ペアの数。 |
221.4.3 REMOVEプロシージャ
このプロシージャは、HTTPヘッダーのSet-Cookie行のexpiresフィールドを01-Jan-1990に設定することにより、Cookieを即時に期限切れにします。
このプロシージャは、HTTPヘッダーのコンテキスト内でコールされます。
構文
OWA_COOKIE.REMOVE( name IN VARCHAR2, val IN VARCHAR2, path IN VARCHAR2 DEFAULT NULL);
パラメータ
表221-4 REMOVEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
期限切れするCookieの名前。 |
|
Cookieの値。 |
|
(現在は使用されていません。) |
221.4.4 SENDプロシージャ
このプロシージャは、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);
パラメータ
表221-5 SENDプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
Cookieの名前。 |
|
Cookieの値。 |
|
Cookieの期限が切れる日付。 |
|
パス・フィールドの値。 |
|
ドメイン・フィールドの値。 |
|
このパラメータの値が |