Herstellen einer Verbindung zum DataSnap-Server (FireDAC)
Nach oben zu Datenbankkonnektivität (FireDAC)
In diesem Thema wird beschrieben, wie eine Verbindung zu mehrschichtigen DataSnap-Servern hergestellt wird.
Inhaltsverzeichnis
Unterstützte Versionen
Der mehrschichtige FireDAC-DataSnap-Treiber unterstützt:
- Mit RAD Studio 2007 und höher erzeugte DataSnap-Server.
- Mit RAD Studio XE2 Enterprise und höher erzeugte DataSnap-Clients.
Client-Software
FireDAC linkt den Embarcadero DataSnap-dbExpress-Treiber statisch, daher sind keine weiteren Dateien oder DLLs erforderlich. Unterstützt wird RAD Studio XE2 Enterprise und höher.
Treibereinbindung
So binden Sie den DataSnap-Treiber ein:
- Ziehen Sie aus der Paletten-Seite "FireDAC Links" eine TFDPhysDSDriverLink-Komponente auf das Formular.
- Oder fügen Sie die Unit FireDAC.Phys.DS in die uses-Klausel ein.
Verbindungsdefinitionsparameter
Für eine Verbindung mit dem DataSnap-Server ist für die meisten Anwendungen die Angabe von DriverID, Protocol, Server, Port, User_Name und Password erforderlich (Einzelheiten finden Sie unter Definieren von Verbindungen (FireDAC)).
DriverID=DS
Parameter | Beschreibung | Beispielwert |
---|---|---|
Protocol |
Das für die Verbindung mit dem DataSnap-Server verwendete Protokoll. Folgende Werte sind möglich:
|
TCP/IP |
Server | Adresse des Servers, mit dem verbunden werden soll. | 127.0.0.1 |
Port | Der TCP/IP- oder HTTP-Port, über den der DataSnap-Server empfängt. Der Vorgabewert für TCP/IP ist 211, für HTTP - 8080. | 211 |
User_Name | Benutzername für die Authentifizierung beim DataSnap-Server. | |
Password | Passwort für die Authentifizierung beim DataSnap-Server. | |
BufferKBSize | Zu verwendende Puffergröße in Kilobyte für Lese- und Schreibvorgänge. Der Vorgabewert ist 32 KB. | 64 |
Filters | Client-Filter zum Speichern der Filterkonfiguration. Der Vorgabewert ist leer. Weitere Informationen unter: TDBXPropertyNames.Filters | { "ZLibCompression": {} } |
URLPath | Nur HTTP. URL-Pfad für den HTTP-DataSnap-Dienst, wenn das HTTP-Protokoll verwendet wird. Der Vorgabewert ist leer. | |
DatasnapContext | Nur HTTP. Pfad zum DS-HTTP-Dienst für die Zusammenstellung des URL. Die aktuelle Konvention lautet: "http://x.com/datasnap/provider/classname/method/params". Der Benutzer kann dabei das Wort "datasnap" ändern oder löschen. Der Vorgabewert ist "datasnap/". | |
DSProxyHost | Nur HTTP. Der Host, über den Anforderungen gesendet werden können, oder ein leerer String, wenn Sie keinen Proxy verwenden. Der Vorgabewert ist leer. | |
DSProxyPort | Nur HTTP. Der Port auf dem Proxy-Host, über den Anforderungen gesendet werden können. Wenn DSProxyHost festgelegt ist, wird dieser Wert ignoriert. Der Vorgabewert ist leer. | |
DSProxyUsername | Nur HTTP. Benutzername für die Authentifizierung beim Proxy. Der Vorgabewert ist leer. | |
DSProxyPassword | Nur HTTP. Passwort für die Authentifizierung beim Proxy. Der Vorgabewert ist leer. | |
DSAuthenticationScheme | Nur HTTP. DataSnap-Authentifizierungsschema. Wird in Verbindung mit dem DataSnap-Benutzernamen und -Passwort für die Authentifizierung mit dem HTTP-Protokoll verwendet. Setzen Sie diesen Parameter auf "basic", um "User_Name"-/"Password"-Werte mit einer HTTP-Basisauthentifizierung zusätzlich zum Senden dieser Werte in dem DBX-Verbindungsstring zu senden. Mit der HTTP-Basisauthentifizierung können Anmeldeinformationen an einen Zwischenprozess-DataSnap-HTTP-Tunnelserver übergeben werden. Der Vorgabewert ist leer. | |
LoginTimeout | Nur HTTP. Zeitüberschreitungswert bei der Verbindung. Der Wert enthält die Anzahl von Millisekunden, die der Client darauf wartet, dass die Verbindung möglich wird. Der Wert stellt die Zeitüberschreitung für die erste Serverantwortbestätigung und nicht für die gesamte Verbindungs-/Authentifizierungsphase bereit. Dieser Parameter sollte verwendet werden, um das Einfrieren der Anwendung zu verhindern, wenn die Möglichkeit besteht, dass Verbindungen zu älteren DataSnap-Server-Versionen oder zu anderen Anwendungen versucht werden, die das aktuelle Kommunikationsprotokoll nicht bestätigen. Der Vorgabewert ist 10000ms. | |
CommunicationTimeout | Nur HTTP. Zeitüberschreitungswert in Millisekunden für eine Antwort nach Herstellen der Verbindung. Der Vorgabewert ist leer. |
Anwendungsfälle
Herstellen einer Verbindung zum lokalen DataSnap-Server mit Standardeinstellungen:
DriverID=DS
Herstellen einer Verbindung zum DataSnap-Server mit dem auf einem lokalen Host ausgeführten TCP/IP-Protokoll:
DriverID=DS Protocol=tcp/ip Server=127.0.0.1 Port=211 User_Name=dsusr Password=123