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 DSHTTPWebDispatcher-Komponente
- Eine WebFileDispatcher-Komponente
- Eine ServerFunctionInvoker-Komponente
- Eine ReverseString-Komponente
- Eine DSProxyGenerator-Komponente
- Eine DSServerMetaDataProvider-Komponente
Alle weiteren Komponenten werden mit dem TDSServer verbunden, dessen Eigenschaft Server auf den Namen der TDSServer-Komponente gesetzt wird. 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, fünf oder sechs Schritten. Die einzelnen Schritte des Experten werden in den folgenden Abbildungen und 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. Sie unterstützt HTTP über eine Indy HTTP-Serverkomponente. |
|
Konsolenanwendung |
Eine eigenständige REST-Konsolenanwendung ist ein Webserver, dessen Benutzeroberfläche nur aus Text besteht. Sie unterstützt HTTP über eine Indy HTTP-Serverkomponente. |
|
ISAPI-DLL |
ISAPI- und NSAPI-Webserveranwendungen sind gemeinsame 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 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. |
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 gewä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 auswählen. Bei Auswahl von HTTPS 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 TDSHTTPServiceAuthenticationManager-Komponente auf dem Serverformular platziert. Die TDSHTTPWebDispatcher-Komponente ermöglicht mit TDSHTTPServiceAuthenticationManager als AuthenticationManager die Implementierung der HTTP-Benutzerauthentifizierung für den DataSnap-Server. Die Implementierung besteht aus der Implementierung der Eigenschaft Authenticate. Wenn Authentifizierung ausgewählt ist, muss der Client den DataSnap-Benutzernamen und das Passwort als 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 die ServerMethodsUnit die Implementierung von zwei einfachen Methoden (EchoString und ReverseString), die den als Parameter übergebenen 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. Untersuchen Sie die Dateien im Verzeichnis templates, um die tatsächliche 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 zu den DataSnap-Konnektoren für mobile Geräte 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 TDSServerModule, um die Datenmengen vom Server für Client-Anwendungen bereitzustellen. 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).