Expert Application DataSnap REST
Remonter à Application Serveur DataSnap
Remonter à Menu Fichier
Fichier > Nouveau > Autre > Projets Delphi > Serveur DataSnap > Application DataSnap REST
Fichier > Nouveau > Autre > Projets C++Builder > Serveur DataSnap > Application DataSnap REST
L'expert Application DataSnap REST crée un projet qui est le point de départ de la construction d'une application web AJAX. Quelles que soient les options sélectionnées, l'expert crée une unité qui contient les composants suivants :
Sommaire
- Un composant DSServer
- Un composant DSServerClass
- Un composant TDSRESTWebDispatcher
- Remarque : Le composant TDSRESTWebDispatcher de l'application REST utilise toujours les sessions, sauf si vous définissez la propriété SessionLifetime de TimeOut sur Request.
- Un composant WebFileDispatcher
- Un composant ServerFunctionInvoker
- Un composant ReverseString
- Un composant DSProxyGenerator
- Un composant DSServerMetaDataProvider
Tous les composants supplémentaires sont connectés au TDSServer, avec la propriété Server définie sur le nom du composant TDSServer. Le protocole de communication entre les applications client et serveur est HTTP ou HTTPS et la technologie est REST (Representational State Transfer).
L'expert Application DataSnap REST est composé de quatre à sept étapes, selon le type de l'application REST sélectionnée à la première étape et les choix que vous effectuerez au sein de cet expert. Les étapes de l'expert sont illustrées dans les images suivantes, suivies d'une description détaillée.
Page Type du projet WebBroker
Dans la première étape de l'expert, vous êtes invité à sélectionner le type de l'application REST. Les options possibles sont listées dans le tableau suivant :
| Option | Description |
|---|---|
|
Application VCL autonome |
Une application VCL REST autonome est un serveur web qui affiche une fiche VCL. Elle supporte HTTP en utilisant un composant serveur Indy HTTP. |
|
Application console autonome |
Une application console REST autonome est un serveur web qui a une interface utilisateur en texte seulement. Elle supporte HTTP en utilisant un composant serveur Indy HTTP. |
|
Bibliothèque de liaison dynamique ISAPI |
Les applications serveur web ISAPI et NSAPI sont des objets partagés qui sont chargés par le serveur web. Les informations de requête client sont transmises à la DLL sous forme de structure et sont évaluées par TISAPIApplication. Chaque message de requête est géré dans un thread d'exécution distinct. Quand vous sélectionnez ce type d'application, l'en-tête de bibliothèque des fichiers projet et les entrées requises sont ajoutés à la liste uses. La clause du fichier projet est aussi exportée. Les bibliothèques ISAPI s'intègrent à IIS. IIS prend en charge HTTP et HTTPS. |
|
Module Apache à liaison dynamique |
Le serveur Web Apache héberge des sites web statiques ou dynamiques, fournissant des fonctionnalités de serveur web sécurisées et efficaces comme CGI (Common Gateway Interface), SSL (Secure Sockets Layer) et des domaines virtuels. Apache prend en charge HTTP et HTTPS. |
Page Type d'application
Cette étape se produit seulement lorsque vous sélectionnez Application autonome lors de l'étape 1. C'est là que vous pouvez choisir le type d'application que vous voulez créer.
Les types d'application disponibles sont :
- Application VCL
- Application FireMonkey
Page Options du module Apache
Cette page apparaît seulement si vous sélectionnez Module Apache à liaison dynamique comme type de projet dans la première étape de cet expert.
Dans cette page, vous êtes invité à saisir les informations suivantes :
- Version Apache
- Module Apache
- Unité Apache
Page Numéro de port
Cette étape de l'expert Application DataSnap REST est seulement disponible si vous choisissez Application VCL autonome ou Application console autonome à la première étape de l'expert. A la seconde étape, vous êtes invité à entrer le port de communication HTTP. L'expert vous permet aussi de tester la disponibilité du port par le biais du bouton Tester le port. Pour compléter automatiquement le champ Port HTTP avec l'un des ports auto-détectés disponibles, cliquez sur le bouton Chercher un port ouvert.
Remarque : Pour utiliser le protocole HTTPS, vous devez sélectionner la case à cocher HTTPS. Si HTTPS est sélectionné, l'expert comporte alors une étape supplémentaire qui vous invite à spécifier les fichiers de certificat. Le port des communications HTTPS sera défini sur 443, qui est le port généralement utilisé par IIS.
Page Certificats X.509
Cette étape apparaît seulement si vous sélectionnez le protocole de communication HTTPS à l'étape précédente. Vous êtes invité à entrer ici les informations suivantes afin d'utiliser le protocole des communications HTTPS :
- Nom du fichier contenant le certificat X.509 (*.pem)
- Nom du fichier contenant la clé
- Nom du fichier contenant le mot de passe pour le fichier de clé
- Nom du fichier contenant le certificat racine
Pour valider la sélection, appuyez sur le bouton Tester.
Page Fonctionnalités serveur
Dans cette étape, vous êtes invité à spécifier les fonctionnalités du serveur DataSnap REST.
- Si vous sélectionnez l'option Authentification, un composant TDSAuthenticationManager est placé sur la fiche serveur. Le composant TDSRESTWebDispatcher utilise le TDSAuthenticationManager en tant que AuthenticationManager afin de permettre l'implémentation de l'authentification utilisateur REST pour le serveur DataSnap. L'implémentation se compose de l'implémentation de la propriété Authenticate. Quand l'option Authentification est sélectionnée, le client doit fournir le nom d'utilisateur et le mot de passe DataSnapdans les propriétés de connexion SQL.
- Sélectionnez l'option Classe de méthodes serveur pour ajouter un composant TDSServerClass à la fiche serveur et permettre la définition d'une classe sur le serveur qui exposera les méthodes serveur aux applications client.
-
- Si vous sélectionnez l'option Méthodes exemples, ServerMethodsUnit contiendra l'implémentation de deux méthodes simples appelées EchoString et ReverseString, qui renvoient la valeur donnée sous la forme d'un paramètre dans des états inversés respectifs normaux.
-
- La sélection de l'option Fichiers web exemple entraîne l'ajout d'un ensemble de fichiers web exemple et de pages associées dans ce projet. Ils sont tous visibles dans le Gestionnaire de projets sous ce projet serveur DataSnap. Inspectez les fichiers du répertoire templates pour observer l'implémentation Web réelle pour les méthodes ServerFunctionInvoker et ReverseString.
- La case à cocher Connecteurs mobiles vous permet d'inclure le support de la répartition des proxys pour le déploiement de connecteurs mobiles. Pour plus d'informations sur les connecteurs mobiles DataSnap, voir Introduction aux connecteurs mobiles DataSnap.
- La case à cocher Module serveur vous permet de créer un module distinct pour les composants serveur DataSnap. Cela active la prise en charge des rappels avancés dans les applications DataSnap REST.
Page Classe ancêtre des méthodes serveur
Cette étape de l'expert Application DataSnap REST vous invite à spécifier le type ancêtre de la classe de méthodes serveur.
Choisissez TDataModule si vous voulez utiliser des composants non visuels dans votre classe serveur. Choisissez TComponent si vous voulez implémenter entièrement la classe serveur.
Page Emplacement du projet
La dernière étape de l'expert vous invite à spécifier l'emplacement du serveur DataSnap REST généré. Tapez le répertoire racine de l'application web que vous êtes en train de créer. Ce répertoire est le répertoire de sortie de l'exécutable du projet et l'emplacement des fichiers d'application web, tels que les fichiers .js, .html et .css, et d'autres fichiers statiques.