@SetHTTPHeader (式言語)

Web アプリケーションで、ブラウザクライアントからの要求に応じてサーバーで生成される応答の HTTP ヘッダーの値を設定します。

注: この関数は Release 6 で新しく追加されました。

構文

@SetHTTPHeader( responseHeader ; value )

パラメータ

responseHeader

String 型。「Content-Encoding」、「Content-Length」、「Set-Cookie」などの応答ヘッダーフィールドの名前です。応答ヘッダーの仕様については、http://www.w3.org/Protocols を参照してください。以下の応答ヘッダーは読み込み専用のため、この関数で設定または上書きすることはできません。

Connection
Content-Type
Date
サーバー

value

文字列、数値、日付。フィールドの値です。日付は RFC 1123 形式に変換されます。空の文字列 ("") を指定すると、ヘッダーとその値が HTTP 応答から削除されます。

戻り値

successOrFailure

数値。HTTP 応答ヘッダーが正常に更新されると、@True つまり 1 が返されます。それ以外の場合は、@False つまりゼロ (0) が返されます。

使用法

@SetHTTPHeader は、ブラウザ使用時に実行する式で使用すると便利です。Notes クライアントでは、この式に対して常に @False つまりゼロ (0) が返されます。

要求ヘッダーの値を取得する方法の詳細については、@GetHTTPHeader を参照してください。

例

このフォームアクションは、「Set-Cookie」という応答ヘッダーフィールドの値を「SHOP_CART_ID=4646」に設定します。その結果、ブラウザクライアントは、この名前と値を使用してサーバーのクッキーを登録します。

@SetHTTPHeader("Set-Cookie"; "SHOP_CART_ID=4646")

この関数は、以下の標準 HTTP 応答の最後に Set-Cookie 応答ヘッダーを追加します。

HTTP/1.0 200 OK
Date: Thurs, 30 Aug 2001 16:17:52 GMT
Server: Domino/6.0
Content-type: text/html
Content-length: 1538
Last-modified: Mon, 27 Aug 2001 01:23:50 GMT
Set-Cookie: SHOP_CART_ID=4646

クロスリファレンス

LotusScript® NotesMIMEEntity クラスの Headers プロパティ

Java™ MIMEEntity クラスの Headers プロパティ