用于子句值的替代参数

每当运行存储过程或函数时，存储过程或函数的已声明参数将自动替代子句定义中的占位符。替代参数允许创建可在运行时动态配置子句的通用 Web 服务过程。任何包含后面跟有已声明参数名称的感叹号 "!" 的子字符串都会被替换为该参数的值。这样，运行时可以替代一个或多个参数值来派生出一个或多个子句值。

参数替代要求遵守以下规则：

用于替代的参数必须是字母或数字。不允许有下划线。
替代参数后面必须紧跟非字母数字字符或终止字符。例如，!sizeXL 不能被名为 size 的参数的值替代，因为 X 属于字母数字字符。
和参数名称不匹配的替代参数将被忽略。
感叹号 (!) 可以用另一个感叹号进行转义。

例如，以下过程说明了参数替代的用法。URL 和 HTTP 标头的定义必须传递给参数。

CREATE PROCEDURE test(uid CHAR(128), pwd CHAR(128), headers LONG VARCHAR)
    URL 'http://!uid:!pwd@localhost/myservice'
    HEADER '!headers';

然后可以使用以下语句来调用 test 过程并发起一个 HTTP 请求：

CALL test('dba', 'sql', 'NewHeader1:value1\nNewHeader2:value2');

每次调用此过程时可使用不同的值。

加密证书示例

可使用参数替代传递来自某文件的加密证书并将它们传递到存储过程或存储函数。

下面的示例说明了如何将证书作为替代字符串传递：

CREATE PROCEDURE secure(cert LONG VARCHAR)
URL 'https://localhost/secure'
TYPE 'HTTP:GET'
CERTIFICATE 'cert=!cert;company=test;unit=test;name=RSA Root';

在以下调用中，从文件中读取证书并将其传递至 secure。

CALL secure( xp_read_file('C:\\Users\\Public\\Documents\\SQL Anywhere 16\\Samples\\Certificates\\rsaroot.crt) );

本示例仅作演示之用。使用 CERTIFICATE 子句的 file= 关键字可以从文件中读取证书。

没有匹配参数名的示例

没有匹配参数名的占位符将自动删除。

例如，将不会用参数 size 替代以下过程中的占位符：

CREATE PROCEDURE orderitem (size CHAR(18))
    URL 'HTTP://localhost/salesserver/order?size=!sizeXL'
    TYPE 'SOAP:RPC';

在本例中，!sizeXL 会始终删除，因为它是一个没有匹配参数的占位符。

调用存储函数或存储过程时，可使用参数替换该函数或过程主体中的占位符。如果不存在特定变量的占位符，参数及其值将作为请求的一部分传递。以这种方式用于替代的参数和值不会作为请求的一部分传递。

使用DocCommentXchange讨论此页。