Présentation de BaaS
Remonter à Développement d'applications RAD Server, Cloud et REST
BaaS (Backend as a Service) également connu sous le nom MBaaS (Mobile Backend as a Service) permet de connecter des applications mobiles (et de bureau) aux services cloud.
RAD Studio fournit le framework REST BaaS (backend-as-service) qui vous permet de connecter vos applications avec les fournisseurs BaaS Kinvey (EN) et Parse (EN).
Utilisez le framework REST BaaS pour établir la connexion avec les fournisseurs BaaS Kinvey ou Parse de manière à :
- Créer, récupérer, mettre à jour et supprimer des objets.
- S'inscrire, se connecter, récupérer, mettre à jour et supprimer des utilisateurs.
- Charger, télécharger et supprimer des fichiers ou des flux.
- Exécuter des requêtes sur des objets et des utilisateurs.
- Envoyer des notifications push.
- S'abonner à et recevoir des notifications push sur un périphérique.
Sommaire
Introduction aux fournisseurs BaaS
Pour pouvoir utiliser Kinvey et Parse comme fournisseurs BaaS, vous devez créer un compte. Ensuite, pour pouvoir ajouter ce service à vos applications, vous devez créer une app avec le fournisseur backend :
Informations sur le compte BaaS
Une fois que vous avez créé une app avec le fournisseur BaaS, Kinvey et Parse vous fournissent des clés que vous devez ajouter dans le composant fournisseur Kinvey et le composant fournisseur Parse de votre application RAD Studio.
Clés Kinvey :
| Nom de clé Kinvey | Propriété |
|---|---|
| App Key (ou App ID) | TKinveyProvider.AppKey |
| App Secret (Secret d'app) | TKinveyProvider.AppSecret |
| Master Secret (secret maître) | TKinveyProvider.MasterSecret |
Clés Parse :
| Nom de clé Parse | Propriété |
|---|---|
| Application ID (ID d'application) | TParseProvider.ApplicationID |
| Master Key (clé maître) | TParseProvider.MasterKey |
| REST API Key (clé API REST) | TParseProvider.RestApiKey |
API REST.Backend
L'API REST.Backend fournit un ensemble de composants à utiliser avec Kinvey et Parse pour gérer différents aspects comme les utilisateurs, le stockage, les fichiers, les requêtes, les notifications push et les événements.
Composants REST.Backend
Les composants REST.Backend prennent en charge les services BaaS de manière générale ou abstraite. Le code que vous écrivez en utilisant ces composants n'est pas spécifique à Kinvey ou à Parse. Par exemple, lorsque vous utilisez le composant TBackendStorage pour créer un objet, le code est le même si vous créez un objet Kinvey ou un objet Parse.
Les composants REST Backend dépendent des implémentations de service backend pour effectuer des appels à Kinvey ou Parse. Par exemple, il existe un service de stockage Kinvey qui peut être utilisé par le composant TBackendStorage.
Pour créer une application BaaS, vous devez inclure un composant fournisseur comme TKinveyProvider ou TParseProvider avec les informations de connexion appropriées pour le service cloud fourni par le fournisseur BaaS. Pour connecter un composant fournisseur à un composant service, vous devez indiquer le composant fournisseur dans la propriété Provider du composant service, par exemple TBackendStorage.Provider. Les tableaux ci-dessous présentent les composants fournisseur BaaS et les composants service :
| Composant fournisseur BaaS | Description |
|---|---|
| TKinveyProvider | Composant fournisseur BaaS Kinvey qui contient les informations relatives à la connexion au service cloud Kinvey. |
| TParseProvider | Composant fournisseur BaaS Parse qui contient les informations relatives à la connexion au service cloud Parse. |
| Composant service | Description |
|---|---|
| TBackendStorage | Utilisez ce composant pour créer, récupérer, mettre à jour et supprimer des objets. |
| TBackendUsers | Utilisez ce composant pour effectuer les actions utilisateur suivantes : s'inscrire, se connecter, récupérer, mettre à jour et supprimer des utilisateurs. |
| TBackendFiles | Utilisez ce composant pour charger et supprimer des fichiers ou des flux. Remarque : Ce composant ne télécharge pas des fichiers. Utilisez la classe REST TDownloadURL pour télécharger des fichiers. |
| TBackendQuery | Utilisez ce composant pour effectuer des requêtes sur les objets, les utilisateurs et d'autres types.
Remarque : Une implémentation de service différente peut prendre en charge l'exécution de requêtes sur différents types. Par exemple, l'implémentation de service Kinvey peut effectuer des requêtes sur les fichiers, tandis que l'implémentation Parse ne le peut pas. |
| TBackendAuth | Utilisez ce composant pour gérer l'authentification des utilisateurs comme la connexion et l'inscription. |
| TBackendPush | Utilisez ce composant pour envoyer des notifications push. |
| TPushEvents | Utilisez ce composant pour écouter les messages des notifications push. |
Méthodes REST.Backend
Les unités API REST REST.Backend.KinveyApi et REST.Backend.ParseApi vous permettent d'exécuter des méthodes API REST Kinvey et Parse.
Ces unités déclarent des méthodes qui sont mappées directement sur l'API REST du fournisseur BaaS. Utilisez ces unités pour écrire du code qui appelle les points de terminaison de l'API REST dans Kinvey ou Parse. Le code que vous écrivez en utilisant ces unités sera spécifique à Parse ou à Kinvey.
Les tableaux ci-dessous présentent les méthodes REST.Backend que vous pouvez utiliser et les ressources et verbes associés utilisés.
Méthodes à partir de REST.Backend.KinveyApi :
| Méthode TKinveyApi | Ressource | Verbe |
|---|---|---|
| AppHandshake | AppData | GET |
| CreateAppData | AppData | POST |
| FindAppData | AppData | GET |
| DeleteAppData | AppData | DELETE |
| UpdateAppData | AppData | PUT |
| QueryAppData | AppData | GET |
| UploadFile | Blob | POST |
| DeleteFile | Blob | DELETE |
| DownloadFile | Blob | GET |
| QueryFiles | Blob | GET |
| RetrieveFile | Blob | GET |
| SignupUser | User | POST |
| LoginUser | User | POST |
| RetrieveUser | User | GET |
| RetrieveCurrentUser | User | GET |
| UpdateUser | User | PUT |
| DeleteUser | User | DELETE |
| SuspendUser | User | DELETE |
| PushRegisterDevice | Push | POST |
| PushUnregisterDevice | Push | POST |
- Remarque : Les ressources du tableau ci-dessus font référence à ce qui suit : AppData désigne les données stockées dans le cloud, Blob désigne les fichiers (comme les images, les vidéos et autres), User désigne un utilisateur et Push désigne une notification push.
Méthodes à partir de REST.Backend.ParseApi :
| Méthode TParseApi | Ressource | Verbe |
|---|---|---|
| CreateClass | Classes | POST |
| DeleteClass | Classes | DELETE |
| FindClass | Classes | GET |
| UpdateClass | Classes | PUT |
| QueryClass | Classes | GET |
| UploadInstallation | Installations | POST |
| UpdateInstallation | Installations | PUT |
| DeleteInstallation | Installations | DELETE |
| QueryInstallation | Installations | GET |
| PushToDevices | Push | POST |
| PushBroadcast | Push | POST |
| PushWhere | Push | POST |
| UploadFile | Files | POST |
| DeleteFile | Files | DELETE |
| SignupUser | Users | POST |
| LoginUser | Users | GET |
| UpdateUser | Users | PUT |
| DeleteUser | Users | DELETE |
| QueryUsers | Users | GET |
- Remarque : Les ressources du tableau ci-dessus font référence à ce qui suit : Classes désigne les objets, Installation désigne une instance de l'app installée sur un périphérique, Push désigne une notification push, Files désigne les fichiers et Users les utilisateurs.
Vous pouvez également consulter la documentation API des fournisseurs BaaS :
Composants LiveBinding visuels
Certains composants BaaS assurent la prise en charge de composants LiveBinding visuels, de sorte que vous pouvez utiliser le Concepteur LiveBindings pour connecter les propriétés des composants aux contrôles de votre fiche.
| Propriété | Valeur | Contrôle typique de liaison |
|---|---|---|
| TBackendQuery.JSONResult | Résultat de la requête (TJSONArray). | TMemo |
| TBackendQuery.BackendClassName | Nom de collection ou de classe lors de l'exécution d'une requête sur le stockage. | TEdit |
| TBackendQuery.BackendService | Cible de la requête : stockage, utilisateurs, installations, fichiers, et ainsi de suite. | TEdit |
| TBackendQuery.QueryStrings | Chaînes de requête. Les chaînes doivent être valides pour le service cloud donné. | TMemo |
| TBackendPush.GCM.Action | Champ d'action du message push (Android). | TEdit |
| TBackendPush.APS.Alert | Champ d'alerte. | TEdit |
| TBackendPush.APS.Badge | Champ de badge (iOS). | TEdit |
| TBackendPush.APS.Sound | Champ de son (iOS). | TEdit |
| TBackendPush.GCM.Title | Champ de titre (Android). | TEdit |
| TPushEvents.JSONResult | Tableau JSON de tous les messages reçus. | TMemo |
| TPushEvents.Active | Ecoute les messages push. | TCheckBox |
Rubriques BaaS
- Introduction à Kinvey et Parse
- Gestion des utilisateurs BaaS
- Utilisation de BaaS pour le stockage backend
- Utilisation de BaaS pour envoyer des notifications push
- Tutoriels BaaS :