$singleton

Vous pouvez appeler directement les fonctions exposées de vos shared singletons via REST.

Singleton functions are called in POST or GET requests with the $singleton command and without (). Par exemple, si vous avez défini une fonction buildVehicle() dans la classe singleton partagée VehicleFactory, vous pouvez l'appeler à l'aide de la requête suivante :

/rest/$singleton/VehicleFactory/buildVehicle

avec les données dans le body de la requête POST : ["truck"]

En langage 4D, cet appel est équivalent à :

$singleton:=cs.VehicleFactory.me.buildVehicle("truck")

note

N'oubliez pas que seules les fonctions avec le mot-clé exposed peuvent être directement appelées à partir de requêtes REST.

Appeler des fonctions

Singleton functions can be called using REST POST or GET requests.

La syntaxe formelle est la suivante :

POST request

/rest/$singleton/SingletonClass/SingletonClassFunction

with data in the body of the POST request: ["myparam"]

GET request

/rest/$singleton/SingletonClass/SingletonClassFunction?$params='["myparam"]'

note

The SingletonClassFunction() function must have been declared with the onHttpGet keyword to be callable with GET (see Function configuration).

La totalité du code 4D appelé à partir de requêtes REST doit être thread-safe si le projet fonctionne en mode compilé, car le serveur REST utilise toujours des process préemptifs dans ce cas (la valeur du paramètre Utiliser un process préemptif est ignorée par le serveur REST).

info

Vous pouvez limiter les appels à des fonctions singleton spécifiques en configurant les privilèges appropriés dans le fichier roles.json.

Paramètres

Vous pouvez envoyer des paramètres aux fonctions singleton. Côté serveur, ils seront reçus dans les paramètres déclarés des fonctions de la classe singleton.

L'envoi de paramètres aux fonctions singleton est exactement le même que l'envoi de paramètres aux fonctions de classe ORDA. Veuillez vous référer au paragraphe Paramètres de la page "Appeler des fonctions de classe" pour une description détaillée.

Exemple

Vous avez créé un singleton partagé simple avec une fonction exposée :

//class mySingleton

shared singleton Class constructor()

exposed Function sayHello ($value : Text)
	return "Hello "+$value

note

La classe mySingleton et la fonction sayHello sont répertoriées lorsque vous appelez la commande $catalog.

Vous pouvez lancer cette requête :

POST /rest/$singleton/mySingleton/sayHello

Body de la requête : ["John"]

Réponse

{
	"result": "Hello John"
}