DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / WebSocket
  • Contextes d'exécution
  • Fonctionnement asynchrone
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
WebSocketExécuteServiceGlobal (Fonction)
En anglais : WebSocketExecuteGlobalService
Exécute une procédure globale dans le contexte du service global du serveur de WebSocket.
Exemple
// Le client vient de se connecter.
// Il se déclare dans le tableau des clients disponibles pour jouer.
WebSocketExécuteServiceGlobal(ConnexionClient, clClient)
 
//=======================
// Procédure globale
PROCÉDURE ConnexionClient(clClient est un websocketClient)
// Utilise le client.
Syntaxe
WebSocketExécuteServiceGlobal(<Procédure WLangage> [, <Paramètres>])
<Procédure WLangage> : Nom de procédure
Nom de la procédure globale WLangage à exécuter dans le contexte du service global.
<Paramètres> : Liste de valeurs entre parenthèses et séparées par des virgules
Paramètres de la procédure. Cette liste de paramètres est de la forme :
(<Paramètre 1>, ..., <Paramètre N>)
où :
  • <Paramètre 1> : Premier paramètre de la procédure.
  • ...
  • <Paramètre N> : Nième paramètre de la procédure.
Attention :
  • Les paramètres sont passés par valeur.
  • Seuls les types simples sont autorisés : Booléen, entier, ... Il n'est par exemple pas possible d'avoir un paramètre correspondant à une instance de classe.
Remarques

Contextes d'exécution

Le service global du serveur de WebSocket et les clients connectés s'exécutent indépendamment. Chacun s'exécute dans son propre contexte avec :
  • sa propre copie des variables globales.
  • son propre contexte de base de données.
  • etc.
Il n'est donc pas possible de manipuler directement le contexte global ou le contexte d'un autre client.
La fonction WebSocketExécuteServiceGlobal permet d'exécuter la procédure globale WLangage passée en paramètre dans le contexte du service global. Pendant l'exécution de la procédure globale, les variables globales vues seront celles du service global.
La procédure globale est appelée entre deux appels de l'événement "Service global" (appelé en boucle). L'intervalle de lancement de cet événement doit donc laisser assez de temps sinon la procédure ne sera jamais appelée. Cet intervalle peut être paramétré via l'attribut d'extension <intervalle=<Durée>>. Pour plus de détails, consultez Utilisez les Websockets grâce au serveur de Websocket.

Fonctionnement asynchrone

Le fonctionnement est asynchrone : la fonction ne fait que demander l'exécution de la procédure. L'exécution effective de la procédure peut intervenir ultérieurement (et en particulier après la sortie de la fonction WebSocketExécuteServiceGlobal). La fonction WebSocketExécuteServiceGlobal ne renvoie jamais d'erreur (par exemple si le client s'est/a été déconnecté entre temps).
Classification Métier / UI : Code métier
Composante : wd290awws.dll
Version minimum requise
  • Version 26
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale