181 WPG_DOCLOAD

WPG_DOCLOADパッケージは、ファイル、BLOBおよびBFILEをダウンロードするインタフェースを提供します。

WPG_DOCLOADの使用方法

文書表のNAME列には、name_col_lenと同じ値を設定する必要があります。

name_col_len CONSTANT pls_integer := 64;

文書表のMIME_TYPE列には、mimet_col_lenと同じ値を設定する必要があります。

mimet_col_len CONSTANT pls_integer := 48;

文書表の名前は、max_doctable_name_lenより短く指定する必要があります。

max_doctable_name_len CONSTANT pls_integer := 256;

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

サブプログラム	説明
DOWNLOAD_FILEプロシージャ	ファイル、`BLOB`および`BFILE`をダウンロードします。

このプロシージャには、3つのバージョンがあります。

最初のバージョンはファイルをダウンロードし、文書内のDOWNLOADプロシージャにより起動され、p_filenameが文書表からクライアントのブラウザにダウンロードされようとしているPL/SQLゲートウェイへ信号を送ります。
2番目のバージョンは、どのプロシージャからも起動でき、p_blobがクライアントのブラウザにダウンロードされようとしているPL/SQLゲートウェイへ信号を送ります。
3番目のバージョンは、どのプロシージャからも起動でき、p_bfileがクライアントのブラウザにダウンロードされようとしているPL/SQLゲートウェイへ信号を送ります。

構文

WPG_DOCLOAD.DOWNLOAD_FILE(
   p_filename      IN             VARCHAR2,
   p_bcaching      IN             BOOLEAN DEFAULT TRUE);

WPG_DOCLOAD.DOWNLOAD_FILE(
   p_blob          IN OUT NOCOPY  BLOB);

WPG_DOCLOAD.DOWNLOAD_FILE(
   p_bfile         IN OUT         BFILE);

パラメータ

表181-2 DOWNLOAD_FILEプロシージャのパラメータ

パラメータ	説明
`p_filename`	文書表からダウンロードするファイル。
`p_blob`	ダウンロードする`BLOB`。
`p_bfile`	ダウンロードする`BFILE`（「使用上の注意」を参照）。
`p_bcaching`	ブラウザ・キャッシングを有効にするかどうか（「使用上の注意」を参照）。

使用上の注意

通常、ブラウザがキャッシュ内に要求された文書が保存されていることを示す'If-Modified-Since'ヘッダーをゲートウェイに送信しない限り、文書はブラウザにダウンロードされます。送信された場合は、ブラウザのキャッシュに保存されたコピーが最新のものであるかどうかをゲートウェイが判別し、最新のものであれば、このコピーを表示させることを指示するHTTP 304ステータス・メッセージをブラウザに送信します。ただし、文書URLおよび文書がPL/SQL Webゲートウェイにおいて必ずしも1対1の関係を構築しているとは限らないため、場合によっては、望んでいない文書のコピーが表示されることがあります。そのような場合には、p_bcachingパラメータをFALSEに設定し、'If-Modified-Since'ヘッダーを無視し、文書をダウンロードするようゲートウェイに指示します。
ファイルにアクセスできるかどうか、存在しているかどうかをチェックするために最初にロケータが開かれるため、p_bfileおよびp_blobはIN OUTとして宣言されます。オープン操作は、ロケータが書込みおよび読取り可能である場合にのみ実行できます。