root Web サービスを作成し、カスタマイズする方法

どの Web サービス要求とも一致しない HTTP クライアント要求は、root Web サービスが定義されていると、root Web サービスによって処理されます。

root Web サービスには、任意の HTTP 要求 (アプリケーションを構築する時点で URL が判明している必要はない) や、認識されない要求を処理する、簡単で柔軟な方法が備えられています。

例

この例では、データベース内のテーブルに格納されている root Web サービスを使用して、Web ブラウザや他の HTTP クライアントにコンテンツを提供する方法を示します。ポート 80 で受信するローカルの HTTP Web サーバを単一のデータベースで起動していることが前提となります。すべてのスクリプトは、Web サーバで実行されます。

Interactive SQL を介してデータベースサーバに接続し、次の SQL 文を実行して、クライアントで指定された url ホスト変数を PageContent というプロシージャに渡す root Web サービスを作成します。

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 文を実行して、root Web サービスに渡される url ホスト変数を受け入れる PageContent プロシージャを実装します。

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 - Page Not Found html ページが作成され、クライアントに送信されます。

ブラウザの中には、ブラウザ自体のページで 404 ステータスに対応するものもあるので、汎用ページが表示される保証はありません。

エラーメッセージでは、HTML_ENCODE 関数を使用して、クライアントで指定された URL 内の特殊文字がエンコードされます。

@HttpStatus ヘッダは、要求で返されるステータスコードを設定するために使用します。404 ステータスは Not Found エラーを示し、200 ステータスは OK を示します。'Content-Type' ヘッダは、要求で返されるコンテンツタイプを設定するために使用します。この例では、index.html ページのコンテンツ (MIME) タイプは text/html です。詳細については、sa_set_http_header システムプロシージャを参照してください。

参照

DocCommentXchange で意見交換できます