如何创建和自定义 root Web 服务

如果定义了 root Web 服务，不匹配任何 Web 服务请求的 HTTP 客户端请求将由 root Web 服务处理。

root Web 服务提供简便且灵活的方法来处理在构建应用程序时 URL 不必知道的任意 HTTP 请求，以及处理无法识别的请求。

示例

本示例说明如何使用 root Web 服务（存储在数据库中的一个表中）为 Web 浏览器和其它 HTTP 客户端提供内容。假设在单一数据库上启动了本地 HTTP Web 服务器，并监听端口 80。所有的脚本都在 Web 服务器上运行。

通过 Interactive SQL 连接数据库服务器，并执行以下 SQL 语句来创建 root Web 服务，从而向名为 PageContent 的过程传递 URL 主机参数（由客户端提供）。

CREATE SERVICE root
    TYPE 'RAW'
    AUTHORIZATION OFF 
    SECURE OFF
    URL ON
    USER DBA
    AS CALL PageContent(:url);

URL ON 部分指定完整的路径组成部分可通过名为 URL 的 HTTP 变量访问。

执行以下 SQL 语句来创建存储页面内容的表。在本例中，页面内容由其 URL、MIME 类型和内容自身决定。

CREATE TABLE Page_Content (
    url          VARCHAR(1024) NOT NULL PRIMARY KEY,
    content_type VARCHAR(128)  NOT NULL, 
    image        LONG VARCHAR  NOT NULL
);

执行以下 SQL 语句来填充该表。在本例中，意图是在 index.html 页面被请求后定义向 HTTP 客户端提供的内容。

INSERT INTO Page_Content 
VALUES(
    'index.html',
    'text/html',
    '<html><body><h1>Hello World</h1></body></html>'
);
COMMIT;

执行以下 SQL 语句来实施 PageContent 过程，此过程接受一并传递给 root Web 服务的 URL 主机变量：

CREATE PROCEDURE PageContent(IN @url LONG VARCHAR)
RESULT ( html_doc LONG VARCHAR )
BEGIN
    DECLARE @status CHAR(3);
    DECLARE @type   VARCHAR(128);
    DECLARE @image  LONG VARCHAR;

    SELECT content_type, image INTO @type, @image
        FROM Page_Content
        WHERE url = @url;

    IF @image is NULL THEN
        SET @status = '404';
        SET @type = 'text/html';
        SET @image =  '<html><body><h1>404 - Page Not Found</h1>'
            || '<p>There is no content located at the URL "' 
            || html_encode( @url ) || '" on this server.<p>'
            || '</body></html>';
    ELSE
    	SET @status = '200';
    END IF;
    CALL sa_set_http_header( '@HttpStatus', @status );
    CALL sa_set_http_header( 'Content-Type', @type );
    SELECT @image;
END;

当向 HTTP 服务器发送的请求不与任何其它已定义的 Web 服务 URL 匹配时，root Web 服务将调用 PageContent 过程。该过程检查客户端提供的 URL 是否和 Page_Content 表中的 URL 匹配。SELECT 语句向客户端发送响应。如果无法在表中找到客户端提供的 URL，则构建通用的 404 未找到 html 页面，并将其发送给客户端。

有些浏览器会用其自身页面响应 404 状态，所以不能保证一定会显示通用页面。

在错误消息中，HTML_ENCODE 函数用于对客户端提供的 URL 中的特殊字符进行编码。

@HttpStatus 标头用于设置请求所返回的状态代码。404 状态表示 Not Found 错误，而 200 状态表示 OK。"Content-Type" 标头用于设置请求所返回的内容类型。在本例中，index.html 页面的内容 (MIME) 类型为 text/html。有关详细信息，请参见sa_set_http_header 系统过程。

另请参见

使用DocCommentXchange讨论此页。