Web 服务请求类型

在创建 Web 客户端函数或过程时，可以指定向 Web 服务器发送的客户端请求类型。CREATE PROCEDURE 和 CREATE FUNCTION 语句的 TYPE 子句在设置请求的格式后才将它们发送到 Web 服务器。

指定 HTTP 请求格式

如果 TYPE 子句中指定的格式以 HTTP 前缀开头，Web 客户端函数和过程将发送 HTTP 请求。

例如，在 Web 客户端数据库中执行以下 SQL 语句来创建名为 PostOperation 的 HTTP 过程，该过程向指定的 URL 发送 HTTP 请求：

CREATE PROCEDURE PostOperation(a INTEGER, b CHAR(128))
    URL 'HTTP://localhost:8082/dbname/SampleWebService'
    TYPE 'HTTP:POST';

在本例中，将请求的格式设置为 HTTP: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:02:49 GMT
Host: localhost:8082
Connection: close
Content-Type: application/x-www-form-urlencoded; charset=windows-1252
Content-Length: 12

a=123&b=data

指定 SOAP 请求格式

如果 TYPE 子句中指定的格式以 SOAP 前缀开头，Web 客户端函数和过程将发送 HTTP 请求。

例如，在 Web 客户端数据库中执行以下语句来创建名为 SoapOperation 的 SOAP 过程，该过程向指定的 URL 发送 SOAP 请求：

CREATE PROCEDURE SoapOperation(intVariable INTEGER, charVariable CHAR(128))
    URL 'HTTP://localhost:8082/dbname/SampleSoapService'
    TYPE 'SOAP:DOC';

在本例中，调用此过程时向 URL 发送了一个 SOAP:DOC 请求，使得生成的请求与下列内容类似：

POST /dbname/SampleSoapService 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:05:13 GMT
Host: localhost:8082
Connection: close
Content-Type: text/xml; charset=windows-1252
Content-Length: 428
SOAPAction: "HTTP://localhost:8082/SoapOperation"

<?xml version="1.0"?>
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:m="HTTP://localhost:8082">
  <SOAP-ENV:Body>
    <m:SoapOperation>
      <m:intVariable>123</m:intVariable>
      <m:charVariable>data</m:charVariable>
    </m:SoapOperation>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

该过程名将出现在主体的 <m:SoapOperation>标记中。该过程的两个参数 intVariable 和 charVariable 分别成为 <m:intVariable>和 <m:charVariable>。

在缺省情况下，在 SOAP 请求时，将存储过程名用作 SOAP 操作名。参数名出现在 SOAP 封装的标记名称中。定义 SOAP 存储过程时必须正确引用这些名称，因为服务器需要 SOAP 请求中带有这些名称。SET 子句可用于为给定的过程指定替代 SOAP 操作名称。WSDLC 用于从文件或 URL 说明中读取 WSDL 并生成 SQL 存根函数或过程。对于最简单的情况（例如，SOAP RPC 调用返回单个字符串值）以外的其它情况，建议使用函数定义，而不使用过程。SOAP 函数返回完整的 SOAP 响应封装，这可以使用 OPENXML 进行解析。

另请参见

使用DocCommentXchange讨论此页。