DSServer.TDSServerClass

Informations Delphi

De DSServer.pas

TDSServerClass = class(TDSCustomServerClass)

Unité : DSServer

Type : classe

Membres de classe hérités : Membres DSServer.TDSServerClass

Constructeurs et destructeurs de classe : Constructeurs DSServer.TDSServerClass

Evénements de classe : Evénements DSServer.TDSServerClass

Description

Composant utilisé pour spécifier une classe côté serveur avec des méthodes publiées qui peuvent être appelées à partir d'un client distant à l'aide d'une invocation de méthode dynamique.

TDSServerClass est un composant qui peut être utilisé pour spécifier une classe côté serveur avec des méthodes publiées qui peuvent être appelées à partir d'un client distant à l'aide d'une invocation de méthode dynamique.

Les méthodes de cette classe peuvent être appelées à partir de clients distants, comme le fournisseur client DBX ou le fournisseur ADO.NET.

Les classes côté serveur qui étendent TRemoteDataModule peuvent également être spécifiées afin que les fournisseurs contenus puissent être accessibles par un composant client TDSProviderConnection côté client.

Les types de paramètres et de retour des méthodes de classe serveur publiées et supportées incluent la plupart des types de valeur dbExpress qui s'étendent depuis les valeurs scalaires TDBXValue et les objets TDBXReader et TStream.

Types de paramètresTDBXValuesupportés

Actuellement, l'utilisation d'un TDBXValue est la façon la plus rapide pour passer un paramètre, car ce sont les objets internes utilisés pour gérer les listes de paramètres. Quand ces types de paramètres sont spécifiés, le TDBXValue interne est passé directement à l'application. Toutefois, puisque cela est traité comme un paramètre TDBXParameterDirections.IN_OUT_PARAMETER, une application peut vouloir appeler TDBXWritableValue.SetNull avant de revenir d'une méthode où la valeur peut être grande. Sinon la valeur est renvoyée au client distant.

Voici la liste des types TDBXValue pouvant être utilisés comme paramètres :

Voici la liste des types spécifiques à JSON pouvant être utilisés comme paramètres :

Les types chaîne ou de valeur scalaire var et out sont supportés

Les paramètres var d'une méthode serveur sont traités comme TDBXParameterDirections.IN_OUT_PARAMETER par un pilote client de base de données. Les paramètres out d'une méthode serveur sont traités comme TDBXParameterDirections.OUT_PARAMETER par un pilote client de base de données.

Voici la liste des types de valeur scalaire supportés :

Les types de valeur scalaire in et return sont supportés.

Le paramètre in d'une méthode serveur est traité comme TDBXParameterDirections.IN_PARAMETER par un pilote client de base de données. Le paramètre return d'une méthode serveur est traité comme TDBXParameterDirections.RETURN_PARAMETER par un pilote client de base de données. La valeur de retour est disponible pour le pilote client de base de données comme le dernier paramètre de la liste des paramètres de la commande.

Cette liste inclut toutes les valeurs scalaires pouvant être transmises en tant que paramètres var et out, plus les types de données supplémentaires suivants :

Actuellement, les valeurs TBcd et TSQLTimeStamp peuvent seulement être passées par les paramètres TDBXBcdValue et TDBXTimeStampValue.

Connexion de base de données partagée

Une méthode serveur peut partager l'accès à une connexion de base de données avec une connexion client. Une connexion client ne peut avoir qu'une seule association avec une connexion de base de données côté serveur à un moment donné. Cette connexion de base de données partageant les méthodes client et serveur permet au client d'exécuter des instructions SQL et des procédures stockées via la même connexion de base de données et contexte transactionnel que les méthodes serveur auxquelles le client fait des appels. Un client peut partager une connexion de base de données avec une méthode serveur en appelant une méthode serveur qui renvoie une instance de TDBXConnection. L'instance de TDBXConnection n'est pas actuellement renvoyée au client. A la place, l'instance de TDBXConnection est utilisée pour toutes les instructions SQL et commandes de procédure stockée SQL qui sont exécutées par le client. Par souci de commodité, cette méthode serveur peut être spécifiée en définissant la propriété de connexion TDBXPropertyNames.ServerConnection sur le nom d'une méthode serveur qui renvoie une instance de TDBXConnection.