View Source

InboundNameValue

InboundNameValueハンドラーは、名前の値ペアのコンテンツを送受信できます。
詳細については、「5.2.6 Webブラウザー・コンテンツ」を参照してください。
このコンテンツ・ハンドラーのRECEIVEコマンドが実行されると、以下のステップが行われます。
1      コンテンツが存在しない場合、ステータス OK が返されます。
2      ハンドラーは、コンテンツ・タイプがapplication/x-www-form-urlencodedであるかどうかをチェックします。このタイプではない場合、ステータス ERROR が返されます。
         CONTENTキーワードを使って、このチェックを上書きし、ハンドラーがデータを受信できるようにすることができます。
         この場合、データは正しい形式であると想定されています。
3      ハンドラーは名前の値ペアをデコードし、BINDキーワード・アクションに応じて、コンテンツをプログラムにバインドします。
構文：

コマンド	キーワード	値	開発者用メモ
RECEIVE	HANDLER	InboundNameValue
	BIND	*FIELD	任意。デフォルト。LANSAファンクション・フィールドに受信した名前の値を設定します。
		*LIST	任意。指定した作業リストに受信した名前の値を入れます。
		*BOTH	任意。ファンクション・フィールドを設定します。フィールドがない場合、指定した作業リストに名前の値を入れます。
	PREFIX	*YES	任意。フィールドには、無視する必要がある1文字接頭辞があります。LANSAWebポスト名は1つのデータ・タイプ接頭辞文字と組み合わせます。
		*NO	デフォルト。フィールドには、無視する必要がある1文字接頭辞はありません。
	ENCODING		任意。詳細は、「ENCODING」を参照してください。フィールド値の変換に使用されます。
	NUMBERFORMAT		任意。詳細は、「NUMBERFORMAT」を参照してください。
	CONTENT		任意。詳細は、「CONTENT」を参照してください。

例
RECEIVE HANDLER(InboundNameValue) BIND(*LIST) #WRLST(NAME,VALUE)

このコンテンツ・ハンドラーのSENDコマンドが実行されると、次のことが実行されます。
URLエンコードの名前の値ペア・レコードが、作業リスト引数から作成されます。
構文：

コマンド	キーワード	値	開発者用メモ
SEND	HANDLER	InboundNameValue
	STATUS	値	オプションHTTPステータス番号デフォルト: 200
	MESSAGE	値	オプションHTTPステータス・メッセージ。デフォルト: OK 正常な HTTP 要求に対する標準的な応答
	UAPATH	値	任意。ユーザー・エージェント保存応答パス
	UAFILE	値	任意。ユーザー・エージェント保存応答ファイル名
	UACACHE	値	任意。キャッシュ制御最大期間デフォルト値は0です。
	UADISPOSITION	値	任意。コンテンツ処理のファイル名
	ENCODING		任意。詳細は、「ENCODING」を参照してください。フィールド値のエンコードに使用されます。
	NUMBERFORMAT		任意。詳細は、「NUMBERFORMAT」を参照してください。
	CONTENT		任意。詳細は、「CONTENT」を参照してください。
	CHARSET	*YES	任意。charset属性を含めます。
		*NO	charset属性を含めません。
		*TEXT	デフォルト。コンテンツがテキストの場合、charset属性を含めます。
	SPACE	*PLUS	デフォルト。スペースを+にエンコードします。
		*BLANK	スペースをブランクにエンコードします。
		*PERCENT20	スペースを%20にエンコードします。

例
SEND HANDLER(InboundNameValue) #WRLST(NAME,VALUE)