$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).

All 4D code called from REST requests must be thread-safe if the project runs in compiled mode, because the REST Server always uses preemptive processes in this case (the Use preemptive process setting value is ignored by the REST Server).

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

The mySingleton class and sayHello function are listed when you call the $catalog command.

Vous pouvez lancer cette requête :

POST /rest/$singleton/mySingleton/sayHello

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

Réponse

{
	"result": "Hello John"
}