Webseiten anpassen

Sie müssen zuerst das Format des vom HTTP-Webserver aufgerufenen Webdienstes berücksichtigen, um Ihre Webseiten anpassen zu können. Beispielsweise sind Webseiten in HTML formatiert, wenn der Webdienst den Typ HTML angibt.

Der Webdiensttyp RAW benötigt den größten Aufwand beim Anpassen, da er erfordert, dass Webdienstprozeduren und -funktionen Code für das erforderlich Markup (z.B. HTML oder XML) enthalten. Bei Verwendung des Typs RAW müssen folgende Aufgaben durchgeführt werden, um Webseiten anzupassen:

Einstellen des HTTP Content-Type-Headerfelds auf den entsprechenden MIME-Typ (etwa text/html) in der aufgerufenen gespeicherten Prozedur.
Anwenden des entsprechenden Markup für den MIME-Typ bei der Generierung einer Webseitenausgabe ausgehend von der abgerufenen gespeicherten Prozedur.

Beispiel

Das folgende Beispiel zeigt die Vorgehensweise zum Erstellen eines neuen Webdienstes, für den der Typ RAW angegeben ist:

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

In diesem Beispiel ruft der Webdienst die gespeicherte Prozedur HomePage auf, die erforderlich ist zum Definieren eines einzelnen URL-Parameters, der die PATH-Komponenten der URL erhält.

Content-Type-Headerfeld definieren

Verwenden Sie die Systemprozedur sa_set_http_header für die Definition des HTTP Content-Type-Headers, um sicherzustellen, dass der Inhalt korrekt in Webbrowsern dargestellt wird.

Das folgende Beispiel zeigt, wie mithilfe der Systemprozedur sa_set_http_header die Webseitenausgabe in HTML unter Verwendung des MIME-Typs text/html formatiert wird:

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

Tag-Konventionen des MIME-Typs anwenden

Sie müssen in Ihrer gespeicherten Prozedur die Tag-Konventionen des durch den Content-Type-Header angegebenen MIME-Typs anwenden. SQL Anywhere verfügt über mehrere Funktionen zum Erstellen von Tags.

Das folgende Beispiel zeigt die Verwendung der Funktionen XMLCONCAT und XMLELEMENT zum Generieren von HTML-Inhalt. Es wird hierbei davon ausgegangen, dass die Systemprozedur sa_set_http_header zum Einstellen des MIME-Typs text/html für den Content-Type-Headers verwendet wird:

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!')
        )
    )
)

Da für Elementinhalte immer Escapezeichen verwendet werden (es sei denn, der Datentyp ist XML), verwendet das obige Beispiel die CAST-Funktion. Andernfalls werden für Sonderzeichen immer Escapezeichen verwendet (z.B. < für <).

Ein ausführliches Beispiel eines RAW-Webdienstes, der eine benutzerdefinierte Webseite generiert, finden Sie unter root-Webdienst erstellen und anpassen.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.