InboundFileハンドラーは、ファイルの送受信に使用されます。
ポストされたHTTPコンテンツは、指定したファイルに直接保存されます。
コマンド | キーワード | 値 | 開発者用メモ |
|---|---|---|---|
RECEIVE | HANDLER | InboundFile | |
TO | 値 | 必須。コンテンツを受信するファイル・パス | |
APPEND | *YES | 任意。既存のファイルにコンテンツを追加します。 | |
*NO | デフォルト。 |
例
RECEIVE HANDLER(InboundFile) TO(/folder/file.jpeg)
このコンテンツ・ハンドラーのSENDコマンドが実行されると、以下のステップが行われます。
- コンテンツ・タイプを決定し、指定したファイルを読み込み、コンテンツをHTTP応答として送信します。
- CONTENTキーワードが存在しない場合、コンテンツ・タイプはJava Activation FrameworkのFileTypeMapにより決定されます。これはファイル拡張子/MIMEタイプの関連付けです。
- HTTPサーバーがMIXED出力モードのIBM iで、選択されたコンテンツ・タイプがtext/で始まる場合、エンコーディングを使用してファイルのバイト・コンテンツをUnicodeに変換し、CGI-EBCDIC-CCSIDプロパティの値を使用してバイトに変換し直します。
- HTTPサーバーがBINARY出力モードである、もしくはコンテンツ・タイプがtext/から始まらない場合は、ファイル・コンテンツは無変換で送信されます。
構文：
コマンド | キーワード | 値 | 開発者用メモ |
|---|---|---|---|
SEND | HANDLER | InboundFile | |
STATUS | 値 | オプションHTTPステータス番号 | |
MESSAGE | 値 | オプションHTTPステータス・メッセージ。 | |
FILE | 値 | 必須。コンテンツのファイル・パス | |
UAPATH | 値 | 任意。ユーザー・エージェント保存応答パス | |
UAFILE | 値 | 任意。ユーザー・エージェント保存応答ファイル名 | |
UACACHE | 値 | 任意。キャッシュ制御最大期間 デフォルト値は0です。 | |
UADISPOSITION | 値 | 任意。コンテンツ処理のファイル名 | |
ENCODING | 任意。詳細は、「ENCODING」を参照してください。 MIXEDモードのコンテンツのエンコーディングに使用されます。 | ||
CONTENT | 任意。詳細は、「CONTENT」を参照してください。 コンテンツ・タイプはファイル・タイプ・マップから取得されます。 | ||
CHARSET | *YES | 任意。charset属性を含めます。 | |
*NO | charset属性を含めません。 | ||
*TEXT | デフォルト。コンテンツがテキストの場合、charset属性を含めます。 |
例
SEND HANDLER(InboundFile) FILE(/folder/file.pdf)