InboundFileハンドラーは、ファイルの送受信に使用されます。
ポストされたHTTPコンテンツは、指定したファイルに直接保存されます。
コマンド |
キーワード |
値 |
開発者用メモ |
RECEIVE |
HANDLER |
InboundFile |
|
|
TO |
値 |
必須。コンテンツを受信するファイル・パス |
|
APPEND |
*YES |
任意。既存のファイルにコンテンツを追加します。 |
|
|
*NO |
デフォルト。 |
例
RECEIVE HANDLER(InboundFile) TO(/folder/file.jpeg)
このコンテンツ・ハンドラーのSENDコマンドが実行されると、以下のステップが行われます。
1 コンテンツ・タイプを決定し、指定したファイルを読み込み、コンテンツをHTTP応答として送信します。
2 CONTENTキーワードが存在しない場合、コンテンツ・タイプはJava Activation FrameworkのFileTypeMapにより決定されます。これはファイル拡張子/MIMEタイプの関連付けです。
3 HTTPサーバーがMIXED出力モードのIBM iで、選択されたコンテンツ・タイプがtext/で始まる場合、エンコーディングを使用してファイルのバイト・コンテンツをUnicodeに変換し、CGI-EBCDIC-CCSIDプロパティの値を使用してバイトに変換し直します。
4 HTTPサーバーがBINARY出力モードである、もしくはコンテンツ・タイプがtext/から始まらない場合は、ファイル・コンテンツは無変換で送信されます。
構文:
コマンド |
キーワード |
値 |
開発者用メモ |
SEND |
HANDLER |
InboundFile |
|
|
STATUS |
値 |
オプションHTTPステータス番号 デフォルト: 200 |
|
MESSAGE |
値 |
オプションHTTPステータス・メッセージ。 デフォルト: OK 正常な 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)