$singleton

You can directly call exposed functions of your shared singletons through REST.

Singleton functions are called in POST requests with the $singleton command and without (). For example, if you have defined a buildVehicle() function in the VehicleFactory shared singleton class, you could call it using the following request:

/rest/$singleton/VehicleFactory/buildVehicle

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

In 4D language, this call is equivalent to:

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

注

Keep in mind that only functions with the exposed keyword can be directly called from REST requests.

関数の呼び出し

Singleton functions must always be called using REST POST requests (a GET request will receive an error). シンタックスは次の通りです:

/rest/$singleton/SingletonClass/SingletonClassFunction

プロジェクトがコンパイル済みモードで実行される場合、RESTサーバーは常にプリエンプティブプロセスを使用するため、RESTリクエストから呼び出されるすべての 4Dコードは スレッドセーフでなければなりません (プリエンプティブプロセスを使用 の設定値 は、RESTサーバーによって無視されます)。

info

You can restrict calls to specific singleton functions by configuring appropriate privileges in the roles.json file.

引数

You can send parameters to singleton functions. On the server side, they will be received in the declared parameters of the singleton class functions.

Sending parameters to singleton functions is exactly the same as sending parameter to ORDA class functions. Please refer to the Parameters paragraph of the "Calling class functions" page for a detailed description.

例題

You have created a simple shared singleton with an exposed function:

//class mySingleton

shared singleton Class constructor()

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

注

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

次のリクエストを実行します:

POST /rest/$singleton/mySingleton/sayHello

Body of the request: ["John"]

レスポンス

{
	"result": "Hello John"
}