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/12.0.1.3600
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/12.0.1.3600
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 で意見交換できます