$singleton

Você pode chamar diretamente as [funções de seus singletons compartilhados] expostas (../Concepts/classes.md#singleton-classes) por meio de REST.

Singleton functions are called in POST or GET requests with the $singleton command and without (). Por exemplo, se você tiver definido uma função buildVehicle() na classe singleton compartilhada VehicleFactory, poderá chamá-la usando a seguinte solicitação:

/rest/$singleton/VehicleFactory/buildVehicle

com dados no corpo do pedido POST: ["truck"]

Na linguagem 4D, esta chamada é equivalente a:

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

nota

Tenha em mente que somente funções com a palavra-chave exposed podem ser diretamente chamadas de solicitações REST.

Chamadas funções

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

A sintaxe formal é:

POST request

/rest/$singleton/SingletonClass/SingletonClassFunction

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

GET request

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

nota

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

Você pode restringir chamadas a funções singleton específicas configurando os privilégios apropriados no arquivo roles.json.

Parâmetros

Você pode enviar parâmetros para funções singleton. Del lado del servidor, serán recibidos en los parámetros declarados de las funciones clase singleton.

O envio de parâmetros para funções singleton é exatamente igual ao envio de parâmetros para funções de classe ORDA. Por favor, consulte o parágrafo Parâmetros da página "Chamando as funções classe" para uma descrição detalhada.

Exemplo

Você criou um singleton compartilhado simples com uma função exposta:

//class mySingleton

shared singleton Class constructor()

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

nota

A classe mySingleton e a função sayHello são listadas quando você chama o comando $catalog.

Pode então executar este pedido:

POST /rest/$singleton/mySingleton/sayHello

Corpo da solicitação: ["John"]

Resposta

{
	"result": "Hello John"
}