Experte für DataSnap-REST-Anwendungen
Nach oben zu DataSnap-Server-Anwendung
Nach oben zu Menü Datei
Datei > Neu > Weitere > Delphi-Projekte > DataSnap-Server > DataSnap-REST-Anwendung
Datei > Neu > Weitere > C++Builder-Projekte > DataSnap-Server > DataSnap-REST-Anwendung
Der Experte für DataSnap-REST-Anwendungen erstellt ein Projekt, das den Ausgangspunkt für das Erzeugen einer AJAX-fähigen Webanwendung darstellt. Ungeachtet der ausgewählten Optionen erstellt der Experte eine Unit, die die folgenden Komponenten enthält:
Inhaltsverzeichnis
- Eine DSServer-Komponente
- Eine DSServerClass-Komponente
- Eine TDSRESTWebDispatcher-Komponente
- Hinweis: Die Komponente TDSRESTWebDispatcher der REST-Anwendung verwendet weiterhin Sitzungen, wenn Sie die Eigenschaft SessionLifetime nicht von TimeOut auf Request setzen.
- Eine WebFileDispatcher-Komponente
- Eine ServerFunctionInvoker-Komponente
- Eine ReverseString-Komponente
- Eine DSProxyGenerator-Komponente
- Eine DSServerMetaDataProvider-Komponente
Alle weiteren Komponenten werden mit der TDSServer-Komponente verbunden, deren Eigenschaft Server auf den Namen der TDSServer-Komponente gesetzt ist. Das Kommunikationsprotokoll zwischen den Server- und Client-Anwendungen ist HTTP oder HTTPS, und die Technologie ist REST (Representational State Transfer).
Der Experte für DataSnap-REST-Anwendungen besteht – abhängig vom Typ der im ersten Schritt ausgewählten REST-Anwendung und anderen Festlegungen in diesem Experten – aus vier bis sieben Schritten. Die einzelnen Schritte des Experten werden anhand der folgenden Abbildungen mit detaillierten Beschreibungen erläutert.
Seite "WebBroker-Projekttyp"
Im ersten Schritt des Experten wählen Sie den Typ der REST-Anwendung aus. Die möglichen Optionen sind in der folgenden Tabelle aufgeführt:
| Option | Beschreibung |
|---|---|
|
VCL-Anwendung |
Eine eigenständige REST-VCL-Anwendung ist ein Webserver, der ein VCL-Formular anzeigt. Dieser Webserver unterstützt HTTP über eine Indy HTTP-Serverkomponente. |
|
Konsolenanwendung |
Eine eigenständige REST-Konsolenanwendung ist ein Webserver, dessen Benutzeroberfläche nur aus Text besteht. Dieser Webserver unterstützt HTTP über eine Indy HTTP-Serverkomponente. |
|
ISAPI-DLL |
ISAPI- und NSAPI-Webserveranwendungen sind gemeinsam genutzte Objekte, die vom Webserver geladen werden. Die Client-Anforderungsinformation wird der DLL als Struktur übergeben und von TISAPIApplication ausgewertet. Jede Anforderung wird in einem eigenen Ausführungs-Thread behandelt. Wenn Sie diesen Anwendungstyp auswählen, werden der Bibliotheks-Header der Projektdateien und die erforderlichen Einträge der uses-Liste hinzugefügt. Darüber hinaus wird auch die Klausel der Projektdatei exportiert. ISAPI-Bibliotheken werden in IIS integriert. IIS unterstützt HTTP und HTTPS. |
|
Dynamisches Apache-Link-Modul |
Der Apache-Webserver hostet statische oder dynamische Websites, indem er sichere und effiziente Webserver-Features wie CGI (Common Gateway Interface), SSL (Secure Sockets Layer) und virtuelle Domänen bereitstellt. Apache unterstützt HTTP und HTTPS. |
Seite "Anwendungstyp"
Dieser Schritt wird nur angezeigt, wenn Sie in Schritt 1 Einzelanwendung ausgewählt haben. Hier können Sie den Typ der Anwendung festlegen, die Sie erstellen möchten.
Folgende Anwendungstypen sind verfügbar:
- VCL-Anwendung
- FireMonkey-Anwendung
Seite "Optionen für Apache-Modul"
Diese Seite wird nur angezeigt, wenn Sie im ersten Schritt dieses Experten Dynamisches Apache-Link-Modul als Projekttyp ausgewählt haben.
Hier müssen Sie folgende Informationen angeben:
- Apache-Version
- Apache-Modul
- Apache-Unit
Seite "Port-Nummer"
Dieser Schritt des Experten für DataSnap-REST-Anwendungen ist nur verfügbar, wenn Sie im ersten Schritt VCL-Anwendung oder Konsolenanwendung ausgewählt haben. In diesem zweiten Schritt geben Sie den HTTP-Kommunikations-Port ein. In dem Experten können Sie zudem mit der Schaltfläche Port testen die Verfügbarkeit des Ports prüfen. Klicken Sie auf die Schaltfläche Geöffneten Port suchen, um in das Feld HTTP-Port einen automatisch ermittelten, verfügbaren Port einzufügen.
Hinweis: Für die Verwendung des HTTPS-Protokolls müssen Sie das Kontrollkästchen HTTPS aktivieren. Wenn HTTPS aktiviert ist, zeigt der Experte eine weitere Seite an, in der Sie die Zertifikatsdateien angeben müssen. Der HTTPS-Kommunikations-Port wird auf 443 gesetzt; das ist ein häufig von IIS verwendeter Port.
Seite "X.509-Zertifikate"
Dieser Schritt wird nur angezeigt, wenn Sie im vorherigen Schritt das Kommunikationsprotokoll HTTPS ausgewählt haben. Hier müssen Sie für die Verwendung des HTTPS-Kommunikationsprotokolls die folgenden Informationen eingeben:
- Name der Datei, die das X.509-Zertifikat enthält (*.pem)
- Name der Datei, die den Schlüssel enthält
- Name der Datei, die das Passwort für die Schlüsseldatei enthält
- Name der Datei, die das Stammzertifikat enthält
Mit der Schaltfläche Testen können Sie die Auswahl prüfen.
Seite "Serverfunktionen"
In diesem Schritt geben Sie die DataSnap-REST-Serverfunktionen an.
- Wenn Sie die Option Authentifizierung auswählen, wird eine TDSAuthenticationManager-Komponente auf dem Serverformular platziert. Die TDSRESTWebDispatcher-Komponente verwendet den TDSAuthenticationManager als AuthenticationManager, um die Implementierung der REST-Benutzerauthentifizierung für den DataSnap-Server zu ermöglichen. Die Implementierung besteht aus der Implementierung des Ereignisses Authenticate. Wenn Authentifizierung ausgewählt ist, muss der Client den DataSnap-Benutzernamen und das Passwortals SQL-Verbindungseigenschaften bereitstellen.
- Wählen Sie die Option Servermethodenklasse, um dem Serverformular eine TDSServerClass-Komponente hinzuzufügen und das Definieren einer Klasse auf dem Server zu ermöglichen, die die Servermethoden für Client-Anwendungen bereitstellt.
-
- Wenn Sie die Option Beispielmethoden auswählen, enthält ServerMethodsUnit die Implementierung zweier einfacher Methoden (EchoString und ReverseString), die den als Parameter übergebenen Wert (Value) im normalen bzw. im umgekehrten Status zurückgeben.
-
- Durch Auswahl der Option Beispiel-Webdateien werden diesem Projekt ein Satz Beispiel-Webdateien und zugehörige Seiten hinzugefügt. Diese werden in der Projektverwaltung unter dem DataSnap-Serverprojekt angezeigt. Sehen Sie sich die Dateien im Verzeichnis templates an, um die eigentliche Webimplementierung für die Methoden ServerFunctionInvoker und ReverseString kennenzulernen.
- Mit dem Kontrollkästchen Mobile Konnektoren können Sie die Unterstützung für Proxy-Weiterleitungen bei der mobilen Konnektorentwicklung einbeziehen. Weitere Informationen über die mobilen DataSnap-Konnektoren finden Sie unter Einführung in DataSnap-Konnektoren für mobile Geräte.
- Mit dem Kontrollkästchen Servermodul können Sie ein eigenes Modul für DataSnap-Serverkomponenten erstellen. Dies ermöglicht die Unterstützung von Heavyweight-Callbacks in DataSnap-REST-Anwendungen.
Seite "Vorfahrklasse der Servermethoden"
Im diesem Schritt des Experten geben Sie den Vorfahrtyp für die Servermethodenklasse an.
Wählen Sie TDataModule, wenn Sie nicht visuelle Komponenten in Ihrer Serverklasse verwenden möchten. Wählen Sie TComponent, wenn Sie die Serverklasse vollständig implementieren möchten.
Seite "Speicherort des Projekts"
Im letzten Schritt des Experten legen Sie den Speicherort für den erzeugten DataSnap-REST-Server fest. Geben Sie das Stammverzeichnis der zu erstellenden Webanwendung ein. Dies ist das Ausgabeverzeichnis der ausführbaren Datei des Projekts und der Speicherort der Webanwendungsdateien (.js-, .html- und .css-Dateien und andere statische Dateien).