HTTP 要求ヘッダの管理

CREATE PROCEDURE 文と CREATE FUNCTION 文の HEADER 句を使用して、HTTP 要求ヘッダを追加、変更、または削除できます。名前を参照することによって、HTTP 要求ヘッダを抑制できます。ヘッダ名の後にコロン、値の順に指定して、HTTP 要求ヘッダ値を追加または変更します。ヘッダ値の指定は省略可能です。

たとえば、HTTP 要求ヘッダを制限する指定した URL に要求を送信する SomeOperation2 という HTTP プロシージャを作成するには、Web クライアントデータベースで次の SQL 文を実行します。

CREATE PROCEDURE SomeOperation2()
    URL 'HTTP://localhost:8082/dbname/SampleWebService'
    TYPE 'HTTP:GET'
    HEADER 'SOAPAction\nDate\nFrom:\nCustomAlias:John Doe';

この例では、SQL Anywhere によって自動的に生成される Date ヘッダが抑制されます。From ヘッダは、含まれているものの、値が割り当てられていません。HTTP 要求には CustomAlias という新しいヘッダが含められ、値 John Doe が割り当てられます。GET 要求は次のようになります。

GET /dbname/SampleWebService HTTP/1.0
ASA-Id: e88a416e24154682bf81694feaf03052
User-Agent: SQLAnywhere/16.0.0.1403
Accept-Charset: windows-1252, UTF-8, *
From: 
Host: localhost:8082
Connection: close
CustomAlias: John Doe

長いヘッダ値の折り返しがサポートされています。折り返すには、\n の直後に 1 つ以上のスペースが必要です。

次の例は、長いヘッダ値のサポートを示します。

CREATE PROCEDURE SomeOperation3()
    URL 'HTTP://localhost:8082/dbname/SampleWebService'
    TYPE 'HTTP:POST'
    HEADER 'heading1: This long value\n is really long for a header.\n 
    heading2:shortvalue';

POST 要求は次のようになります。

POST /dbname/SampleWebService HTTP/1.0
ASA-Id: e88a416e24154682bf81694feaf03052
User-Agent: SQLAnywhere/16.0.0.1403
Accept-Charset: windows-1252, UTF-8, *
Date: Fri, 03 Feb 2012 15:26:04 GMT
heading1: This long value is really long for a header.     heading2:shortvalue
Host: localhost:8082
Connection: close
Content-Type: application/x-www-form-urlencoded; charset=windows-1252
Content-Length: 0

注意

SOAP 関数またはプロシージャの作成時に WSDL に指定された SOAP サービス URI に SOAPAction HTTP 要求ヘッダを設定してください。

自動生成される HTTP 要求ヘッダ

自動生成されるヘッダを修正すると、予期しない結果になる可能性があります。次の HTTP 要求ヘッダは、事前の対策を行わずに変更しないでください。

HTTP ヘッダ	説明
Accept-Charset	常に自動的に生成されます。このヘッダを変更または削除すると、予期しないデータ変換エラーが発生する可能性があります。
ASA-Id	常に自動的に生成されます。このヘッダは、デッドロックを防ぐため、クライアントアプリケーションがそれ自体に接続しないようにします。
Authorization	URL にクレデンシャルが含まれるときに自動生成されます。このヘッダを変更または削除すると、要求がエラーになる可能性があります。BASIC 認証だけがサポートされています。ユーザとパスワードの情報は、HTTPS を使用した接続時だけ含めるようにしてください。
Connection	Connection: close は常に自動的に生成されます。クライアントアプリケーションは、永続的接続をサポートしません。変更した場合、接続がハングする可能性があります。
Host	常に自動的に生成されます。HTTP/1.1 クライアントが Host ヘッダを提供しない場合、400 Bad Request で応答するには HTTP/1.1 サーバが必要です。
Transfer-Encoding	チャンクモードで要求を通知するときに自動生成されます。このヘッダやチャンク値を削除すると、クライアントが CHUNK モードを使用しているときにエラーになります。
Content-Length	チャンクモード以外で要求を通知するときに自動生成されます。このヘッダは、本文のコンテンツ長をサーバに通知するために必要です。コンテンツ長が不正な場合、接続がハングするか、データが失われる可能性があります。

参照

DocCommentXchange で意見交換できます