root-Webdienst erstellen und anpassen

Eine HTTP-Clientanforderung, die mit keiner Webdienstanforderung übereinstimmt, wird vom root-Webdienst verarbeitet, wenn ein root-Webdienst definiert ist.

Der root-Webdienst bietet Ihnen eine einfache und flexible Methode für die Verarbeitung von beliebigen HTTP-Anforderungen, deren URLs zum Zeitpunkt der Erstellung Ihrer Anwendung nicht unbedingt bekannt sind, und für die Verarbeitung von nicht erkannten Anforderungen.

Beispiel

Dieses Beispiel zeigt die Verwendung eines root-Webdienstes, der in einer Tabelle innerhalb der Datenbank gespeichert ist, um für Webbrowsern und HTTP-Clients Inhalte bereitzustellen. Es wird davon ausgegangen, dass Sie einen lokalen HTTP-Webserver auf einer einzelnen Datenbank gestartet haben und Port 80 überwacht wird. Alle Skripte werden auf dem Webserver ausgeführt.

Stellen Sie über Interactive SQL eine Verbindung zum Datenbankserver her und führen Sie folgendes SQL-Skript zur Erstellung eines root-Webdienstes aus, der die vom Client bereitgestellte Hostvariable URL an eine Prozedur mit dem Namen PageContent weitergibt:

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

Der URL ON-Teil gibt an dass die vollständige Pfadkomponente durch eine HTTP-Variable mit dem Namen URL zugriffsfähig gemacht wird. Weitere Hinweise zur CREATE SERVICE-Anweisungssyntax finden Sie unter CREATE SERVICE-Anweisung.

Führen Sie folgendes SQL-Skript zum Erstellen einer Tabelle zum Speichern von Seiteninhalten aus. In diesem Beispiel wird der Seiteninhalt durch ihre URL, ihren MIME-Typ und den Inhalt selbst definiert.

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

Führen Sie folgendes SQL-Skript aus, um die Tabelle mit Daten zu füllen. In diesem Beispiel soll der für den HTTP-Client bereitzustellende Inhalt bei Anforderung der index.html-Seite definiert werden.

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

Führen Sie folgendes SQL-Skript zur Implementierung der Prozedur PageContent aus, die die vom root-Webdienst übergebene Hostvariable URL akzeptiert:

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>There is no content located at the URL "' || html_encode( @url ) || '" on this server.</body></html>';
    ELSE
    	SET @status = '200';
    END IF;
    CALL dbo.sa_set_http_header( '@HttpStatus', @status );
    CALL dbo.sa_set_http_header( 'Content-Type', @type );
    SELECT @image;
END;

Der root-Webdienst ruft die Prozedur PageContent auf, wenn eine Anforderung an den HTTP-Server mit keiner anderen definierten Webdienst-URL übereinstimmt. Die Prozedur prüft, ob die vom Client gelieferte URL mit einer URL in der Tabelle Page_Content übereinstimmt. Die SELECT-Anweisung sendet eine Antwort an den Client. Wenn die vom Client bereitgestellt URL in der Tabelle nicht gefunden wurde, wird eine generische HTML-Seite des Typs 404 - Page Not Found erstellt und an den Client gesendet.

In der Fehlermeldung wird die HTML_ENCODE-Funktion dazu verwendet, die Sonderzeichen in der vom Client bereitgestellten URL zu kodieren. Weitere Hinweise finden Sie unter HTTP_ENCODE-Funktion [Verschiedene].

Der @HttpStatus-Header wird zum Festlegen des mit der Anforderung zurückgegebenen Statuscode verwendet. Ein Status von 404 weist darauf hin, dass die Seite nicht gefunden wurde. Ein Status von 200 bedeutet, dass die Seite OK ist. Der 'Content-Type'-Header wird zum Festlegen des mit der Anforderung zurückgegebenen Inhaltstyps verwendet. In diesem Beispiel lautet der Inhaltstyp (MIME-Typ) der Seite index.html "text/html". Weitere Hinweise finden Sie unter sa_set_http_header-Systemprozedur.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.