创建 DISH 服务

SQL Anywhere 允许创建 DISH 服务，这些服务为 SOAP 服务组充当 SOAP 端点。DISH 服务还会自动构造 WSDL（Web Services Description Language，Web 服务描述语言）文档，允许 SOAP 客户端工具箱生成与 WSDL 中描述的 SOAP 服务进行数据交换所需的接口。不需对 DISH 服务进行维护即可对 SOAP 服务进行添加或删除，因为当前运行的 SOAP over HTTP 服务集始终是公开的。

示例

在 Interactive SQL 中执行以下 SQL 语句以在 HTTP Web 服务器中创建示例性 SOAP 和 DISH 服务：

CREATE SERVICE "Samples/TestSoapOp"
    TYPE 'SOAP'
    DATATYPE ON
    USER DBA
    AUTHORIZATION OFF
    AS CALL sp_echo(:i, :f, :s);

CREATE PROCEDURE sp_echo(i INTEGER, f REAL, s LONG VARCHAR)
RESULT( ret_i INTEGER, ret_f REAL, ret_s LONG VARCHAR )
BEGIN
	SELECT i, f, s;
END;

CREATE SERVICE "dnet_endpoint"
    TYPE 'DISH'
    GROUP "Samples"
    FORMAT 'DNET';

第一个 CREATE SERVICE 语句创建一个名为 Samples/TestSoapOp 的新 SOAP 服务。

第二个 CREATE SERVICE 语句创建一个名为 dnet_endpoint 的新 DISH 服务。GROUP 子句的 Samples 部分标识了要公开的 SOAP 服务组。可以查看 DISH 服务生成的 WSDL 文档。在计算机上运行 SQL Anywhere Web 服务器时，可以用 http://localhost:port-number/dnet_endpoint URL 来访问服务，其中 port-number 为服务器运行的端口号。

在本例中，SOAP 服务没有包含决定 SOAP 响应格式的 FORMAT 子句。因此，SOAP 响应格式由 DISH 服务来决定，但它不会替代 SOAP 服务的 FORMAT 子句。本功能允许创建同类 DISH 服务，这样每个 DISH 端点就能以多种功能为 SOAP 客户端提供服务。

创建同类 DISH 服务

当 SOAP 服务定义将 FORMAT 子句的规范交给 DISH 服务决定时，一套 SOAP 服务可以在定义格式的 DISH 服务内集合成组。多个 DISH 服务则可以用不同的 FORTMAT 规范来公开同一组 SOAP 服务。如果要详述示例 TestSoapOp，可以使用下列 SQL 语句来创建另一个名为 java_endpoint 的 DISH 服务：

CREATE SERVICE "java_endpoint"
    TYPE 'DISH'
    GROUP "Samples"
    FORMAT 'CONCRETE';

在本例中，当 SOAP 客户端通过 java_endpoint DISH 服务为 TestSoapOp 操作发出 Web 服务请求时，它将接收到一个名为 TestSoapOp_Dataset 的响应对象。可以检查 WSDL 以比较 dnet_endpoint 和 java_endpoint 之间的差异。使用此技术，可以快速构建满足特定 SOAP 客户端工具箱需要的 SOAP 端点。

另请参见

使用DocCommentXchange讨论此页。