如何自定义 Web 页

必须先确定 HTTP Web 服务器调用的 Web 服务格式以自定义 Web 页面。例如，当 Web 服务指定 HTML 类型时，Web 页面将是 HTML 格式。

RAW Web 服务类型能提供最多的自定义选项，因为它需要 Web 服务过程和函数显式地要求代码来提供需求的标记，如 HTML 或 XML。使用 RAW 类型时，必须执行以下任务来自定义 Web 页面：

在调用存储过程中，将 HTTP Content-Type 标头字段设置为适当的 MIME 类型，例如 text/html。
当从调用存储过程中生成 Web 页面输出时，为 MIME 类型应用适当的标记。

示例

以下示例将说明如何通过指定 RAW 类型来创建新的 Web 服务：

CREATE SERVICE WebServiceName 
    TYPE 'RAW'
    AUTHORIZATION OFF 
    URL ON
    USER DBA
    AS CALL HomePage( :url );

在本例中，Web 服务调用了 HomePage 存储过程，这在定义单个接收 URL PATH 组成部分的 URL 参数时是必需的。

设置 Content-Type 标头字段

使用 sa_set_http_header 系统过程定义 HTTP Content-Type 标头以确保 Web 浏览器能正确地显示其内容。

以下示例将说明如何通过 sa_set_http_header 系统过程使用 text/html MIME 类型来设置 HTML 输出的 Web 页面格式：

CREATE PROCEDURE HomePage (IN url LONG VARCHAR)
    RESULT (html_doc XML)
    BEGIN
        CALL sa_set_http_header ( 'Content-Type', 'text/html' );
        -- Your SQL code goes here.
        ...
    END

应用 MIME 类型的标记约定

在存储过程中必须应用 Content-Type 标头指定的 MIME 类型标记约定。SQL Anywhere 提供了几种函数来创建标记。

以下示例将说明如何使用 XMLCONCAT 和 XMLELEMENT 函数来生成 HTML 内容，前提是使用了 sa_set_http_header 系统过程将 Content-Type 标头设置为 text/html MIME 类型：

XMLCONCAT(
   CAST('<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">' AS XML),
   XMLELEMENT(
        'HTML',
        XMLELEMENT(
            'HEAD',
            XMLELEMENT('TITLE', 'My Home Page')
        ),
        XMLELEMENT(
            'BODY',
            XMLELEMENT('H1', 'My home on the web'),
            XMLELEMENT('P', 'Thank you for visiting my web site!')
        )
    )
)

由于元素内容始终会被转义（除非数据类型为 XML），所以上例使用 CAST 函数。否则会转义出特殊字符（例如用 < 来表示 <）。

有关生成自定义 Web 页面的 RAW Web 服务的广泛示例，请参见如何创建和自定义 root Web 服务。

另请参见

使用DocCommentXchange讨论此页。